前言¶
在 DeepSeek Harness（DSH）里做开发时，执行侧通常由 DeepSeek 和本机工具完成；若还需要第二套视角做方案、代码审查或训练结果解读，往往要切换到 Codex CLI 或图形客户端，工作目录和对话上下文也要自己对齐。dsh-codex-bridge 把 Codex 以会话级插件接进 Harness：默认关闭，只在显式开启的会话里调用本机 Codex CLI，并与当前会话的真实工作区共享只读上下文。下面介绍它的定位、能力与安装启用方式。
这是什么¶
- 名称：
dsh-codex-bridge（npm 包名一致） - 维护者：ChangJiang326（独立社区项目，与 DeepSeek、OpenAI 无官方隶属关系）
- 分类：工作流（SkillHub 目录）
- 版本：0.4.0（MIT 许可证）
- 一句话：DeepSeek 负责执行，Codex 通过本机 CLI 提供方案、代码审查、改进建议与训练结果分析；仅对单独开启协作的会话生效。
核心功能¶
会话级协作开关¶
协作默认关闭。新会话、复制会话和子会话也默认关闭；设置按会话 ID 持久化。关闭协作或取消调用会终止本会话的 Codex 子进程，晚到的结果会被丢弃，不会取消 DeepSeek 或其训练任务。
自动与手动模式¶
勾选功能并打开「在本会话启用协作」后：
- 自动模式：每轮开始时请求一次方案，轮末请求一次审查；DeepSeek 也可按需使用
consult_codex。未勾选的功能会跳过对应自动调用。 - 手动模式：关闭自动计划与审查；面板按钮和 DeepSeek 按需调用仍可用。面板请求只展示结果，不会唤醒 DeepSeek。
默认每轮最多 3 次顾问调用，单次超时 300 秒，可在面板调整。配额涵盖自动计划、审查和工具调用；轮末审查最多一次，DeepSeek 修正后不会无限自动重审。手动请求需要会话已有运行实例；新建空会话若提示尚未运行，需先发送一条消息。
工作区与共享上下文¶
Codex 使用当前 Harness 会话的真实工作目录。CLI 以 read-only sandbox、approval_policy=never、临时执行模式启动。Codex 的建议与短依据返回给 DeepSeek，不共享模型内部隐藏思考。
可选共享内容包括近期用户/助手/工具文字，以及会话专用记录目录（开启「每步保存」时由插件写入，Codex 不写项目文件）：
<当前工作区>/.codex-bridge/<会话ID的哈希>/
TASK.md 最新顾问请求
PROGRESS.md DeepSeek 步骤和顾问进度（滚动保留）
DECISIONS.md 最近一次顾问结论与验收项
自动附带的对话最多 24,000 字符；系统提示、隐藏推理和二进制附件不会自动附带。关闭「共享上下文/读取记录」只关闭自动附带，Codex 仍能只读访问工作区文件。顾问结果限 256 KiB，超限会报错。建议将 .codex-bridge/ 加入 .gitignore。
插件配置及最近结果保存在 $DSH_HOME/plugins/codex-bridge/（默认 ~/.dsh/plugins/codex-bridge/）。
自动识图（可选）¶
勾选「自动识图（当前会话）」后，开启协作的会话收到用户图片时会交给 Codex 分析，结果反馈给 DeepSeek；默认关闭，手动模式下也可独立生效。图片发往当前 Codex 所配置的模型服务，模型需支持图片输入。一次最多 8 张，每张不超过 20 MiB；QQ 图片暂不支持。
环境安装与登录（Windows 侧重）¶
环境配置在本机共用，与各会话协作开关独立。面板提供：检查连接、完整环境检查、配置 CLI 与终端、同步系统代理到终端、打开浏览器登录等。Windows 可在面板内安装官方独立 Codex CLI，无需另装 Node 或 npm；仅安装 ChatGPT 图形客户端不能保证 CLI 可用。插件不自带 API Key，调用使用本机 CLI 的身份与模型配置。本插件已在 Windows 真机验证；macOS / Linux 可参考 Codex 官方 CLI 说明，但尚未完成对应系统实机验收。
当前范围与限制¶
本版支持文字、代码、图片识别与训练结果顾问协作；训练本身仍由 DeepSeek 和本机工具执行。QQ 图片、生图和视频生成尚未接入。
安装与启用¶
环境要求¶
- DeepSeek Harness：
0.2.1-rc.3（README 记载的已验证目标版本；package.json中dsh引擎为>=0.2.1-rc.3 <0.3.0-0） - Node（插件运行时）：
>=22.19.0（由 Harness 自带运行时承载）
Windows 安装包¶
从 GitHub Releases 下载 dsh-codex-bridge-0.4.0-windows.zip，解压后双击 Install.cmd。安装前完全退出 Harness，重新打开后会话输入框旁出现 Codex 协作 入口，再通过面板安装 CLI 并完成登录。
GitHub 自动生成的 Source code 压缩包是源码；手动安装可使用同一 Release 中的 .tgz。
使用 tgz 安装（含迁移）¶
先打开 Harness 一次以初始化配置，再完全退出。在安装包所在目录执行：
dsh plugin --profile desktop add ./dsh-codex-bridge-0.4.0.tgz
Windows 迁移包中的 Install.cmd / Install.ps1 可自动寻找 Harness，也支持 -HarnessPath 指定安装目录。
卸载¶
完全退出 Harness 后执行：
dsh plugin --profile desktop remove dsh-codex-bridge
卸载保留设置和项目记录；再次安装后仍可读取。
典型用法¶
- 在 Harness 会话输入框旁点击 Codex 协作。
- 在 环境安装与登录 中点击 完整环境检查；缺少 CLI 时点击 配置 CLI 与终端；需登录时点击 打开浏览器登录，在浏览器中完成授权。
- 勾选需要的功能，打开 在本会话启用协作；更改其他设置后点击 保存设置。
- 按自动或手动模式与 DeepSeek 协同工作；需要时由 DeepSeek 调用
consult_codex。
同一时刻仅执行一个环境配置任务；进行中的顾问调用与环境配置互斥。
适用场景与注意¶
适合：希望在同一 Harness 工作区内，让 DeepSeek 执行的同时，用本机 Codex 做计划、评审、识图或训练结果解读的开发者；尤其 Windows 上希望面板内完成 CLI 安装与检查的流程。
注意：
- 插件在本机 DSH 进程权限下运行，安装前应阅读仓库源码与 MIT 许可证，确认可接受其只读沙箱、上下文共享与网络行为。
- 工作区内含敏感资料时，应使用适当划分的项目目录；共享上下文不是完整聊天备份。
- 健康检查成功只表示程序与登录可用，真实请求仍可能因模型、服务端或网络失败。
- SkillHub 目录页与 GitHub 为社区分发渠道，非 DeepSeek / 幻方官方应用商店。
