在 DeepSeek Harness (DSH) 的插件生态中，处理子代理任务通常采用一次性委托模式。如果需要与 Codex 保持长期上下文，或者希望 DSH 仅作为透传层而不介入中间推理，dsh-subagent-codex-plus 提供了基于“真网关”的直连方案。
插件定位¶
这是一个由 february2015 维护的插件，基于官方 @deepseek-ai/dsh-subagent-codex 派生。它保留了官方的一键委托能力，并在此基础上增加了一个持久化的直连网关层。在这个模式下，DSH 不再运行中间模型，而是直接将字节流在用户与 Codex 会话之间透传。
与其兄弟插件 dsh-subagent-pi 类似，两者共享相同的底层架构，仅直连对象不同（Codex 与 Pi），因此功能映射一一对应。
核心功能¶
1. 真网关直连¶
通过本地命令将当前 DSH 会话 1:1 绑定到一个持久的 Codex 线程。
* 命令：/codex-lock
* 特性：DSH 仅作为透传层。绑定后输入直达 Codex。
* 持久化：关闭或重启 DSH 后，重新打开会话会自动重连到同一个 Codex 线程，无需手动操作。
* 限制：一个 Codex 线程只能绑定到一个 DSH 会话。
2. 持续对话：队列与直接插入¶
- 自动排队：当 Codex 正在处理时，新消息会自动进入队列。
- 原生管理：队列消息会立即出现在原生编辑器的队列条带中，支持查看、编辑、删除和引导。
- 执行顺序：当前回合结束后，队列中的消息按顺序执行。
- 直接插入：通过浮动面板可以直接插入消息，使其在下一个回合优先执行。
3. 实时中间输出¶
Codex 的执行进度（推理摘要、消息增量、工具调用、状态事件）会以近乎实时的方式显示在 DSH 会话中，而不仅仅是最终答案。默认为只读显示，不会进入 DSH 的模型上下文。
* 心跳机制：长工具调用会显示心跳（例如 正在执行 <tool>），并在运行超过 1 分钟后显示已运行时长，避免界面看起来像卡死。
4. 状态显示¶
绑定成功后，会话头部会出现 CDX-xxxx 标识（包含状态色点与线程 ID 前缀），编辑器停靠栏会显示“Codex 直连 · …”。未绑定时界面保持整洁。
5. 图片/附件透传¶
支持直接粘贴或上传图片给 Codex。如果 Codex 模型本身具备视觉能力，它会正常处理；若遇回退情况，由 TeamAI 技能 ocgw-vision 处理。
6. 委托与网关共存¶
一个 DSH 对话中可以同时包含多次模型触发的“一次性委托”运行，以及最多一个用户附加的网关会话。两者可以自由切换。
安装与启用¶
在确认路径正确后，使用以下命令安装插件并启动对应 Profile：
dsh plugin --profile <name> add /path/to/dsh-subagent-codex-plus
dsh --profile <name>
典型用法¶
- 打开任意一个 DSH 会话（当前目录即为项目目录）。
- 输入
/codex-lock。绑定成功后，头部会出现CDX-xxxx标识，输入框的内容会直接发送给 Codex。 - 当 Codex 正在处理时，新消息会自动进入队列，显示在原生的消息队列条带中，支持编辑、删除和引导。当前回合结束后按顺序执行。
- 输入
/codex-unlock断开连接。Codex 线程会被保留，随时可以重新绑定。
适用场景与注意事项¶
- 适用场景：适合需要与 Codex 保持长对话上下文、需要精细控制对话流程（通过队列引导）的开发者。
- 版本依赖：插件依赖 DeepSeek Harness 的客户端运行时与连接组件（
dsh-client-*）。 - 权限：插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
总结¶
dsh-subagent-codex-plus 为 DSH 用户提供了与 Codex 建立持久化、可控对话的能力。如果你习惯于 Pi 的直连体验但需要使用 Codex 模型，或者需要 DSH 充当纯透传网关，该插件提供了直接的解决方案。
