DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

hunmer /

hunmer/dsh-team-control

Topic repository only

DSH 的 Agent Team 控制平面:成员上限可配、DAG 自动派发、四域强制权限、SSE 实时面板

★ 32 Stars1 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: master@0f5ca5e8

dsh-team-control

node deps license

一句话:给 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/ 需求文档与实现摘要

声明

  • 许可:MIT,见 LICENSE。
  • 本地优先:sidecar 只监听 127.0.0.1,/api/** 与 /panel 免 token,因此不要把端口直接暴露到公网;需要远程访问请自行套反向代理与鉴权。
  • 不碰凭据:不内置 LLM 客户端、不保存任何 API Key;敏感 env 输出一律 <redacted>。
  • 非官方:本项目为个人项目,与 DeepSeek 官方无隶属或背书关系。
  • 取舍:Node 无 net 权限门、状态单点存放、并发写用 CAS 等已知限制与理由见 docs/adr/。
—/ 5

No ratings yet

Manifest verification required

Commit 0f5ca5e86763

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout