前言¶

对于 DSH 使用者来说，如果一次委托只处理一句任务，面对一批有依赖关系的任务时，还需要人工处理并行、隔离、冲突和恢复。TaskSwarm 把这些事情收进一个插件里：先按依赖关系把任务分成 waves，再让同 wave 内的任务在独立 lane 中并行执行，最后做审查、合并和状态保留。

下面介绍 TaskSwarm 的定位、核心能力、安装方式和典型用法。

这是什么¶

TaskSwarm（蜂群）是 DeepSeek Harness (DSH) 上的多智能体任务编排插件，npm 包名为 dsh-taskswarm，由 february2015 维护，许可证为 MIT。资料标注其上游为 TaskPlane，本项目为 native port。

它把一批任务组织为任务包，并在 DSH 会话中提供 supervisor、worker、reviewer、merger 的协作流程。

核心功能¶

Waves / Lanes 并行编排¶

• 任务按依赖 DAG 分层为 waves。
• 同一个 wave 内的任务并发执行，形成 parallel lanes。
• lane worktree 从 taskswarm/orch HEAD 创建，继承先前已合并的输出。

Git worktree 隔离¶

• 每个任务或 lane 使用独立 worktree。
• lane 的结果合并到 taskswarm/orch。
• taskswarm/orch 是集成分支，应保留，不要删除。

Task packets¶

• 每个任务包含 PROMPT.md 与 STATUS.md。
• PROMPT.md 保存任务说明、步骤和约束。
• STATUS.md 保存进度，为 worker 提供跨上下文重置的持久任务记忆。

Checkpoint discipline¶

• 步骤边界自动 git commit。
• worker 崩溃时，已提交工作不会丢失。
• 持久磁盘状态、checkpoints 和保留的 lane 分支共同支持崩溃恢复。

Cross-model review¶

• 独立 reviewer 按任务 Review Level 打分。
• PASS 合并。
• REVISE 回退给 worker 修改。

File mailbox¶

• worker 与 supervisor 通过文件异步通信。
• 通信不依赖共享上下文。

Conversational supervisor¶

• supervisor 与当前 DSH 会话共享。
• 支持 start、pause、abort、integrate、open dashboard 等指令。
• 通知和 prompt 为中文 / English 双语。
• 语言设置持久化到 .taskswarm/config.json。

Web Dashboard¶

• 本地实时 dashboard，基于 node:http + SSE。
• 启动批次时自动启动 dashboard，并在会话中打印链接。
• 每个 workspace 仅一个实例；已有实例会被复用，不会重复启动。

LLM merge agent¶

• lane 合并到 taskswarm/orch 发生冲突时，由独立 merger 代理做语义解决。
• 无法解决时，lane 进入 conflict 状态并暂停批次。

安装与启用¶

先安装 npm 包：

dsh plugin --profile web add dsh-taskswarm

安装后重启：

Restart dsh web

插件在 DSH 启动时生效。

2026-08-17 至 2026-08-18 期间，npm 包 dsh-taskswarm 曾下架，需从 GitHub 安装；2026-08-19 起 npm 包恢复。

升级已安装版本时，如果直接执行：

dsh plugin --profile web add dsh-taskswarm

可能报告 Already up to date。此时需要显式指定新版本：

dsh plugin --profile web add dsh-taskswarm@<new-version>

或者运行：

pnpm update --latest

完成后重启 dsh web。

典型用法¶

先创建示例任务包：

/tswarm-init

该命令会创建 EXAMPLE-001 和 EXAMPLE-002 两个示例任务包。

再预览 wave 计划：

/tswarm-plan all

该步骤只预览按依赖分组后的任务计划，不执行任务。

然后启动批次：

/tswarm all

并行运行所有任务；也可以运行单个任务：

/tswarm EXAMPLE-002

随时查看进度：

/tswarm-status

打开 dashboard：

/tswarm-dashboard

也可以用独立 CLI 启动：

npx taskswarm-dashboard --root <repo>

或不先安装插件，通过 npx 临时获取：

npx --package dsh-taskswarm taskswarm-dashboard --root <repo> [--port 8100] [--no-open]

启动批次时，dashboard 会启动并在会话中打印链接。

校验任务包：

/tswarm-check

或：

npm run check:tasks

状态与 Git 模型¶

持久状态位于：

<repo>/.taskswarm/

批次状态文件为：

.taskswarm/batches/<batchId>.json

Git 模型中，taskswarm/orch 是集成分支，所有 lane 输出合并到这里；它应保留，不要删除。

lane worktree 的基线来自 taskswarm/orch HEAD，这样 lane 会继承此前已合并的输出。

适用场景与注意¶

适合一批相关任务需要依赖排序、并行执行、工作区隔离、审查合并和崩溃恢复的场景。

注意：

• 插件会以当前 dsh 进程的权限运行，能访问仓库、git 状态和本地端口；安装前应检查源码、依赖和 MIT 许可证。
• taskswarm/orch 是集成分支，不要误删。
• 升级后如果仍停留在旧版本，需显式指定新版本或更新依赖，再重启 dsh web。
• 它发布在社区目录中，目录是独立站点，不应视为官方应用商店。

链接¶

• 目录页：https://www.skillhub.cn/plugins/february2015/dsh-taskswarm
• GitHub：https://github.com/february2015/dsh-taskswarm