Codex 编程子代理 dqtz5vpvj9-create/dsh-subagent-mcp

中文 · English · 开始使用 · 使用指南

DSH Subagent MCP 让 Codex 直接调用 DeepSeek 子代理。Codex 负责规划和验收，子代理在 DSH 中完成各自的任务，结束后自动回传结果。需要修改时，可以继续使用原来的代理，无需重新交代上下文。

并行执行多个代理可以同时处理独立任务。
自动回传完成后带着答复和证据唤醒 Codex，无需轮询。
继续同一会话保留上下文，交给原来的代理继续修改。

开始使用

安装 Node.js 24+ 后，在终端执行：

npx -y dsh-subagent-mcp@latest

Windows、Linux 和 macOS 使用相同的安装命令。安装器会复用已有的 DSH 和 Codex 配置，补齐依赖，完成后返回终端。还缺哪些账号配置，安装结果会直接提示。

进入要处理的项目目录，像平时一样启动 Codex：

codex

如果安装器为你单独安装了兼容的 Codex，使用 npx -y dsh-subagent-mcp@latest codex 启动它。如果安装时 Codex 已经打开，新开一个 Codex 会话即可加载 MCP 工具和 skill。

先在 Codex 中试一个小任务：

让 DSH 只读检查这个项目，找出主要入口和测试运行方式，完成后帮我整理一份简短说明。

Codex 会把任务交给 DSH，完成后自动接收结果。你可以询问进度，让同一个代理继续排查，或在方向变化时要求它停止。开始实现功能时，再让 Codex 将已确认的方案拆成独立任务，交给 DSH 执行测试，最后统一验收。

为什么将 Codex 与 DSH 结合？

使用 GPT-6 Astra 处理长任务时，模型用量不只花在制定方案上。每轮执行后的判断、进度查询和结果检查也会消耗 token。DSH Subagent MCP 将范围明确的工作交给 DeepSeek，让 Codex 负责方案设计和最终验收。例如，Codex 可以将一个模块的实现交给子代理，待代码和测试结果返回后统一检查。

DeepSeek 在自己的 Harness 中执行任务，Codex 则通过完成回调接收结果。子任务运行期间，父模型无需反复查询进度。

让 DeepSeek 在 DSH 中执行任务

编程代理需要读取项目、编辑文件和执行命令，也需要管理执行过程中不断增长的上下文。桥接器直接启动 DeepSeek Harness，由 DSH 处理这些工作。每个代理在指定目录中运行，使用各自的工具权限并保留会话。标准预设会压缩过长的上下文、裁剪工具结果；后续修改可以在同一会话中继续。

Codex 在委派时说明目标、允许修改的范围、约束和验收要求。子代理负责完成实现，并处理相关测试中发现的问题。父代理收到结果后集中检查，无需逐步指导子代理调用工具。

完成后自动通知 Codex

Codex 通过 MCP 启动子代理，配套 skill 随后为这次任务注册后台监听器。监听器进行一次无超时等待，待任务结束后保存完整结果，再通过 Codex App Server 送回原生工具结果 dsh_completion。追问同一个代理时，也会为新任务注册监听器。

等待发生在监听器中，不触发模型请求。Codex 有其他工作时可以继续处理，没有工作时则结束当前轮次。各个子代理分别回传：父代理仍在运行时，结果进入当前轮次；父代理已空闲时，结果会自动启动下一轮，让它继续验收和集成。

任务因错误或上下文耗尽而结束时，也会通知父代理。如果只是某次工具调用失败，而子代理还在处理，监听器会继续等待。主动中断或关闭的代理不会触发继续执行的回调。

委派开销还取决于任务和上下文

父代理仍要准备任务、传递必要的上下文并检查结果。如果模型每隔几秒查询一次进度，这些查询又会产生新的推理轮次，每轮都带上父会话上下文。一次持续的工具等待可以避免轮询；后台监听器还允许父会话结束当前轮次，由调度器在完成事件到达时恢复执行。

任务应该一次交代清楚，并划分好各代理可以修改的文件。子代理完成后提交简短结论和验收证据，父代理集中检查；详细日志保留在文件中，检查到具体问题时再读取。需要修复的缺陷可以合并成一次后续任务，交给原来的代理处理。

父会话本身也会不断变长。阶段性验收后，保留目标、已确认的结论和后续需要的产物及代理 ID 即可，详细日志留在原处。同一任务的追问仍可使用原来的 DSH 代理，不必将它的全部执行记录复制到父会话。

等待与回传的实际表现

实测中，Codex 可以在等待 DSH 时结束当前轮次，等待本身不消耗 GPT 额度。子代理完成后，结果自动送达，空闲的 Codex 会恢复执行并检查结果，无需用户再次发送消息。Codex 正在处理其他工作时，结果则进入当前轮次。

任务安排和结果验收仍会消耗 Codex token，DeepSeek 的用量由其服务单独计算。测试环境和验证方法见验证记录。

在 DSH Web 查看执行记录

DSH 将子代理按工作区归档。每个工作区有一条名为“Claude Code / Codex 子代理”的会话，打开其中的子代理列表，就能查看各项任务的对话和工具执行记录。

网页显示已保存的记录，可能晚于实际执行进度，运行标识也不反映这些代理的实时状态。可以让 Codex 查询，也可以直接从终端管理：

npx -y dsh-subagent-mcp@latest agents list
npx -y dsh-subagent-mcp@latest agents ps
npx -y dsh-subagent-mcp@latest agents result AGENT_ID
npx -y dsh-subagent-mcp@latest agents followup AGENT_ID --task "继续检查第一个问题"

任务完成后自动保存会话并释放子进程；追问时恢复同一段对话。agents --help 可查看中断、关闭和清理空闲运行时等命令，详细说明见运维指南。

已有的普通 DSH Web 会话可以通过 dsh_attach 接入，继续原来的工作。具体用法见使用指南。

进一步了解

| 文档 | 内容 |
| 安装 | 凭据、持久安装、升级和旧会话迁移 |
| 使用 | 工具、回调、追问、进度、外部会话和上下文预算 |
| 架构 | 进程归属、权限和生命周期 |
| 运维 | 服务管理、子代理命令行管理、结果检查和网页历史 |
| 回调验证 | 结果回传、空闲等待与父代理验收 |
| 更新日志 | 版本变化和兼容性说明 |

执行工具也可用于 Claude Code 等其他 MCP 客户端。这里的自动唤醒使用 Codex 专用回调；其他客户端采用各自支持的通知或等待方式。目前 DSH 在 Codex 中显示为 MCP 活动。

使用问题和功能建议请提交到 Issues。

致谢

基于 DeepSeek Harness 和 MCP SDK 构建。感谢 dsh-mcp 与 dsh-cursor-codex 对 DSH 委派的探索，以及启发本项目的终端界面 DSH-Code。

MIT 许可，独立社区项目。