dsh-dispatch-board 0.3.0 → 0.3.3
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 +13 -9
- package/lib/index.js +220 -22
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +2 -2
- package/presets/taskboard.patch.yml +31 -9
package/README.md
CHANGED
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
|
|
7
7
|
> 包名:`dsh-dispatch-board`(npm / GitHub 同名)。内部运行时标识仍是 `taskboard`(存储目录 `~/.dsh/storages/dsh-taskboard/`、RPC 路由 `/taskboard`、预设 id `taskboard-*`、工具 `taskboard_*`),这样老安装和已有看板数据不会失效。
|
|
8
8
|
|
|
9
|
-
> **你只管和主会话说话,活由工作区组长派给 worker 干。**
|
|
9
|
+
> **你只管和主会话说话,活由工作区组长派给 worker 干。** 默认「工作区组长模式」:
|
|
10
10
|
> 你绑定一个主会话(普通对话),在看板加任务;插件按工作区自动找 / 建常驻工作区组长,
|
|
11
11
|
> 组长派 worker 子 Agent 干活、审核并把结论写回看板;任务完成后插件把「【任务看板 · 汇报】」
|
|
12
12
|
> 回执推给主会话,由它向你汇总。看板是唯一事实源与汇报通道,你只负责看结论和归档。
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## 工作区组长模式怎么用(默认)
|
|
15
15
|
|
|
16
16
|
v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务新建会话。默认链路是:
|
|
17
17
|
|
|
@@ -22,8 +22,12 @@ v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务
|
|
|
22
22
|
任务加进「待开始」即可。你也可以直接对主会话说「把 XX 加进看板」,它用 `taskboard_add` 加
|
|
23
23
|
(跨工作区时带 `workspace` 参数)。
|
|
24
24
|
3. **组长自动派发**:插件每 15s 扫「待开始」,按任务工作区找到 / 创建该工作区的**常驻工作区组长**,
|
|
25
|
-
|
|
25
|
+
把任务投给它;组长先把任务置「进行中」,再默认派一个 **worker** 后台干活(可拆任务见下)。
|
|
26
26
|
- 一个工作区只有一个组长,任务不会挤进别的对话,也不会每个任务新建一个会话;
|
|
27
|
+
- **谁当组长**:插件懒创建的组长,或该工作区里第一个派 worker 的派单模式会话。工作区没有组长 /
|
|
28
|
+
组长已归档时,你手动开的派单会话第一次派活就会被登记为组长;已有活组长不抢,只打开不派活不会接管(v0.3.2);
|
|
29
|
+
- **可拆任务**:组长可按写域拆成多个独立片,在同一轮 fan-out 多个 worker;写域不相交是硬条件,
|
|
30
|
+
全部完成后组长合并/验证再收尾。切片会各自出现在看板(宿主自动卡),最终以父卡结论为准(v0.3.3);
|
|
27
31
|
- 组长忙时任务留「待开始」,下一轮再试;
|
|
28
32
|
- 组长不可用(被关掉 / 唤起失败)时任务留「待开始」并提示,点组长条的「创建组长」可以修复;
|
|
29
33
|
- 组长会话**被归档**时不用手动处理:下次轮询会自动摘除旧映射、重建组长,并把该组长名下
|
|
@@ -60,7 +64,7 @@ v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务
|
|
|
60
64
|
还能在浮层里直接改状态;
|
|
61
65
|
- 视觉:macOS / iOS 风格皮肤——灰色画布 + 白色卡片、发丝分隔线、胶囊按钮、系统字体、柔和阴影,深色模式自动跟随宿主主题;窗口变窄时四列自动降成两列 / 一列;
|
|
62
66
|
- 顶部:轮询开关、轮询间隔(5s / 15s / 30s / 60s)、**派发到**(工作区组长(默认)/ 新对话 / 回发起对话 / 空闲会话)、一键归档已完成、立即刷新;
|
|
63
|
-
-
|
|
67
|
+
- **工作区组长(默认)**:按任务工作区投给该工作区的常驻组长(见「工作区组长模式怎么用」);
|
|
64
68
|
- **新对话**:在任务所属工作区新建一个派单模式对话(旧行为,兼容);
|
|
65
69
|
- **回发起对话**:派回创建这条任务的那个对话(旧行为,兼容);
|
|
66
70
|
- **空闲会话**:忽略来源,自动挑一个空闲会话(旧行为,兼容)。
|
|
@@ -81,8 +85,8 @@ v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务
|
|
|
81
85
|
旧模式下优先找那个工作区里打开的会话执行,找不到就停在待开始并提示(不会跑到别的工作区干活);
|
|
82
86
|
急着处理可以点「立即派发」改派。
|
|
83
87
|
- **两个内置模式**:插件包自带 `taskboard-dispatch`(工作区组长)与 `taskboard-worker`(执行者)声明,
|
|
84
|
-
|
|
85
|
-
想手动体验时仍可在模式选择器里选「任务看板 · 工作区组长(自动)」(= 工作区组长口径,不写文件、不跑命令,一切派给子 Agent
|
|
88
|
+
不写盘、不需要额外安装步骤。组长会话由插件按工作区自动创建,**通常不需要手动选模式**;
|
|
89
|
+
想手动体验时仍可在模式选择器里选「任务看板 · 工作区组长(自动)」(= 工作区组长口径,不写文件、不跑命令,一切派给子 Agent;工作区没有组长 / 组长已归档时,这个会话第一次派 worker 会被登记为组长,已有活组长不抢;只打开不派活不会自动接管)。
|
|
86
90
|
|
|
87
91
|
## npm 安装
|
|
88
92
|
|
|
@@ -131,7 +135,7 @@ dsh web
|
|
|
131
135
|
|
|
132
136
|
## 用法
|
|
133
137
|
|
|
134
|
-
>
|
|
138
|
+
> 默认是「工作区组长模式」,流程见上面的「工作区组长模式怎么用」。下面是完整步骤(含旧模式差异)。
|
|
135
139
|
|
|
136
140
|
1. **绑定主会话**:用平时的**普通会话**打开看板,在组长条点「把当前对话设为主会话」。
|
|
137
141
|
换绑 = 再点一次「换绑」;一个看板对应一个主会话。
|
|
@@ -217,13 +221,13 @@ dsh web
|
|
|
217
221
|
主会话要**在线且空闲**才会收到「【任务看板 · 汇报】」回执,忙的时候等下一轮补投。
|
|
218
222
|
- **任务一直停在待开始、详情里提示「工作区组长不可用」**:组长会话被关掉或唤醒失败。点组长条的
|
|
219
223
|
「创建组长」修复;也可以对任务点「立即派发」重试。
|
|
220
|
-
-
|
|
224
|
+
- **升级后不再每个任务新开对话了**:默认 `dispatchMode='workspace-lead'`,这是预期行为;
|
|
221
225
|
要回旧行为在看板顶部「派发到」切到「新对话 / 回发起对话 / 空闲会话」。
|
|
222
226
|
- **模式选择器里没有「任务看板 · 工作区组长(自动)」**:确认插件已装进当前 profile(`dsh plugin --profile <name> list`)
|
|
223
227
|
并重启了 `dsh web`;看板页顶部若出现红色「任务看板 · 工作区组长(自动)加载失败:…」就是某个预设行配置有误,
|
|
224
228
|
照着 `broken` 原文改 `presets/taskboard.patch.yml`(常见:删了必填 config)。
|
|
225
229
|
- **主 Agent 还是自己干活**:默认(工作区组长)模式下任务由组长派 worker 执行;只有旧模式下才会派给主 Agent。
|
|
226
|
-
若你手动选了「任务看板 ·
|
|
230
|
+
若你手动选了「任务看板 · 工作区组长(自动)」对话,它按工作区组长口径工作(不写文件、不跑命令、不直接面向用户),工作区没有组长 / 组长已归档时,它第一次派 worker 会被登记为组长,已有活组长不抢。
|
|
227
231
|
- **点了「归档 / 删除 / 开始 / 完成」没反应**:0.1.0 修过一个客户端 bug(卡片按钮回调里的变量遮蔽,
|
|
228
232
|
点击直接抛异常)。升级到当前版本并**重启 `dsh web` + 刷新页面**即可。删除现在是行内二次确认
|
|
229
233
|
(第一次点变「确认删除」,再点才真删),不再依赖浏览器原生 confirm。
|
package/lib/index.js
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
* set-config / archive-done / install-preset / bind-main-session / clear-main-session /
|
|
9
9
|
* set-workspace-filter / set-workspace-draft / ensure-workspace-lead / upload-attachment / attachment 等端点;
|
|
10
10
|
* 2. 持久化任务看板到 $DSH_HOME/storages/dsh-taskboard/board.json(原子写);
|
|
11
|
-
* 3.
|
|
11
|
+
* 3. 轮询「待开始」列(默认 workspace-lead 模式):按任务工作区复用/懒创建常驻工作区组长
|
|
12
12
|
* (taskboard-dispatch 预设),用 agent.followup() 推一条【任务看板 · 待开始】消息;
|
|
13
13
|
* 组长据此派 taskboard-worker 子 Agent 干活并审核写回(本插件不直接起子 Agent);
|
|
14
14
|
* 4. 任务 done 且未汇报时,把完成回执合并成【任务看板 · 汇报】推给主会话(config.mainSessionId);
|
|
@@ -1281,15 +1281,19 @@ export function archivedSessionIdSet(rt) {
|
|
|
1281
1281
|
/**
|
|
1282
1282
|
* 工作区组长会话失效(被归档)时,把它名下「进行中」的任务重排回待开始,
|
|
1283
1283
|
* 交给新组长重新接单;done / archived 任务不动。
|
|
1284
|
+
* @param {string} [exceptTaskId] 不重排的任务 id(接管新组长时正在派发的卡)
|
|
1284
1285
|
* @returns {number} 重排的任务数
|
|
1285
1286
|
*/
|
|
1286
|
-
export function requeueTasksOfLead(state, sessionId, now = Date.now()) {
|
|
1287
|
+
export function requeueTasksOfLead(state, sessionId, now = Date.now(), exceptTaskId = '') {
|
|
1287
1288
|
if (!state || !Array.isArray(state.tasks)) return 0
|
|
1288
1289
|
if (typeof sessionId !== 'string' || sessionId === '') return 0
|
|
1289
1290
|
const stamp = iso(now)
|
|
1291
|
+
const keepId = typeof exceptTaskId === 'string' ? exceptTaskId.trim() : ''
|
|
1290
1292
|
let requeued = 0
|
|
1291
1293
|
for (const task of state.tasks) {
|
|
1292
1294
|
if (!task || task.status !== 'doing' || task.dispatchedSessionId !== sessionId) continue
|
|
1295
|
+
// v0.3.2:接管新组长时,正在派发的这张卡不属于「旧组长的遗留任务」,不要打回 todo。
|
|
1296
|
+
if (keepId !== '' && task.id === keepId) continue
|
|
1293
1297
|
task.status = 'todo'
|
|
1294
1298
|
task.startedAt = null
|
|
1295
1299
|
task.finishedAt = null
|
|
@@ -1434,6 +1438,8 @@ export function buildDispatchText(task, now = Date.now()) {
|
|
|
1434
1438
|
lines.push(
|
|
1435
1439
|
'请按派单规则处理这条看板任务:先用 taskboard_update 把它置为 doing,' +
|
|
1436
1440
|
'再派发子 Agent 执行(背景执行,不要自己在对话里等),然后结束本轮。' +
|
|
1441
|
+
'如果这条任务可以拆成 ≥2 个写域不相交的独立片,按 persona 的 fan-out 规则一次派多个 worker;' +
|
|
1442
|
+
'切片 worker 的 prompt 不要出现父任务 id / 标题,也不要写行首任务 id。' +
|
|
1437
1443
|
'子 Agent 回报后审核:通过就 taskboard_update 置为 done 并把结论写进 result;' +
|
|
1438
1444
|
'不通过就 send_message 打回同一个子 Agent 重做,任务保持 doing。' +
|
|
1439
1445
|
'写 result 时用 Markdown(小标题、- 列表、| 表格 |、`代码`),看板详情浮层会按 Markdown 渲染,' +
|
|
@@ -2245,6 +2251,93 @@ function repairWorkspaceLeadMapping(rt, mapping, key, cwd, agent) {
|
|
|
2245
2251
|
commitBoard(rt.state, rt.filePath)
|
|
2246
2252
|
}
|
|
2247
2253
|
|
|
2254
|
+
/**
|
|
2255
|
+
* v0.3.2:派单会话「接管」工作区组长(§1.5)。
|
|
2256
|
+
*
|
|
2257
|
+
* 触发:一个 `taskboard-dispatch` 会话在 `tools/pre-execute` 闸门成功准备卡片、即将启动 worker。
|
|
2258
|
+
* 规则(只有这两种情况才改写映射,绝不抢已有可用组长):
|
|
2259
|
+
* - 该工作区还没有组长映射;
|
|
2260
|
+
* - 已有映射的组长会话已被归档(视为失效:删映射、重排它名下 doing 任务)。
|
|
2261
|
+
* 接管后把当前会话写进 `config.workspaceLeads`——轮询下一轮就投给它,不再新建一个组长窗口。
|
|
2262
|
+
* 只让 root 会话当组长:dispatch 预设的子 Agent(罕见)不接管工作区。
|
|
2263
|
+
* @param {{taskId?:string}} [options] `taskId` = 正在派发的卡,从旧组长重排里排除并改绑到当前会话
|
|
2264
|
+
* @returns {{adopted:boolean, key?:string, reason?:string}}
|
|
2265
|
+
*/
|
|
2266
|
+
function adoptWorkspaceLead(rt, agent, args, options = {}, now = Date.now()) {
|
|
2267
|
+
try {
|
|
2268
|
+
const sessionId = agentSessionId(agent) || ''
|
|
2269
|
+
if (sessionId === '') return { adopted: false, reason: 'no-session' }
|
|
2270
|
+
// 子 Agent(delegationDepth > 0)不是 root:它可能带着 dispatch 预设,但不应成为工作区组长。
|
|
2271
|
+
try {
|
|
2272
|
+
const agents = serviceOf(rt.ctx, 'agents')
|
|
2273
|
+
const roots = agents && typeof agents.roots === 'function' ? agents.roots() : null
|
|
2274
|
+
if (Array.isArray(roots) && roots.length > 0) {
|
|
2275
|
+
// 按 session id 比较,避免 roots() 返回的对象与 exec.agent 不是同一个引用。
|
|
2276
|
+
const rootIds = new Set(
|
|
2277
|
+
roots.map((root) => agentSessionId(root)).filter((id) => typeof id === 'string' && id !== ''),
|
|
2278
|
+
)
|
|
2279
|
+
if (rootIds.size > 0 && !rootIds.has(sessionId)) return { adopted: false, reason: 'not-root' }
|
|
2280
|
+
}
|
|
2281
|
+
} catch {
|
|
2282
|
+
/* roots 不可用时放行(best-effort,不阻断派发) */
|
|
2283
|
+
}
|
|
2284
|
+
const rawCwd =
|
|
2285
|
+
sessionCwd(agent) || resolveSessionCwd(rt.ctx, sessionId) || (isPlainObject(args) ? asString(args.cwd) : '')
|
|
2286
|
+
if (rawCwd === '') return { adopted: false, reason: 'no-workspace' }
|
|
2287
|
+
const cwd = workspacePathForCwd(rt.ctx, rawCwd) || rawCwd
|
|
2288
|
+
const key = workspaceKeyForCwd(rt.ctx, cwd)
|
|
2289
|
+
if (key === '') return { adopted: false, reason: 'no-workspace' }
|
|
2290
|
+
reloadBoardIfStale(rt)
|
|
2291
|
+
const archived = archivedSessionIdSet(rt)
|
|
2292
|
+
// 当前会话自己已归档:不该接管(归档门通常会先拒绝它跑模型步进,这里再兜一层)。
|
|
2293
|
+
if (archived.has(sessionId)) return { adopted: false, reason: 'self-archived' }
|
|
2294
|
+
let config = normalizeConfig(rt.state.config)
|
|
2295
|
+
const mapping = selectWorkspaceLead(config, key)
|
|
2296
|
+
if (mapping && mapping.sessionId === sessionId) {
|
|
2297
|
+
// 已经是组长:顺手修掉空的 title / cwd,不改 sessionId。
|
|
2298
|
+
repairWorkspaceLeadMapping(rt, mapping, key, cwd, agent)
|
|
2299
|
+
return { adopted: false, reason: 'already-lead' }
|
|
2300
|
+
}
|
|
2301
|
+
if (mapping) {
|
|
2302
|
+
// 已有别的组长:只有它已归档(失效)才接管;活着的组长不抢。
|
|
2303
|
+
if (!archived.has(mapping.sessionId)) {
|
|
2304
|
+
return { adopted: false, reason: 'other-lead' }
|
|
2305
|
+
}
|
|
2306
|
+
dropWorkspaceLeadMapping(rt, key)
|
|
2307
|
+
requeueTasksOfLead(rt.state, mapping.sessionId, now, options.taskId || '')
|
|
2308
|
+
config = normalizeConfig(rt.state.config)
|
|
2309
|
+
console.warn('[taskboard] 工作区组长已归档,由派发会话接管:' + key + ' → ' + sessionId)
|
|
2310
|
+
}
|
|
2311
|
+
const entry = {
|
|
2312
|
+
sessionId,
|
|
2313
|
+
title: sessionTitle(agent),
|
|
2314
|
+
cwd,
|
|
2315
|
+
createdAt: iso(now),
|
|
2316
|
+
}
|
|
2317
|
+
config.workspaceLeads = putWorkspaceLead(config.workspaceLeads, key, entry)
|
|
2318
|
+
rt.state.config = config
|
|
2319
|
+
// 正在派发的卡:把「组长对话」改到当前会话(旧组长可能正是被归档的那个)。
|
|
2320
|
+
if (typeof options.taskId === 'string' && options.taskId !== '') {
|
|
2321
|
+
const task = taskById(rt.state, options.taskId)
|
|
2322
|
+
if (task) {
|
|
2323
|
+
task.dispatchedSessionId = sessionId
|
|
2324
|
+
task.dispatchedSessionTitle = sessionTitle(agent)
|
|
2325
|
+
task.updatedAt = iso(now)
|
|
2326
|
+
}
|
|
2327
|
+
}
|
|
2328
|
+
const saved = commitBoard(rt.state, rt.filePath)
|
|
2329
|
+
if (saved && saved.saved === false) {
|
|
2330
|
+
console.warn('[taskboard] 工作区组长接管写盘失败:' + (saved.error || ''))
|
|
2331
|
+
}
|
|
2332
|
+
console.log('[taskboard] 工作区组长由派发会话接管:' + key + ' → ' + sessionId)
|
|
2333
|
+
return { adopted: true, key }
|
|
2334
|
+
} catch (error) {
|
|
2335
|
+
// 接管是 best-effort:失败不影响这次派发,下一次派发 / ensure-workspace-lead 还会再试。
|
|
2336
|
+
console.warn('[taskboard] 工作区组长接管失败:' + describeError(error))
|
|
2337
|
+
return { adopted: false, reason: 'error' }
|
|
2338
|
+
}
|
|
2339
|
+
}
|
|
2340
|
+
|
|
2248
2341
|
/** 组装 LeadRef(§3.1.1):live/busy 来自 live Agent,title 优先 live 标题、其次持久化映射。 */
|
|
2249
2342
|
function leadRefFrom(key, mapping, agent, archived = false) {
|
|
2250
2343
|
const live = !!agent
|
|
@@ -2331,7 +2424,7 @@ async function runTick(rt, options = {}) {
|
|
|
2331
2424
|
}
|
|
2332
2425
|
const agents = serviceOf(rt.ctx, 'agents')
|
|
2333
2426
|
|
|
2334
|
-
//
|
|
2427
|
+
// 默认:按任务工作区投给该工作区的常驻组长(§1.5)。绝不每任务新建会话。
|
|
2335
2428
|
if (config.dispatchMode === 'workspace-lead') {
|
|
2336
2429
|
const picked = await pickWorkspaceLeadTarget(rt, candidates, config, agents, options, now)
|
|
2337
2430
|
if (!picked) return { dispatched: false, reason: rt.poll.lastSkipReason || 'lead-unavailable' }
|
|
@@ -2869,17 +2962,27 @@ function recordLeadAutoError(rt, message, now = Date.now()) {
|
|
|
2869
2962
|
console.warn('[taskboard] ' + auto.lastError)
|
|
2870
2963
|
}
|
|
2871
2964
|
|
|
2872
|
-
/**
|
|
2965
|
+
/**
|
|
2966
|
+
* worker 会话 id 对应的**宿主自动建**任务:同一 worker 只建一条(§1.8 去重 / 完成回写)。
|
|
2967
|
+
* v0.3.1:优先认宿主独占的 `workerSessionId`(真实执行会话 id),老 board / 旧 Host 没有这个字段时
|
|
2968
|
+
* 才回退到 `assignee`(v0.2.9 之前的语义:assignee 直接写 subagentId)——当前 dsh 的 `subagent`
|
|
2969
|
+
* 结果没有 subagentId,assignee 可能是名字,不能只靠它认任务。
|
|
2970
|
+
* 只认带标记的任务:轮询投递任务的 workerSessionId / assignee 也可能被写成 worker 会话 id,
|
|
2971
|
+
* 那是组长审核的对象,绝不能被宿主自动收尾(§1.8 完成回写)。
|
|
2972
|
+
*/
|
|
2873
2973
|
export function findTaskByWorker(state, workerSessionId) {
|
|
2874
2974
|
const id = trimmed(workerSessionId, 200)
|
|
2875
2975
|
if (!state || !Array.isArray(state.tasks) || id === '') return null
|
|
2876
2976
|
for (let i = state.tasks.length - 1; i >= 0; i--) {
|
|
2877
2977
|
const task = state.tasks[i]
|
|
2878
|
-
if (!task || task.
|
|
2879
|
-
|
|
2880
|
-
|
|
2881
|
-
|
|
2882
|
-
|
|
2978
|
+
if (!task || task.autoDispatch !== LEAD_AUTO_MARK) continue
|
|
2979
|
+
const storedWorker = asString(task.workerSessionId)
|
|
2980
|
+
if (storedWorker !== '') {
|
|
2981
|
+
if (storedWorker === id) return task
|
|
2982
|
+
continue
|
|
2983
|
+
}
|
|
2984
|
+
// 老 board / v0.2.9 之前没有 workerSessionId 字段:只能回退 assignee。
|
|
2985
|
+
if (task.assignee === id) return task
|
|
2883
2986
|
}
|
|
2884
2987
|
return null
|
|
2885
2988
|
}
|
|
@@ -3423,13 +3526,16 @@ export function releasePreparedDispatch(rt, exec, abortReason = '', now = Date.n
|
|
|
3423
3526
|
export const discardPreparedDispatch = releasePreparedDispatch
|
|
3424
3527
|
|
|
3425
3528
|
/**
|
|
3426
|
-
* tools/result 命中「工作区组长成功派出 worker」时把 worker
|
|
3529
|
+
* tools/result 命中「工作区组长成功派出 worker」时把 worker 信息挂到卡片上(§1.8)。
|
|
3427
3530
|
*
|
|
3428
3531
|
* 0.2.4 起卡片由 `tools/pre-execute` 的派发闸门(`prepareLeadDispatch`)在 worker 启动**之前**
|
|
3429
3532
|
* 建好 / 认领好;这里优先消费闸门留下的 `exec → 卡片` 句柄(`prepared` 分支),只补 worker 字段。
|
|
3430
3533
|
* 闸门没留下句柄(老宿主 / 单测直接调用)时退回旧的「观察后补建」路径,保证兜底也有记录。
|
|
3534
|
+
* v0.3.1:当前 dsh 的 `subagent` 成功结果只有 `{kind:'activation', name}`(没有 subagentId),
|
|
3535
|
+
* `childId` 可能为空——这时用 name 先占位,`workerSessionId` 由 `backfillWorkerSessionId()`
|
|
3536
|
+
* 从子 Agent 目录按 name 异步回填;**不能**因为缺 id 就丢掉「worker 已启动」事实。
|
|
3431
3537
|
* 只做副作用:永不抛出(失败只记 leadAuto.lastError),不阻断派发。
|
|
3432
|
-
* @param {{agent:object, childId
|
|
3538
|
+
* @param {{agent:object, childId?:string, workerName?:string, args?:object, exec?:object}} input
|
|
3433
3539
|
* @returns {{created:boolean, reason?:string, taskId?:string, task?:object}}
|
|
3434
3540
|
*/
|
|
3435
3541
|
export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
@@ -3437,7 +3543,8 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
|
3437
3543
|
try {
|
|
3438
3544
|
const agent = input && input.agent
|
|
3439
3545
|
const childId = trimmed(input && input.childId, 200)
|
|
3440
|
-
|
|
3546
|
+
const workerName = trimmed(input && input.workerName, 200)
|
|
3547
|
+
if (!agent) {
|
|
3441
3548
|
auto.skipped += 1
|
|
3442
3549
|
auto.updatedAt = iso(now)
|
|
3443
3550
|
return { created: false, reason: 'skipped' }
|
|
@@ -3463,11 +3570,16 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
|
3463
3570
|
}
|
|
3464
3571
|
}
|
|
3465
3572
|
// 自动建的卡片归当前 worker;轮询任务只在还没挂 worker 时补——组长审核的对象不被覆盖。
|
|
3466
|
-
|
|
3467
|
-
|
|
3573
|
+
const workerLabel = childId !== '' ? childId : workerName
|
|
3574
|
+
if (workerLabel !== '' && (task.autoDispatch === LEAD_AUTO_MARK || task.assignee === '')) {
|
|
3575
|
+
task.assignee = workerLabel
|
|
3576
|
+
}
|
|
3577
|
+
// v0.2.9(§2):执行会话 id 由宿主独占,**总是**覆盖为本次 worker 会话——不看 `autoDispatch`、
|
|
3468
3578
|
// 不看已有 `assignee`。组长把 assignee 写成 subagent 名字(实测 `session-jump-bug`)时,
|
|
3469
3579
|
// 看板「对话」仍指向真正在跑的那个会话;重派后也不会继续指向旧 worker。
|
|
3470
|
-
|
|
3580
|
+
// v0.3.1:当前 dsh 的 `subagent` 结果没有 subagentId,先置 null(清掉旧 worker),
|
|
3581
|
+
// 再由 `backfillWorkerSessionId()` 从子 Agent 目录按 name 回填。
|
|
3582
|
+
task.workerSessionId = childId !== '' ? childId : null
|
|
3471
3583
|
task.workerRunState = 'running'
|
|
3472
3584
|
if (sessionId !== '' && asString(task.dispatchedSessionId) === '') task.dispatchedSessionId = sessionId
|
|
3473
3585
|
if (asString(task.dispatchedSessionTitle) === '') task.dispatchedSessionTitle = sessionTitle(agent)
|
|
@@ -3475,7 +3587,7 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
|
3475
3587
|
task.updatedAt = iso(now)
|
|
3476
3588
|
const saved = commitBoard(rt.state, rt.filePath)
|
|
3477
3589
|
auto.lastTaskId = task.id
|
|
3478
|
-
auto.lastWorkerSessionId = childId
|
|
3590
|
+
if (childId !== '') auto.lastWorkerSessionId = childId
|
|
3479
3591
|
auto.updatedAt = iso(now)
|
|
3480
3592
|
if (saved && saved.saved === false) {
|
|
3481
3593
|
// worker 已经跑起来了(无法回退),但卡片在启动前已落盘:只记错误,让排障知道 worker 会话 id 没落盘。
|
|
@@ -3485,6 +3597,13 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
|
3485
3597
|
}
|
|
3486
3598
|
// 卡片在闸门之后被删掉了:继续走下面的兜底建卡,绝不出现「worker 在跑、看板没记录」。
|
|
3487
3599
|
}
|
|
3600
|
+
if (childId === '') {
|
|
3601
|
+
// 没有 prepared 卡片、也拿不到 worker 会话 id:没有可追踪的对象,不建卡也不降级。
|
|
3602
|
+
// 计一次 skipped:handler 走到了但没有动作(§3.2 口径)。
|
|
3603
|
+
auto.skipped += 1
|
|
3604
|
+
auto.updatedAt = iso(now)
|
|
3605
|
+
return { created: false, reason: 'no-child-id' }
|
|
3606
|
+
}
|
|
3488
3607
|
const existing = findTaskByWorker(rt.state, childId)
|
|
3489
3608
|
if (existing) {
|
|
3490
3609
|
auto.deduped += 1
|
|
@@ -3536,6 +3655,57 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
|
3536
3655
|
}
|
|
3537
3656
|
}
|
|
3538
3657
|
|
|
3658
|
+
/**
|
|
3659
|
+
* v0.3.1:当前 dsh 的 `subagent` 成功结果只有 `{kind:'activation', name}`,没有 subagentId。
|
|
3660
|
+
* worker 会话 id 从子 Agent 目录(`subagents.listDescendants(parentSessionId)`)按 name 回填——
|
|
3661
|
+
* 同一个父级下 name 唯一(dsh 的 catalog 约束)。best-effort:目录不可用 / 子 Agent 还没出现时
|
|
3662
|
+
* 保持 `workerSessionId=null`,卡片仍是 doing;**绝不**因此回退 todo 再被轮询重复派发。
|
|
3663
|
+
* @param {{agent:object, taskId:string, workerName:string}} input
|
|
3664
|
+
* @returns {boolean} 是否已发起异步回填
|
|
3665
|
+
*/
|
|
3666
|
+
function backfillWorkerSessionId(rt, input) {
|
|
3667
|
+
const agent = input && input.agent
|
|
3668
|
+
const taskId = trimmed(input && input.taskId, 200)
|
|
3669
|
+
const workerName = trimmed(input && input.workerName, 200)
|
|
3670
|
+
const parentId = agentSessionId(agent) || ''
|
|
3671
|
+
if (taskId === '' || workerName === '' || parentId === '') return false
|
|
3672
|
+
const ctx = rt && rt.ctx
|
|
3673
|
+
const subagents = ctx && typeof ctx.get === 'function' ? ctx.get('subagents') : undefined
|
|
3674
|
+
if (!subagents || typeof subagents.listDescendants !== 'function') return false
|
|
3675
|
+
Promise.resolve()
|
|
3676
|
+
.then(() => subagents.listDescendants(parentId))
|
|
3677
|
+
.then((rows) => {
|
|
3678
|
+
if (!Array.isArray(rows)) return
|
|
3679
|
+
const entry = rows.find(
|
|
3680
|
+
(row) => row && row.parentId === parentId && row.kind === 'child' && asString(row.name) === workerName,
|
|
3681
|
+
)
|
|
3682
|
+
const childId = entry ? asString(entry.id).trim() : ''
|
|
3683
|
+
if (childId === '') return
|
|
3684
|
+
reloadBoardIfStale(rt)
|
|
3685
|
+
const task = taskById(rt.state, taskId)
|
|
3686
|
+
if (!task) return
|
|
3687
|
+
// 已经有 id(回填过 / 重派换了 worker)→ 不覆盖。
|
|
3688
|
+
if (asString(task.workerSessionId) !== '') return
|
|
3689
|
+
task.workerSessionId = childId
|
|
3690
|
+
if ((task.workerRunState === null || task.workerRunState === '') && task.status === 'doing') {
|
|
3691
|
+
task.workerRunState = 'running'
|
|
3692
|
+
}
|
|
3693
|
+
task.updatedAt = iso(Date.now())
|
|
3694
|
+
const saved = commitBoard(rt.state, rt.filePath)
|
|
3695
|
+
if (saved && saved.saved === false) {
|
|
3696
|
+
console.warn('[taskboard] worker 会话 id 回填写盘失败:' + (saved.error || ''))
|
|
3697
|
+
}
|
|
3698
|
+
const auto = ensureLeadAuto(rt)
|
|
3699
|
+
auto.lastWorkerSessionId = childId
|
|
3700
|
+
auto.updatedAt = iso(Date.now())
|
|
3701
|
+
})
|
|
3702
|
+
.catch((error) => {
|
|
3703
|
+
// 回填是 best-effort,不是派发失败:只告警,不污染 leadAuto.lastError。
|
|
3704
|
+
console.warn('[taskboard] worker 会话 id 回填失败:' + describeError(error))
|
|
3705
|
+
})
|
|
3706
|
+
return true
|
|
3707
|
+
}
|
|
3708
|
+
|
|
3539
3709
|
/**
|
|
3540
3710
|
* subagent/end:worker 结束 → **宿主自动建的任务**置 done + result(§1.8),并 flush 完成回执(§1.6)。
|
|
3541
3711
|
* 只认带 `autoDispatch === 'lead-dispatch'` 标记的任务:轮询投递任务的 assignee 也可能被组长写成 worker
|
|
@@ -3553,7 +3723,25 @@ export async function handleSubagentEnd(rt, info, now = Date.now()) {
|
|
|
3553
3723
|
return { updated: false, reason: 'skipped' }
|
|
3554
3724
|
}
|
|
3555
3725
|
reloadBoardIfStale(rt)
|
|
3556
|
-
|
|
3726
|
+
let task = findTaskByWorker(rt.state, childId)
|
|
3727
|
+
if (!task) {
|
|
3728
|
+
// v0.3.1:workerSessionId 还没回填时(当前 dsh 的 subagent 结果没有 subagentId),
|
|
3729
|
+
// 用 end 事件里的 parentSessionId 在「该组长名下、只此一条在跑的自动卡」里兜底认领。
|
|
3730
|
+
// 多于一条时无法判断是哪个 worker → 不猜(保持 doing,交给组长审核)。
|
|
3731
|
+
const parentId = asString(info && info.parentSessionId).trim()
|
|
3732
|
+
if (parentId !== '') {
|
|
3733
|
+
const candidates = rt.state.tasks.filter(
|
|
3734
|
+
(candidate) =>
|
|
3735
|
+
candidate &&
|
|
3736
|
+
candidate.autoDispatch === LEAD_AUTO_MARK &&
|
|
3737
|
+
candidate.status === 'doing' &&
|
|
3738
|
+
asString(candidate.workerRunState) === 'running' &&
|
|
3739
|
+
asString(candidate.sessionId) === parentId &&
|
|
3740
|
+
asString(candidate.workerSessionId) === '',
|
|
3741
|
+
)
|
|
3742
|
+
if (candidates.length === 1) task = candidates[0]
|
|
3743
|
+
}
|
|
3744
|
+
}
|
|
3557
3745
|
if (!task) {
|
|
3558
3746
|
// 不是宿主建的自动任务(例如组长审核时派去跑命令的验证子 Agent,
|
|
3559
3747
|
// 或轮询投递任务的 worker——那条任务的 autoDispatch 为 null)。
|
|
@@ -3653,13 +3841,12 @@ export function registerLeadAutoHooks(ctx, rt) {
|
|
|
3653
3841
|
(exec, result) => {
|
|
3654
3842
|
try {
|
|
3655
3843
|
if (!exec || exec.name !== 'subagent') return
|
|
3656
|
-
// §1.8
|
|
3657
|
-
// exec.name === 'subagent' + 非错误结果 + value 是 {kind:'activation'
|
|
3844
|
+
// §1.8 命中条件(缺一不可,避免别的工具输出里恰好带 subagentId 就误建任务):
|
|
3845
|
+
// exec.name === 'subagent' + 非错误结果 + value 是 {kind:'activation'}。
|
|
3658
3846
|
const failed = !result || result.isError === true
|
|
3659
3847
|
const value = result && result.value
|
|
3660
3848
|
const activation = !failed && isPlainObject(value) && value.kind === 'activation'
|
|
3661
|
-
|
|
3662
|
-
if (!activation || childId === '') {
|
|
3849
|
+
if (!activation) {
|
|
3663
3850
|
// §1.8(0.2.4,t-70 加固):无法确认 worker 已启动(被其它策略拒绝 / post-execute block /
|
|
3664
3851
|
// 启动失败 / 取消 / 返回形状变化)→ **绝不删卡**,只把闸门预建的卡片降级为可见的待开始
|
|
3665
3852
|
// 记录(status=todo + lastError)。删掉一张 worker 可能正在使用的卡 = 重新制造「有活没卡」。
|
|
@@ -3668,7 +3855,15 @@ export function registerLeadAutoHooks(ctx, rt) {
|
|
|
3668
3855
|
}
|
|
3669
3856
|
const agent = exec.agent
|
|
3670
3857
|
if (!agent) return
|
|
3671
|
-
|
|
3858
|
+
// v0.3.1:当前 dsh 的 `subagent` 成功结果是 `{kind:'activation', name}`,没有 subagentId。
|
|
3859
|
+
// activation 本身就证明 worker 已启动:先按 name 占位 / 保持 doing,再从子 Agent 目录回填
|
|
3860
|
+
// workerSessionId。只有「不是 activation」才走上面的降级分支。
|
|
3861
|
+
const childId = typeof value.subagentId === 'string' ? value.subagentId.trim() : ''
|
|
3862
|
+
const workerName = asString(value.name).trim()
|
|
3863
|
+
const dispatched = handleSubagentDispatch(rt, { agent, childId, workerName, args: exec.arguments, exec })
|
|
3864
|
+
if (childId === '' && workerName !== '' && dispatched && dispatched.taskId) {
|
|
3865
|
+
backfillWorkerSessionId(rt, { agent, taskId: dispatched.taskId, workerName })
|
|
3866
|
+
}
|
|
3672
3867
|
} catch (error) {
|
|
3673
3868
|
recordLeadAutoError(rt, '组长直聊派活挂钩失败:' + describeError(error))
|
|
3674
3869
|
}
|
|
@@ -3724,6 +3919,9 @@ export function registerLeadDispatchGate(ctx, rt) {
|
|
|
3724
3919
|
info: { name: 'TaskboardDispatchError', code: outcome.reason === 'write-failed' ? 'internal' : 'bad-request' },
|
|
3725
3920
|
}
|
|
3726
3921
|
}
|
|
3922
|
+
// v0.3.2:卡片已准备好、worker 即将启动——这是「派发者出现」的时刻。
|
|
3923
|
+
// 工作区没有组长 / 组长已归档 → 把当前派单会话登记为组长,避免轮询再新建一个组长窗口。
|
|
3924
|
+
adoptWorkspaceLead(rt, agent, exec.arguments, { taskId: outcome.taskId })
|
|
3727
3925
|
return next()
|
|
3728
3926
|
} catch (error) {
|
|
3729
3927
|
const message =
|
package/locale/en.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "Task board + dispatcher mode",
|
|
4
|
-
"description": "
|
|
4
|
+
"description": "Task board + workspace-lead dispatch: talk to the main session; leads dispatch workers and the four-column board tracks progress and results."
|
|
5
5
|
}
|
|
6
6
|
}
|
package/locale/zh.json
CHANGED
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-dispatch-board",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "DeepSeek Harness 插件:派单看板 +
|
|
3
|
+
"version": "0.3.3",
|
|
4
|
+
"description": "DeepSeek Harness 插件:派单看板 + 工作区组长模式。组长派 worker 执行,看板四列跟踪进度与结论。A dispatch board and workspace-lead mode for DeepSeek Harness.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
7
7
|
"icon": "icon.svg",
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
#
|
|
4
4
|
# 两个模式:
|
|
5
5
|
# taskboard-dispatch —— 工作区组长:只处理本工作区任务,收到投递后置 doing、派 worker、审核写回看板;
|
|
6
|
-
# 只读文件工具,无 shell
|
|
6
|
+
# 只读文件工具,无 shell、无写文件工具(由宿主按工作区自动创建/维护);
|
|
7
7
|
# taskboard-worker —— 子 Agent:完整执行工具,由组长的 subagent 工具用
|
|
8
8
|
# agentPreset 指定(spawn provider 才支持 preset 选择)。
|
|
9
9
|
#
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
config:
|
|
17
17
|
id: taskboard-dispatch
|
|
18
18
|
name: 任务看板 · 工作区组长(自动)
|
|
19
|
-
description:
|
|
19
|
+
description: 工作区常驻组长(由宿主自动维护):接单、派 worker、审核并回写看板;通常无需手动选择。
|
|
20
20
|
order: 40
|
|
21
21
|
plugins:
|
|
22
22
|
# 工作区组长口径。persona 行只改本预设的 scope,不影响其它模式。
|
|
@@ -31,13 +31,34 @@
|
|
|
31
31
|
你只处理本工作区(当前工作目录)里的任务。看板任务由插件轮询后以用户消息形式投递给你,
|
|
32
32
|
消息以「【任务看板 · 待开始】」开头。收到后的固定动作:
|
|
33
33
|
1) 先 taskboard_update 把该任务置为 doing(硬要求,不要漏);
|
|
34
|
-
2)
|
|
35
|
-
|
|
34
|
+
2) 默认用 subagent 派发一个 worker(agentPreset 已固定为 taskboard-worker,后台执行,不等待);
|
|
35
|
+
如果这条任务可拆成多个写域不相交的独立片,按下面的「可拆任务的并行 fan-out」一次派多个。
|
|
36
|
+
单 worker 路径的 prompt 必须自包含:任务 id 与标题(宿主据此复用原卡片,**不要省略**)、任务的工作目录、
|
|
36
37
|
验收标准(任务备注)、以及回报模板(改了哪些文件 / 跑了什么命令 / 证据 / 验收结论 /
|
|
37
38
|
未完成的部分,用 Markdown 分条写)。子 Agent 看不到这段对话,别写「如上」「刚才那个」;
|
|
39
|
+
(fan-out 切片 worker 的 prompt 规则见下文:不要出现父任务 id / 标题,也不要写行首任务 id。)
|
|
38
40
|
3) 一句话说明派了什么,然后结束本轮。不要在轮内等待、不要轮询、不要叙述你在等——
|
|
39
41
|
下一次行动的输入是子 Agent 的完成通知,它会为你开新一轮。
|
|
40
42
|
|
|
43
|
+
可拆任务的并行 fan-out(v0.3.3):如果这条任务能拆成 ≥2 个**写域不相交**的独立片
|
|
44
|
+
(不同文件/目录,每片有明确验收标准,且每片工作量足够大),不要一个 worker 从头串到尾:
|
|
45
|
+
1) 先列出切片表:片名、写域(文件/目录)、验收标准、依赖;片与片的写域不得重叠;
|
|
46
|
+
只并行最长路径上的片,切片别太碎(每片至少几分钟),并发 2–4 个。
|
|
47
|
+
2) 在**同一轮**为每片各派一个 worker(多次 subagent 调用);description 必须互不相同,
|
|
48
|
+
并把父任务 id 放在 description 里(例如「t-107 切片 A · 内核 Context」)。
|
|
49
|
+
每片 worker 的 prompt **不要出现父任务 id 或标题**,也不要写行首「任务 id:t-N」/
|
|
50
|
+
「看板任务:t-N」——宿主的 lead-intent 匹配是全文匹配,第一片会被误认成父卡 worker,
|
|
51
|
+
父卡只记得最后一个 worker。prompt 用片名、写域、验收标准自包含即可。
|
|
52
|
+
3) 父任务保持 doing;收到切片完成通知时先 taskboard_list 核对本批切片是否都 done,
|
|
53
|
+
不要来一个就收尾。全部完成后做一次合并:
|
|
54
|
+
- 只读复核 + 跑测试能收尾的,自己复核(你只读);
|
|
55
|
+
- 需要写文件集成 / 解冲突 / 跑全量测试的,派一个 merge worker(写域=整个改动集,
|
|
56
|
+
prompt 同样不要出现父任务 id / 标题、不要写行首任务 id),由它合并并跑全量测试;
|
|
57
|
+
- 合并/测试通过后再 taskboard_update 父任务 done,result 写合并结论。
|
|
58
|
+
4) 任何一片失败:send_message 打回同一个 worker 重做,父任务保持 doing;
|
|
59
|
+
不要因为一片失败就重派整批。
|
|
60
|
+
5) 如果任务不可拆、切片写域重叠、或拆分/合并成本大于收益,按单 worker 路径执行。
|
|
61
|
+
|
|
41
62
|
子 Agent 回报后审核:对工作区取证,不只看汇报摘要——读改动过的文件、逐条对照验收标准,
|
|
42
63
|
需要跑命令就派一个验证子 Agent 去跑。然后二选一:
|
|
43
64
|
- 通过:taskboard_update 置为 done,result 写结构化 Markdown 结论(小标题、- 列表、
|
|
@@ -53,10 +74,11 @@
|
|
|
53
74
|
与已尝试的动作,必要时把任务回退 todo,交给人处理。
|
|
54
75
|
|
|
55
76
|
直聊派活(v0.2.0 补充):用户也可以直接在这个会话里要求你派活。照常先 subagent 派 worker
|
|
56
|
-
即可——宿主会在 **worker
|
|
57
|
-
结束时自动写回 done + result
|
|
58
|
-
|
|
59
|
-
|
|
77
|
+
即可——宿主会在 **worker 启动前**强制为每次派发建一条看板 doing 任务(带 autoDispatch 标记),
|
|
78
|
+
worker 结束时自动写回 done + result(完成回执也由宿主汇总给主会话,你不用去找用户汇报)。
|
|
79
|
+
可拆任务按上面的 fan-out 规则一次派多个,宿主会为每片各建一张自动卡;合并后直接在聊天里汇报。
|
|
80
|
+
这种场景不要为了记录再手动 taskboard_add 一条(会重复);只有真正要另立任务(后续安排、
|
|
81
|
+
跨工作区拆分记账)才用 taskboard_add。
|
|
60
82
|
无卡不得派发(v0.2.4 硬规则):建卡写盘失败时宿主会**拒绝派发**(worker 不会启动),返回
|
|
61
83
|
「派发已中止:没有看板卡片就不能启动 worker」。按错误提示修复
|
|
62
84
|
$DSH_HOME/storages/dsh-taskboard/board.json 的写权限后重试,或先用 taskboard_add 建卡、
|
|
@@ -219,7 +241,7 @@
|
|
|
219
241
|
config:
|
|
220
242
|
id: taskboard-worker
|
|
221
243
|
name: 任务看板 · 执行者(自动派发)
|
|
222
|
-
description:
|
|
244
|
+
description: 工作区组长派发的 worker 专用:完整执行工具,只干被指派的一件事,不再往下派。
|
|
223
245
|
order: 41
|
|
224
246
|
plugins:
|
|
225
247
|
- id: persona
|