前言¶

DeepSeek Harness（DSH）采用插件化架构。在多智能体协作中，独立窗口间的任务流转和状态追踪容易产生混乱。dsh-flat-teams 是一个工作流插件，它为 DSH 提供了无队长的扁平团队能力，支持跨窗口派发结构化任务，并提供记录员服务和 Web 看板。

这是什么¶

dsh-flat-teams：Leaderless flat agent teams for DeepSeek Harness。它通过 team_create/team_join/team_leave/team_roster 等工具管理扁平团队，利用 task_dispatch 进行结构化任务派发与状态机管理，内置记录员服务维护 progress.json，并提供 Web 看板用于查看主表和二级表。

• 维护者：whateverboy2333
• 许可证：MIT
• 所属分类：工作流

核心功能¶

扁平团队管理¶

插件提供基础的团队管理能力：
* team_create：建队，可预置成员规格。
* team_join：已有窗口自注册加入。
* team_leave：退出团队。
* team_roster：查看花名册（成员/领域/在线状态）。

结构化任务派发¶

• task_dispatch：按成员名或负责领域派活。
• 状态机：任务状态流转为 pending → delivered → claimed → in_progress → completed | failed | cancelled。
• 投递机制：任务先落盘并写入收件成员邮箱，再尽力实时唤醒。离线投递的任务会停在 delivered 状态，留存在邮箱中。

记录员服务与 Web 看板¶

• 记录员：订阅事件流维护 progress.json，可随时从 events.jsonl 重建。
• Web 看板：安装到 web profile 后，浏览器右上角出现”团队看板”浮层。提供主表（成员数/在线数/进行中数）和二级表（花名册/任务看板/进展时间线）。
• 查询接口：Web 看板通过 GET /plugins/flat-teams/state 获取数据（5s 轮询）。

安装与启用¶

1. 安装插件：
   使用官方推荐命令安装：

    dsh plugin --profile <name> add dsh-flat-teams

或使用 git 形式：

    dsh plugin --profile <name> add github:whateverboy2333/dsh-flat-teams

*注：本地路径形式用于开发调试。*

2. 重启 Profile：
   安装后必须重启该 profile 才能生效。

3. 验证安装：
   通过配置检查插件是否加载成功：

    dsh --profile <profile> --dump-config

组合树中应出现 `flat-teams` 行。

工具速查¶

注意事项与限制¶

1. 运行环境：

   • 需要 DSH 0.1.0-rc.6 或更高版本。
   • 需要 Node 22.19 或 Node 24+。

2. 进程限制：

   • 仅同进程跨会话：所有成员窗口必须在同一个 DSH 进程内。
   • 跨工作区：支持同进程内跨工作区。

3. 状态持久化：

   • 跨重启成员窗口不自动复活：编程创建的成员窗口由插件 fiber 持有，进程退出或插件卸载即销毁。窗口需重新创建。
   • 离线投递无自动重投：目标离线且冷恢复失败时，任务停留在 delivered 状态，需上线后手动触达。
   • 取消不撤回：task_cancel 只迁移状态，已投递到接收方窗口的消息不会被撤回。

4. 权限与规则：

   • area 不强制独占：area 仅做路由参考，允许多成员，派发时必须指明成员名。
   • 权限强制：取消仅限派发方；认领/完成仅限指定接收成员。

5. 数据目录：

   • 团队状态存于 DSH_HOME 级，路径为 <DSH_HOME>/flat-teams/<teamId>/，包含 team.json、tasks/、events.jsonl、inbox/、progress.json。

短结尾¶

dsh-flat-teams 为 DSH 用户提供了轻量级的扁平团队协作方案，通过结构化任务派发和记录员服务解决了多窗口协作中的状态同步问题。适合需要在单一进程内进行多 Agent 协作的开发者。

生态背景：DSH 理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

链接：
* 插件目录
* GitHub 仓库