Codex Workbench

Codex Workbench 是一个辅助官方 Codex VS Code 扩展使用的工作台。它帮助你把当前正在看的文件、选中的代码、终端输出和代码批注整理成 Codex 更容易理解的上下文。

它不替代 Codex，也不会自动决定怎么改代码。它的作用是减少你手动复制路径、代码片段、问题说明和上下文的成本，让你和 Codex 的协作更顺手。

主要功能

添加文件或目录到 Codex

你可以从编辑器标题栏、资源管理器右键菜单或命令面板，把当前文件、选中文件或目录加入 Codex 对话。

适合这些场景：

• 让 Codex 阅读一个文件并解释代码。
• 让 Codex 基于一个目录分析模块结构。
• 让 Codex 结合当前文件继续修改或排查问题。

添加选中代码到 Codex

在编辑器里选中一段代码后，可以使用 Codex：加入选区，只把选中的内容发送给 Codex。

适合这些场景：

• 只讨论一个函数、配置片段或错误位置。
• 避免把整个文件都交给 Codex。
• 让 Codex 聚焦在你真正关心的代码上。

快捷键：

• Windows / Linux：Ctrl+Alt+C
• macOS：Cmd+Alt+C

添加终端选区到 Codex

在 VS Code 终端里选中日志、报错或命令输出后，可以使用 Codex：加入终端选区。

扩展会把终端内容整理成 Markdown 上下文，再加入 Codex 对话。这样 Codex 能同时看到报错内容、终端名称、工作区信息和捕获时间。

快捷键：

• Windows / Linux：Ctrl+Alt+T
• macOS：Cmd+Alt+T

写代码批注

你可以直接在代码行上写审阅批注，然后把批注交给 Codex 处理。

批注会保留这些信息：

• 目标文件和行号。
• 精确选区位置。
• 选中的原文。
• 前后文代码片段。
• 文件快照信息。
• 用户评论和回复链。
• 批注状态。

快捷键：

• Windows / Linux：Ctrl+Alt+R
• macOS：Cmd+Alt+R

批注面板

Codex：批注面板 可以集中查看当前工作区里的批注，并执行常用操作：

• 发送待处理批注给 Codex。
• 复制批注内容。
• 标记批注已解决。
• 清理已解决批注。
• 定位到批注所在代码。

状态栏也会显示批注数量，格式为：

待发送 / 已提交 / 已解决

推荐工作流

1. 在代码里选择问题位置。
2. 使用 Codex：写批注 记录你的问题、建议或修改要求。
3. 重复添加多条批注。
4. 使用 Codex：发送未解决 或批注面板，把待处理批注加入 Codex。
5. 在 Codex 对话里让 AI 逐条处理这些批注。
6. Codex 修改对应文件后，已提交的旧批注会自动清理。
7. 继续基于新的代码状态添加下一轮批注。

这个流程适合做代码审阅、问题修复、重构说明和多点修改任务。

批注状态说明

批注有三种常见状态：

• 待发送：还没有提交给 Codex，会出现在下一次发送范围里。
• 已提交 Codex：已经加入 Codex 对话，等待对应文件发生变化后自动清理。
• 已解决：用户手动确认已处理，可按需清理。

当你把批注发送给 Codex 后，扩展不会立即删除它们。只有对应文件内容发生变化后，扩展才会清理该文件下已经提交给 Codex 的旧批注。这样可以避免你刚发送完还没来得及对照查看，批注就消失。

如果同一个文件里后来又新增了新的批注，新批注不会被旧批注的自动清理逻辑影响。

Markdown 文件批注建议

建议在 Markdown 源码编辑器里添加批注。

VS Code 的 Markdown 预览是 Webview，和源码行列位置并不总是稳定对应。为了避免批注位置和真实原文错位，涉及 Markdown 文档时，优先在 .md 源文件中批注。

配置项

审阅批注汇总文件

配置项：codexBridge.reviewNotesFile

默认值：

.codex-bridge/review-notes.md

发送批注给 Codex 时，扩展会把批注整理到这个 Markdown 文件中，再加入 Codex 对话。

添加批注后自动发送

配置项：codexBridge.autoSendReviewComment

默认值：

true

开启后，新增批注会自动加入 Codex 对话。关闭后，你可以先写多条批注，再通过批注面板或命令手动发送。

常见问题

为什么发送后批注没有立刻消失？

发送成功只表示批注已经加入 Codex 对话，并不能确认 Codex 已经读完或完成修改。为了避免误删，扩展会等对应文件内容发生变化后，再清理该文件下已提交的旧批注。

为什么已经提交的批注不会再次发送？

已提交批注代表它已经进入过 Codex 上下文。后续发送只会包含新的待发送批注，避免旧问题反复干扰新的对话。

为什么有时需要手动清理批注？

如果你只是让 Codex 解释问题，没有实际修改文件，已提交批注不会自动清理。你可以在批注面板里手动标记解决或删除。

使用前需要安装官方 Codex 扩展吗？

需要。Codex Workbench 负责整理和传递上下文，实际对话仍由官方 Codex VS Code 扩展完成。