DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zws20070309 /

zws20070309/dsh-dispatch-agent-team

Topic repository only

调度模式(dispatch-mode)agent preset + 智能体团队插件 for DeepSeek Harness:12 类队员角色、共享队员卡(缓存友好)、report_result 结构化汇报、wake_teammate、缓存保活、会话级团队开关记忆。一条命令安装:node tools/install.cjs

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@b2aa7058

调度模式智能体团队

一个 DSH 桌面端插件 + 一个 agent preset。它把官方实验性的 Agent Teams 改造成一套 **「先把需求问清楚,再动手」**的团队工作方式。

  • 调度模式(dispatch-mode)preset:Lead 先分轮把需求问清楚再落地 —— 每轮把问题一次列完, 用聊天界面的提问卡片(选项 + 推荐项)问你,你点选提交;没有静默假设、用户确认共享理解之前不动手。 「找事实」由 Lead 自己查或派队员查,不问用户。 提问走卡片而不是写在回复正文里:卡片的答案以工具结果回到同一个回合,会话不断; 写在正文里则这一轮直接结束,你得再发一条才能继续。默认无限等(不会因为超时先替你继续)。
  • 12 个队员角色(按工作流阶段排列,按需叫、不必叫满):外部调研、探索调研、前沿审查、计划审查、 执行落地、集成落地、复现回归、逻辑审查、对抗审查、美术审查、反思优化、文档术语。
  • 模型与强度配置:插件详情页可以一次性给全部角色统一模型与思考强度(省得逐行点),也可以逐角色单独指定;不用编辑 YAML,默认全部「跟随 Lead」。
  • 队员的能力面自动收窄:自动摘掉目标工具与子代理工具,只保留它本职需要的团队工具。
  • 结构化汇报:队员做完必须调 report_result(状态 / 证据 / 验收 / 未决项), 插件会把它投递给 Lead —— 「没有结构化报告就当没完成」不再只是一句纪律。
  • /team 开启团队,默认关闭(团队会真的多花模型预算)。开关按会话记忆, 宿主重启后会自动把开过团的会话装回来。
  • 缓存友好:所有队员共用同一份队员卡与同一份工具目录,角色差异只走 Lead 派活时写的 那段提示词,队员之间因此能共用提示词前缀。 精确说法:逐字节相同的是「队员卡 + 工具目录」这一层,不是整份系统提示词 —— 每个队员还会按自己的角色配置挂一段各不相同的工具用法/遮蔽段(收窄工具面、预设重绑、ops 指引等), 且预设不同时工具文档段本身也不同。所以「前缀可共用」成立,「整份提示词逐字相同」不成立。

要求

项 要求
DSH 桌面端 0.2.0-rc.2 或更新(更早的版本请先跑 node tools/drift-check.cjs 看兼容性)
Node.js ≥ 18
官方 bundle 需在插件页启用 @deepseek-ai/dsh-experimental-agent-team-profile(本插件复用它不可替代的持久化域服务;工具面与界面由本插件接管)
可选:dsh-ops 装了并启用后,Lead 与每个队员自动获得它的文件检索四件套(注册在全局层);其余工具各有权限门 —— ops_bash 与四个 job 工具要会话处于「完全访问」,ops_batch/ops_result 只给纯 PTC 档队员(见下文「ops 工具」)。不装也完全能用,本插件不依赖它

安装

先完全退出 DSH 桌面端(官方要求 desktop profile 的操作在它退出后进行),然后在本目录执行:

node tools/install.cjs

然后重启桌面端 → 新建会话 → 推理模式选「调度模式」→ 输入 /team。

  • 只想看这条命令会做什么、不改任何东西:node tools/install.cjs --dry-run
  • 界面安装(等价路径):插件 → 已安装 → 添加插件 → 填本目录的绝对路径, 然后再跑一次 node tools/repair.cjs --apply。

为什么装完还要补跑一次 repair.cjs --apply:官方安装器不负责两件必需品 —— 包内指向 ~/.dsh/profiles/node_modules 的依赖 junction(缺了插件行在加载期就起不来), 以及 profile 层的 agent-team 容量覆盖(缺了有效容量退回官方默认 8,8 次派活之后团队就派不出人)。 install.cjs 会自动串跑它;走界面安装时才需要手动补一次。

注意:安装会把 profile 指向你运行 install.cjs 的那个目录。如果你另外留着一份副本, 那份就是死代码 —— 改它不会生效。用 node tools/repair.cjs 可以确认 profile 实际链接到哪一份。

装完后哪里找

  • 插件 → 已安装 → 调度模式智能体团队:配置页(每个角色的模型 / 思考强度)。
  • 左侧栏「智能体团队」:点一下直接进配置页(每个角色的模型 / 思考强度),不用再走「插件 → 已安装 → 详情页」。
  • 推理模式选择器:多出「调度模式」。 本插件不改新会话的默认 preset(安全选择:preset 配错会让新建会话直接失败), 要用调度模式请手选一次;已开始过的会话不能切换 preset,需要新建会话。

改代码后的生效方式

改动 生效方式
lib/*.js(宿主半) 重启 DSH
lib/client.js(浏览器半) 刷新页面即可
presets/*.patch.yml、cordis.patch.yml 重新加载插件后生效

如果源码目录与桌面端实际加载的那份是两个目录,改完要同步一次: node tools/sync-to-dsh.cjs(--dry-run 只看差异)。

分支约定(用户 2026-10-14 定案)

日常改动一律在 dev,提交后推 origin/dev;攒一批再合并进 main(合并需用户批准, 历史上是 10-09、10-11、10-14 三次)。main 是仓库默认分支,也是「已发布」的那一份。

为什么必须定期合:GitHub 贡献图只统计默认分支可达的提交。实测 10-13 那 17 个提交 只推了 dev 时,图上 10-13 = 0;合并进 main 后同一格变成 17。所以「改动都在远端、图上却是 0」 不是丢提交,是分支问题 —— 先 git ls-remote origin dev 确认在不在,再看 main 可不可达。

合并的做法(照 10-14 那次):

  1. git merge-tree --write-tree origin/main origin/dev 先干跑,确认零冲突;
  2. 用临时 worktree 操作(git worktree add <tmp> --detach origin/main),不要在正在运行的 插件目录里 checkout —— 那个目录是桌面端实际加载的 junction,切分支会当场改变插件代码;
  3. git merge --no-ff origin/dev(保留合并提交,与历史两次一致);
  4. 核对 git diff --stat HEAD origin/dev 为空,再 git push origin HEAD:main;
  5. git worktree remove <tmp>,确认插件目录仍在 dev 且工作树干净。

使用

开启与关闭团队

这些入口只在「调度模式」的会话里出现(别的 preset 看不到、也开不了本插件的团队)。

操作 怎么做
开启 输入 /team(推荐,/ 菜单里能搜到),或直接说「组队」「开团队」让 Lead 自己开
关闭 直接说「关掉团队」「解散团队」,Lead 会调 disable_agent_team
  • 没有 /team-off:团队开关只有一个斜杠命令 /team 与两个模型工具,不需要记第二个命令。
  • 命令执行后命令行只显示 >_ team,不会再追加一段横幅;紧跟其后的用户气泡就是你打的那一行。
  • 不要用 /智能体团队 这类自造斜杠命令:命令名在宿主侧只允许 ASCII,未注册的 /xxx 会被客户端命令面板吞掉 —— 既不报错也不发给模型,也就是什么都不会发生。
  • 团队开关按会话记忆:/team 成功后这个会话会被记下来,宿主重启或重开该会话时自动把团队装回来, 你不用再打一次 /team。说「关掉团队」会立刻删掉这条记录。
  • /team 可以带附件:贴一张截图再打 /team 帮我查这个报错,图片和你那行文字会一起进 Lead 的上下文。 通用文件(日志、CSV 等)按只读路径交给模型,需要时它自己读。

配置队员的模型与思考强度

插件 → 已安装 → 调度模式智能体团队 → 详情页。

页面顶部有一个统一选择队员模型与思考强度:选一次就把下面所有角色的对应项都改成这一个; 只想给某个角色特殊待遇时,再单独改它那一行。

思考强度依附于模型(档位是每个模型各自广告的),所以强度那个下拉要先把模型统一后才能选; 没统一时它会保持可见但禁用,并写明原因与下一步。

  • 默认每行都是跟随 Lead:不配置 = 不加任何覆盖,队员跟着 Lead 当前的选择走。
  • 统一选择时,思考强度会按新模型重算:仍然支持的档位保留,不支持的退回「模型默认」。
  • 改完立即生效:已经在跑的队员也在下一次请求就用上新路由,不需要重启。
  • 唯一的例外是 spawn_teammate 的显式参数(provider/model/reasoning_effort)—— 那是「这一次派活」的命令,会钉在该队员身上。思考强度未显式给时,spawn 会继承 Lead 当前生效档并钉住(2026-11-07 修复:规避 agent-default-model 步前固定与 adapter default 的强度冲突);模型与路由仍逐请求实时跟随。
  • 配置文件在 ~/.dsh/dispatch-agent-team.json。

典型的协作节奏

  1. 你说需求(可以很模糊)。
  2. Lead 派 1–3 个 scout(查本仓库)或 researcher(查仓库之外)去查事实。
  3. Lead 把不依赖这些事实的问题一次性列成一轮,等你答复;答复改变设计树后重算下一轮。
  4. 前沿快空时派 frontier-auditor 复核有没有被跳过的分支,直到你确认共享理解。
  5. Lead 切写域、在任务板上建任务、派 builder 落地;多写域时派 integrator 接线。
  6. 声称完成后派 verify 走真实链路验证,高风险改动加 red-team 主动证伪。
  7. Lead 自己复核关键结论后给你最终答案。

工作区(团队拓扑可视化)

会话顶栏点「智能体团队」打开成员面板,面板的「成员」标题右侧有进入工作区。

左侧栏那个「智能体团队」是另一个东西:它进的是配置页(每个角色的模型与思考强度), 不是这个工作区画布。两处入口各管各的。

画布上每个方块是一个真实成员,数据全部来自你自己的会话日志与团队域服务,不是演示数字:

  • 列 = 真实依赖深度:Lead 在最左;只读别人产出的在左列,互相读写的成员被收进 虚线「协作核」容器(点容器或顶栏「展开协作核」摊开看内部关系)。
  • 线 = 真实关系:蓝虚线 = Lead 正在派活(流光 Lead→队员);绿实线 = 该队员已向 Lead 交付(流光 队员→Lead);紫线 = 承接关系,即「A 写的文件被 B 读了」(流光 写方→读方, 越粗共享文件越多)。队员之间的线只画真实存在的读写关系,不是并列装饰。
  • 方块内容:TODO(完成/进行中/总数)、模型、输出/缓存 token、缓存命中率、运行时长、 输出速度(TPS)、上下文占用圆环(悬停看数值)、档位分段条(两枚色段 = 该队员的 agent 预设族 + 呈现档:空心段 = 跟随 Lead;整行悬停看确切说明。T9-3 那类「preset 没按 配置生效」的问题从此在画布上直接可见)。
  • 底栏:全队总 token、整体缓存命中率、平均 TPS、承接关系数。
  • 点任意方块弹出该成员的详情浮窗(指标 + 实时对话 + 提问回答)。顶栏可开关流光/弱关系、 缩放、适配窗口。Esc 退出。
  • 浮窗与官方聊天界面等价(不是「另做一套再想办法同步」):
    • 实时:浮窗吃的是官方对话自己在用的那份事件窗口,所以思考、正文、工具调用 都是一个 token 一个 token 长出来的,与你在官方界面看到的同帧;这一步结算后 由宿主的正式对话行接管(按 callId 与 (turn, step) 去重,不会显示两遍)。 思考在有正文时收成一行「思考过程」,点开看全文(与官方同一套披露行)。
    • 回答提问:弹窗里点「提交回答」调的是官方那张提问卡自己的 answer(), 与你在聊天界面点提交是同一个方法、同一个对象 —— 阻塞中的那次提问当场拿到答案、 官方卡片自己关闭。不是把答案拼成一条消息插进对话。 答案批次的形状照抄官方 submitDrafts(没填自定义时 custom 键不出现): 写成 custom: undefined 会被网关的 lossless-JSON 校验拒掉,那次提问会当场 以 isError 结算(实测 session-00001004)。而官方 answer() 永远 resolve、 不回报失败,所以弹窗另外去查这次工具调用的结算结果,只有确认被接受了 才说「已回答」;查出来是死的就如实报错,不谎报、也不退成消息投递。
    • 拿不到这套对象层时(宿主版本不对 / 该会话没有活体对象)自动退回「轮询会话日志」, 功能不丢,只是不再逐 token 实时,并且会如实说明答案只是投递。
  • 新队员实时出现:给 Lead 发消息后进工作区,每派一个队员画布上就多一个方块(约 1 秒内), 入场带淡入动画,派活线同时出现;队员交报告后那条线当场由蓝虚线变绿实线。 画布用自适应刷新:团队在变化时约 1.2 秒一轮,稳定后退回 5 秒一轮(数据没变不重绘, 流光动画与悬停提示都不会被打断)。
  • 加载与空是两种态:打开工作区时画布(队员卡)、底栏(任务板)、浮窗对话(队员报告流) 三处先显示呼吸骨架占位;数据读到后换成真实内容——确认「什么都没有」时才显示空态文案 (系统跟随系统的减弱动态偏好,自动关闭呼吸动画)。
  • 任务板悬停浮窗 + DAG 聚焦:悬停底栏的任务分段条,浮窗列出每条任务的状态/标题/ 归属与关联报告摘要,每行尾注 ← 依赖任务(blockedBy 前驱)。点一行 = 聚焦它的 完整上下游依赖链(链上主色高亮、链外淡出,标题行给出相关条数);再点一次或 Esc 取消。 浮窗开着时可以移进去点行,移出两块区域(分段条+浮窗)才收起。

暗色模式跟随 DSH 主题自动切换,无需设置。

Lead 能用的工具

工具 作用
spawn_teammate 创建一个具名队员(带角色;可选覆盖模型 / 思考强度)
send_message / broadcast_message 给一个 / 多个队员发消息
list_agents / wait_agent / interrupt_agent 看成员状态、等变化、打断某个队员
team_task_create / team_task_list / team_task_get / team_task_update 共享任务板(含写域与依赖)
wake_teammate 队员被输出上限截断、没交报告时叫它从断点续写(不用你手动打「继续」)

队员看到的是另一份子集:没有 spawn_teammate / interrupt_agent(只有 Lead 能创建或打断), 多一个 report_result(交付报告)与 ask_lead(中途向 Lead 提问),也没有目标与子代理工具。

ops 工具(可选插件 dsh-ops,原生链接)

dsh-ops 是另一个插件:用 Rust 实现的文件检索、后台任务与批量操作, 比宿主同名工具更快、输出更省 token。本插件不内嵌它、也不依赖它 —— 两个插件各自安装、各自启用; 检测到它在场时,队员不需要任何配置就直接看得到它的工具,并额外收到一段简短的使用指引。

分工要说准(实测,别当成「全都一样」)。dsh-ops 的呈现方式随版本变过,两代都要认清:

  • 0.3.x(旧):file 组件的工具注册在全局层,Lead 与每个队员都直接看得到; shell / background / PTC 增强 注册在各 agent 自己的作用域上,各有一道门。
  • 0.5.x(本机装机版):改成「一条预设一档」的 mode 行族(dsh-ops-mode-* + dsh-ops-discovery), 并且把 file 工具从「全部常驻」改成 按需加载:native 档常驻的只有 ops_read_files, 其余(grep / glob / replace / diff / stat / copy / move / remove / read_pdf / read_docx / read_table …) 要先经 ops_discover_tools 选中才在下一步出现;纯 PTC 档常驻的是 ops_inspect_local_file 与 ops_result, 其余在 run_code 程序里通过 ops_load_sdk 加载。 所以新版里「工具清单里没有 ops_grep」是设计,不是没装好 —— 这是最容易误判的一条。

批量工具(ops_batch/ops_result)的门两代都最窄:只放行纯 PTC 呈现档 (dsh-ops lib/ptc/index.js:该作用域的工具组合恰好只有一个 run_code,且 tools:ptc-only 段非空)。 所以实测结论是:Lead(原生档)拿不到那两个工具,而队员能不能拿到取决于它是不是纯 PTC 档 (= 预设 ptc + 打开「批量调用」;2026-10-21 起开/关就是 ptc/native 两档,不再有 both)。 这不是缺陷,是 ops 的设计;怎么配见下面第一条。Lead 那侧本插件刻意不动 —— 那是你的主会话。

想确认这套链接在你机器上真的通了(不用重启 DSH):node tools/ops-mount-check.mjs —— 它挂真 dsh-ops 组件与真宿主注册表跑一遍, 四段各自独立(各用独立 Context):A 交付态(按装机那一代装配:0.3.x 的四组件行 / 0.5.x 的 mode 行族)、 B 负对照(同一份原版组件只差呈现档)、C 后台任务(0.3.2 起该组件已移除,自动跳过)、 D shell 通道(ops_bash 已发布 + 本包的 extraGuidance 确实进渲染结果)。 本机 dsh-ops 没装原生 worker 时,A/B 会如实跳过而不是报错 —— 那种情况下 file 与 PTC 工具按 ops 的设计 就不会发布,把「装机缺件」报成「插件坏了」是错的;判定是三值的(true / false / 跳过)。

dsh-ops 组件 队员拿到什么
file 常驻:ops_read_files(0.5.x)/ 整套 ops_* 文件工具(0.3.x)。其余按需:ops_discover_tools 选中 grep / glob / replace / diff / stat / copy / move / remove / read_pdf / read_docx / read_table 后于下一步出现
background ops_run_background / ops_job_output / ops_job_list / ops_job_kill —— 长任务托管(需会话处于完全访问)。0.3.2 起该组件已被 dsh-ops 整体移除,行留着只会打一条警告,四个工具不再发布
shell ops_bash(一次性 POSIX 命令)+ 把命令执行器换成随包 PowerShell 7(Windows 上通常比系统自带的好用)
discovery(0.5.x 新增) ops_discover_tools —— file 工具的按需激活入口,native 档才有
PTC 增强 ops_batch / ops_result(+ 0.5.x 的 ops_load_sdk)—— 一次调用完成跨文件的复制/移动/删除(先 plan 再执行),大结果分页引用。仅纯 PTC 档队员(预设 ptc + 打开「批量调用」)拿得到;Lead 与原生档队员按 ops 的设计拿不到

三点如实说明:

  • ops_batch/ops_result 要纯 PTC 档才有:dsh-ops 的 PTC 组件按自己的设计只把这两个工具 给纯 PTC 呈现档的作用域。本包不改 dsh-ops 一行源码,用已有的配置就能拿到:把该角色的 预设设为 ptc 并打开它的「批量调用」开关(见上文配置页),那名队员就是纯 PTC 档, ops 自己会把这两个工具给他(可在 run_code 程序里调用)。 注意方向:2026-10-21 起这个开关的语义是「开 = 钉 ptc 档 / 关 = 钉 native 档」 (宿主已删掉 both 档)。所以「关掉批量」恰恰会把它变成原生档、拿不到这两个工具 —— 那是 both 还在时的老杠杆,已不适用。关掉批量时其余 ops 工具照常可用,不影响任何功能。
  • 没装 dsh-ops 的用户零影响:不注册任何提示词、不多一个字节,插件页也不会出现 ops 组件。
  • 状态可查:~/.dsh/dispatch-agent-team-status.json 的 opsIntegration 字段记录组件的挂载事实、 当前可见的 ops_* 清单,以及(仅当某名纯 PTC 档队员看不到 ops_batch/ops_result 时)一句点名修法。 两代行名都认:0.3.x 的 dsh-ops-shell/file/background/ptc 与 0.5.x 的 dsh-ops-mode-* / dsh-ops-discovery。 注意 node tools/ops-enable.cjs 只管旧四行(老版本才有对应 insert);0.5.x 上它会如实说明 那四行已不再是开关载体,别照着它去插件页找不存在的开关。

想在老版本 dsh-ops 上把四个组件都开(含它默认关着的 background 与 PTC): node tools/ops-enable.cjs 后重启 DSH;--check 只看不改,--prune 只清死配置, --revert 删掉本工具管过的全部行回到 dsh-ops 自带默认。 0.5.x 上这四行已不再是开关载体(上游不再 insert 它们),此时该命令的职责是清理,不是启用: 跑一次会把 profile 里那些孤儿覆盖连同它们的注释块一起删掉。

卸载

node tools/install.cjs --uninstall          # 推荐:走官方 CLI(先退出桌面端)
  • 界面卸载:插件 → 已安装 → 调度模式智能体团队 → 卸载。
  • 卸载后把推理模式选择器里的默认 preset 换回你原来的那个。
  • 界面卸载或应急摘除不会自动回收 profile 层那段托管块(tool-agent-team: disabled + agent-team 容量覆盖),需要自己补一次:node tools/repair.cjs --revert(幂等)。
  • 角色配置与会话记忆文件会留在 ~/.dsh/ 下,可以手动删。
  • DSH 起不来时的应急路径:node tools/emergency-disable.cjs(把本插件从 bundles 里摘掉)。

维护

改完代码、以及每次官方升级 DSH 之后,建议跑一遍(全部只读):

node tools/selftest.cjs           # 纯逻辑回归(零 dsh 依赖)
node tools/drift-check.cjs        # 官方实现假设校验(升级后必跑)
node tools/integration-test.cjs   # 真链路集成测试
node tools/client-smoke-test.cjs  # 浏览器半渲染冒烟
node tools/repair.cjs             # 安装状态体检(bundles / junction / 文件齐全)

注意:除 client-smoke-test 外,其余脚本都需要先有安装期那个依赖 junction (也就是跑过 repair.cjs --apply),否则会报 ERR_MODULE_NOT_FOUND —— 那是「还没装好」,不是插件坏了。

还有三个只读探针,排查问题时很有用:

node tools/session-probe.cjs --tools --session <会话子串>          # 会话里团队工具面的真实增删
node tools/asar-probe.cjs --grep "<字符串>" --list "dsh-llm/lib"   # 官方安装包里到底有没有这个东西
node tools/cache-prefix-audit.cjs                                  # 缓存命中率:① 实测(读会话日志的 usage)② 前缀复用模型(定位断裂点)
node tools/cache-prefix-audit.cjs --all --tail 200                 # 连非本插件的会话一起看

开发者文档

实现契约、精确的 API 签名与官方行为实测记录(agent/request waterfall 形状、ctx.webServer.register、 plugins.bundle.config 槽位契约、以及一份逐条标注「原文哪里错了」的勘误表)都在 INTERFACES.md。改这个插件之前先读它。

设计取舍与历史事故(为什么这样切缓存、为什么必须关掉官方同名工具行、 两道容量帽分别是什么、历次故障的根因与修法)不在本文件里 —— 那些属于维护者笔记, 按本仓库约定不进版本库(见 .gitignore)。README 只讲怎么用。

许可

MIT

—/ 5

No ratings yet

Manifest verification required

Commit b2aa705898d6

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