yidapan666-creator/codex-dsh-supervisor

Codex DSH Supervisor

让 Codex 通过 MCP 监督持久的 DeepSeek Harness（DSH）编码会话——具备重连、有界执行、令牌预算和独立完成检查。

产品和仓库名为 Codex DSH Supervisor。已发布的包、CLI、MCP 端点和状态目录保留 dsh-gate 名称以保持兼容性。

系统工作流 · 受审查的控制循环 · 中文快速上手 · 部署指南

快速开始

npx @yidapan666/dsh-gate setup

该安装程序会安装匹配的发行版、配置 Codex、安装监督技能、启动独立的 DSH Host，并运行实时健康检查。请参阅所有安装和更新选项。

然后自然地询问 Codex：

在 /absolute/path/to/project 中使用 DSH 修复失败的认证测试。使用 Standard 模式和受审查的监督，允许最多 3 个直接子代理，强制执行 60000 令牌预算，打开 DSH Web，并每五分钟报告一次汇总进度。

简短形式同样有效：

在 /absolute/path/to/project 中使用 DSH 修复失败的认证测试。

缺失的常规约束会在无需额外模型调用的情况下被填充。Standard 模式、全工作区写入者范围、先聚焦后完整的验证、仅实质性升级，以及最多五个直接子代理是默认值。

选择 DSH 的工作方式

| 选择 | 最适合 | 约束 |
| --- | --- | --- |
| Standard（默认） | 编码、修复和常规仓库工作 | 支持受审查或委托的监督 |
| PTC | 广泛的只读探索和可批量化的搜索 | 仅限委托监督 |
| Minimal / Creator | — | 被拒绝，因为它们无法满足安全契约 |

| 监督方式 | Codex 参与 |
| --- | --- |
| 受审查（写入者的默认方式） | 审查实质性提案，可以暂停/纠正工作，检查实际差异，并在接受前重新运行相关验证 |
| 委托（只读工作的默认方式） | 按五分钟节奏观察，并根据 Host 事实验证结构化终端证据 |

它保证什么

- DSH Host 和会话在 MCP 或 Codex 重启后仍然存活，并且可以在不重放任务的情况下被重新发现。
- 只有在有效的监督者交接且其匹配的轮次结束之后，运行才算完成；仅凭轮次结束永远不会被视为成功。
- 写入者通过 Git worktree 隔离，并根据其被允许的路径范围进行检查；并行写入者需要单独的 worktree。
- 令牌预算、子代理限制、执行租约和只读限制由长期运行的 Host 强制执行——而不仅仅通过提示指令。
- 五分钟观察报告有界进度、项目活动、验证结果、工具计数和令牌增量，而不转发原始推理或日志。

源码开发环境搭建

pnpm bootstrap
pnpm run doctor
pnpm host:start
pnpm run doctor --live
pnpm skill:install -- --target /absolute/path/to/personal/skills

将 config/codex-mcp.example.toml 复制到对应的 Codex 配置中，并将  替换为此检出版本的绝对路径。MCP 可执行文件为 packages/mcp-server/dist/cli.js。

源码检出版本将公共 DSH fork 固定于提交 68dd149a1834496ced7308de5a7084328855f13e。Bootstrap 会验证这一确切的兼容性接缝，并拒绝脏的或不匹配的检出版本。有关前置条件、生命周期命令、更新固定版本以及恢复方法，请参阅 DEPLOYMENT.md。

监督循环的工作原理

1. Codex 编译一个受限的任务包，并将其提交到一个持久化的 DSH Root。
2. DSH 进行调查，并在审查模式下提交重要的实现提案，以供 Codex 做出阻塞性决策。
3. Host 仅授予受限的执行阶段，并记录持久化的身份、预算、谱系和活动事实。
4. Codex 以五分钟为边界进行观察，或在批准、重大风险、失败或协议事件发生时立即观察。
5. 完成需要 worker 交接、匹配的回合结束、Host 检查，以及 Codex 独立的 diff 和验证审查。

重连使用持久化的 sessionId、runId、请求回执和观察游标。中断的工作从受限的恢复胶囊中恢复；不确定的影响必须进行协调，而不是盲目重放。请参阅协议契约。

包、发布模型和高级组件

- @dsh-gate/mcp-server — MCP 网关、重连、观察和控制工具。
- @dsh-gate/supervisor-tools — Host 侧的准入、交接、Git 范围、预算和执行强制。
- @dsh-gate/decision-policy — 带版本控制的干预策略，支持 explain、dry-run 和 shadow 评估。
- @dsh-gate/run-journal — 受限、原子、无模型的终端运行记录。
- @dsh-gate/rag-context — 独立的检索契约和排序基线；未连接到实时监督。

只有轻量的 @yidapan666/dsh-gate 安装器会发布到 npm。它会下载一个不可变、带校验和的 GitHub Release。npm、离线包和源码安装只要针对同一版本，就能提供相同的工作流；仅推送 main 并不会发布 release。

文档

部署 · 分发 · 协议 · 中文快速入门 · 手动 E2E · 决策策略与 RAG 研究 · 贡献 · 安全