dsh-team-control

dsh-team-control

[](#安装) [](#安装) [](LICENSE)

一句话：给 DeepSeek Harness 的 Agent Team 加一个独立 sidecar——成员上限可配、DAG 依赖自动派发、按成员分配 DSH 权限预设（permission presets）、成员审批转发给 Lead 决定、事件流可回放、SSE 实时面板。

附带的工作区级「任务看板」：同一个 sidecar 上的任务队列（todo → planning → planned → inprogress → done / failed），自动排队、先规划后执行，和团队编排共用一套事件流。

架构

sidecar 是独立 Node 进程（bin/dsh-team.mjs，默认只监听 127.0.0.1:4317），由 Host 插件按需拉起；每个成员都是一个真的 DSH 子会话。

flowchart LR
  Lead["Lead AgentDSH 主会话"]

  subgraph Host["dsh-plugin · Host 插件（进程内）"]
    Tools["19 个 team_*2 个 board_*"]
    Life["sidecar 生命周期"]
    Fwd["审批 / trace / 产物转发"]
  end

  subgraph SC["sidecar · 127.0.0.1:4317"]
    Sch["SchedulerDAG 求值 · 自动派发"]
    Ev["EventStoreevent 只增 · 状态物化"]
    Ap["Approval审批镜像 + 审计"]
    Bus["MessageBus持久信箱 + 三态回执"]
    Hub["SSE HublastEventId 续传"]
  end

  subgraph Mem["DSH 子会话成员 × N"]
    M1["member 1"]
    M2["member 2"]
  end

  Panel["面板 /panelTrace · DAG · 审批"]
  Cli["CLI dsh-team"]

  Lead -->|team_* / board_*| Tools
  Lead -->|REST / SSE| SC
  Tools -->|HTTP JSON| SC
  Tools -->|subagents.startActivation| Mem
  Mem -->|team_report_task| Tools
  SC -->|静态托管 + SSE| Panel
  Cli -->|run/sidecar.json| SC

三条链路：

• 编排：Lead 调 team_ / board_ → Host 插件校验并绑定会话 → sidecar 写 event、算 DAG、推进派发。
• 成员：subagents.startActivation 拉起真子会话，成员跑完用 team_report_task 回写 → sidecar 推进依赖、唤醒下一波。
• 观测：面板与 CLI 走 REST + SSE，lastEventId 断线续传；面板构建产物由 sidecar 同源托管。

一轮任务怎么跑

sequenceDiagram
  autonumber
  actor L as Lead
  participant P as dsh-plugin
  participant S as sidecar
  participant M as 成员子会话

  L->>P: team_create / team_spawn / team_task
  P->>S: 建团队 · 注册成员 · 建 DAG 节点
  S->>S: Scheduler 求值就绪任务
  P->>M: 派发简报（含验收标准）
  M->>M: 执行任务 · team_todo 更新计划
  opt 触发审批（permission preset = ask）
    M->>P: 审批请求
    P->>L: 转发请求
    L->>P: team_approve(allow / deny)