- Home
- Plugins
- Workflow & Automation
- dsh-dispatch-board
dsh-dispatch-board
duanxiangchun/dsh-dispatch-board
DeepSeek Harness 插件:派单看板 + 派单模式。主 Agent 只拆解/派发/审核/汇报,子 Agent 干活;看板四列(待开始/进行中/已完成/已归档)由轮询自动派发,结论按 Markdown 展示。Dispatcher mode plus a dispatch board for DeepSeek Harness.
Install
dsh plugin --profile web add github:duanxiangchun/dsh-dispatch-boardREADME
dsh-dispatch-board —— 任务看板 + 工作区组长模式
给 DeepSeek Harness(dsh)用的插件,解决一个具体问题:
包名:
dsh-dispatch-board(npm / GitHub 同名)。内部运行时标识仍是taskboard(存储目录~/.dsh/storages/dsh-taskboard/、RPC 路由/taskboard、预设 idtaskboard-*、工具taskboard_*),这样老安装和已有看板数据不会失效。
你只管和主会话说话,活由工作区组长派给 worker 干。 v0.2.0 起默认「工作区组长模式」: 你绑定一个主会话(普通对话),在看板加任务;插件按工作区自动找 / 建常驻工作区组长, 组长派 worker 子 Agent 干活、审核并把结论写回看板;任务完成后插件把「【任务看板 · 汇报】」 回执推给主会话,由它向你汇总。看板是唯一事实源与汇报通道,你只负责看结论和归档。
工作区组长模式怎么用(v0.2.0 默认)
v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务新建会话。默认链路是:
- 绑定主会话:用你平时对话的那个普通会话打开看板(会话 header「任务看板」按钮,或左侧栏「任务看板」)。 看板头部「组长条」显示「未绑定主会话」,点「把当前对话设为主会话」。之后这条会话就是总控: 加任务、看进度、收完成回执都由它承担。点「打开」跳回主会话,「换绑」把当前会话换成主会话。
- 在看板加任务:右栏看板默认绑定当前工作区;左侧「任务看板(全部工作区)」可以选任意工作区。
任务加进「待开始」即可。你也可以直接对主会话说「把 XX 加进看板」,它用
taskboard_add加 (跨工作区时带workspace参数)。 - 组长自动派发:插件每 15s 扫「待开始」,按任务工作区找到 / 创建该工作区的常驻工作区组长,
把任务投给它;组长先把任务置「进行中」,再用
subagent派一个 worker 后台干活。- 一个工作区只有一个组长,任务不会挤进别的对话,也不会每个任务新建一个会话;
- 组长忙时任务留「待开始」,下一轮再试;
- 组长不可用(被关掉 / 唤起失败)时任务留「待开始」并提示,点组长条的「创建组长」可以修复;
- 组长会话被归档时不用手动处理:下次轮询会自动摘除旧映射、重建组长,并把该组长名下 「进行中」的任务重新排队;组长条会显示「已归档」+「创建组长」。主会话被归档则回执暂停,换绑即可。
- 没绑定主会话也能跑,只是任务完成后没人给你汇总回执。
- 审核 + 完成回执:worker 干完会把完成通知送回组长;组长对工作区取证审核(读文件、对照验收标准),
通过后把任务置「已完成」并把结论写进
result(Markdown),不通过就带着意见打回同一个 worker。 任务一旦done,插件会在主会话空闲时把一批完成结果合并成一条 「【任务看板 · 汇报】…」消息推给主会话;主会话据此向你汇总。主会话正忙就等下一轮,不会丢。 - 你做什么:看结论、点归档;要追加需求就继续对主会话说,或往看板加任务。 「派发到」下拉默认就是「工作区组长」;要旧行为(每任务新开对话 / 回发起对话 / 任挑空闲会话)时才切换。
界面
两个看板,同一份数据:
1) 本工作区看板(右侧栏)
- 会话 header 右侧的「任务看板」图标按钮(带本工作区待开始角标)→ 右侧栏打开「任务看板」tab; 右栏引导页里也有入口卡片。右栏 tab 的关闭按钮只在悬停或键盘聚焦时显示(v0.2.0 起对看板 tab 收紧, 避免非激活 tab 上常驻一个关闭按钮;关闭按钮由 dsh 的右栏 chrome 渲染,插件只对看板 tab 做了作用域内样式覆盖)。
- 组长条(v0.2.0):看板头部显示主会话与工作区组长——
- 未绑定主会话 → 「把当前对话设为主会话」按钮;已绑定 → 主会话标题 + 在线 / 忙 / 离线状态点 + 「打开」(跳到主会话)/「换绑」;
- 当前看板涉及的工作区组长:
组长 · <工作区名>+ 状态点 + 「打开」;还没有组长时显示「创建组长」。
- 只显示当前对话所属工作区的任务;副标题带工作区名。
- 布局随右栏宽度自适应:窄栏 → 四个状态纵向 lane;≥560px → 两列网格;全屏/≥900px → 四列看板。
- 「待开始」列可以自己加任务(标题 + 备注/验收标准);从哪个对话加的,任务会记录那个对话与工作区 (默认模式下由该工作区的组长执行,不再回到原对话);卡片只显示标题 + 操作按钮,工作区、备注等信息在详情浮层;
- 卡片按钮:详情 / 开始 / 立即派发 / 完成 / 打回 / 归档 / 重新打开 / 编辑 / 删除, 有关联会话时还有「对话」——一键跳到发起/执行这条任务的那个对话(详情里也有「发起对话 / 执行对话」; 旧任务没记录执行会话时,进行中的那条会用「最近派发」兜底显示「执行对话」); 点卡片标题(或「详情」)看完整详情:完整结论、备注、创建/开始/完成时间、工作区、组长 / 执行者, 还能在浮层里直接改状态;
- 视觉:macOS / iOS 风格皮肤——灰色画布 + 白色卡片、发丝分隔线、胶囊按钮、系统字体、柔和阴影,深色模式自动跟随宿主主题;窗口变窄时四列自动降成两列 / 一列;
- 顶部:轮询开关、轮询间隔(5s / 15s / 30s / 60s)、派发到(工作区组长(默认)/ 新对话 / 回发起对话 / 空闲会话)、一键归档已完成、立即刷新;
- 工作区组长(默认,v0.2.0):按任务工作区投给该工作区的常驻组长(见「工作区组长模式怎么用」);
- 新对话:在任务所属工作区新建一个派单模式对话(旧行为,兼容);
- 回发起对话:派回创建这条任务的那个对话(旧行为,兼容);
- 空闲会话:忽略来源,自动挑一个空闲会话(旧行为,兼容)。
- 宽栏底部显示数据文件路径(本机持久化,不随会话结束丢失)。
2) 任务看板(左侧栏,全部工作区)
- 左侧栏多一个「任务看板」面板图标(带 全部待开始+进行中 的数量角标)。
- 整页显示全平台所有工作区的任务;顶部有工作区过滤(全部 / 单个,会记住上次的选择,刷新页面 / 重启后自动恢复),卡片显示标题 + 一行工作区标签 + 操作按钮,备注 / 结论等其余信息仍在详情浮层里看。
- 工作区标签(v0.2.4):卡片标题与操作行之间一行小字,文本优先取工作区
title;工作区未注册 /title为空时回退目录名(cwd路径尾段),任务没有cwd显示—。标签只加在平台看板 (第五列「待你处理」的卡片同样有);右栏会话看板不重复显示,工作区只在详情浮层里看(右栏整块看板 本来就绑定单个工作区)。 - 头部同样有「派发到」选择器与组长条(全部工作区组长列表;缺失时可「创建组长」)。
- 新建任务必须选工作区(下拉来自 DSH 的工作区列表,会记住上次选的工作区,刷新页面 / 去别的会话再点回来都会自动恢复;与顶部过滤器各自记忆、互不串值):默认模式下任务投给该工作区的常驻组长; 旧模式下优先找那个工作区里打开的会话执行,找不到就停在待开始并提示(不会跑到别的工作区干活); 急着处理可以点「立即派发」改派。
- 两个内置模式:插件包自带
taskboard-dispatch(工作区组长)与taskboard-worker(执行者)声明, 不写盘、不需要额外安装步骤。v0.2.0 起组长会话由插件按工作区自动创建,通常不需要手动选模式; 想手动体验时仍可在模式选择器里选「任务看板 · 工作区组长(自动)」(= 工作区组长口径,不写文件、不跑命令,一切派给子 Agent;手动选的会话不会被自动接进看板,日常交给插件自动创建即可)。
npm 安装
dsh plugin --profile web add dsh-dispatch-board
npm: https://www.npmjs.com/package/dsh-dispatch-board · npm 发布与 GitHub Release 都由 tag v* 触发流水线自动完成(仓库 Secret NPM_TOKEN,无需人工 2FA / staged 批准)。
安装
# 1) 装进你的 profile(web 是 `dsh web` 默认用的那个)
dsh plugin --profile web add C:\Users\duan\Code\dsh-taskboard
# 2) 重启 web 服务(Host 半需要重新加载)
dsh web
# 3) 浏览器刷新 http://127.0.0.1:3080 —— 左侧栏出现「任务看板」、会话 header 右侧出现「任务看板」按钮
也可以用 GUI 的插件管理器安装本地包(等价于把包 link 进 profile)。 卸载:
dsh plugin --profile web remove dsh-dispatch-board。
「任务看板 · 工作区组长(自动)」(taskboard-dispatch,原名「派单看板模式」,v0.2.0 起按「工作区组长」口径工作)与
「任务看板 · 执行者(自动派发)」(taskboard-worker)由插件包自带的 presets/taskboard.patch.yml 声明
(dsh 0.2.2 起 preset 是 bundle patch 里的 @deepseek-ai/dsh-agent-preset 行,不是
~/.dsh/.agent-presets 目录)。装好插件、重启 dsh web、刷新页面后,模式选择器里就会出现这两个模式:
- 任务看板 · 工作区组长(自动)(工作区组长:只处理本工作区任务,派 worker、审核、写回看板)
- 任务看板 · 执行者(自动派发)(子 Agent 专用:完整执行工具集)
不需要任何额外安装步骤,也不写盘。默认的「工作区组长模式」下组长会话由插件自动创建, 你通常不需要手动开这两个模式。
兼容性:需要 dsh ≥ 0.2.2-rc.1(
package.json的engines.dsh)。taskboard-worker用到 dsh 0.2.2 才提供的 PTC 执行器@deepseek-ai/dsh-tool-executor-ptc(运行时ctx.ptcRuntime); dsh 0.1.x 没有这个包,模式声明会挂载失败(看板页顶部出现红色诊断条,两个模式都不可用)。 worker 侧 PTC 在宿主缺ptcRuntime时会静默回落到 native 工具形态,不影响派发与看板。
⚠️ 不推荐开关:工作区组长也启用了 PTC(v0.2.8,按用户要求)。PTC 的
run_code是 Node 子进程, 可以import('node:fs/promises')直接读写工作区,权限等于会话沙箱(默认workspace-write)—— 这会突破「组长只读」的设计边界。插件仅用 persona 用法限制(只读取证、禁止写文件/跑命令)兜底, 属自担风险的配置;需要严格只读时,把presets/taskboard.patch.yml里taskboard-dispatch的tool-executor-ptc两行删掉即可恢复 native。
用法
v0.2.0 默认是「工作区组长模式」,流程见上面的「工作区组长模式怎么用」。下面是完整步骤(含旧模式差异)。
- 绑定主会话:用平时的普通会话打开看板,在组长条点「把当前对话设为主会话」。 换绑 = 再点一次「换绑」;一个看板对应一个主会话。
- 加任务:点会话 header 的「任务看板」按钮打开右侧栏 → 在「待开始」区输入任务标题(可加备注写验收标准),回车。
- 右栏看板默认绑定当前对话的工作区;左侧「任务看板(全部工作区)」新建时必须选工作区;
- 也可以直接对主会话说「把 XX 加进看板」,它用
taskboard_add加(跨工作区时带workspace); - 老版本「任务会回到本对话执行」的语义只在旧模式下成立。
2b. 跨工作区派活:主会话
taskboard_add {title, note, workspace},或在左侧看板新建时选工作区。 任务归属由工作区(cwd)决定,默认模式下会投给该工作区的组长。
- 组长自动派发:宿主每 15s 轮询一次「待开始」,按任务工作区找到 / 创建常驻组长并投递
【任务看板 · 待开始】t-3 …;组长先把任务改成「进行中」,再派 worker 子 Agent 后台干活, 自己结束本轮(不占对话)。一个工作区只有一个组长,不会每个任务新建会话。 派发前强制建卡:宿主在 worker 启动前认领 / 新建看板卡片,卡片写不进board.json时会拒绝派发 (worker 不会启动),不会出现「派了活但看板看不到」。 - 审核 + 完成回执:worker 完成后,运行时把完成通知送回组长;组长对工作区取证审核:
- 通过 → 看板任务变「已完成」,
result里是结论;插件在主会话空闲时把一批结果合并成 「【任务看板 · 汇报】…」推给主会话,主会话向你汇总; - 不通过 → 带着修改意见打回同一个 worker 重做,任务保持「进行中」。
- 通过 → 看板任务变「已完成」,
- 归档:你点「归档」,或顶部「全部归档」,任务进「已归档」列,不再参与轮询。
- 旧模式:看板顶部「派发到」切到「新对话 / 回发起对话 / 空闲会话」即回到 v0.1.x 的行为 (每任务新开对话 / 派回发起对话 / 挑空闲会话,由那个会话的主 Agent 自己派子 Agent)。
轮询规则(为什么它不会烦到你)
工作区组长模式(默认)
- 按任务工作区路由到该工作区的常驻组长,不会每任务新建会话、也不跨工作区改派;
- 派发前强制建卡:组长每次
subagent派发都先认领 / 新建看板卡片(直聊派活也会自动出现doing卡片);建卡写盘失败 → 派发被拒绝、worker 不启动,不会出现「worker 在跑、看板没记录」; - 组长忙 → 任务留在「待开始」等下一轮;组长离线 / 唤醒失败 → 跳过并提示「工作区组长不可用」 (点组长条的「创建组长」可修复);
- 只在组长会话空闲(idle)时投递;投递成功即自动置「进行中」;
- 所有工作区共用一个轮询,每轮全局最多投递 1 条任务(多工作区轮流服务);
- 同一个任务两次提醒之间至少等
2 × 轮询间隔(最长 120s),最多提醒 5 次, 超过后不再自动提醒,任务留在「待开始」等你手动处理; - 顶部可以随时暂停轮询;「立即派发」跳过等待(组长忙时排进它的下一轮)。
旧模式(new / creator / auto)
- 任务优先派回创建它的对话(工作区绑定);平台看板的任务优先派给同工作区的空闲会话;
- 目标会话忙/该工作区没有打开的会话时会等(不跨工作区偷偷执行),只有「立即派发」才允许改派;
- 一次轮询逐条试任务,某个任务的目标会话正忙不会挡住其它任务。
数据与文件
| 内容 | 路径 |
|---|---|
| 看板数据 | $DSH_HOME/storages/dsh-taskboard/board.json(原子写,坏文件自动备份) |
| 模式声明 | 插件包内 presets/taskboard.patch.yml(随 bundle 加载,不写 $DSH_HOME) |
另外 board.json 的 config 里还存主会话绑定(mainSessionId / mainSessionTitle)与工作区组长映射
(workspaceLeads,最多 32 条);任务上有 reportedAt 记录完成回执是否已推送给主会话。
这些字段都由插件维护,不需要手工编辑。
$DSH_HOME 默认 ~/.dsh(Windows:C:\Users\<你>\.dsh)。
想改模式行为(persona、工具集)就直接改 presets/taskboard.patch.yml 再重启;看板页会在模式
挂载失败时显示红色诊断条(agentPresets.list() 的 broken 原文)。
给模型用的工具
插件在宿主级注册了三个工具,所有模式都能用:
| 工具 | 用途 |
|---|---|
taskboard_list | 列出看板任务(可只看某个状态),派单前确认、审核时对照 |
taskboard_add | 往「待开始」加任务(用户口述需求、主 Agent 拆出的后续任务);可选 workspace(id / 名称 / 路径)指定任意工作区 |
taskboard_update | 改状态(doing / done / todo / archived)、写 result / assignee / note |
排障
- 会话 header 没有「任务看板」按钮:确认部署里有右侧栏(
@deepseek-ai/dsh-client-ui-sidebar-right, web-app 自带);再确认dsh plugin --profile web list里有dsh-dispatch-board,重启dsh web后刷新页面。 浏览器控制台若有dsh.client相关报错,说明lib/client.js没被识别(检查exports["./client"])。 - 点了按钮右栏没出现看板:看 console 的
[dsh-dispatch-board]警告——通常是右栏服务不可用; 也可以直接点右栏 tab 条上的 + 从引导页里选「任务看板」。 - 加了任务但没派发:看页面顶部的跳过原因—— 「没有在线的会话」表示当前没有打开的会话;「目标会话正在运行」表示组长 / 主 Agent 正忙; 「轮询已暂停」就点恢复。也可以对任务点「立即派发」跳过等待。
- 任务完成了但没人向我汇报:看板头部组长条是否显示「未绑定主会话」——点「把当前对话设为主会话」; 主会话要在线且空闲才会收到「【任务看板 · 汇报】」回执,忙的时候等下一轮补投。
- 任务一直停在待开始、详情里提示「工作区组长不可用」:组长会话被关掉或唤醒失败。点组长条的 「创建组长」修复;也可以对任务点「立即派发」重试。
- 升级后不再每个任务新开对话了:v0.2.0 默认
dispatchMode='workspace-lead',这是预期行为; 要回旧行为在看板顶部「派发到」切到「新对话 / 回发起对话 / 空闲会话」。 - 模式选择器里没有「任务看板 · 工作区组长(自动)」:确认插件已装进当前 profile(
dsh plugin --profile <name> list) 并重启了dsh web;看板页顶部若出现红色「任务看板 · 工作区组长(自动)加载失败:…」就是某个预设行配置有误, 照着broken原文改presets/taskboard.patch.yml(常见:删了必填 config)。 - 主 Agent 还是自己干活:默认(工作区组长)模式下任务由组长派 worker 执行;只有旧模式下才会派给主 Agent。 若你手动选了「任务看板 · 工作区组长(自动)」对话,它按工作区组长口径工作(不写文件、不跑命令、不直接面向用户),但不会被自动接进看板,日常交给插件自动创建即可。
- 点了「归档 / 删除 / 开始 / 完成」没反应:0.1.0 修过一个客户端 bug(卡片按钮回调里的变量遮蔽,
点击直接抛异常)。升级到当前版本并重启
dsh web+ 刷新页面即可。删除现在是行内二次确认 (第一次点变「确认删除」,再点才真删),不再依赖浏览器原生 confirm。 - 点了「归档」过一会儿又变回「已完成」:常见原因是同时开了两个 dsh 进程共用同一个
board.json(比如正式实例 + 一个测试实例),后写的整份内存状态会把先写的覆盖掉。 0.1.0 起读/写前都会比对revision、盘上更新就采用盘上状态;测试实例请用$env:DSH_TASKBOARD_PATH='C:\Users\<你>\.dsh-taskboard-test\board.json'单独隔离。 升级后需要重启一次dsh web(Host 半改动)再刷新页面。
开发
node --check lib\index.js
node --check lib\client.js
node --test
- 契约(RPC 端点 / 任务状态机 / 快照字段 / 模式声明):
docs/architecture.md - RPC 探针:
node .dev/verify-rpc.mjs http://127.0.0.1:3099(含错误分支;v0.2.0 起还会覆盖 bind-main-session / clear-main-session / ensure-workspace-lead) - 验证记录(自动化 + 端到端闭环证据):
docs/verification.md - 浏览器端调查(slot / RPC / 主题变量):
docs/client-notes.md - Host 端调查:
docs/host-notes.md - 预设调查:
docs/preset-notes.md
改 lib/client.js 后刷新浏览器即可(client bundle 走 HMR / 页面重载);
改 lib/index.js 需要重启 dsh web(Host 模块不热更)。
License
MIT
Related plugins
webnovel-writer
lingfengqaq/webnovel-writer
loopx (dsh-loopx-plugin)
loopx-project/loopx
ouroboros (dsh-plugin)
q00/ouroboros
loopx (dsh-loopx-plugin)
huangruiteng/loopx