evo-subagent

English | 简体中文

下载趋势

图表展示自首次发布以来的 npm 累积下载量，并每天自动更新。DSH Market 使用 npm 下载量进行排序，因此它是最接近公开采用量的指标；但不能区分来自插件市场与直接 npm 安装的下载。

evo-subagent 是一个面向 DeepSeek Harness 的 Subagent 路由与项目级进化插件。

它把稳定的 Agent 角色映射到已经注册的 provider/model，为每个角色记录已验证命令与经验，并隔离不同项目的 Agent 知识。

功能

• 通过同名 Markdown 绑定文件路由每个 agent_key。
• 创建子 Agent 前严格验证 provider/model 组合。
• 自动维护每个 Agent 的 prefercmd.md 与 memory.md。
• 按项目工作区隔离绑定和进化数据。
• 支持全新上下文的 spawn 和继承对话上下文的 fork。
• 没有绑定文件时保留 DSH 原生模型继承行为。
• 不保存 API Key、端点、凭据或 provider 定义。

安装

dsh plugin add evo-subagent

快速开始

1. 打开 设置 → 插件，展开 evo-subagent。
2. 选择工作区并添加内置角色，或把自定义绑定放入该工作区的 agents/ 目录。
3. 为每个自定义绑定选择已经注册的 provider/model 组合。
4. 展开 Agent，即可查看其 prefercmd.md 与 memory.md 进化文件。

下载 MP4 教程

Agent 绑定

在项目中创建 agents/ 目录，每个角色对应一个 Markdown 文件。文件名即 agent_key。

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

每个绑定文件以严格的 front matter 开头：

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

# Code reviewer
下方可以添加可选的角色说明。

provider 和 model 必须已经注册，匹配区分大小写。

使用对应的 key 调用插件工具：

{
  "agent_key": "code-reviewer",
  "description": "审查实现",
  "prompt": "报告正确性、安全性和测试覆盖问题。",
  "run_in_background": false
}

内置角色

插件包含三个模板：

项目中存在同名绑定时，项目绑定优先于内置模板。

进化

每个项目的角色知识保存在：

.evo_subagent/evolution/<agent_key>/prefercmd.md
.evo_subagent/evolution/<agent_key>/memory.md

• prefercmd.md 记录已经验证可用的命令。
• memory.md 记录可复用经验和需要避免的失败。

前台 Subagent 会接收一段有长度限制的知识上下文，并可通过以下格式返回新内容：

[[EVOLUTION]]
prefercmd:
- pnpm test
memory:
- 不要在 CI 中使用 --force。
[[/EVOLUTION]]

条目会去重并限制数量。使用 ! 前缀标记最高优先级，使用 ? 标记可在上下文紧张时压缩的条目。

旧 .smart_subagent/evolution 数据仍可只读回退，并会在下次保存时复制到新目录。

工作区管理

插件设置卡片按项目分组 Agent，并支持：

• 展开或折叠工作区 Agent 列表；
• 编辑自定义绑定的已注册 provider/model 路由；
• 将内置角色模板复制到指定工作区；
• 绑定一个工作区根目录的 AGENTS.md 作为 Main agent；
• 查看和编辑每个 Agent 的进化文件。

Main agent 的进化数据位于 .evo_subagent/evolution/main/。绑定或解绑只会修改 AGENTS.md 中由插件管理的指令区块。

工具字段

路由流程

1. 安全解析 <agent_key>.md。
2. 读取 fenced front matter 中的 provider 和 model。
3. 在实时模型注册表中验证两个值。
4. 通过所选 spawn 或 fork provider 创建子 Agent。

无效绑定会在创建子 Agent 前失败。绑定缺失且没有同名内置模板时，保留 DSH 原生继承行为。

开发

需要 Node.js 22 或更高版本。

npm test
npm run check
npm pack --dry-run

许可证

MIT