在 DeepSeek Harness（DSH）的插件生态中，构建多 Agent 协作系统通常面临 Agent 崩溃导致任务丢失、长输出消耗大量 Token、以及 Agent 频繁冷启动带来的延迟。dsh-swarm 插件 v0.4.0 通过引入常驻进程和任务账本机制，解决了这些问题。
核心功能¶
- 常驻 Agent：每个 Agent 是一个独立 Node.js 进程，循环读取 inbox、执行任务、写入 outbox，无需每次冷启动。
- 独立 API：每个 Agent 独立配置模型、Provider、apiBaseUrl 和 apiKey，写入各自的
state.json。 - 工件引用传递：长产出自动落盘到共享工件库，Agent 间消息只传递
art://<id>引用 + 200 字摘要，需要全文时按引用展开，大幅节省 Token。 - 任务账本 + 看门狗：任务状态机为
pending → claimed → done/failed。失败会自动重试（最多 3 次），claimed状态超过 5 分钟无进展会自动重派，防止 Agent 崩溃导致任务丢失。 - 可视化 UI：DSH 界面内置团队面板，支持可视化创建/删除空白 Agent、查看任务账本进度。
- 内置联网：Agent 自带
web_search/web_fetch（jina.ai），无需额外插件。
安装与启用¶
# 复制到本地插件目录
cp -r dsh-swarm ~/.dsh/local-plugins/dsh-swarm
# 同步到 desktop profile 副本（Windows 下 link: 不生效，是物理拷贝）
robocopy "local-plugins\dsh-swarm" "profiles\desktop\node_modules\dsh-swarm" /MIR
# 重启 DSH（引擎启动时自动加载）
典型用法¶
- 添加 Agent：可以在对话中直接添加，例如：“添加一个 Agent，ID 叫 researcher1，用 deepseek-chat，API 是 https://api.deepseek.com/v1”。也可以在团队面板点击“添加”。
- 组队干活：当遇到复杂任务时，领队会自动拆分任务并分配给 Agent 执行。例如：“帮我调研 X 框架和 Y 框架的优劣，写一份对比报告”。
- 看进度：DSH 界面内置的团队面板会实时显示 Agent 状态（⏳pending 🔄claimed ✅done 💀dead）与任务账本进度。
与 agent-teams 的区别¶
| 维度 | agent-teams | dsh-swarm |
|---|---|---|
| 队员形态 | 同进程 subagent | 独立常驻进程 + 独立 API |
| 结果传递 | 全文经主会话中转 | 工件引用 + 摘要，按需展开 |
| 失败处理 | 任务丢失 | 账本重试 + 看门狗自动重派 |
| 适用场景 | 简单委派 | 复杂多角色协作 / 长任务 |
工具列表¶
用户工具
swarm_add_agent：添加空白 Agent（指定 agent_id / model / provider / api_base_url / api_key）。swarm_remove_agent：删除 Agent，停止其进程。swarm_list_agents：查看所有 Agent 状态与角色分配情况。
Captain 工具
swarm_create_team：组建团队：自动给空白 Agent 分配角色（researcher/coder/analyst/reviewer），启动进程。swarm_set_agent_prompt：给 Agent 写角色提示词（内置 4 种模板或自定义全文）。swarm_send_task：派发任务：写 inbox → 轮询 outbox → 返回结果（长结果返回art://引用）。swarm_read_results：非阻塞读取 Agent 已产出的结果。swarm_read_artifact：按art://<id>引用展开工件全文（支持 max_chars 分段）。swarm_status：团队状态 + 任务账本（触发一次看门狗扫描）。swarm_disband：解散团队，停止所有 Agent 进程（不删除 Agent）。
适用场景与注意¶
该插件适合需要多角色分工、长流程输出的复杂任务场景。由于插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
总结¶
dsh-swarm 通过常驻进程、独立 API、工件引用传递和任务账本看门狗机制，构建了一个健壮的多 Agent 协作环境。它解决了传统多 Agent 系统中 Token 浪费和任务可靠性低的问题。
- 目录页：https://www.skillhub.cn/plugins/wanghj040530/dsh-swarm
- GitHub：https://github.com/wanghj040530/dsh-swarm
