From 37ee2d4a6ffae69d70ca80276e5cfc8902f9782b Mon Sep 17 00:00:00 2001 From: qyh15 Date: Sat, 14 Nov 2026 11:35:42 +0800 Subject: [PATCH] =?UTF-8?q?fix(observe):=20=E5=90=8E=E5=8F=B0=20job=20?= =?UTF-8?q?=E7=A7=9F=E7=BA=A6=E4=BA=A4=E7=BB=99=20ctx.jobs.wait=EF=BC=88v0?= =?UTF-8?q?.2.6=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 工具结果含 job id 且宿主有 ctx.jobs 时,租约保留到 job 结束 - 无 jobs 服务/同步失败回退原释放路径 - Q08e 回归;158/158 tests --- README.md | 2 +- docs/verification/00-baseline.md | 4 +-- docs/verification/02-test-matrix.md | 10 +++--- docs/verification/04-release.md | 15 ++++++--- docs/verification/05-delivery-note.md | 2 +- ds-bot/package.json | 2 +- sansheng/package.json | 2 +- sansheng/src/observe.js | 46 +++++++++++++++++++++++---- sansheng/test/dispatch-v2.test.js | 41 ++++++++++++++++++++++-- 9 files changed, 100 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index bfa6421..4a0e3e1 100644 --- a/README.md +++ b/README.md @@ -51,7 +51,7 @@ ## 验证 ```sh -node --test --test-isolation=none sansheng/test/*.test.js # 157 tests +node --test --test-isolation=none sansheng/test/*.test.js # 158 tests node --check sansheng/client.js && node --check sansheng/index.js ``` diff --git a/docs/verification/00-baseline.md b/docs/verification/00-baseline.md index ee72a27..9601f1f 100644 --- a/docs/verification/00-baseline.md +++ b/docs/verification/00-baseline.md @@ -12,8 +12,8 @@ | 基准提交 | `3f20f89`(工作树在开工时仅多出交接方案文档) | | 远端 | `origin https://git.qyhhh.top/newbie/dsh-sansheng-liubu.git` | | 根工作区 | `workspaces: ["sansheng", "ds-bot"]`,根 `package.json` 不是 DSH 插件 | -| 治理包 | `sansheng/` = `dsh-sansheng-sansheng@0.2.5`(本次发布候选) | -| 团队底座 | `ds-bot/` = `ds-bot@0.3.2-sansheng.5`(上游 `Fei2411/DS-Bot@84c3cb8` + 本地 M-01–M-06) | +| 治理包 | `sansheng/` = `dsh-sansheng-sansheng@0.2.6`(本次发布候选) | +| 团队底座 | `ds-bot/` = `ds-bot@0.3.2-sansheng.6`(上游 `Fei2411/DS-Bot@84c3cb8` + 本地 M-01–M-06) | | Node | v24.21.0(DSH 随附 `~/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node.exe`) | | 桌面宿主 | DeepSeek Harness 0.2.2-rc.3(`resources/runtime/primary-runtime/runtime.json`) | | 基线测试 | `node --test --test-isolation=none sansheng/test/*.test.js` → 56/56 通过(2026-11-13) | diff --git a/docs/verification/02-test-matrix.md b/docs/verification/02-test-matrix.md index 5ba9c49..950fb57 100644 --- a/docs/verification/02-test-matrix.md +++ b/docs/verification/02-test-matrix.md @@ -1,7 +1,7 @@ -# 验收矩阵与证据状态(候选版本 v0.2.5) +# 验收矩阵与证据状态(候选版本 v0.2.6) 日期:2026-11-14 -结论:**候选版本**。仓库内自动化回归 **157/157 通过**;已在隔离测试 profile(独立 DSH_HOME,宿主 0.2.2-rc.3)完成真实宿主冒烟:原生项目树、原生聊天、右栏三卡与 Bot 切换,DS-Bot 全局 shell 未接管,控制台无 DS-Bot 重挂/设置冲突警告,证据见 `03-host-smoke.md`。真实模型 E2E(E01–E04)、长消息/连续工具流仍缺失;用户日常 desktop profile 未修改。 +结论:**候选版本**。仓库内自动化回归 **158/158 通过**;已在隔离测试 profile(独立 DSH_HOME,宿主 0.2.2-rc.3)完成真实宿主冒烟:原生项目树、原生聊天、右栏三卡与 Bot 切换,DS-Bot 全局 shell 未接管,控制台无 DS-Bot 重挂/设置冲突警告,证据见 `03-host-smoke.md`。真实模型 E2E(E01–E04)、长消息/连续工具流仍缺失;用户日常 desktop profile 未修改。 ## 1. 自动化测试入口 @@ -19,7 +19,7 @@ node --check sansheng/index.js - `api-v3.test.js`:状态投影与历史折叠 - `gate-install.test.js`:F01、unknown 身份、治理损坏、跨项目 - `client.test.js`:右栏/入口/项目上下文(见 UI 工作包报告) -- 审查修复回归:Q01/Q01b/Q01c(store+apply)、Q02/Q02b(governance+gate 双故障)、Q03(unknown 工具)、Q04(governance + 真实 memory install + peer stub)、Q05/Q05b/Q05c(observer)、Q06/G06(draft+最终复核)、Q07(artifact/gate)、Q08/Q08b/Q08c/Q08d(提交租约+真实写根+junction+过期接管)、Q09(store+HTTP route)、Q10(records)、Q11/Q11b/Q11c/Q11d(config 回滚+并发+recovery sidecar)、Q12/Q12b/Q12c(Hook+超时+真实 useSanshengState)、Q13(needsKey 服务端+前端)。 +- 审查修复回归:Q01/Q01b/Q01c(store+apply)、Q02/Q02b(governance+gate 双故障)、Q03(unknown 工具)、Q04(governance + 真实 memory install + peer stub)、Q05/Q05b/Q05c(observer)、Q06/G06(draft+最终复核)、Q07(artifact/gate)、Q08/Q08b/Q08c/Q08d/Q08e(提交租约+真实写根+junction+过期接管+后台 job wait)、Q09(store+HTTP route)、Q10(records)、Q11/Q11b/Q11c/Q11d(config 回滚+并发+recovery sidecar)、Q12/Q12b/Q12c(Hook+超时+真实 useSanshengState)、Q13(needsKey 服务端+前端)。 ## 2. 入口与布局 @@ -100,7 +100,7 @@ node --check sansheng/index.js | Q05 | 已修 | `dispatch-v2.test.js` Q05/Q05b/Q05c:begin/mark 失败 nativeCalls=0;回执失败 unknown | | Q06 | 已修 | `store.test.js` Q06 延迟落盘不可见;`records.test.js` Q06/G06 guard 打标后最终复核阻止执行 | | Q07 | 已修 | `artifact.test.js` missing 不再通过;`gate.test.js` Q07 truncated/missing 拒绝;review 写入前拦截 pass | -| Q08 | 部分修 | realpath/junction 同根互斥、提交与写工具共用根锁、5 分钟续租、过期租约可接管;后台 job 生命周期和未知第三方写工具仍未覆盖 | +| Q08 | 已修(后台 job wait) | 已知写工具同根互斥、realpath/junction、5 分钟续租、过期接管;结果里出现 job id 且有 `ctx.jobs` 时租约交给 `jobs.wait`,job 结束才释放;未知第三方写工具仍不覆盖 | | Q09 | 已修 | `store.test.js` Q09 + `route.test.js` Q09:跨项目核实 409 且不写事件;事件与状态同事务 | | Q10 | 已修 | `records.test.js` Q10:重复 draft/start 拒绝,新建/启动确认 | | Q11 | 部分修 | Q11/Q11b/Q11c:失败角色也补偿、保留 model/appliedModel、整段配置按项目串行、sidecar recovery;真实 session selectModel 故障和 DS-Bot 并发外部写未测 | @@ -114,6 +114,6 @@ node --check sansheng/index.js | P1 缺陷关闭且回归可复现 | F01–F08、F10、F11 仓库内修复/回归;F09 旧包不接管主聊天已在旧包临时止血,新方案不注册 main.conversation | | U/I/G/A/R 必选项 | 自动化项通过;U01/U05/U07/U08 的视觉与真实宿主项未验证 | | E01–E04 | 未执行 → 候选状态 | -| 两包依赖/宿主兼容 | 明确:sansheng 0.2.5 + ds-bot 0.3.2-sansheng.5(本地补丁 M-01–M-06) | +| 两包依赖/宿主兼容 | 明确:sansheng 0.2.6 + ds-bot 0.3.2-sansheng.6(本地补丁 M-01–M-06) | | 数据保留/升级/回退 | v2→v3 只补字段;严格 schema 只拒绝损坏文件并保留 registry;不迁移旧十席数据 | | 真实截图与 UI 复核 | 有测试 profile 浅色截图;真实多项目/深色/窄屏仍缺 | diff --git a/docs/verification/04-release.md b/docs/verification/04-release.md index 09915a2..ec0a4c4 100644 --- a/docs/verification/04-release.md +++ b/docs/verification/04-release.md @@ -1,4 +1,4 @@ -# 发布说明(候选版本 v0.2.5 / ds-bot 0.3.2-sansheng.5) +# 发布说明(候选版本 v0.2.6 / ds-bot 0.3.2-sansheng.6) 日期:2026-11-14 状态:**候选版本**。可用于隔离测试环境;用户日常 desktop profile 未由实施者修改。 @@ -7,10 +7,15 @@ | 包 | 版本 | 文件 | | --- | --- | --- | -| `dsh-sansheng-sansheng` | 0.2.5 | `dist/dsh-sansheng-sansheng-0.2.5.tgz` | -| `ds-bot`(上游 0.3.2 + M-01–M-06) | 0.3.2-sansheng.5 | `dist/ds-bot-0.3.2-sansheng.5.tgz` | +| `dsh-sansheng-sansheng` | 0.2.6 | `dist/dsh-sansheng-sansheng-0.2.6.tgz` | +| `ds-bot`(上游 0.3.2 + M-01–M-06) | 0.3.2-sansheng.6 | `dist/ds-bot-0.3.2-sansheng.6.tgz` | -云端发布:**未执行**。按审查报告“不授权推送或发布”的约束,v0.2.5 只在本地构建了两个 tarball;待用户明确授权后再推送/开 PR/合并/发布。此前 `v0.2.2-sansheng` 仍是在线候选版本。 +云端发布:**未执行**。按审查报告“不授权推送或发布”的约束,v0.2.6 只在本地构建了两个 tarball;待用户明确授权后再推送/开 PR/合并/发布。此前 `v0.2.2-sansheng` 仍是在线候选版本。 + +### v0.2.6 变更(Q08 后台 job) + +- 写工具结果里出现后台 job id 且宿主提供 `ctx.jobs` 时,根租约不再随工具调用返回而释放,而是交给 `jobs.wait`,job 完成/终止后才释放;无 jobs 服务或同步失败时仍按原路径释放。 +- 新增 Q08e 回归:后台 job 未结束前租约保留,结束后释放。 ### v0.2.5 变更(第三轮复审补充) @@ -81,7 +86,7 @@ node pack --pack-destination ..\dist - 真实模型 E2E(E01–E04)未执行;隔离测试 profile 无 API key。 - Q04 记忆边界有真实 memory.js 集成测试(peer stub loader),覆盖群快照/显式 recall;真实模型/宿主记忆注入仍未做。 -- Q08 已覆盖已知写工具、同根/junction 别名、提交与写工具共用根锁、过期租约接管;后台 job 返回后仍会释放租约,第三方工具若绕过这些入口仍可能不受根租约约束。 +- Q08 已覆盖已知写工具、同根/junction 别名、提交与写工具共用根锁、过期租约接管、后台 job `ctx.jobs.wait`;第三方工具若绕过这些入口仍可能不受根租约约束。 - Q11 真实 `selectModel`/忙碌会话故障注入未执行;补偿失败 sidecar `config-recovery.jsonl` 在 Store 完全不可写时也可能失败。 - Q12 有真实 `useSanshengState` Hook 级测试(mini React hooks);真实浏览器像素时间线仍未自动化。 - UI01–UI03 在隔离测试 profile 的浅色 1440×900、深色 1440×900、窄屏 900×700 验证;Bot 详情/终端/文件交叉打开、DS-Bot 先加载顺序仍未操作。 diff --git a/docs/verification/05-delivery-note.md b/docs/verification/05-delivery-note.md index ac44025..edea2c5 100644 --- a/docs/verification/05-delivery-note.md +++ b/docs/verification/05-delivery-note.md @@ -12,7 +12,7 @@ https://git.qyhhh.top/DeepsSeekHarness/dsh-sansheng-liubu/releases/tag/v0.2.2-sansheng - 发布产物:`dist/dsh-sansheng-sansheng-0.2.2.tgz`、`dist/ds-bot-0.3.2-sansheng.2.tgz` - 审查修复 v0.2.3:本地提交(当前 HEAD)(`dsh-sansheng-sansheng@0.2.3` / `ds-bot@0.3.2-sansheng.3`),144/144 回归;按审查“不授权推送/发布”暂未推 Gitea,tarball 只在 `dist/`。 -- 第三轮审查修复 v0.2.5:`dsh-sansheng-sansheng@0.2.5` / `ds-bot@0.3.2-sansheng.5`,157/157 回归;UI01–UI03 原生共存、Q01/Q02 启动保护、Q11–Q13 补强;仍未推送/发布。 +- 第三轮审查修复 v0.2.6:`dsh-sansheng-sansheng@0.2.6` / `ds-bot@0.3.2-sansheng.6`,158/158 回归;UI01–UI03 原生共存、Q01/Q02 启动保护、Q11–Q13 补强;仍未推送/发布。 - 当前状态:候选版本,真实模型 E2E(E01–E04)未执行;日常 desktop profile 未修改。 > 说明:仓库的 `master` 分支仍是旧版结构(工作台/panel 目录),与 `feat/dsbot` 不在同一历史线。 diff --git a/ds-bot/package.json b/ds-bot/package.json index 82c7976..4921b14 100644 --- a/ds-bot/package.json +++ b/ds-bot/package.json @@ -1,6 +1,6 @@ { "name": "ds-bot", - "version": "0.3.2-sansheng.5", + "version": "0.3.2-sansheng.6", "description": "DS Bot: a team of long-lived Bots for DeepSeek Harness, with Main Bots, Bot-to-Bot messages and group chats", "keywords": [ "dsh-plugin", diff --git a/sansheng/package.json b/sansheng/package.json index 26a4a00..c4d88e5 100644 --- a/sansheng/package.json +++ b/sansheng/package.json @@ -1,6 +1,6 @@ { "name": "dsh-sansheng-sansheng", - "version": "0.2.5", + "version": "0.2.6", "private": true, "description": "三省六部:在 DS Bot 团队上提供丞相/尚书/工部三角色、目标门禁与审查记录。", "type": "module", diff --git a/sansheng/src/observe.js b/sansheng/src/observe.js index 60d4d08..3e1e719 100644 --- a/sansheng/src/observe.js +++ b/sansheng/src/observe.js @@ -34,7 +34,7 @@ function textOfResult(result) { export function installObserver({ ctx, store, dsbot, bootId, isBotSession }) { return ctx.on('tools/execute', async (exec, next) => { if (!exec) return next() - if (isWriteTool(exec.name)) return observeWrite({ store, dsbot, exec, next, isBotSession }) + if (isWriteTool(exec.name)) return observeWrite({ ctx, store, dsbot, exec, next, isBotSession }) if (exec.name !== 'group_goal') return next() const action = String(exec.arguments?.action ?? '') if (!isGoalMutation(action)) return next() @@ -157,7 +157,7 @@ export function installObserver({ ctx, store, dsbot, bootId, isBotSession }) { }) } -async function observeWrite({ store, dsbot, exec, next, isBotSession }) { +async function observeWrite({ ctx, store, dsbot, exec, next, isBotSession }) { const actor = resolveActor({ dsbot, store, sessionId: exec.agent?.id, isBotSession }) if (actor.kind !== 'bot' || !actor.project || actor.projectConflict) return next() const project = actor.project @@ -174,15 +174,49 @@ async function observeWrite({ store, dsbot, exec, next, isBotSession }) { const renew = setInterval(() => { store.acquireRootLease(root, { holder, taskId: String(exec.id ?? exec.arguments?.task ?? 'write') }).catch(() => {}) }, 5 * 60 * 1000) + renew.unref?.() + let background = false try { - return await next() + const result = await next() + // Q08:后台 job 的工具调用一返回,宿主的执行已经结束但工作还在跑。 + // 有 ctx.jobs 就把租约交给 job 的 wait,等 job 真正结束后再释放。 + const jobId = backgroundJobIdOf(result) + let jobs + try { jobs = ctx.get?.('jobs', false) } catch { jobs = undefined } + if (jobId && jobs && typeof jobs.wait === 'function') { + const sessionId = exec.agent?.id + try { + const waiter = jobs.wait(jobId, 24 * 60 * 60 * 1000, sessionId) + background = true + void Promise.resolve(waiter) + .catch(() => undefined) + .finally(async () => { + clearInterval(renew) + await store.releaseRootLease(root, holder).catch(() => {}) + }) + } catch { + // wait 同步拒绝时退回普通释放路径。 + } + } + return result } finally { - clearInterval(renew) - // 真实执行结束、抛错或取消都释放;进程被杀时最多留到租约过期。 - await store.releaseRootLease(root, holder).catch(() => {}) + if (!background) { + clearInterval(renew) + // 真实执行结束、抛错或取消都释放;进程被杀时最多留到租约过期。 + await store.releaseRootLease(root, holder).catch(() => {}) + } } } +/** DSH 后台 job id 形如 `-<16 hex>`;只认工具结果里明确出现的 id。 */ +function backgroundJobIdOf(result) { + const direct = result?.jobId ?? result?.job?.id + if (typeof direct === 'string' && direct.trim() !== '') return direct.trim() + const text = textOfResult(result) + const match = text.match(/\b([a-z][a-z0-9-]*-[0-9a-f]{16})\b/i) + return match?.[1] +} + function finalGateReason({ store, dsbot, exec, project, roomId, isBotSession }) { const room = dsbot.roomOf(roomId) const goal = room?.goal diff --git a/sansheng/test/dispatch-v2.test.js b/sansheng/test/dispatch-v2.test.js index afe16db..cec6bda 100644 --- a/sansheng/test/dispatch-v2.test.js +++ b/sansheng/test/dispatch-v2.test.js @@ -39,7 +39,7 @@ function goalAt({ revision = 4, reworks = 0 } = {}) { } } -function fakeEnv({ goal = goalAt(), deliver } = {}) { +function fakeEnv({ goal = goalAt(), deliver, jobs } = {}) { const room = { id: 'room-1', name: '派发项目 · 三省六部', admin: 'b-shang', members: ['b-lead', 'b-shang', 'b-gong'], @@ -66,7 +66,11 @@ function fakeEnv({ goal = goalAt(), deliver } = {}) { if (deliver) await deliver(payload) }, } - const ctx = { handlers: {}, on(event, handler) { this.handlers[event] = handler }, get() { return rt } } + const ctx = { + handlers: {}, + on(event, handler) { this.handlers[event] = handler }, + get(name) { return name === 'jobs' ? jobs : rt }, + } return { room, dsbot, ctx, calls } } @@ -262,3 +266,36 @@ test('Q05c:原生已执行但回执写入失败时,记录标为 unknown 而 await cleanup() } }) + +test('Q08e:后台 job 结果把租约交给 ctx.jobs.wait,job 结束才释放', async () => { + const { store, cleanup } = await tempStore() + try { + await store.saveProject({ ...PROJECT, workDir: 'C:/work/background-root' }) + let finishJob + const jobDone = new Promise(resolve => { finishJob = resolve }) + const waited = [] + const jobs = { + wait(id, timeoutMs, caller) { + waited.push({ id, timeoutMs, caller }) + return jobDone.then(() => ({ id, status: 'completed' })) + }, + } + const { dsbot, ctx } = fakeEnv({ goal: goalAt(), jobs }) + installObserver({ ctx, store, dsbot, bootId: newBootId() }) + const result = await ctx.handlers['tools/execute']( + { name: 'pwsh', id: 'call-bg', arguments: { command: 'long' }, agent: { id: 'sess-shang' } }, + async () => ({ content: [{ type: 'text', text: 'started background job pwsh-0123456789abcdef' }] }), + ) + assert.match(result.content[0].text, /background job/) + assert.equal(waited.length, 1, '应把 job 交给 wait') + assert.equal(waited[0].id, 'pwsh-0123456789abcdef') + assert.equal(waited[0].caller, 'sess-shang') + assert.match(store.rootLeaseOf('C:/work/background-root')?.holder ?? '', /^b-shang:call-bg:/, 'job 没结束前租约必须保留') + + finishJob() + await new Promise(resolve => setTimeout(resolve, 20)) + assert.equal(store.rootLeaseOf('C:/work/background-root'), undefined, 'job 结束后释放租约') + } finally { + await cleanup() + } +})