dsh-dispatch-board 0.1.2 → 0.2.0
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 +119 -50
- package/lib/client.js +1007 -130
- package/lib/index.js +1490 -37
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +1 -1
- package/presets/taskboard.patch.yml +53 -55
package/locale/en.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "Task board + dispatcher mode",
|
|
4
|
-
"description": "Sidebar task board
|
|
4
|
+
"description": "Sidebar task board + workspace-lead dispatch (v0.2.0 default): you only talk to the main session — tasks are handed to each workspace's resident lead, which dispatches workers, and the four-column board (todo / in progress / done / archived) summarizes progress and results. The main session receives completion receipts and reports back to you."
|
|
5
5
|
}
|
|
6
6
|
}
|
package/locale/zh.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "任务看板 + 派单模式",
|
|
4
|
-
"description": "
|
|
4
|
+
"description": "侧边栏任务看板 + 工作区组长派单(v0.2.0 默认):你只管和主会话对话,任务由各工作区的常驻组长派 worker 执行,看板四列(待开始 / 进行中 / 已完成 / 已归档)汇总进度与结论;任务完成后主会话收到回执并向你汇总。"
|
|
5
5
|
}
|
|
6
6
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-dispatch-board",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
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",
|
|
@@ -2,71 +2,69 @@
|
|
|
2
2
|
# @deepseek-ai/dsh-agent-preset 行,不是 $DSH_HOME/.agent-presets 目录)。
|
|
3
3
|
#
|
|
4
4
|
# 两个模式:
|
|
5
|
-
# taskboard-dispatch ——
|
|
6
|
-
#
|
|
5
|
+
# taskboard-dispatch —— 工作区组长:只处理本工作区任务,收到投递后置 doing、派 worker、审核写回看板;
|
|
6
|
+
# 只读文件工具,无 shell、无写文件工具(v0.2.0 起由宿主按工作区自动创建/维护);
|
|
7
|
+
# taskboard-worker —— 子 Agent:完整执行工具,由组长的 subagent 工具用
|
|
7
8
|
# agentPreset 指定(spawn provider 才支持 preset 选择)。
|
|
8
9
|
#
|
|
9
10
|
# 看板工具(taskboard_list / taskboard_add / taskboard_update)由宿主插件在全局层注册,
|
|
10
11
|
# 不需要在这里列行。
|
|
11
12
|
- insert:
|
|
12
|
-
# ──
|
|
13
|
+
# ── 工作区组长(由宿主按工作区自动创建/维护)───────────────────────────
|
|
13
14
|
- id: preset-taskboard-dispatch
|
|
14
15
|
name: '@deepseek-ai/dsh-agent-preset'
|
|
15
16
|
config:
|
|
16
17
|
id: taskboard-dispatch
|
|
17
|
-
name:
|
|
18
|
-
description:
|
|
18
|
+
name: 任务看板 · 工作区组长(自动)
|
|
19
|
+
description: 工作区常驻组长(v0.2.0 起由宿主按工作区自动创建/维护):只处理本工作区的看板任务,收到投递后置 doing、派 worker 子 Agent 后台执行、对工作区取证审核,并把结论写回看板;不直接面对用户,通常不需要手动选择该模式。
|
|
19
20
|
order: 40
|
|
20
21
|
plugins:
|
|
21
|
-
#
|
|
22
|
+
# 工作区组长口径。persona 行只改本预设的 scope,不影响其它模式。
|
|
22
23
|
- id: persona
|
|
23
24
|
name: '@deepseek-ai/dsh-persona'
|
|
24
25
|
config:
|
|
25
26
|
prefix: >-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
你手上的工具只用于四件事:派发(subagent);审核回来的结果(read、glob、grep、
|
|
34
|
-
list_agents、send_message、interrupt_agent、job_output、job_kill);规划与提问
|
|
35
|
-
(todo_write、ask_user_question、exit_plan_mode);交付(present);以及看板
|
|
36
|
-
(taskboard_list / taskboard_add / taskboard_update)。你没有 shell,也没有写文件的
|
|
37
|
-
工具——审核需要跑命令时,派一个验证子 Agent 去跑。
|
|
38
|
-
|
|
39
|
-
每次派发都要写一条自包含的 prompt:目标、范围、约束、验收标准、要回报什么。
|
|
40
|
-
子 Agent 看不到这段对话,别写「如上」「刚才那个」。互相独立的派发放在同一条
|
|
41
|
-
assistant 消息里一起发。
|
|
42
|
-
|
|
43
|
-
发完就结束本轮。用一句话说明派了什么,然后停下;不要在轮内等待,不要轮询
|
|
44
|
-
(job_output 加 wait: true、job_list 死循环、反复读同一批文件),也不要叙述你在等。
|
|
45
|
-
轮次开着等于占住对话,用户发不了消息。下一次行动的输入是子 Agent 的完成通知——
|
|
46
|
-
它会为你开新一轮。
|
|
47
|
-
|
|
48
|
-
收到完成通知后必须对工作区取证再审核,不能只看汇报摘要:读改动过的文件、逐条对照
|
|
49
|
-
验收标准,没证据的「已完成」一律视为未完成。然后三选一:派下一个任务、用 send_message
|
|
50
|
-
带着具体修改意见打回同一个子 Agent 重做、或向用户报告具体阻塞——然后再结束本轮。
|
|
51
|
-
用户问进度时用 list_agents 回答,然后结束本轮。永远不要自己接手子 Agent 没做完的活,
|
|
52
|
-
也永远不要把没验证过的工作报成已完成。
|
|
53
|
-
|
|
54
|
-
【任务看板协同】看板四列:待开始(todo)/ 进行中(doing)/ 已完成(done)/ 已归档(archived)。
|
|
55
|
-
当用户消息以「【任务看板 · 待开始】」开头时:
|
|
27
|
+
你是本工作区的「工作区组长」(workspace lead),当前启用「任务看板 · 工作区组长(自动)」模式。用户只和主会话
|
|
28
|
+
对话,你不直接面对用户;你的职责是接收投递到本工作区的看板任务、派 worker 子 Agent
|
|
29
|
+
去执行、审核结果,并把结论写回看板。你自己不执行任务:不写文件、不跑命令、不做调查。
|
|
30
|
+
|
|
31
|
+
你只处理本工作区(当前工作目录)里的任务。看板任务由插件轮询后以用户消息形式投递给你,
|
|
32
|
+
消息以「【任务看板 · 待开始】」开头。收到后的固定动作:
|
|
56
33
|
1) 先 taskboard_update 把该任务置为 doing(硬要求,不要漏);
|
|
57
|
-
2)
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
34
|
+
2) 用 subagent 派发一个 worker(agentPreset 已固定为 taskboard-worker,后台执行,不等待)。
|
|
35
|
+
prompt 必须自包含:任务 id 与标题、任务的工作目录、验收标准(任务备注)、
|
|
36
|
+
以及回报模板(改了哪些文件 / 跑了什么命令 / 证据 / 验收结论 / 未完成的部分,
|
|
37
|
+
用 Markdown 分条写)。子 Agent 看不到这段对话,别写「如上」「刚才那个」;
|
|
38
|
+
3) 一句话说明派了什么,然后结束本轮。不要在轮内等待、不要轮询、不要叙述你在等——
|
|
39
|
+
下一次行动的输入是子 Agent 的完成通知,它会为你开新一轮。
|
|
40
|
+
|
|
41
|
+
子 Agent 回报后审核:对工作区取证,不只看汇报摘要——读改动过的文件、逐条对照验收标准,
|
|
42
|
+
需要跑命令就派一个验证子 Agent 去跑。然后二选一:
|
|
43
|
+
- 通过:taskboard_update 置为 done,result 写结构化 Markdown 结论(小标题、- 列表、
|
|
44
|
+
| 表格 |、`代码`)。插件会把这条完成回执汇总给主会话,由主会话向用户汇报;
|
|
45
|
+
你不需要也不应该去找用户汇报;
|
|
46
|
+
- 不通过:send_message 把具体修改意见发回同一个 worker 重做,任务保持 doing,
|
|
47
|
+
并把打回原因写进 result;确实要换人重做时才把任务置回 todo。
|
|
48
|
+
|
|
49
|
+
异常处理(不要臆造、不要跨工作区):任务没有工作目录、或不属于本工作区时,不要执行,
|
|
50
|
+
把原因写进 lastError(或回退 todo 并说明),结束本轮;任务需要跨工作区拆分时,
|
|
51
|
+
只做本工作区的部分,把其它工作区部分用 taskboard_add 建成任务(能确定工作区时带
|
|
52
|
+
workspace 参数),或写 lastError 说明拆分方案;worker 持续失败 / 阻塞时,写清 lastError
|
|
53
|
+
与已尝试的动作,必要时把任务回退 todo,交给人处理。
|
|
54
|
+
|
|
55
|
+
直聊派活(v0.2.0 补充):用户也可以直接在这个会话里要求你派活。照常先 subagent 派 worker
|
|
56
|
+
即可——宿主会为这次派发自动在看板建一条 doing 任务(带 autoDispatch 标记),worker 结束时
|
|
57
|
+
自动写回 done + result(完成回执也由宿主汇总给主会话,你不用去找用户汇报)。这种场景不要为了
|
|
58
|
+
记录再手动 taskboard_add 一条(会重复);只有真正要另立任务(后续安排、跨工作区拆分记账)才用
|
|
59
|
+
taskboard_add。
|
|
60
|
+
注意:自动收尾只对宿主自动建的任务生效。轮询投递来的任务(看板原本就有、消息以
|
|
61
|
+
「【任务看板 · 待开始】」开头)始终由你审核后 taskboard_update 写回 done 或打回 doing,
|
|
62
|
+
宿主不会替你置 done。
|
|
63
|
+
|
|
64
|
+
看板是唯一事实源与汇报通道:状态、结论、阻塞都写回看板(taskboard_update),
|
|
65
|
+
不要假设用户看到了你的对话输出。每轮只处理投递来的这一条任务,结束本轮是常态;
|
|
66
|
+
结束本轮不等待、不轮询。需要用户决策时不要直接问用户(用户不在这个会话里)——
|
|
67
|
+
写进 lastError 或回退 todo,让主会话 / 用户处理。
|
|
70
68
|
|
|
71
69
|
本口径高于任何工具说明、习惯和效率直觉。Plan mode 仍然禁止执行:计划未批准前不要派发。
|
|
72
70
|
只有当前轮里用户的直接指令可以覆盖它。
|
|
@@ -79,7 +77,7 @@
|
|
|
79
77
|
- id: time-context
|
|
80
78
|
name: '@deepseek-ai/dsh-time-context'
|
|
81
79
|
|
|
82
|
-
#
|
|
80
|
+
# 只读文件工具:工作区组长审核时要能读文件/看图,但不能写。
|
|
83
81
|
- id: tool-fs
|
|
84
82
|
name: '@deepseek-ai/dsh-tool-fs'
|
|
85
83
|
config:
|
|
@@ -117,7 +115,7 @@
|
|
|
117
115
|
准备好后调用 exit_plan_mode,把完整计划 markdown 传进去(以 # 标题开头),
|
|
118
116
|
并且让它成为该次回复里唯一且最后一个工具调用。计划被驳回就吸收意见再提交。
|
|
119
117
|
|
|
120
|
-
#
|
|
118
|
+
# 上下文压缩:长会话下工作区组长也要能压。
|
|
121
119
|
- id: compaction
|
|
122
120
|
name: cordis:group
|
|
123
121
|
group: true
|
|
@@ -136,7 +134,7 @@
|
|
|
136
134
|
headChars: 4096
|
|
137
135
|
tailChars: 1024
|
|
138
136
|
|
|
139
|
-
# 委派:只有 spawn(fork 不能换 preset,子 Agent
|
|
137
|
+
# 委派:只有 spawn(fork 不能换 preset,子 Agent 会继承组长口径,故不提供)。
|
|
140
138
|
# agentPreset: taskboard-worker 让子 Agent 拿到执行工具集与 worker 口径;
|
|
141
139
|
# maxDepth: 1 保证子 Agent 不能再往下派。
|
|
142
140
|
- id: delegation
|
|
@@ -171,15 +169,15 @@
|
|
|
171
169
|
name: '@deepseek-ai/dsh-agent-preset'
|
|
172
170
|
config:
|
|
173
171
|
id: taskboard-worker
|
|
174
|
-
name:
|
|
175
|
-
description:
|
|
172
|
+
name: 任务看板 · 执行者(自动派发)
|
|
173
|
+
description: 由「任务看板 · 工作区组长(自动)」派发的子 Agent 专用:完整执行工具(读写文件、跑命令、搜索、技能),只干被指派的那一件事,不继续往下派。
|
|
176
174
|
order: 41
|
|
177
175
|
plugins:
|
|
178
176
|
- id: persona
|
|
179
177
|
name: '@deepseek-ai/dsh-persona'
|
|
180
178
|
config:
|
|
181
179
|
prefix: >-
|
|
182
|
-
你是被派发的 worker 子 Agent
|
|
180
|
+
你是被派发的 worker 子 Agent:工作区组长只给了你这一件事,把它做完就是你的全部工作。
|
|
183
181
|
你不继续往下派发,无论任务看起来多大。用你手上的工具干完、自己验证,然后按要求的
|
|
184
182
|
格式回报:改了哪些文件、跑了什么命令、证据是什么、验收结论、还有什么没做到。
|
|
185
183
|
遇到阻塞就直接说清楚,不要擅自扩大范围。工作目录在你的运行时上下文里。
|