8.1 KiB
保存后数据库占用:修复与验收
日期:2026-11-18。分支:codex/issue29-blocking-cleanup,基础提交:cdbc92f。范围为保存后的源文件绑定、占锁交接、诊断与收尾错误;不涉及独立校验工作台。
问题与处理
先前 mentor-live/first-project 的 RL02、RL05 两处替换及 Save/CloseProject 已返回,随后 bind_project_commit_source() 读取 database/icdb.dat 时发生 PermissionError。该异常被归为通用错误,外层资源释放错误又掩盖了原始位置。历史日志缺少底层 Windows 代码和持锁者证据,仍不能认定当时的具体持锁进程。
现在先验证 CAD 身份及工程确实关闭,固定保存 marker、原始尝试和目标证据到 project-save-pending.json,再进行源文件绑定。只有绑定成功才发布完整 project-checkpoint.json 并登记工程检查点。等待期间显示“工程已保存,等待数据库释放后核验”;不是已经核验成功。
flowchart TD
A[替换、保存及关闭工程] --> B[验证空工程与本批身份]
B --> C[保留保存 marker 和原始尝试证据]
C --> D[读取保存源文件]
D --> E{读取结果}
E -- 正常 --> F[绑定稳定源文件及命令摘要]
E -- Windows 32 / 33 --> G[记录错误及持锁观察,最多等待 3 秒]
E -- 权限、缺失等 --> P[已保存但待核验,保留首发原因]
G --> D
G -- 仍占用 --> H[再检查暂停意图,正常退出本批 Mentor 一次]
H -- 正常退出 --> I[再次读取,最多等待 3 秒]
H -- 强杀或收尾未确认 --> P
I -- 仍占用或暂停 --> P
I -- 可稳定读取 --> F
F --> J[从保存副本导出原生数据并核验目标]
J --> K[提交真实回执,任务完成]
Windows 读文件使用 CreateFile 保留原生错误码,使用与后续 CRT 校验一致的 READ/WRITE 共享模式。仅 32(共享冲突)、33(锁冲突)进入等待;5(权限不足)、2(文件缺失)等直接形成明确的 saved_source_pending 错误。源文件读前后的工程摘要必须一致,改变或不可确认时保留待核验。
退出回调只存在于受管理 runtime 的已关闭工程、已验证保存 marker 分支。正常可读时继续复用 CAD;异常才走现有身份绑定的正常 Quit。该路径不派发替换,也不重新打开原工程。退出失败或需要强杀时,不绑定成功证明;资源释放和业务待核验分别保留。暂停会阻止进入退出回调,并在诊断、读取恢复后重新检查。已请求普通暂停但未遇锁的安全保存收尾仍沿用原流程。
首次锁冲突使用 Windows Restart Manager 只读查询候选进程,记录 PID、创建时间和名称。结果是该接口返回的观察,不是穷举全部内核句柄;空结果或查询失败均不授权结束任何外部进程。查询后重读,防止用已经过时的锁状态触发 CAD 回收。
saved-source-status.json 保留同一 session token、同一工程的首发错误、持锁观察及回收事实,后续 SQL 回执再次绑定时不会覆盖它;新 token 重置诊断。该文件不是成功证明,实际源文件始终重新验证。operation-events.jsonl 保留绑定及 Mentor 退出调用的先后顺序。多层资源异常仍显示最初的保存读取错误;诊断写入失败通过附注保留,不能替换首发错误。
验收结果
证据根目录:D:/CodexValidation/saved-source-20261118/。测试 XML 在仓库 build/managed-desktop/,集合有交集,不累加为独立用例或业务样本数。
| 验证 | 结果 | 证据 |
|---|---|---|
| 保存、runtime、回执、恢复与反馈相关回归 | 124 passed,108.18 秒 | saved-source-regression-final.xml |
| 源文件交接及资源状态增量回归 | 64 passed,26.56 秒 | saved-source-delta-final.xml |
| 最终专项,Windows 默认 GBK 环境 | 21 passed,5.52 秒 | saved-source-handoff-final.xml |
| 最终原生文件锁探针 | 20 个样本通过,28.320 秒 | native-final-02/report.json |
| 原失败双目标工程,正常运行 | 2 saved / 0 failed,原生回读通过 | mentor-dual/report.json |
| 双目标工程,保存后注入真实锁 | 2 saved / 0 failed,正常退出后核验通过 | mentor-dual-fault/report.json、fault-result.json |
新逻辑均先观察失败再修复;覆盖权限/缺失不重试、短暂锁、持续外部锁、源文件变化、暂停在诊断中到达和在退出提示后到达、强杀/退出未确认不发布证明、日志写失败、嵌套异常、诊断再绑定历史、下一工程新代次和可选进度损坏。独立只读审查提出的具体问题已修复,最终复查无剩余可操作发现。
20 个原生文件锁样本
脚本:tools/probe_saved_source_handoff.py。使用合成工程与文件,不启动 CAD。五种场景各 4 次:短暂独占锁、退出持有者后读取、持续外部锁、等待中暂停、文件缺失。真实 CreateFile 独占锁返回 32;Restart Manager 查到已知 fixture 进程。仅前两类最终绑定成功,其余保留 pending,退出回调次数受限,均不执行替换。真正 ACL 拒绝不通过修改用户 ACL 制造,错误 5 由专项测试模拟。
探针中的退出回调只释放其自建 fixture 进程,不能当成真实 Mentor 回收测试。首轮 native-01 曾发现诊断耗时导致使用旧冲突触发退出,报告保留;补重读及回归后通过,最终又以默认编码环境运行。20 个文件锁样本不是 20 个 BOM 业务样本。
两次真实 Mentor 双目标验收
两个独立的新副本均替换 RL02、RL05:4100-CA3300-T7 → 4100-CA3300-2200。从保存后的原生数据独立读取两个目标及其余未选位号;每次仅一个 VBS worker、一次 OpenProject、一次保存,没有重放。
| 指标 | 正常双目标 | 注入锁双目标 |
|---|---|---|
| 队列耗时 | 257.842 秒 | 271.420 秒 |
| saved / failed | 2 / 0 | 2 / 0 |
| 任务 / 操作状态 | completed / verified | completed / verified |
| CAD 代次 | 1 | 1 |
| 正常退出 / 强杀 | 正常 / 无 | 正常 / 无 |
| CAD 退出耗时 | 16.625 秒 | 5.688 秒 |
正常运行没有复现历史锁。故障运行由 build/managed-desktop/live_saved_source_fault.py 在已保存关闭后,用一个自建独立进程持有副本数据库的只读独占句柄;产品调用正常退出 Mentor,驱动确认退出回调返回后才释放 fixture,然后由产品继续核验。fault-result.json 证明注入成功、退出回调确实调用且运行退出码为 0。外部 fixture 并非被产品杀死,不能据此声称 Mentor 的 Quit 可以关闭任意外部文件句柄。
故障时间线(本地时间):18:16:39.722 开始绑定,18:16:43.192 开始正常退出 Mentor,18:16:48.910 退出返回,18:16:49.806 绑定完成。两次总耗时差异包含 CAD 运行波动,不能直接视为等待逻辑的固定开销。
任务 ID:正常 d9a1c9af-7a39-4659-a445-a682c8c41a91;故障 be954b05-2b8c-4990-a74f-e18655ca93af。两次任务数据库均 completed、两个操作均 verified;全部已记录写进程身份退出,受管理桌面消失。原始备份 34 文件 SHA-256 全部未变化。
真实故障验收后发现并修正同 token 诊断被第二次绑定覆盖的问题;暂停、嵌套报错、编码及诊断保留的最终增量由专项和资源回归验证。真实工程写入场景未为这些诊断增量重复执行。
边界
历史失败的具体持锁者仍不可从旧日志还原,本次修复并验证的是这类冲突的交接处理。持续的外部锁、真正权限不足、文件变化及强杀后不确定写入继续保留待核验,不能算执行成功,也不会自动重替换。
如果在完成源文件绑定之前退出程序,只保留保存 marker 和原始尝试,现有恢复逻辑不会把未绑定的 project-save-pending.json 当成成功证明。该状态仍需核对原结果,不提供自动重放或自动成功恢复。
未构建安装包、推送或发布版本;未修改原工程、中心库、系统配置和外部 Agent。