dsh-team-control
一句话:给 DeepSeek Harness 的 Agent Team 加一个独立 sidecar——成员上限可配、DAG 依赖自动派发、按成员分配 DSH 权限预设(permission presets)、成员审批转发给 Lead 决定、事件流可回放、SSE 实时面板。
截图
安装
要求 Node.js ≥ 22.15(node:sqlite ≥22.5、Worker 的 module.registerHooks ≥22.15;实测 v24.22)。零依赖、零构建,不需要 npm install。
1. 装插件(dsh plugin)
# 本地源码(推荐:sidecar 能被插件自动拉起)
git clone https://github.com/hunmer/dsh-team-control.git ~/dsh-team-control
dsh plugin --profile web add "$HOME/dsh-team-control/dsh-plugin"
dsh plugin --profile web add "$HOME/dsh-team-control/dsh-plugin-ui" # 可选:GUI 看板
# GitHub 源码(免 clone;本仓库无构建脚本,不需要 allowBuilds 授权)
dsh plugin --profile web add "github:hunmer/dsh-team-control#path:/dsh-plugin"
dsh plugin --profile web add "github:hunmer/dsh-team-control#path:/dsh-plugin-ui"
# npm 包(预构建,装完即用;sidecar 以依赖 dsh-team-control-cli 一起装)
dsh plugin --profile web add dsh-team-control
dsh plugin --profile web add dsh-team-control-ui # 可选:GUI 看板
装完重启 DSH(或到 设置 → 插件 里禁用/启用一次),team_* 工具与「编排」「任务看板」两个独立入口才会出现。
dsh plugin --profile web remove dsh-team-control(UI 包同理)。
2. 验证
cd ~/dsh-team-control
node demo/run-demo.mjs # 3 成员 + DAG + 一次审批 + 一次 interrupt/resume
node tests/run-all.mjs # AC-1 ~ AC-18 与插件/面板/路由/CLI 全量验收
示例用法
装好后直接用自然语言下任务,模型会自己调用这些工具(sidecar 首次调用时由插件自动拉起):
你:用 dsh-team 起个 3 人团队,写一篇 800 字的短文并互审。
team_create { name: "essay", workspace: "D:/work/essay", permissionPreset: "workspace-write",
agentPreset: "standard", maxMembers: 3 }
→ { team: { id: "team_x1" } }
team_spawn { teamId: "team_x1", name: "writer", role: "writer", prompt: "你是 writer…" }
team_spawn { teamId: "team_x1", name: "reviewer", role: "reviewer", prompt: "你是 reviewer…" }
team_task { teamId: "team_x1", subject: "01 写初稿", assignee: "<writer 的 id>",
acceptance: "draft.md 存在且 ≥800 字" }
team_task { teamId: "team_x1", subject: "02 审稿", assignee: "<reviewer 的 id>",
deps: [{ from: "<01 的 task id>", condition: "all_success" }],
acceptance: "review.md 含 3 条以上具体意见,引用 draft.md 原句" }
成员干完各自 team_report_task({ teamId, taskId, status, summary }),
调度器按 DAG 自动派下一波;需要审批的操作会转发给 Lead,由 team_approve 放行或拒绝。
team_status { teamId: "team_x1", detail: "dag" } // 看成员状态与 DAG 关键路径
team_report { teamId: "team_x1" } // 导出 Markdown 运行报告与审计表
面板:http://127.0.0.1:4317/panel(插件拉起 sidecar 后即可访问)。CLI 等价入口:
npx -y dsh-team-control-cli status | dag | logs | report。
任务看板
「任务看板」是独立于团队 DAG 的工作区级任务队列:一个工作区一块看板,入口是 DSH 里与「编排」并列的「任务看板」页签(也可直接打开 #/board[/<workspaceId>])。它不依赖当前 team,也不要和「编排」页签里的「成员看板」混淆——后者展示成员运行态 Trace,前者管理任务生命周期。
- 状态:
todo → planning → planned → inprogress → done / failed。界面按Waiting(todo/planned/failed)、Progress(planning/inprogress)、Done三列展示。 - 排队与并发:
auto=0的任务先留在 Waiting,点「开始执行」才入队;auto=1自动排队。规划、执行并发按工作区分别设置,默认各 1;planned不占槽位。失败可重试,终态可封存/恢复,进行中的任务可停止。 - 执行链路:插件按
boardDispatchMs(默认 2s)向 sidecar claim 槽位 → 创建规划会话(默认read-only)→ 会话调用board_plan_submit提交计划 → 任务进入planned→ 槽位空出后在同一会话继续执行(默认),或按executionMode: "new"新建 Lead 会话 → Lead 用team_*拉成员、跑 DAG → 调用board_task_status报done/failed。 - 模型与权限:规划默认
read-only,执行默认danger-full-access;工作区设置或任务可覆盖规划/执行 provider、model、reasoning effort,以及成员模型白名单teamModels。同会话模式下规划与执行共用会话模型;要分开规划/执行模型,选「在新的会话执行」。 - 关联与续聊:任务可绑定多个团队;
team_create会自动把当前 Lead 会话对应的任务与团队关联,任务详情可跳到「编排」页签或执行会话。任务完成后用户再发消息,会把任务改回inprogress继续处理。 - 工具与接口:
board_plan_submit({plan, summary?})、board_task_status({status, summary?});任务管理走面板或/api/board/**(详见docs/CONTRACT.md的任务看板一节)。
架构
Lead Agent ──REST / CLI / SSE──▶ dsh-team sidecar (127.0.0.1:4317)
├ Scheduler DAG 求值 + 自动派发
├ EventStore event 只增流 + 状态物化
├ Approval 成员审批镜像与决策审计
├ MessageBus 持久信箱 + 三态回执
├ SSE Hub lastEventId 断线续传
└ Web UI 面板 /panel(Trace 瀑布 / DAG / 审批)
DSH agent × N ◀──subagents.startActivation / sendMessage── dsh-plugin/ 真子会话成员
- 状态只有一根主轴:所有变更写
event,member_state是它的物化视图,崩溃后可完整重建。 - 权限不再由 sidecar 判定:
permissionPreset落到实处子会话,审批经插件转发给 Lead,approval表只做镜像与审计(team_approve→ 宿主allowed-once/rejected)。 - 工具/skill/MCP 由
agentPreset(DSH 组合预设)决定,按团队默认、成员覆盖;fork继承 Lead 组合,fresh才支持独立预设。 - 契约:
docs/CONTRACT.md;每条偏离一份docs/adr/。
文件地图
| 路径 | 作用 |
|---|---|
bin/dsh-team.mjs |
CLI:up / down / status / dag / logs / approvals / report |
src/core.mjs |
组合根、业务查询、报告导出 |
src/db.mjs |
SQLite schema / 事务 / 轻量迁移 |
src/eventstore.mjs |
事件流 append / rebuild / verify |
src/scheduler.mjs |
DAG 求值、就绪推进、失败策略、环检测 |
src/approval 相关 |
core 的 createApproval / decideApproval 镜像宿主审批 |
src/bus.mjs |
持久信箱与回执 |
src/sse.mjs |
SSE hub 与断线续传 |
src/server.mjs |
REST + SSE + 静态面板(仅回环监听) |
src/web/ |
面板构建产物(panel.html + assets/) |
src/web-ui/ |
面板源码(React + coss ui,含 Trace 瀑布) |
dsh-plugin/ |
DSH Host bundle:14 个 team_* + 2 个 board_* 工具 + sidecar 生命周期 + 子会话成员调度 + 审批转发 |
dsh-plugin-ui/ |
GUI 看板 bundle:better-sidebar 页签 / 侧栏入口 |
skills/dsh-agent-team/ |
给模型看的调用配方 skill |
tests/ |
ac-*.mjs 验收脚本 + harness + run-all.mjs |
demo/ |
run-demo.mjs 可复现演示、seed.mjs 灌演示数据 |
docs/ |
CONTRACT.md 实现契约、adr/ 决策记录、handoffs/ 交接 |
prd/ |
需求文档与实现摘要 |
No comments yet. Be the first to write one.