dsh-dispatch-board 0.2.7 → 0.2.9
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/lib/client.js +101 -23
- package/lib/index.js +73 -7
- 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/lib/client.js
CHANGED
|
@@ -531,6 +531,9 @@ window.__ModuleLoader__.load({
|
|
|
531
531
|
// v0.2.4:点「对话」失败不再静默(服务缺失 / 目标会话已关闭或不存在)。
|
|
532
532
|
'openSession.failed': '无法打开对话:会话 {session} 已关闭或不存在',
|
|
533
533
|
'openSession.unavailable': '无法打开对话:会话导航服务未就绪,请稍后重试',
|
|
534
|
+
// v0.2.9:回退 / 目标就是当前会话时必须说出来(否则看起来就是「点了没反应」)。
|
|
535
|
+
'openSession.fallback': '执行对话不可用(worker 会话已中断或丢失),已打开组长对话 · {session}',
|
|
536
|
+
'openSession.stale': '这条任务的执行对话已失效,没有可跳转的会话',
|
|
534
537
|
'detail.sessions': '关联对话',
|
|
535
538
|
'detail.creatorSession': '发起对话',
|
|
536
539
|
'detail.runSession': '执行对话',
|
|
@@ -717,6 +720,9 @@ window.__ModuleLoader__.load({
|
|
|
717
720
|
// Unreleased (0.2.4 candidate): a failed 对话 click must never be silent.
|
|
718
721
|
'openSession.failed': 'Cannot open conversation: session {session} is closed or unavailable',
|
|
719
722
|
'openSession.unavailable': 'Cannot open conversation: session navigation is not ready yet, please retry',
|
|
723
|
+
// v0.2.9: a fallback (or a target equal to the current conversation) must be visible too.
|
|
724
|
+
'openSession.fallback': 'Worker conversation is gone (interrupted or removed); opened the lead conversation · {session}',
|
|
725
|
+
'openSession.stale': 'This task has no reachable conversation; nothing to open',
|
|
720
726
|
'detail.sessions': 'Linked conversations',
|
|
721
727
|
'detail.creatorSession': 'Created in',
|
|
722
728
|
'detail.runSession': 'Dispatched to',
|
|
@@ -1042,11 +1048,18 @@ window.__ModuleLoader__.load({
|
|
|
1042
1048
|
return sessionId.length > 8 ? sessionId.slice(-8) : sessionId
|
|
1043
1049
|
}
|
|
1044
1050
|
|
|
1045
|
-
// 会话 id
|
|
1046
|
-
//
|
|
1047
|
-
|
|
1051
|
+
// 会话 id 只认三种形态(v0.2.9 收紧):`session-<纯数字>`(历史时间戳 id)、`session-<uuid>`
|
|
1052
|
+
// (当前宿主)、裸 UUID(宿主 `subagentId` 就是会话 UUID);另外兼容 `session-<hex 8+>`(历史 hex id)。
|
|
1053
|
+
// **`session-` 后不能是任意字母串**:组长会把 subagent 名字写进 `assignee`(实测 `session-jump-bug` /
|
|
1054
|
+
// `session-worker1111`),旧规则把它们当会话 id,看板「对话」点开必失败后静默回退到当前会话——
|
|
1055
|
+
// 用户看到的就是「点了没反应」。真正在跑的 worker 会话 id 由宿主记在 `workerSessionId`(§2)。
|
|
1056
|
+
const SESSION_ID_PATTERN =
|
|
1057
|
+
/^(?:session-(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[0-9a-f][0-9a-f-]{7,}|\d+)|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i
|
|
1048
1058
|
// 从自由文本里找会话 id token 用:不带锚点,但两侧边界不能是 `[A-Za-z0-9_-]`(见 extractSessionId)。
|
|
1049
|
-
|
|
1059
|
+
// 形态与 SESSION_ID_PATTERN 完全一致(同一口径,别只收紧一半);alternative 顺序必须是
|
|
1060
|
+
// **长的在前**——不带锚点时 `\d+` 会先把 `session-6a5f0f02-…` 截成 `session-6`,边界判定随后把它丢掉。
|
|
1061
|
+
const SESSION_TOKEN_PATTERN =
|
|
1062
|
+
/session-(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[0-9a-f][0-9a-f-]{7,}|\d+)|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi
|
|
1050
1063
|
const SESSION_TOKEN_EDGE = /[A-Za-z0-9_-]/
|
|
1051
1064
|
|
|
1052
1065
|
/** 整串就是会话 id(严格判定,不做提取)。 */
|
|
@@ -1087,6 +1100,22 @@ window.__ModuleLoader__.load({
|
|
|
1087
1100
|
return extractSessionId(task.assignee)
|
|
1088
1101
|
}
|
|
1089
1102
|
|
|
1103
|
+
/**
|
|
1104
|
+
* 宿主独占的执行会话 id(v0.2.9,§2):`task.workerSessionId`。
|
|
1105
|
+
* 这个字段只由宿主写(`tools/result` 拿到 `subagentId` 时**总是**覆盖),模型改不了,
|
|
1106
|
+
* 所以它比 `assignee` 可信——后者是组长随手写的 label / 名字,可能根本不是会话 id。
|
|
1107
|
+
*/
|
|
1108
|
+
function workerSessionIdOf(task) {
|
|
1109
|
+
if (!task || typeof task !== 'object') return ''
|
|
1110
|
+
return extractSessionId(task.workerSessionId)
|
|
1111
|
+
}
|
|
1112
|
+
|
|
1113
|
+
/** 执行会话:宿主字段 `workerSessionId` 优先,老 Host(没有该字段)回退 `assignee` 文本。 */
|
|
1114
|
+
function taskWorkerSession(task) {
|
|
1115
|
+
const hostWritten = workerSessionIdOf(task)
|
|
1116
|
+
return hostWritten !== '' ? hostWritten : workerSessionOf(task)
|
|
1117
|
+
}
|
|
1118
|
+
|
|
1090
1119
|
/* ── v0.2.0 组长条(主会话 / 工作区组长)纯展示函数 ───────── */
|
|
1091
1120
|
|
|
1092
1121
|
// 「派发到」的四个合法值:v0.2.0 起默认 workspace-lead(缺省 / 未知一律回退它,不要回退 new)。
|
|
@@ -2046,8 +2075,38 @@ window.__ModuleLoader__.load({
|
|
|
2046
2075
|
return last
|
|
2047
2076
|
}
|
|
2048
2077
|
|
|
2078
|
+
/**
|
|
2079
|
+
* 卡片「对话」一次点击的判定(v0.2.9,两块看板共用;行为在 test/client-render.test.mjs
|
|
2080
|
+
* 里通过两块看板的真实渲染验证):
|
|
2081
|
+
* - 候选链里只剩**当前会话**:`uiWorkspace.openSession` 是同步 void,打开当前会话 = 界面毫无变化
|
|
2082
|
+
* (旧行为看起来就是「点了没反应」)→ 不调用它,直接按 `reason:'stale'` 出提示;
|
|
2083
|
+
* - 首选能打开 → `{result, fallback:false}`;
|
|
2084
|
+
* - 首选打不开、回退到别的会话 → `{result, fallback:true}`,调用方**必须**把回退说出来;
|
|
2085
|
+
* - 全都打不开(会话已关闭 / 不存在)→ 原样返回失败结果(走 `openSession.failed` 文案)。
|
|
2086
|
+
*/
|
|
2087
|
+
function chatOpenOutcome(candidates, currentSessionId) {
|
|
2088
|
+
const list = (Array.isArray(candidates) ? candidates : []).filter(
|
|
2089
|
+
(id) => typeof id === 'string' && id !== '',
|
|
2090
|
+
)
|
|
2091
|
+
const primary = list.length > 0 ? list[0] : ''
|
|
2092
|
+
const current = typeof currentSessionId === 'string' ? currentSessionId : ''
|
|
2093
|
+
// 当前会话本身作为跳转目标是空操作:先摘掉它再试,剩下的都打不开才说「执行对话已失效」。
|
|
2094
|
+
const openable = current === '' ? list : list.filter((id) => id !== current)
|
|
2095
|
+
if (openable.length === 0) {
|
|
2096
|
+
return { result: { ok: false, reason: 'stale', sessionId: primary }, fallback: false }
|
|
2097
|
+
}
|
|
2098
|
+
const result = openFirstAvailable(openable)
|
|
2099
|
+
return { result, fallback: result.ok === true && primary !== '' && result.sessionId !== primary }
|
|
2100
|
+
}
|
|
2101
|
+
|
|
2049
2102
|
/** 跳转失败的顶部提示文案(两块看板共用;`t` 由组件传入,保持纯函数可测)。 */
|
|
2050
|
-
function sessionFailureText(t, result, candidates) {
|
|
2103
|
+
function sessionFailureText(t, result, candidates, options) {
|
|
2104
|
+
// v0.2.9:回退到别的会话(首选 worker 打不开 / 目标就是当前会话)也必须说出来——
|
|
2105
|
+
// 「打开成功但界面没变」是最容易让人以为按钮坏了的情况。
|
|
2106
|
+
if (options && options.fallback === true && result && result.ok === true) {
|
|
2107
|
+
return t('openSession.fallback', { session: shortSession(result.sessionId) })
|
|
2108
|
+
}
|
|
2109
|
+
if (result && result.reason === 'stale') return t('openSession.stale')
|
|
2051
2110
|
if (result && result.reason === 'unavailable') return t('openSession.unavailable')
|
|
2052
2111
|
const list = Array.isArray(candidates) ? candidates : []
|
|
2053
2112
|
const first = list.find((id) => typeof id === 'string' && id !== '') || ''
|
|
@@ -2272,9 +2331,10 @@ window.__ModuleLoader__.load({
|
|
|
2272
2331
|
}
|
|
2273
2332
|
|
|
2274
2333
|
/**
|
|
2275
|
-
*
|
|
2276
|
-
* worker
|
|
2277
|
-
*
|
|
2334
|
+
* 任务关联的会话(卡片「对话」按钮的跳转目标),优先级(v0.2.9):
|
|
2335
|
+
* **宿主记的执行会话** `workerSessionId` → worker 子会话(旧 Host:从 `assignee` 提取,
|
|
2336
|
+
* 用收紧后的正则,subagent 名字不再算会话)→ 组长会话(dispatchedSessionId)
|
|
2337
|
+
* → 发起对话(sessionId)→ 老 Host 的 poll 兜底(doing)。
|
|
2278
2338
|
*
|
|
2279
2339
|
* 返回**去重后的候选链**(v0.2.4):worker 子会话是子 Agent 会话,客户端未必解析得到
|
|
2280
2340
|
* (侧栏隐藏、依赖父会话 catalog),打不开时不能连累整次点击——调用方按顺序试到第一个能打开的。
|
|
@@ -2285,6 +2345,7 @@ window.__ModuleLoader__.load({
|
|
|
2285
2345
|
const push = (value) => {
|
|
2286
2346
|
if (typeof value === 'string' && value !== '' && out.indexOf(value) < 0) out.push(value)
|
|
2287
2347
|
}
|
|
2348
|
+
push(workerSessionIdOf(task))
|
|
2288
2349
|
push(workerSessionOf(task))
|
|
2289
2350
|
push(task.dispatchedSessionId)
|
|
2290
2351
|
push(task.sessionId)
|
|
@@ -2595,8 +2656,9 @@ window.__ModuleLoader__.load({
|
|
|
2595
2656
|
// 标题/按钮之间只留 gap,不再用整卡 min-height + 操作行 margin-top:auto 撑空行)。
|
|
2596
2657
|
|
|
2597
2658
|
cardActions.unshift(['detail', () => actions.openDetail(task), false])
|
|
2598
|
-
//
|
|
2599
|
-
//
|
|
2659
|
+
// 卡片「对话」的目标:宿主记的执行会话 workerSessionId 优先(v0.2.9),老 Host 回退 worker /
|
|
2660
|
+
// 组长 / 发起对话;title 用实际目标 id 便于辨认。assignee 里的 subagent 名字不再当会话 id。
|
|
2661
|
+
// 点击走 actions.openChat(task):worker 打不开时自动回退组长 / 发起会话,全部失败 / 回退都出提示(不静默)。
|
|
2600
2662
|
const cardSessionId = sessionOf(task)
|
|
2601
2663
|
if (cardSessionId !== '') {
|
|
2602
2664
|
const openChatAction = () => (typeof actions.openChat === 'function' ? actions.openChat(task) : actions.openSession(cardSessionId))
|
|
@@ -2683,10 +2745,11 @@ window.__ModuleLoader__.load({
|
|
|
2683
2745
|
[t('detail.archived'), fmtShortWhen(task.archivedAt), fmtWhen(task.archivedAt)],
|
|
2684
2746
|
]
|
|
2685
2747
|
const resultEmpty = task.status === 'done' && !task.result
|
|
2686
|
-
// 「关联对话」:发起(sessionId)/
|
|
2687
|
-
//
|
|
2748
|
+
// 「关联对话」:发起(sessionId)/ 执行(宿主 workerSessionId,老 Host 回退 assignee)/
|
|
2749
|
+
// 组长(dispatchedSessionId / poll 兜底),各自可点;同一个会话只显示一次
|
|
2750
|
+
// (worker 可能等于发起会话,组长会话也可能等于发起会话)。
|
|
2688
2751
|
const creatorSession = typeof task.sessionId === 'string' ? task.sessionId : ''
|
|
2689
|
-
const workerSession =
|
|
2752
|
+
const workerSession = taskWorkerSession(task)
|
|
2690
2753
|
const leadSession = leadSessionOf(task)
|
|
2691
2754
|
const detailSessions = []
|
|
2692
2755
|
if (creatorSession !== '') {
|
|
@@ -3402,14 +3465,15 @@ window.__ModuleLoader__.load({
|
|
|
3402
3465
|
* t-71:浮层开着时把提示交给浮层(`detailNotice`)渲染——`.tb-detail-mask` 是 z-index:9000
|
|
3403
3466
|
* 的全屏遮罩,看板顶部横幅在它下面,用户看不见。成功跳转顺带清掉上一次的会话失败提示;
|
|
3404
3467
|
* `kind:'session'` 标记保证只清自己设的提示,不误清「派发成功」「已归档」等其它通知。
|
|
3468
|
+
* v0.2.9:回退到别的会话(`options.fallback`)算成功但不静默——照样出 warn。
|
|
3405
3469
|
*/
|
|
3406
|
-
function reportSessionFailure(result, candidates) {
|
|
3407
|
-
if (result && result.ok) {
|
|
3470
|
+
function reportSessionFailure(result, candidates, options) {
|
|
3471
|
+
if (result && result.ok && !(options && options.fallback === true)) {
|
|
3408
3472
|
setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
|
|
3409
3473
|
setDetailNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
|
|
3410
3474
|
return result
|
|
3411
3475
|
}
|
|
3412
|
-
const item = { tone: 'warn', text: sessionFailureText(t, result, candidates), kind: 'session' }
|
|
3476
|
+
const item = { tone: 'warn', text: sessionFailureText(t, result, candidates, options), kind: 'session' }
|
|
3413
3477
|
if (detailId !== null) {
|
|
3414
3478
|
setDetailNotice(item)
|
|
3415
3479
|
setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
|
|
@@ -3424,11 +3488,16 @@ window.__ModuleLoader__.load({
|
|
|
3424
3488
|
return reportSessionFailure(openSessionById(sessionId), [sessionId])
|
|
3425
3489
|
}
|
|
3426
3490
|
|
|
3427
|
-
/**
|
|
3491
|
+
/**
|
|
3492
|
+
* 任务卡片的「对话」:按候选链(workerSessionId → worker → 组长 → 发起 → poll 兜底)
|
|
3493
|
+
* 试到第一个能打开的;回退 / 只剩当前会话时都给可见提示(v0.2.9)。
|
|
3494
|
+
* 当前会话用本看板绑定的 `sessionId`(右栏 tab 的会话 scope)。
|
|
3495
|
+
*/
|
|
3428
3496
|
function openChatAction(task) {
|
|
3429
3497
|
const pieces = boardPiecesRef.current
|
|
3430
3498
|
const candidates = pieces && typeof pieces.sessionCandidatesOf === 'function' ? pieces.sessionCandidatesOf(task) : []
|
|
3431
|
-
|
|
3499
|
+
const outcome = chatOpenOutcome(candidates, sessionId)
|
|
3500
|
+
return reportSessionFailure(outcome.result, candidates, { fallback: outcome.fallback })
|
|
3432
3501
|
}
|
|
3433
3502
|
|
|
3434
3503
|
/* ── 组长条动作(v0.2.0)────────────────────────────────── */
|
|
@@ -4251,14 +4320,15 @@ window.__ModuleLoader__.load({
|
|
|
4251
4320
|
* 与右栏看板同一套反馈:能打开就跳转,打不开就出 warn 横幅。
|
|
4252
4321
|
* t-71:浮层开着时提示渲染在浮层内部(`detailNotice`),否则看板顶部横幅会被遮罩盖住;
|
|
4253
4322
|
* 成功跳转只清 `kind:'session'` 的旧提示(不误清派发 / 归档等其它通知)。
|
|
4323
|
+
* v0.2.9:回退到别的会话(`options.fallback`)算成功但不静默——照样出 warn。
|
|
4254
4324
|
*/
|
|
4255
|
-
function reportSessionFailure(result, candidates) {
|
|
4256
|
-
if (result && result.ok) {
|
|
4325
|
+
function reportSessionFailure(result, candidates, options) {
|
|
4326
|
+
if (result && result.ok && !(options && options.fallback === true)) {
|
|
4257
4327
|
setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
|
|
4258
4328
|
setDetailNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
|
|
4259
4329
|
return result
|
|
4260
4330
|
}
|
|
4261
|
-
const item = { tone: 'warn', text: sessionFailureText(t, result, candidates), kind: 'session' }
|
|
4331
|
+
const item = { tone: 'warn', text: sessionFailureText(t, result, candidates, options), kind: 'session' }
|
|
4262
4332
|
if (detailId !== null) {
|
|
4263
4333
|
setDetailNotice(item)
|
|
4264
4334
|
setNotice((prev) => (prev && prev.kind === 'session' ? null : prev))
|
|
@@ -4273,11 +4343,16 @@ window.__ModuleLoader__.load({
|
|
|
4273
4343
|
return reportSessionFailure(openSessionById(sessionId), [sessionId])
|
|
4274
4344
|
}
|
|
4275
4345
|
|
|
4276
|
-
/**
|
|
4346
|
+
/**
|
|
4347
|
+
* 任务卡片的「对话」:按候选链(workerSessionId → worker → 组长 → 发起 → poll 兜底)
|
|
4348
|
+
* 试到第一个能打开的;回退 / 只剩当前会话时都给可见提示(v0.2.9)。
|
|
4349
|
+
* 平台看板没有 session scope:当前会话取 `lastConversationSessionId`(宿主渲染过的最近对话)。
|
|
4350
|
+
*/
|
|
4277
4351
|
function openChatAction(task) {
|
|
4278
4352
|
const pieces = boardPiecesRef.current
|
|
4279
4353
|
const candidates = pieces && typeof pieces.sessionCandidatesOf === 'function' ? pieces.sessionCandidatesOf(task) : []
|
|
4280
|
-
|
|
4354
|
+
const outcome = chatOpenOutcome(candidates, lastConversationSessionId)
|
|
4355
|
+
return reportSessionFailure(outcome.result, candidates, { fallback: outcome.fallback })
|
|
4281
4356
|
}
|
|
4282
4357
|
|
|
4283
4358
|
/* ── 组长条动作(v0.2.0,与右栏看板同一套 RPC)──────────── */
|
|
@@ -4753,6 +4828,9 @@ window.__ModuleLoader__.load({
|
|
|
4753
4828
|
// v0.2.0 任务关联对话:worker 会话判定(assignee 只在能提取到会话 id 时算会话)
|
|
4754
4829
|
workerSessionOf,
|
|
4755
4830
|
extractSessionId,
|
|
4831
|
+
// v0.2.9:宿主独占的 workerSessionId(优先)+ 卡片「对话」的执行会话判定
|
|
4832
|
+
workerSessionIdOf,
|
|
4833
|
+
taskWorkerSession,
|
|
4756
4834
|
groupTasks,
|
|
4757
4835
|
statusAccent: STATUS_ACCENT,
|
|
4758
4836
|
statusOrder: STATUS_ORDER,
|
package/lib/index.js
CHANGED
|
@@ -113,6 +113,29 @@ const ATTACHMENT_REF_PATTERN = /!\[[^\]]*\]\(attachment:\/\/([0-9a-f]{8}-[0-9a-f
|
|
|
113
113
|
* 轮询投递任务 / 人工任务恒为 null —— 组长把它们的 assignee 写成 worker 会话 id 也不会被宿主抢答。
|
|
114
114
|
*/
|
|
115
115
|
export const LEAD_AUTO_MARK = 'lead-dispatch'
|
|
116
|
+
/**
|
|
117
|
+
* v0.2.9:worker 执行状态(宿主独占字段 `task.workerRunState`,模型不可写,§2)。
|
|
118
|
+
* - `'running'`:`tools/result` 确认 worker 已启动;
|
|
119
|
+
* - `'failed'`:`subagent/end` 收到非 `completed` 的结束(会话可能已被移除);
|
|
120
|
+
* - `'ended'`:`subagent/end` 收到 `completed`(执行会话 id 保留,仍可回看对话);
|
|
121
|
+
* - `null`:还没派过 worker(含老 board.json 缺字段)。
|
|
122
|
+
*/
|
|
123
|
+
export const WORKER_RUN_STATES = Object.freeze(['running', 'failed', 'ended'])
|
|
124
|
+
/**
|
|
125
|
+
* v0.2.9:会话 id 形态(Host / Client 同一条口径,`looksLikeSessionId` 用它)。
|
|
126
|
+
*
|
|
127
|
+
* 只认三种真会话 id:
|
|
128
|
+
* - `session-<纯数字>`:历史时间戳式会话 id(如 `session-1747351234567`);
|
|
129
|
+
* - `session-<uuid>`:当前宿主形态(如 `session-042eeecd-19bc-400d-9e1b-5db67d5ee2b3`);
|
|
130
|
+
* - 裸 UUID:`subagentId` 就是会话 UUID。
|
|
131
|
+
* 另外兼容 `session-<hex 8 位以上>`(历史 hex id / 测试数据,如 `session-aaaa1111`)。
|
|
132
|
+
*
|
|
133
|
+
* 关键收紧:`session-` 后**不能是任意字母串**。组长会把 subagent 的名字写进 `assignee`
|
|
134
|
+
* (实测 `session-jump-bug` / `session-jump-fix`),旧规则 `session-[0-9a-z-]{8,}` 把名字当会话 id,
|
|
135
|
+
* 认领判定(`canReuseMentionedTask`)与看板「对话」跳转都跟着错。
|
|
136
|
+
*/
|
|
137
|
+
const SESSION_ID_PATTERN =
|
|
138
|
+
/^(?:session-(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[0-9a-f][0-9a-f-]{7,}|\d+)|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i
|
|
116
139
|
/**
|
|
117
140
|
* §1.8 in-flight 去重的陈旧窗口:组长名下「doing + notifiedAt」的轮询任务超过这个时长没有更新
|
|
118
141
|
* (worker 长跑 / 组长卡死)就不再挡住直聊派活——宁可多一条可见任务,也不让派活无声消失。
|
|
@@ -447,6 +470,10 @@ function normalizeTask(raw, index) {
|
|
|
447
470
|
answeredAt: asString(raw.answeredAt) || null,
|
|
448
471
|
cwd: typeof raw.cwd === 'string' && raw.cwd !== '' ? raw.cwd : null,
|
|
449
472
|
assignee: trimmed(raw.assignee, 200),
|
|
473
|
+
// v0.2.9(§2):宿主独占的「执行会话 id / 执行状态」。模型不可写(不在 taskboard_update 白名单、
|
|
474
|
+
// applyTaskUpdate 也不读这两个键),老 board.json 缺字段一律 null;不做迁移。
|
|
475
|
+
workerSessionId: trimmed(raw.workerSessionId, 200) || null,
|
|
476
|
+
workerRunState: WORKER_RUN_STATES.includes(raw.workerRunState) ? raw.workerRunState : null,
|
|
450
477
|
result: truncateNote(raw.result, MAX_NOTE_CHARS),
|
|
451
478
|
createdAt: asString(raw.createdAt) || iso(Date.now()),
|
|
452
479
|
updatedAt: asString(raw.updatedAt) || asString(raw.createdAt) || iso(Date.now()),
|
|
@@ -867,6 +894,9 @@ export function addTask(state, input, now = Date.now()) {
|
|
|
867
894
|
answeredAt: null,
|
|
868
895
|
cwd: typeof input.cwd === 'string' && input.cwd !== '' ? input.cwd : null,
|
|
869
896
|
assignee: '',
|
|
897
|
+
// v0.2.9(§2):宿主独占字段,建任务时都还没有 worker。
|
|
898
|
+
workerSessionId: null,
|
|
899
|
+
workerRunState: null,
|
|
870
900
|
result: '',
|
|
871
901
|
createdAt: stamp,
|
|
872
902
|
updatedAt: stamp,
|
|
@@ -1004,6 +1034,10 @@ export function applyTaskUpdate(state, id, patch, now = Date.now()) {
|
|
|
1004
1034
|
task.notifiedAt = null
|
|
1005
1035
|
task.notificationCount = 0
|
|
1006
1036
|
task.assignee = ''
|
|
1037
|
+
// v0.2.9:回到待开始 = 下一轮会派新的 worker,执行会话记账一起清空
|
|
1038
|
+
// (旧 worker 的会话已中断 / 已失效,留着只会让看板「对话」指向一个打不开的会话)。
|
|
1039
|
+
task.workerSessionId = null
|
|
1040
|
+
task.workerRunState = null
|
|
1007
1041
|
task.reportedAt = null
|
|
1008
1042
|
// 重新排队后由轮询投递、归组长审核:不再是「宿主自动任务」,别再被 subagent/end 自动 done(§1.8)。
|
|
1009
1043
|
task.autoDispatch = null
|
|
@@ -1262,6 +1296,9 @@ export function requeueTasksOfLead(state, sessionId, now = Date.now()) {
|
|
|
1262
1296
|
task.notifiedAt = null
|
|
1263
1297
|
task.notificationCount = 0
|
|
1264
1298
|
task.assignee = ''
|
|
1299
|
+
// v0.2.9:重排后旧 worker 的执行会话记账一并清空(与 applyTaskUpdate 的 →todo 同口径)。
|
|
1300
|
+
task.workerSessionId = null
|
|
1301
|
+
task.workerRunState = null
|
|
1265
1302
|
task.dispatchedSessionId = null
|
|
1266
1303
|
task.dispatchedSessionTitle = ''
|
|
1267
1304
|
// §1.9:重排后这条任务不再由旧组长/旧提问者跟进,清掉问题标记——
|
|
@@ -3016,12 +3053,18 @@ export function dispatchReferencedTaskId(text) {
|
|
|
3016
3053
|
return ''
|
|
3017
3054
|
}
|
|
3018
3055
|
|
|
3019
|
-
/**
|
|
3056
|
+
/**
|
|
3057
|
+
* assignee 看起来是不是一个真实 worker 会话 id(UUID / `session-<数字或 UUID>` / `session-<hex>`);
|
|
3058
|
+
* 自由文本标签(`taskboard-worker`)与 subagent 名字(`session-jump-bug`)都不算。
|
|
3059
|
+
*
|
|
3060
|
+
* v0.2.9 收紧:旧规则 `/^session-[0-9a-z-]{8,}$/i` 把 `session-jump-bug` 当会话 id,于是
|
|
3061
|
+
* 「看板任务:t-N」认领会被名字骗过(`canReuseMentionedTask`),看板「对话」也指向假会话。
|
|
3062
|
+
* 现在与 Client 共用同一条形态(`SESSION_ID_PATTERN`),见 §2 的 `workerSessionId`。
|
|
3063
|
+
*/
|
|
3020
3064
|
export function looksLikeSessionId(value) {
|
|
3021
3065
|
const text = typeof value === 'string' ? value.trim() : ''
|
|
3022
3066
|
if (text === '') return false
|
|
3023
|
-
|
|
3024
|
-
return /^session-[0-9a-z-]{8,}$/i.test(text)
|
|
3067
|
+
return SESSION_ID_PATTERN.test(text)
|
|
3025
3068
|
}
|
|
3026
3069
|
|
|
3027
3070
|
/**
|
|
@@ -3224,6 +3267,9 @@ export function prepareLeadDispatch(rt, input, now = Date.now()) {
|
|
|
3224
3267
|
task.autoDispatch = LEAD_AUTO_MARK
|
|
3225
3268
|
task.dispatchedSessionId = leadId || null
|
|
3226
3269
|
task.dispatchedSessionTitle = sessionTitle(agent)
|
|
3270
|
+
// v0.2.9(§2):建卡时 worker 还没启动,执行会话未知;`tools/result` 拿到 subagentId 才写。
|
|
3271
|
+
task.workerSessionId = null
|
|
3272
|
+
task.workerRunState = null
|
|
3227
3273
|
task.lastError = ''
|
|
3228
3274
|
task.updatedAt = iso(now)
|
|
3229
3275
|
const saved = commitBoard(rt.state, rt.filePath)
|
|
@@ -3403,6 +3449,11 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
|
3403
3449
|
}
|
|
3404
3450
|
// 自动建的卡片归当前 worker;轮询任务只在还没挂 worker 时补——组长审核的对象不被覆盖。
|
|
3405
3451
|
if (task.autoDispatch === LEAD_AUTO_MARK || task.assignee === '') task.assignee = childId
|
|
3452
|
+
// v0.2.9(§2):执行会话 id 由宿主独占,**总是**覆盖为本次 `subagentId`——不看 `autoDispatch`、
|
|
3453
|
+
// 不看已有 `assignee`。组长把 assignee 写成 subagent 名字(实测 `session-jump-bug`)时,
|
|
3454
|
+
// 看板「对话」仍指向真正在跑的那个会话;重派后也不会继续指向旧 worker。
|
|
3455
|
+
task.workerSessionId = childId
|
|
3456
|
+
task.workerRunState = 'running'
|
|
3406
3457
|
if (sessionId !== '' && asString(task.dispatchedSessionId) === '') task.dispatchedSessionId = sessionId
|
|
3407
3458
|
if (asString(task.dispatchedSessionTitle) === '') task.dispatchedSessionTitle = sessionTitle(agent)
|
|
3408
3459
|
task.lastError = ''
|
|
@@ -3445,6 +3496,9 @@ export function handleSubagentDispatch(rt, input, now = Date.now()) {
|
|
|
3445
3496
|
applyTaskUpdate(rt.state, task.id, { status: 'doing', assignee: childId }, now)
|
|
3446
3497
|
// 持久化标记:只有带这个标记的任务才允许 subagent/end 自动收尾(§1.8 / §2)。
|
|
3447
3498
|
task.autoDispatch = LEAD_AUTO_MARK
|
|
3499
|
+
// v0.2.9(§2):兜底建卡路径也由宿主记执行会话 id / 执行状态(与 prepared 分支同口径)。
|
|
3500
|
+
task.workerSessionId = childId
|
|
3501
|
+
task.workerRunState = 'running'
|
|
3448
3502
|
task.dispatchedSessionId = sessionId || null
|
|
3449
3503
|
task.dispatchedSessionTitle = sessionTitle(agent)
|
|
3450
3504
|
task.lastError = ''
|
|
@@ -3512,6 +3566,10 @@ export async function handleSubagentEnd(rt, info, now = Date.now()) {
|
|
|
3512
3566
|
}
|
|
3513
3567
|
const detail = result === '' ? '没有返回结论' : flattenResultLine(result, RECEIPT_RESULT_CHARS)
|
|
3514
3568
|
task.lastError = trimmed('worker 结束(' + stopReason + '):' + detail, 500)
|
|
3569
|
+
// v0.2.9(§2):worker 异常中断(非 completed)时**保留**执行会话 id 与 assignee,只把运行状态
|
|
3570
|
+
// 标成 failed——看板「对话」仍会先试那个 worker 会话,打不开时客户端给可见回退提示。
|
|
3571
|
+
if (asString(task.workerSessionId) === '') task.workerSessionId = childId
|
|
3572
|
+
task.workerRunState = 'failed'
|
|
3515
3573
|
task.updatedAt = iso(now)
|
|
3516
3574
|
commitBoard(rt.state, rt.filePath)
|
|
3517
3575
|
// 只写任务 lastError;leadAuto.lastError 语义是「挂钩自身失败原因」,不装派发结果。
|
|
@@ -3536,6 +3594,9 @@ export async function handleSubagentEnd(rt, info, now = Date.now()) {
|
|
|
3536
3594
|
}
|
|
3537
3595
|
applyTaskUpdate(rt.state, task.id, patch, now)
|
|
3538
3596
|
task.lastError = ''
|
|
3597
|
+
// v0.2.9(§2):正常结束 → **保留**执行会话 id(还能回看 worker 对话),只把运行状态标成 ended。
|
|
3598
|
+
if (asString(task.workerSessionId) === '') task.workerSessionId = childId
|
|
3599
|
+
task.workerRunState = 'ended'
|
|
3539
3600
|
task.updatedAt = iso(now)
|
|
3540
3601
|
commitBoard(rt.state, rt.filePath)
|
|
3541
3602
|
// 只在真正的 doing→done 时计数;第二次结束只刷 result,不算又一次完成。
|
|
@@ -3789,8 +3850,9 @@ export const TASK_LIST_OUTPUT_SCHEMA = {
|
|
|
3789
3850
|
* 这里的键必须全部在 output.schema 里声明:dsh tools 管线在 execute() 成功返回之后才校验 canonical
|
|
3790
3851
|
* output,而两个 output.schema 都是 additionalProperties:false 的封闭契约——多带一个未声明字段就会抛
|
|
3791
3852
|
* ToolOutputError(INVALID_TOOL_OUTPUT),此时 execute() 的副作用(写盘 / 状态迁移)已经生效,
|
|
3792
|
-
* 模型侧却只看到调用失败。UI 专用字段(dispatchedSessionId / sessionId / cwd
|
|
3793
|
-
* 的完整任务对象提供,不要加进 taskBrief
|
|
3853
|
+
* 模型侧却只看到调用失败。UI 专用字段(dispatchedSessionId / sessionId / cwd / v0.2.9 的
|
|
3854
|
+
* workerSessionId / workerRunState 等)由 buildSnapshot() 的完整任务对象提供,不要加进 taskBrief。
|
|
3855
|
+
* 回归测试见 test/host.test.mjs。
|
|
3794
3856
|
*/
|
|
3795
3857
|
export function taskBrief(task) {
|
|
3796
3858
|
return {
|
|
@@ -3953,7 +4015,8 @@ export function registerTools(toolCtx, rt) {
|
|
|
3953
4015
|
name: 'taskboard_update',
|
|
3954
4016
|
description:
|
|
3955
4017
|
'更新看板任务:置为 doing(已派发)、done(审核通过)、todo(打回重做)、archived(归档);' +
|
|
3956
|
-
'也可以用 result
|
|
4018
|
+
'也可以用 result 写审核结论。assignee 只写子 Agent 的 label / 名字(自由文本),**不要写会话 id**——' +
|
|
4019
|
+
'执行会话 id 由宿主记在 workerSessionId,模型写不进去。状态迁移非法时会返回错误。' +
|
|
3957
4020
|
'需要用户决策时用 needsUser:true + question(可选 questionOptions 选项)在任务上提问,' +
|
|
3958
4021
|
'看板会把它放进「待你处理」并通知用户回答;needsUser:false 取消提问(问题字段清空,回答留档)。' +
|
|
3959
4022
|
'任务已归档时不能再提问(返回 conflict):需要用户拍板请先重开该任务或新建一条任务。',
|
|
@@ -3965,7 +4028,7 @@ export function registerTools(toolCtx, rt) {
|
|
|
3965
4028
|
id: { type: 'string', description: '任务 id,例如 t-3' },
|
|
3966
4029
|
status: { type: 'string', enum: [...STATUSES], description: '目标状态' },
|
|
3967
4030
|
result: { type: 'string', description: '审核结论 / 子 Agent 汇报摘要' },
|
|
3968
|
-
assignee: { type: 'string', description: '子 Agent 的 label
|
|
4031
|
+
assignee: { type: 'string', description: '子 Agent 的 label / 名字(自由文本;不要写会话 id)' },
|
|
3969
4032
|
note: { type: 'string', description: '备注(覆盖原备注)' },
|
|
3970
4033
|
needsUser: {
|
|
3971
4034
|
type: 'boolean',
|
|
@@ -3986,6 +4049,9 @@ export function registerTools(toolCtx, rt) {
|
|
|
3986
4049
|
async execute(args, exec) {
|
|
3987
4050
|
if (!args || !args.id) throw new Error('缺少任务 id')
|
|
3988
4051
|
const patch = {}
|
|
4052
|
+
// v0.2.9(§2):`workerSessionId` / `workerRunState` 是宿主独占字段,**不在白名单里**——
|
|
4053
|
+
// 模型即使传了也进不了 patch(`parameters.additionalProperties:false` 还会在入参校验阶段拒绝),
|
|
4054
|
+
// `applyTaskUpdate` 也不读这两个键,所以任务字段绝不会被模型改写。
|
|
3989
4055
|
for (const key of ['status', 'result', 'assignee', 'note', 'needsUser', 'question', 'questionOptions']) {
|
|
3990
4056
|
if (args[key] !== undefined) patch[key] = args[key]
|
|
3991
4057
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-dispatch-board",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.9",
|
|
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'
|