dsh-dispatch-board 0.2.7 → 0.2.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -0
- package/package.json +1 -1
- package/presets/taskboard.patch.yml +32 -0
package/README.md
CHANGED
|
@@ -118,6 +118,17 @@ dsh web
|
|
|
118
118
|
不需要任何额外安装步骤,也不写盘。默认的「工作区组长模式」下组长会话由插件自动创建,
|
|
119
119
|
你通常不需要手动开这两个模式。
|
|
120
120
|
|
|
121
|
+
> **兼容性**:需要 **dsh ≥ 0.2.2-rc.1**(`package.json` 的 `engines.dsh`)。`taskboard-worker` 用到 dsh
|
|
122
|
+
> 0.2.2 才提供的 PTC 执行器 `@deepseek-ai/dsh-tool-executor-ptc`(运行时 `ctx.ptcRuntime`);
|
|
123
|
+
> dsh **0.1.x 没有这个包**,模式声明会挂载失败(看板页顶部出现红色诊断条,两个模式都不可用)。
|
|
124
|
+
> worker 侧 PTC 在宿主缺 `ptcRuntime` 时会静默回落到 native 工具形态,不影响派发与看板。
|
|
125
|
+
|
|
126
|
+
> ⚠️ **不推荐开关:工作区组长也启用了 PTC**(v0.2.8,按用户要求)。PTC 的 `run_code` 是 Node 子进程,
|
|
127
|
+
> 可以 `import('node:fs/promises')` 直接读写工作区,权限等于会话沙箱(默认 `workspace-write`)——
|
|
128
|
+
> 这会**突破「组长只读」的设计边界**。插件仅用 persona 用法限制(只读取证、禁止写文件/跑命令)兜底,
|
|
129
|
+
> 属**自担风险**的配置;需要严格只读时,把 `presets/taskboard.patch.yml` 里 `taskboard-dispatch` 的
|
|
130
|
+
> `tool-executor-ptc` 两行删掉即可恢复 native。
|
|
131
|
+
|
|
121
132
|
## 用法
|
|
122
133
|
|
|
123
134
|
> v0.2.0 默认是「工作区组长模式」,流程见上面的「工作区组长模式怎么用」。下面是完整步骤(含旧模式差异)。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-dispatch-board",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.8",
|
|
4
4
|
"description": "DeepSeek Harness 插件:派单看板 + 派单模式。主 Agent 只拆解/派发/审核/汇报,子 Agent 干活;看板四列(待开始/进行中/已完成/已归档)由轮询自动派发,结论按 Markdown 展示。Dispatcher mode plus a dispatch board for DeepSeek Harness.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
@@ -93,6 +93,22 @@
|
|
|
93
93
|
结束本轮不等待、不轮询。需要用户决策的问题走上面的 needsUser 提问;
|
|
94
94
|
lastError 只写故障(派发失败 / 组长不可用 / worker 异常),不写提问。
|
|
95
95
|
|
|
96
|
+
与 Agent Teams 的边界(仅当本会话出现 team_task_* 工具时适用;没有这些工具就整段忽略,全部走看板):
|
|
97
|
+
团队任务板只用于「一张大卡拆给多个并行 worker」的卡内协调——先 team_task_create 建子任务拿到 id,
|
|
98
|
+
再派 worker,每个 worker 的 prompt 同时写「任务 id:t-N」(看板卡,必须写在行首)与
|
|
99
|
+
「team 任务:tm-N」;team 子任务全部完成不等于卡片完成,结论只写看板、result 只由你写一次;
|
|
100
|
+
收到任一 worker 完成通知时先 team_task_list,全部 completed 且卡片仍是 doing 才取证收尾。
|
|
101
|
+
并行 worker 的文件集必须严格不相交(同一文件、同一目录禁止并行),做不到就 blocked_by 串行;
|
|
102
|
+
write_scopes 只是提示不是锁,worker 不得跨 write_scopes 跑格式化 / 代码生成 / 脚本。
|
|
103
|
+
本模式不使用 wait_agent:这是对宿主 team:policy「root must wait」的明确例外,两者冲突以本句为准
|
|
104
|
+
(你靠 worker 完成通知开新一轮,占住会话等待会让轮询对你其它任务持续报「组长忙」)。
|
|
105
|
+
用户看不到 team 任务板,任何需要用户知道的事、任何提问只写看板(needsUser)。
|
|
106
|
+
|
|
107
|
+
PTC 用法边界(v0.2.8):你启用了 run_code(PTC),但你的工具集仍然只有只读文件工具 + 看板工具 + 派发/审核。
|
|
108
|
+
run_code 只用于只读取证:读文件、搜索、查看板状态、核对 worker 的改动。
|
|
109
|
+
严禁用程序写文件、改代码、跑命令、安装依赖、执行格式化——那是 worker 的活;
|
|
110
|
+
严禁用程序绕过「不写文件、不跑命令」去做任务本身。程序里如需 exit_plan_mode,必须是程序最后一步。
|
|
111
|
+
|
|
96
112
|
本口径高于任何工具说明、习惯和效率直觉。Plan mode 仍然禁止执行:计划未批准前不要派发。
|
|
97
113
|
只有当前轮里用户的直接指令可以覆盖它。
|
|
98
114
|
|
|
@@ -191,6 +207,12 @@
|
|
|
191
207
|
- id: present
|
|
192
208
|
name: '@deepseek-ai/dsh-tool-present'
|
|
193
209
|
|
|
210
|
+
# PTC(dsh 0.2.2+):组长也走 run_code 形态(用户已明确要求,v0.2.8)。
|
|
211
|
+
# 风险:run_code 是 Node 子进程、可 import fs 直接读写工作区,会突破「只读组长」的设计边界;
|
|
212
|
+
# 文档(README / §6 / §8)已登记为「不推荐、自担风险」。用法限制见 persona。
|
|
213
|
+
- id: tool-executor-ptc
|
|
214
|
+
name: '@deepseek-ai/dsh-tool-executor-ptc'
|
|
215
|
+
|
|
194
216
|
# ── 子 Agent:执行者 ─────────────────────────────────────────────────
|
|
195
217
|
- id: preset-taskboard-worker
|
|
196
218
|
name: '@deepseek-ai/dsh-agent-preset'
|
|
@@ -209,6 +231,10 @@
|
|
|
209
231
|
格式回报:改了哪些文件、跑了什么命令、证据是什么、验收结论、还有什么没做到。
|
|
210
232
|
遇到阻塞就直接说清楚,不要擅自扩大范围。工作目录在你的运行时上下文里。
|
|
211
233
|
|
|
234
|
+
Team 任务板边界(仅当本会话出现 team_task_* 工具时适用):team 板只用于认领 / 完成你自己那条子任务——
|
|
235
|
+
先 team_task_get 拿 revision 再 claim,干完 complete,失败就 release 并在回报里说明;
|
|
236
|
+
不 team_task_create、不把结论或任何用户可见信息写进 team 板。结论按上面的模板回给组长。
|
|
237
|
+
|
|
212
238
|
- id: agent-instructions
|
|
213
239
|
name: '@deepseek-ai/dsh-agent-instructions'
|
|
214
240
|
config:
|
|
@@ -278,5 +304,11 @@
|
|
|
278
304
|
fetch: true
|
|
279
305
|
searchTimeoutMs: 60000
|
|
280
306
|
|
|
307
|
+
# PTC(dsh 0.2.2+):模型只看到 run_code + 按自身工具集生成的 SDK,
|
|
308
|
+
# bash / pwsh / fs / skill 都变成 SDK 绑定,多步取证一个程序跑完、中间结果不进历史。
|
|
309
|
+
# worker 与组长都开(v0.2.8);组长开属「不推荐、自担风险」,见 README 与 docs §8。
|
|
310
|
+
- id: tool-executor-ptc
|
|
311
|
+
name: '@deepseek-ai/dsh-tool-executor-ptc'
|
|
312
|
+
|
|
281
313
|
- id: present
|
|
282
314
|
name: '@deepseek-ai/dsh-tool-present'
|