前言¶

下面介绍 DSH 插件 dsh-team-task。DSH 的理念是「一切皆插件」，社区可以通过插件扩展智能体协作能力。对于需要跨多轮执行、依赖评审和失败恢复的长任务，单靠一次提示词或短促会话不容易保持稳定。

dsh-team-task 是 Ready22Race 维护的 DSH 插件，面向长任务多智能体任务：lead 会话规划需评审的 DAG，durable members 执行节点，append-only event log 作为唯一真相，resident reconciler 在崩溃和重启后继续推进任务。许可证为 MIT。

插件定位¶

dsh-team-task 解决的核心问题包括：

• 长任务中成员执行结果需要可追踪。
• 多个节点之间存在依赖，需要评审后再推进。
• 进程崩溃、会话中断或 harness 重启后，任务需要继续。
• 不同角色之间的协议不能每次都完整塞进 prompt。

它不是普通的一次性命令工具，而是围绕事件日志、评审闸门、定时恢复和按需加载协议设计的 DSH 插件。

核心功能¶

已核实的能力如下：

1. lead 会话规划需评审的 DAG。
2. durable members 执行节点。
3. 常驻 reconciler 按计时器重新推进任务，并在 lead 返回时恢复工作。
4. 运行时在 idle 边结算任务，完成工具只加速而不作为闸门。
5. 评审闸门：仅 lead approve 解锁下游，rework 将反馈送回同一节点并保留 attempt 历史。
6. append-only event log 作为唯一真相，并使用 fence tokens 拒绝迟到写入。
7. 事件日志可重放，snapshot.json 与 inbox 为派生视图。
8. 渐进式 playbook：通过 team_task_playbook 按需加载 lead / member / recovery 协议。
9. M1 提供 board data routes：/plugins/team-task/state 与 /plugins/team-task/log。

资料列出的工具包括：

• team_task_playbook
• team_task_create
• team_task_add_member
• team_task_plan
• team_task_dispatch
• team_task_await
• team_task_complete
• team_task_review
• team_task_send
• team_task_status
• team_task_finish

安装与启用¶

先确认 Node 环境。资料给出的要求是：

^22.19 || >=24

资料明确说明 Node 23 无法启动 dsh。

DSH 插件会以当前 dsh 进程权限运行。安装前建议检查源码、依赖和许可证。本插件许可证为 MIT。

1、添加插件：

dsh plugin --profile web add @ready22race/dsh-team-task

这一步把 @ready22race/dsh-team-task 加入 web profile。

2、启动或重启 dsh：

dsh web

plugin add 后需要重启 dsh，因为 bundle list 在进程内缓存。

3、验证组合：

dsh --profile web --dump-config

预期看到：

id: team-task

典型用法¶

打开：

http://127.0.0.1:3080

在 Settings → Models 设置模型 key，选择 workspace 后发送：

用 team-task 跑一个长任务：先加载 lead playbook，规划一张带依赖和预指派（assignee）的节点图，逐节点评审，最后合并交付。

预期看到：

• 任务卡片
• 右侧 board floater
• 本地事件日志：<workspace>/.team-task/tasks/<id>/log.jsonl

推进任务时，可以先加载 lead playbook，再使用：

team_task_create
team_task_plan
team_task_dispatch
team_task_review
team_task_status

等工具。具体调用顺序取决于任务节点、依赖关系和评审结果。

存储与配置¶

资料说明 log.jsonl 是单一真相。snapshot.json 与 inbox/ 是派生视图，不可手工写入，也不被代码读回。

事件日志可重放，也就是说，某个历史时刻的团队状态可以通过重放日志得到。

资料明确列出的配置项包括：

stateDir
memberProvider
memberMaxDepth
maxMembers
reconcileIntervalMs

M1 提供的 board data routes 为：

/plugins/team-task/state
/plugins/team-task/log

适用场景与注意¶

这个插件适合需要在 DSH 中运行长任务多智能体流程的用户，尤其是需要依赖节点、评审反馈、执行记录保留和失败恢复的场景。

需要注意：

• Node 要求为 ^22.19 || >=24，资料明确 Node 23 无法启动 dsh。
• plugin add 后需要重启 dsh。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• v0.1 已知限制：成员唤醒仍需 live lead Agent。
• message_delivered 只表示 inbox acceptance，不表示 turn consumption。
• npm 发布需要账户拥有 @ready22race scope；2FA 启用时 npm publish 需要 --otp 或 bypass 2FA token。

链接¶

目录页：

https://www.skillhub.cn/plugins/Ready22Race/dsh-team-task

GitHub：

https://github.com/Ready22Race/dsh-team-task