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