前言¶
在 DeepSeek Harness（DSH）里做项目时，常见分工是：主对话里的 DeepSeek 负责写代码、改 bug，而架构取舍、大范围评审往往仍要你自己串流程。若你已经在本机用 ChatGPT 登录了 OpenAI Codex CLI，又希望规划和代码审查走同一套 Harness 窗口，而不是再开一套工具链，就需要一个把 Codex 接进 Desktop 的客户端插件。
下面介绍社区插件 dsh-codex-architect（仓库名 dsh-codex-bridge，维护者 Lanzuelo）。它在官方 DeepSeek Harness Desktop 0.2.0-rc.2、Windows 环境下，把已安装的 Codex CLI 接到 Harness：Codex 侧以只读方式做架构设计与变更评审，实现仍由 DeepSeek 完成；写入磁盘前需显式确认，并支持本地检查点回滚。插件当前版本 0.2.1，属预览发布；npm 上的包名是 dsh-codex-architect，与仓库名不同，安装时不要误装 npm 上名为 dsh-codex-bridge 的其他项目。
这是什么¶
dsh-codex-architect 是 DSH 的客户端类插件（分类：客户端）。在同一 Harness 窗口中提供 slash 命令 /codex 与右侧面板 Codex Bridge。它调用本机 Codex CLI（ChatGPT 登录），不需要 OpenAI API Key，文档也说明不会自动切到付费 API 或替换模型。
典型协作路径是 Codex → DeepSeek：Codex 出计划或评审意见，你通过 handoff 等步骤把结果交给 DeepSeek 落地；DeepSeek 不会由该插件自动拉起，交接是显式操作。
核心功能¶
界面与模式¶
打开 Codex Bridge 后可选择：
- DeepSeek：只把想法或修补说明交给 DeepSeek，不跑 Codex；
- Codex：让 Codex 做计划、文件建议或修补方案；
- Codex → DeepSeek：Codex 设计与审查，DeepSeek 实现与修正。
面板会显示当前阶段、最近任务，并提供 构建计划、审查项目、在 DeepSeek 中修复、在 Codex 中准备、显示建议、应用、恢复、重试、停止 等动作（具体 ID 与 slash 命令见 README 技术细节）。
新项目：计划与交接¶
plan 最多给出三个不写文件的方案；handoff 可把推荐方案交给 DeepSeek。在 Codex 模式下可在面板选方案并准备文件内容，只有单独的 apply 确认才会写入。
/codex plan Создай Telegram-бота с PostgreSQL
/codex handoff <id плана>
新项目骨架会涉及 docs/architecture.md 与 docs/deepseek-handoff.md。已有 AGENTS.md 可进入上下文，插件不会创建或覆盖 AGENTS.md，以免与用户指令冲突。
评审与修复¶
无路径时，评审覆盖相对 HEAD 的 staged / unstaged、删除与未跟踪文件；无 Git 时则对项目做受限安全快照并注明无 baseline 的限制。还可带上主要 manifest、架构文档及最多 12 个本地 JS/TS 依赖。评审不跑测试与构建。
/codex review
/codex review focus Проверь особенно обработку повреждённых данных
/codex review files src/auth.ts|src/auth.test.ts --focus валидация
/codex handoff <id ревью>
/codex fix <id ревью>
handoff 把 findings 交给 DeepSeek 修复并做检查；fix 让 Codex 准备修改但不写盘。应用与查看建议：
/codex show <id предложения исправлений>
/codex apply <id предложения исправлений> <код подтверждения>
模型、状态与取消¶
模型列表通过文档化的 app-server model/list 按需拉取，任务执行走 exec，目录不硬编码在插件里。
/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 задания>
配额用尽时会保留任务快照并阻塞新请求，无自动重试与 API fallback；可用 retry 显式重试（默认同任务最多 3 次）。默认超时 10 分钟。
检查点与只读约束¶
写入前会保存被替换文件的原始字节与操作日志；快照之后你又改过的文件不会被覆盖。回滚需显式：
/codex restore <id предложения> <код подтверждения>
这是本地文件检查点，不涉及 git commit/reset。文档说明 Codex 请求以 read-only 等方式执行（README 在截断处另有沙箱与 web search 等限制说明，以仓库全文为准）。
安装与启用¶
前置条件（来自 README）：
- 已安装 Harness 0.2.0-rc.2、Git、Codex CLI，且在 Codex 中完成 ChatGPT 登录。文档记载的 CLI 验证版本为 0.162.0-alpha.17.2（alpha 界面可能随更新变化）。
- 在 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，在添加时填写其绝对路径。 - 等待激活成功；若插件管理器提示，重启 Harness。
- 在项目聊天输入
/codex help；在右侧面板通过+或标签页选择打开 Codex Bridge。 - 点击 加载模型，选择模型并保存（可为所有角色共用一个模型、分角色配置，或手填 ID；
default表示 Codex 自带 default 与隔离启动配置）。
若 Desktop 在 PATH 中找不到 CLI，插件会查找 %USERPROFILE%\AppData\Local\OpenAI\Codex\bin\<版本>\codex.exe。非默认安装可在用户 profile 的插件行配置里设置 codexPath（需绝对路径指向 codex.exe，相对 .cmd 不可靠）。若该行已存在，请修改而非重复添加：
- 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
README 建议先在独立 profile 验证包；升级 Harness 后需重新确认兼容性，不要绕过版本限制。0.1.0 / 0.1.1 曾有 bundle 激活问题，0.1.3 修复 Windows 上 /codex models 后的 EBUSY，0.2.1 修复 DSH 沙箱内模型列表加载——若你仍在旧版，应更新包并重启 Harness。
典型用法小结¶
- 装好后在 Codex Bridge 加载并保存模型。
- 新项目：
/codex plan …→ 在面板或/codex handoff <计划 id>交给 DeepSeek。 - 改代码后：
/codex review（可加focus、files）→/codex handoff或/codex fix→ 查看/codex show→ 确认码后/codex apply；需要时用/codex restore。 - 任务卡住或配额问题：
/codex status、/codex cancel、/codex retry。
适用场景与注意¶
适合谁：已在 Windows 上使用 DSH 0.2.0-rc.2，本机有 ChatGPT 登录的 Codex CLI，希望由 Codex 做架构/只读评审、由 DeepSeek 写代码，并需要显式批准写入与本地回滚的开发者。
务必注意：
- 插件以当前 DSH 进程权限运行，安装前请自行查看 GitHub 源码 与 MIT 许可证（见
package.json）。 - 目标环境在 README 中写明为 Windows 与指定 Harness 版本；其他平台或版本未在此文承诺。
- 社区目录 SkillHub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；星标与热度以各站点当时显示为准（目录线索为 0 star）。
- DeepSeek 主对话、其他插件不受 Bridge 统一调度；取消只停止插件所属进程。
结尾¶
dsh-codex-architect 把 Codex CLI 嵌进 Harness 右栏与 /codex 命令，用 ChatGPT 登录即可做规划与只读评审，并把实现显式交给 DeepSeek，配合 apply 确认与 restore 检查点控制写盘风险。进一步了解可访问 SkillHub 目录页 与仓库 Lanzuelo/dsh-codex-bridge。
