DevCodex

宿主与工作区设置

先完成5 分钟开始，再处理宿主差异、auto 或多项目 workspace。本页只讲如何选择入口；能力结论以宿主参考的当前证据为准。

选择你的入口

宿主推荐入口使用前要知道
GitHub CopilotCopilot CLIVS Code / JetBrains 主要使用 instruction fallback，不能继承 CLI 的 Hook 证据
Claude CodeClaude Code完整程度以当前 adapter 和 direct evidence 为上限
CodexCodex App / CLIHook 与 MCP 是否生效取决于当前安装和宿主能力
GeminiGemini CLI没有 direct replay 时保持 Beta / UNVERIFIED
Grokdevcodex grok普通 grok 是 Partial 兼容入口
Cursor本地 IDE / CLI本地为 Beta；Cursor Cloud Agent 是 Partial / UNVERIFIED

安装或更新 DevCodex 后要完全新开宿主会话。旧会话不会在中途切换 runtime generation。

多项目 workspace

在共同 workspace 根执行：

cd <workspace-root>
devcodex init
devcodex status

DevCodex 使用 workspace base + project overlay 保存项目 Profile、报告、记忆和任务状态。开始任务时应能解析出唯一项目；若多个候选同名或 active-root 不唯一，先明确项目名或进入对应项目目录，不要让模型猜。

auto 入口

正式入口为 @devcodex-auto，默认快捷别名是 @rocky：

@rocky 按已确认方案完成文档修改并运行相关验证，不要提交或发布。

auto 只自动通过适用 CP，不会扩大项目范围或发布授权；文件、删除与命令权限由宿主及其用户配置决定。extensions.devcodex.autoAliases 为非空数组时会替换默认别名；空数组会关闭默认别名。

验证宿主是否真的就绪

devcodex status
devcodex doctor

不要只看“配置文件存在”。依次确认 workspace 已解析、adapter configured、contract 通过，以及当前宿主要求的 native probe 是否有直接证据。没有证据就保留 UNVERIFIED。

产物链接为什么有时打不开

DevCodex 按当前呈现面选择打开方式，而不是看到宿主名称就假定链接可用。Codex Desktop 使用真实本地文件链接；VS Code、Zed、JetBrains 可给对应打开命令；CLI、未知界面或能力未验证时给可复制绝对路径。只有打开动作执行且回读成功才会显示“已打开”；仅生成 renderer、命令或链接不会冒充成功。若目标缺失、动作失败或无法回读，回复会直接显示绝对路径和 fallback 原因。

常见恢复

  • 更新后仍是旧行为：在原任务核对安装版本与实际加载的 runtime generation；可用时重载连接，没有该能力时保存检查点、继续可执行工作，方便时重载宿主后续办。
  • Grok 没有完整流程：确认从 devcodex grok 启动，而不是普通 grok。
  • Cursor Cloud 看起来比本地少：这是已知能力边界，不能用本地 Beta 结果覆盖 Cloud。
  • 项目识别错误：回到真实项目或 workspace 根运行 status；检查 Profile 和 project overlay。

仍无法恢复时进入故障排查。