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