在 DeepSeek Harness (DSH) 中,单个智能体在处理复杂任务时往往存在序列化瓶颈,导致长任务排队、上下文填满以及质量漂移。dsh-swarm-orchestrator 旨在解决这些问题,它将一个目标转化为受监督的智能体团队:架构师将计划审查为 PLAN.md,并行构建器执行任务 DAG,审查者把关质量,集成器合并并交付结果。整个过程在一个实时看板上可见。
核心功能¶
- 角色模型绑定与回退链:每个角色(架构师、构建器、审查者、集成器)都可以绑定特定的模型。插件支持模型回退链和推理努力阶梯,以确保任务完成。
- 并行任务 DAG 执行:任务以有向无环图 (DAG) 形式定义,并带有依赖关系 (
blockedBy)。独立的任务会并行执行,受全局并发上限限制。 - 带反馈的审查循环:被标记为需要审查的任务会由审查者智能体评估。拒绝的任务会循环回构建器并附带反馈。可以将审查门控设置为
human以手动批准。 - 实时看板:提供 Live Kanban Dashboard,用于跟踪每个聊天工作区的运行状态和任务进度。
- 证据检查:支持通过证据命令或文件检查机器验证交付成果。
- 内存安全并发:智能体在 DSH 主机中作为进程内会话运行。全局上限 (
maxTotalConcurrentAgents) 防止堆内存耗尽。 - 作用域工作区执行:每个聊天标签页的 Swarm 标签页显示该工作区的运行情况。
- 每次目标一次运行:除非用户选择退出,否则除非计划经过架构师审查,否则不会开始构建。
典型用法¶
- 调度目标:用户在聊天界面向聊天智能体分派一个群组目标。
- 架构审查:智能体生成计划后,架构师智能体将其审查并整合为
PLAN.md。 - 并行构建:并行构建器智能体根据任务依赖关系(DAG)执行任务图。
- 质量把关:审查者智能体评估交付成果,拒绝不合格的结果并提供反馈,或者将门控设置为
human等待人工批准。 - 集成交付:集成器智能体合并所有部分,验证结果,并生成最终报告。
适用场景与注意¶
- 运行环境:此插件在
dsh web主机中作为进程内会话运行,不启动守护进程或第二个进程。 - 并发控制:存在全局并发上限(默认为 8),防止堆内存耗尽。可以通过 Runtime 设置中的
maxTotalConcurrentAgents调整此上限。 - 工具访问:默认情况下,
modlens工具被拒绝给 swarm 角色。如果需要在无头环境中使用,请在 Roster 中按角色添加回。 - 证据命令:证据命令在 PowerShell 下运行(在根目录中)。
- 任务状态:被采用的任务必须具有状态
"completed"。 - 许可证:MIT。
总结¶
dsh-swarm-orchestrator 为 DSH 提供了一个结构化的多智能体编排层。它通过确保并行工作流、模型分配和机器验证,解决了单个智能体的局限性。有关安装和文档,请访问 GitHub 仓库。