Codex 架构审查 Lanzuelo/dsh-codex-bridge

DSH Codex Architect

English · 发布说明 · 更新日志

这是给 Windows 上官方 DeepSeek Harness Desktop 0.2.0-rc.2 用的插件。Codex 负责设计架构、审查改动，DeepSeek 负责主要开发工作。插件版本：0.2.1，预发布版。npm 包名：dsh-codex-architect。

在同一个 Harness 窗口里，你可以用 /codex 命令，也可以用右侧面板的 Codex Bridge 标签页。插件调用已安装的 Codex CLI，通过 ChatGPT 登录。不需要 OpenAI API 密钥；不会切换到付费 API，也不会自动替换模型。

0.1.0 和 0.1.1 有 bundle 激活错误。0.1.3 修掉了 /codex models 之后 Windows 报的 EBUSY 错误。0.2.0 加了主要的管理界面，0.2.1 修掉了 DSH 沙箱内加载模型列表的问题。请更新包并重启 Harness。

安装

1. 确认已安装 Harness 0.2.0-rc.2、Git 和 Codex CLI；Codex 里已通过 ChatGPT 登录。已验证的 CLI 版本：0.162.0-alpha.17.2。这是 alpha 版，升级后界面可能变。
2. 在 Harness 里打开 Plugins / 插件，选择添加包，填 dsh-codex-architect（npm latest：0.2.1）。要指定精确版本：dsh-codex-architect@0.2.1。GitHub 源：github:Lanzuelo/dsh-codex-bridge#v0.2.1。也可以从 GitHub Releases 下载 .tgz，然后填它的完整绝对路径。npm 上的 dsh-codex-bridge 属于另一个项目：不要把它当成这个插件安装。
3. 等激活成功，如果管理器要求就重启 Harness。
4. 在项目聊天里输入 /codex help。在右侧面板用 + / 标签页选择页打开 Codex Bridge。
5. 点 加载模型，选一个模型并保存。可以所有角色共用一个模型，也可以每个角色单独一个，或者手动输入 ID。default 表示 Codex 自带的 default，配独立的启动配置。

如果 Desktop 在 PATH 里找不到 CLI，插件会去 %USERPROFILE%\AppData\Local\OpenAI\Codex\bin\<版本> 找 codex.exe。非标准安装时，在插件行的配置里指定 codexPath。相对路径的 .cmd 可执行脚本不会通过 shell 启动；建议用 codex.exe 的绝对路径。

用户配置档 patch 里插件行的配置示例，如果这一行已经存在，请修改它，不要再加一份重复的：

- id: codex-bridge
name: dsh-codex-architect
config:
codexPath: 'C:\Users\USERNAME\AppData\Local\OpenAI\Codex\bin\VERSION\codex.exe'
Необязательно: отдельное локальное хранилище вне каталога проекта.
stateDirectory: 'C:\Users\USERNAME\.dsh-codex-bridge'
timeoutMs: 600000
maxAttempts: 3
未在开发过程中安装到用户的工作配置档。建议先在单独的配置档中验证包。更新 Harness 需要重新验证兼容性；不要绕过版本限制。

界面中的主流程

打开 Codex Bridge 标签页并选择模式：

- DeepSeek — 把想法或修正交给 DeepSeek，不启动 Codex；
- Codex — 把计划、文件建议或修正交给 Codex；
- Codex → DeepSeek — Codex 负责设计和验证，DeepSeek 负责实现和修正。

面板显示当前阶段、最近的任务和同名操作： 构建计划、检查项目、在 DeepSeek 中修正、 在 Codex 中准备、显示建议、应用、 恢复、重试 和 停止。ID 和 slash 命令位于技术详情中。

通过命令创建新项目

/codex plan Создай Telegram-бота с PostgreSQL
/codex handoff <id плана>

plan 最多给出三个方案，不写入文件。handoff 不带附加文本时，把推荐方案交给 DeepSeek 实现。在 Codex 模式下，面板允许选择方案并准备文件内容；只有单独确认 apply 才会写入建议。

骨架中必须有 docs/architecture.md 和 docs/deepseek-handoff.md。现有的 AGENTS.md 可以作为项目约定进入上下文；插件不会创建也不会覆盖 AGENTS.md，以免与用户指令冲突。现有项目使用同样的 plan；改动原始技术栈需要明确请求。

评审与修正

/codex review
/codex review focus Проверь особенно обработку повреждённых данных
/codex review files src/auth.ts|src/auth.test.ts --focus валидация
/codex handoff <id ревью>
/codex fix <id ревью>

不带路径时，评审覆盖相对 HEAD 的 staged 和 unstaged 改动、删除和 untracked 文件。没有 Git 时，插件检查整个项目的有限安全快照，并把缺少 baseline 标记为限制。还会传入主要 manifests、架构文档和最多 12 个本地 JS/TS 依赖。如果 Git 仓库位于工作目录之上，请选择它的根目录。路径可以包含空格；多个路径的分隔符是 |。

评审返回 severity、file、line/end_line、evidence、explanation、proposed_fix、confidence、summary 和 handoff。此时不会运行测试和构建。报告针对已保存的代码快照，而不是未来的改动。排除项和上下文限制可通过 show 查看。

用户直接选择执行方。两条命令都接受内容充实的 incomplete 报告，只要包含具体 findings，不要求模板化文本：

/codex handoff <id ревью>
/codex fix <id ревью>
/codex show <id предложения исправлений>
/codex apply <id предложения исправлений> <код подтверждения>
handoff 把 DeepSeek 的审查意见连同标准任务一起交给 Codex，让它修正并跑检查。fix 让 Codex 先准备改动，不写入。ID 后面的附加文字仍是可选的补充说明。

模型、配额与取消

/codex models
/codex model all gpt-5.6-sol
/codex model architect default
/codex model review <поддерживаемый ID>
/codex model fix <поддерживаемый ID>
/codex status
/codex cancel
/codex retry <id задания>

模型目录只在请求时通过文档化的 model/list app-server 获取；任务本身通过 exec 执行。目录没有写死在代码里。ID gpt-5.6-sol 由本地目录返回，开发期间跑过一次最小请求；这不代表它以后一定可用。

模型不可用时，插件会给出警告并保留已选的 ID；你换一个模型再跑 retry 即可。遇到配额限制时会保留任务快照，新的请求被拦住，不会自动重试，也没有 API fallback。retry 是你明确决定重试，会用新快照和角色当前模型；同一个任务默认最多尝试三次。

DeepSeek 不会被插件自动启动。handoff 是你明确决定把结果交出去、继续往下做，包括在 Codex 配额用尽之后。普通消息和 Harness 的其他插件不受 Bridge 管理。取消会停掉插件自己启动的进程；默认超时十分钟。

检查点与限制

写入之前，会保存所有将被替换文件的原始字节，以及操作日志。快照之后被你改过的文件不会被覆盖。回滚要显式执行：

/codex restore <id предложения> <код подтверждения>

回滚会拒绝覆盖之后的改动。应用过程中出故障，用同一个 restore；原始文件留在 checkpoint-<id>.json 里。恢复完成前别删这个存储。回滚只删除本次操作新建的文件和空目录。这是本地文件检查点，不做 git commit/reset，也不动 Git index。

- 所有 Codex 请求都以 read-only 执行，不带用户 config，关闭 web search 和 shell 功能，工作目录是项目之外的一个临时目录。输入源码以受限快照传入；进程的 cwd 不用源码目录。读隔离不等于在操作系统层面禁止读取你的任何文件。
- 只传 OS/runtime/proxy 环境变量和 CODEX_HOME；Harness 环境里那些服务商密钥不会跟着继承过去。
- 排除 .env（.env.example 除外）、密钥文件、credentials、.git、.aws、.ssh、依赖和构建产物。这是按文件名过滤，不是能扫出源码里任何密钥的通用扫描器。
- 写入仅限相对路径的文本文件；禁止遍历、junction/symlink、Windows 保留名称/数据流、路径冲突，也禁止修改 AGENTS.md。不支持删除文件、二进制改动和安装依赖。
- 快照预算：最多 60 个文件、180 KB 源文本/diff、目录树最多 2000 条记录；大改动需要拆分。插件不会发送完整聊天历史。
- 自动审查已关闭：智能体进入 idle 不算可靠信号，无法据此认定用户任务已成功完成。只要 DeepSeek 空闲，随时可以手动启动。
- 该标签页已在浏览器测试台中验证，使用已安装 Harness 的 React；Host 加载已在真实 Cordis/CommandRuntime 上验证。安装与运行的完整验证仍需在 Desktop 内进行。
- 请只让一个 Harness 应用使用此存储。存储按单 Host 进程设计；0.1.0 没有跨进程同步。

状态、报告、快照和检查点都保存在本地 ~/.dsh-codex-bridge 或 stateDirectory 中。它们可能包含项目源码。Raw OAuth token 不会被读取，也不会传给 Harness。降低配额消耗靠手动启动和短上下文实现；不承诺固定的节省比例。

开发

Node 24+、Git；核心没有 production 依赖。Host 使用已安装 Harness 的 peer 包，React 和 RPC 面板由 Desktop 提供。

node scripts/check.mjs
node --test test/.test.mjs
npm.cmd pack --ignore-scripts --pack-destination artifacts

完整测试 junction 需要创建权限。scripts/inspect-runtime.mjs <app.asar 完整路径> 会把已安装 runtime 中选定的文件复制到被忽略的 .compat，不改动安装。scripts/runtime-smoke.mjs 用真实包验证加载，通过 --import ./scripts/runtime-loader.mjs。scripts/diagnose.mjs <codex.exe> 检查登录和目录，不做 inference；scripts/inference-smoke.mjs <codex.exe> <model> 执行一次模型请求并消耗配额。