oh-my-deepseekharness

oh-my-dsh (omd)

[](./LICENSE) [](https://nodejs.org/) [](./tests)

DeepSeek Harness 的多智能体编排层 —— OMC / OMX 编排理念的 dsh 宿主适配实现。

Multi-agent orchestration layer for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), adapted from:

• [oh-my-claudecode (OMC)](https://github.com/Yeachan-Heo/oh-my-claudecode) — Claude Code 编排层
• [oh-my-codex (OMX)](https://github.com/Yeachan-Heo/oh-my-codex) — Codex 编排层

omd 以单个 dsh 插件交付：注入编排协议到系统提示词、注册 49 个 skill 目录 + 33 个 omd-agent-* 角色卡（66 个双语文件，会话技能目录共 82 条）与 3 个斜杠命令、挂载内置 MCP server 提供 58 个状态/记忆/协调/代码智能/graph 运行时工具。三种执行模式（autopilot / ralph / team）：autopilot 与 ralph 由 dsh 原生 goal / ralph 工具驱动前台循环；team 由 lib/team.js 领队运行时驱动（阶段状态机 + 队员 UUID 生命周期 + mailbox + heartbeat + merge 计划，无 tmux——dsh 无承载面）。

---

安装 / Install

# 发布后（npm 包名 @sakura12/oh-my-deepseekharness——注意裸 oh-my-dsh 是 npm 上另一个已停更的包）
dsh plugin --profile  add @sakura12/oh-my-deepseekharness

# 本地开发（指向本仓库路径；以你的检出路径替换）
dsh plugin --profile  add /path/to/oh-my-deepseekharness

> ` 是 dsh 的隔离配置/插件组合单元（本机如 web）；dsh plugin 实为转发 pnpm 到该 profile 目录，add/remove 均用 npm 包名。装完必须重启或重载 profile（重开 dsh web）再开新会话，插件树才会重载生效——然后在会话里输入「setup omd」走安装向导，或直接 /omd-doctor` 验装。

要求：Node.js ≥ 22.19；dsh 宿主兼容范围以 package.json 的 peerDependencies 为权威（0.1.2 / 0.1.5 / 0.1.7 三条 0.1.x 线与 ≥0.2.0-rc 线；0.2.0-rc.2 与 0.2.1-rc.5 实测全绿——0.2.1 删除了 subagents 服务级 start（改 startActivation），0.7.1 起 omd_delegate 经双形态 feature-detect 自适应新旧两线）。兼容性质证的逐条证据台账是仓内审计产物（.omd/plans/，gitignored），不随 npm 包发布。所有 @deepseek-ai/ 依赖均为宿主义务（peerDependencies，缺失自动降级，见下文「依赖边界」）。可选能力依赖（optionalDependencies，缺席显式降级不阻断）：@ast-grep/napi（ast_grep_ 工具）、vscode-jsonrpc / vscode-languageserver-protocol / vscode-uri（lsp_* 工具）。

验装：安装后在会话中输入 /omd-doctor（不确定可用入口时先 /omd 看速查）。

开发改动 → GUI 生效（install-local）：profile 依赖若从 npm 解析（如 ^0.4.9），仓库里的改动不会到达运行中的 GUI（2026-10-26 审查实证：实装 0.4.9 vs 仓库 0.5.1 漂移）。闭合链路：

pwsh scripts/install-local.ps1   # npm pack → 装进 profile → 按提示重启 dsh web

> 注意：该脚本是直接覆盖 profile node_modules 的快装路径；下次在 profile 里跑 pnpm install/add 会被冲掉。长期方案是把 profile 依赖改为本地路径（dsh plugin add <仓库路径>）或发布新版。

---

快速上手 / Quick Start

三种执行模式，一句话启动：

| 模式 | 一句话示例 | 说明 |

|---|---|---|

| autopilot | autopilot 帮我做一个 CLI 字数统计工具 | 自然语言触发，goal 驱动的全流程自动编排（访谈→规划→执行→双评审门→沉淀检查点） |

| ralph | ralph: 把 README 的测试徽章数字同步到当前实际值 | 显式触发：行首 ralph: 或「用 ralph …」（锚定守卫防误触发；/ralph 斜杠形态经技能面加载，同效）；PRD + 证据契约的迭代循环，前台阻塞 |

| team | 用 team 调研插件市场生态并出报告 | 无关键词，只能显式调用；五阶段流水线 + 领队运行时（team_phase_transition 状态机 / team_register_worker 生命周期 / team_mail_* 信箱 / team_heartbeat_scan / team_merge_plan） |

三个斜杠命令与取消/诊断入口：

| 操作 | 命令 |

|---|---|

| 速查帮助 | /omd（模式关键词 / 技能总览 / HUD 与记忆入口） |

| 取消当前模式 | 输入 cancelomd（或 stopomd），或斜杠命令 /omd-cancel |

| 验装诊断 | /omd-doctor（注册计数 / Config / MCP 冒烟 / .omd 可写性） |

> 退役关键词 ultrawork / ulw / uw / ccg 不再触发，命中时会提示改用 autopilot 或 team（如 autopilot <你的任务>）。

>

> 触发词 code review / 代码评审 命中的是行内指引块（轻量提示），不是完整 review 技能流程；要完整评审请显式调用（如「用 review 技能评审这次改动」）。

---

能力速览 / Capabilities

| 维度 | 内容 |

|---|---|

| 执行模式 | 3 种：autopilot（goal 循环）/ ralph（PRD 迭代）/ team（五阶段流水线 + 领队运行时），模式互斥 + 触发守卫防误触发 |

| 角色 | 33 个委派角色卡（omd-agent-*：OMC 19 + OMX 移植 14——api-reviewer / style-reviewer / performance-reviewer / quality-reviewer / quality-strategist / build-fixer / dependency-expert / information-architect / vision / product-analyst / product-manager / ux-researcher / researcher / explore-harness），各带档位（low 5 / medium 17 / high 11）与职责资产 |

| Skills | 49 个（中英双语资产）：3 执行模式 + 规划 + 质量 + 研究 + 记忆 + 基础设施与元 + OMX 移植 4（analyze / best-practice-research / design / performance-goal） |

| MCP 工具 | 58 个（内置 omd-state MCP server）：state_×5 / notepad_×6 / prd_×4 / handoff_×3 / team_×18（c5/c6/c8 + 领队运行时 + team_cancel 取消路径） / events_×1/ trace_×4 / hud_×2 / graph_×6（U4 graph DAG 运行时：validate/run/status/resume/node_result/gate_resolve）/ 代码智能×9（ast_grep_×2 + lsp_*×7） |

| Team 运行时 | lib/team.js：阶段状态机（team-plan→prd→exec→verify→fix(≤3，状态机强制)→终态）/ 队员 registry（workerId=UUID，runId=owner-epoch，终态不可复活）/ mailbox（in=队员→队长 progress/blocker/done/question，out=队长→队员 nudge/assign/answer）/ heartbeat（team_heartbeat_scan 按需扫描 + 插件侧周期检测定时器——检测+呈面，催促归队长模型，绝不自动杀）/ merge 计划（树∩主仓冲突候选 + 建议序，执行归模型） |

| HUD | 三层承载：web GUI 右侧边栏 omd-hud 面板（client half，lib/client.js，自适应轮询五要素卡：活跃 5s，空转退避至 ≤30s；full preset 另渲染「队员」「工具调用」两区）/ 数据路由 GET /oh-my-dsh/hud.json（loopback 私有面另聚合 team registry 为 workers、聚合 .omd/state/events.jsonl 派发事件总线为 toolCalls，MCP wire 零变化）/ MCP hud_render hud_summary（CLI 会话同款摘要） |

| 代码智能 | ast_grep_search / ast_grep_replace（结构化语法检索/重写，$VAR/$$$VARS 元变量，dryRun 默认不落盘）；lsp_start/stop/status/document_symbols/references/definition/diagnostics（Config codeIntel.lspServers 注册表驱动，单实例/崩溃重启 ≤2/随 MCP server 退出回收） |

| Hook 与定时 | c2 keyword-hook（agent/pre-step 原生拦截点，唯一 hook 电线）+ team heartbeat 周期检测定时器（Config team.heartbeatIntervalMs，默认 60s，0=关闭） |

| 跨会话记忆 | omd_memory_set/get/list/delete（宿主 storage domain 承载）+ notepad 三区（priority 永久 / working 7 天 / MANUAL 永不清理）+ autopilot/ralph 收尾沉淀检查点（替代 OMC hook 自动 learner） |

| 路由 | c3 自适应路由（4 特征 + 表上限钳制 + fallback 审计）+ omd_delegate 硬路由工具（tier/model 经 spawn 路径强制生效） |

功能点对齐全景（OMC/OMX 45 功能点：✅34 / ⚠️1 / ❌0 / 🚫10 含决定记录）见 docs/feature-parity-audit.md。

---

配置 / Config

插件配置（cordis Config，schemastery 校验）：

| 键 | 类型 / 默认 | 说明 |

|---|---|---|