oh-my-deepseekharness

前言¶

DeepSeek Harness（DSH）採用插件化架構。在 DSH 中實現多智能體編排通常需要自行處理複雜的任務拆解、角色分配和狀態管理。oh-my-deepseekharness 適配了 OMC/OMX 編排理念，將其封裝爲一個單一的 DSH 插件，提供了一套標準化的多智能體交互協議。

核心定位¶

DeepSeek Harness 的多智能體編排層 —— OMC / OMX 編排理念的 dsh 宿主適配實現。

安裝與啓用¶

該插件通過 npm 包分發。安裝前需確保環境滿足要求：Node.js >= 22.19.0，以及 dsh 宿主版本 >= 0.1.7-rc.1。

dsh plugin --profile <name> add @sakura12/oh-my-deepseekharness

安裝完成後，可在會話中輸入 /omd-doctor 進行驗裝診斷。

三種執行模式¶

插件提供三種互斥的執行模式，通過自然語言關鍵詞或斜槓命令觸發：

1. autopilot
   自然語言觸發，由 dsh 原生 goal 工具驅動前臺循環。支持全流程自動編排（訪談→規劃→執行→雙評審門→沉澱檢查點）。

   • 示例：autopilot 幫我做一個 CLI 字數統計工具

2. ralph
   顯式觸發（ralph: 前綴），由 dsh 原生 ralph 工具驅動。採用 PRD + 證據契約的迭代循環，前臺阻塞。

   • 示例：ralph: 把 README 的測試徽章數字同步到當前實際值

3. team
   顯式調用，由 lib/team.js 領隊運行時驅動。採用五階段流水線（階段狀態機 + 隊員 UUID 生命週期 + mailbox + heartbeat + merge 計劃）。

   • 示例：用 team 調研插件市場生態並出報告

取消當前模式可輸入 cancelomd（或 /omd-cancel）。

能力概覽¶

插件內置了豐富的技能與工具集：

• 角色與技能：包含 33 個角色卡（omd-agent-*，如 api-reviewer、product-manager 等）與 42 個 Skills（中英雙語資產）。
• MCP 工具：掛載了內置 omd-state MCP server，提供 55 個工具，涵蓋狀態管理、記憶存儲、協調、代碼智能、graph 運行時等。
• 運行時能力：支持 graph DAG 運行時、Team 流水線、HUD 面板、跨會話記憶及自適應路由。
• 代碼智能：支持 ast_grep 結構化檢索/重寫以及 LSP 工具集（診斷、符號引用等）。

配置¶

插件通過 cordis.patch.yml 進行配置，支持語言、檔位映射、角色覆蓋、迭代輪次控制及心跳檢測等。

# cordis.patch.yml
oh-my-dsh:
  language: zh
  tiers:
    low: inherit
    high: deepseek-reasoner
  autopilot:
    maxIterations: 15
  team:
    heartbeatIntervalMs: 60000
  codeIntel:
    lspServers:
      typescript:
        command: typescript-language-server
        args: ["--stdio"]
        languages: [typescript]

依賴與注意事項¶

• 依賴邊界：所有 @deepseek-ai/* 依賴爲宿主義務，缺失時自動降級；@ast-grep/napi、vscode-rpc 等爲可選依賴，缺席時顯式報錯但不阻斷。
• 環境要求：Node.js >= 22.19.0，dsh 宿主 0.1.7-rc.1+。
• 廢棄關鍵詞：ultrawork、ulw、uw、ccg 不再觸發，建議改用 autopilot 或 team。
• 運行時產物：所有狀態與日誌存儲在 .omd/ 目錄下，建議加入 .gitignore。

生態鏈接¶

• GitHub: https://github.com/1225Sakura/oh-my-deepseekharness
• 目錄頁: https://www.skillhub.cn/plugins/1225Sakura/oh-my-deepseekharness