evo-subagent：DeepSeek Harness 插件：角色子智能體路由與進化

DeepSeek Harness (DSH) 的插件生態支持擴展能力。在開發多智能體系統時，處理路由邏輯併爲特定角色積累可複用的命令（prefercmd）和經驗教訓（memory）是一個常見痛點。evo-subagent 作爲一個統一的插件，專注於角色子智能體路由以及項目範圍的進化。它確保重複任務從經過驗證的命令開始，從而節省 tokens。

安裝與前置要求¶

安裝前，請確保環境滿足以下版本要求：

DeepSeek Harness 0.1.5-rc.3 或更新版本
Node.js >=24.2.0

安裝命令如下：

dsh plugin add evo-subagent

核心功能¶

該插件提供以下能力：

綁定與路由：將每個 agent_key 路由到同名的 Markdown 綁定文件。
嚴格驗證：在創建子智能體之前，驗證提供者（provider）和模型（model）對是否準確。
進化文件：維護每個智能體的 prefercmd.md（驗證過的命令）和 memory.md（經驗教訓）知識文件。
工作區隔離：按項目工作區隔離綁定和進化數據。
執行模式：支持 spawn（創建全新子智能體）和 fork（上下文感知的子智能體）。
原生回退：當不存在綁定時，回退到 DSH 的原生模型繼承機制。
安全隔離：插件本身不存儲 API 密鑰、端點、憑據或提供者定義。

典型用法¶

1. 配置綁定¶

在項目根目錄創建 agents/ 目錄，併爲每個角色添加一個 Markdown 文件。文件名（不含擴展名）即爲 agent_key。

project/
├─ agents/
│  ├─ code-reviewer.md
│  └─ researcher.md
└─ .evo_subagent/
   └─ evolution/

每個綁定必須以嚴格的前端塊開頭，定義 provider 和 model。匹配是區分大小寫的。

provider: deepseek-official
model: deepseek-v4-flash

2. 調用子智能體¶

使用插件工具調用對應的 key。description 用於任務標籤，prompt 包含完整任務描述。

{
  "agent_key": "code-reviewer",
  "description": "Review the implementation",
  "prompt": "Report correctness, security, and test coverage issues.",
  "run_in_background": false
}

進化機制¶

插件會在項目目錄下維護每個智能體的進化數據：

prefercmd.md：記錄已驗證有效的命令。
memory.md：記錄可複用的經驗和失敗案例。

子智能體可以通過返回特定的標籤來更新這些文件：

[[EVOLUTION]]
prefercmd:
- pnpm test
memory:
- Do not use --force in CI.
[[/EVOLUTION]]

內置角色與技能¶

內置角色¶

插件提供三個內置角色模板，項目中同名綁定會覆蓋內置模板：

code-reviewer：代碼審查
researcher：證據支持的調查
wps-worker：辦公文檔生產

捆綁技能¶

安裝插件會在 DSH 技能目錄註冊三個輔助技能，需在 DSH 中啓用技能註冊表和工具後才能看到：

/evo-route-doctor：診斷路由問題或無效的提供者/模型對。
/evo-memory-review：審查角色記憶文件中的陳舊或衝突知識。
/evo-delegation-guide：選擇現有角色並準備範圍化的子智能體任務。

注意事項¶

插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
進化數據存儲在項目本地的 .evo_subagent/ 目錄中。
需要確保 DSH 的技能註冊表和技能工具已啓用，捆綁技能才能生效。

倉庫與許可¶

GitHub：https://github.com/ZekaiShi/evo-subagent
許可證：MIT