fix(observe): 后台 job 租约交给 ctx.jobs.wait(v0.2.6)

- 工具结果含 job id 且宿主有 ctx.jobs 时,租约保留到 job 结束
- 无 jobs 服务/同步失败回退原释放路径
- Q08e 回归;158/158 tests
This commit is contained in:
qyh15 2026-11-14 11:35:42 +08:00
parent 39d905add8
commit 37ee2d4a6f
9 changed files with 100 additions and 24 deletions

View File

@ -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
```

View File

@ -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) |

View File

@ -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 浅色截图;真实多项目/深色/窄屏仍缺 |

View File

@ -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 <path-to-pnpm.cjs> 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 先加载顺序仍未操作。

View File

@ -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` 不在同一历史线。

View File

@ -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",

View File

@ -1,6 +1,6 @@
{
"name": "dsh-sansheng-sansheng",
"version": "0.2.5",
"version": "0.2.6",
"private": true,
"description": "三省六部:在 DS Bot 团队上提供丞相/尚书/工部三角色、目标门禁与审查记录。",
"type": "module",

View File

@ -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 形如 `<kind>-<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

View File

@ -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()
}
})