Compare commits

..
Author SHA1 Message Date
阿白叔 ec9f8a3e40 docs: record review 430 tests and frozen native smoke 2026-11-16 10:04:10 +08:00
阿白叔 fa5590468d fix: separate skipped writes and file proof from native release 2026-11-16 09:53:29 +08:00
阿白叔 fee4a67ff1 fix: address review 414 write consent and native ownership boundaries 2026-11-13 17:32:14 +08:00
阿白叔 1572e2d8ca fix: decouple CBB imports from optional export diagnostics 2026-11-13 15:29:00 +08:00
abaishu0730 cbc5723849 Merge pull request '修复原生调用停止、管理监督与只读状态边界' (#13) from codex/runtime-lifecycle-safety into main 2026-11-12 17:40:05 +08:00
abaishu0730 b2ddd76a04 Merge pull request '审查拆分 4/4:残留释放边界、确认留证与 0.2.4b1 契约' (#12) from codex/review-residual-release into main 2026-11-12 17:39:46 +08:00
abaishu0730 39af2112e3 Merge pull request '审查拆分 3/4:独立后台检查与中心库管理界面' (#11) from codex/review-ui-integration into main 2026-11-12 17:39:30 +08:00
abaishu0730 229df4b0ef Merge pull request '审查拆分 2/4:原生诊断、工程清单与 CBB 事务后端' (#10) from codex/review-native-backend into main 2026-11-12 17:39:13 +08:00
阿白叔 9eea9a4c20 fix: explain blocked export evidence and show batch results before refresh 2026-11-12 17:36:34 +08:00
阿白叔 466f400514 fix: scope release proofs and bind PCB opening consent 2026-11-12 16:02:53 +08:00
阿白叔 42d0cebc54 fix: address defects found in frozen native acceptance 2026-11-12 11:33:44 +08:00
阿白叔 b86e4e315a test: simulate all UI buttons and handle log folder errors 2026-11-11 16:22:14 +08:00
阿白叔 42e8719026 fix: keep residual release controls aligned with live queue state 2026-11-11 14:56:08 +08:00
阿白叔 fdd07224aa docs: record full review fixes and final 1775-test validation 2026-11-09 14:49:45 +08:00
阿白叔 a045683c8a fix: publish management receipt before orphan-exitable terminal state 2026-11-09 14:44:09 +08:00
阿白叔 74a45eb5cf Merge branch 'codex/review-residual-release' into codex/runtime-lifecycle-safety 2026-11-09 14:34:32 +08:00
阿白叔 a7df105616 fix: recreate batch resume action after release summary retirement 2026-11-09 14:34:28 +08:00
阿白叔 78ff118f82 fix: preserve accepted native calls and explain retained queue waits 2026-11-09 14:33:44 +08:00
阿白叔 d0a5ce5d17 Merge branch 'codex/review-residual-release' into codex/runtime-lifecycle-safety 2026-11-09 14:10:38 +08:00
阿白叔 363a279157 Merge branch 'codex/review-ui-integration' into codex/review-residual-release
# Conflicts:
#	src/cbb_refresh_verify/ui/main_window.py
2026-11-09 14:10:30 +08:00
阿白叔 306aa5c544 fix: centralize native dispatch and itemize retained session release 2026-11-09 14:03:07 +08:00
阿白叔 0fca6abb4e Merge branch 'codex/review-native-backend' into codex/review-ui-integration 2026-11-09 14:02:14 +08:00
阿白叔 342a7266c7 fix: retire result dialogs and clarify batch lifecycle 2026-11-09 13:51:32 +08:00
阿白叔 e8a1714d95 fix: clarify backend status freshness and scoped copy evidence 2026-11-09 13:50:04 +08:00
阿白叔 60101b7195 Merge branch 'codex/review-residual-release' into codex/runtime-lifecycle-safety
# Conflicts:
#	src/cbb_refresh_verify/ui/residual_release_dialog.py
2026-11-09 13:47:18 +08:00
阿白叔 14c9a74bbf fix: show confirmed scope beside actual residual release results 2026-11-09 13:45:53 +08:00
阿白叔 42898d33d2 chore: pin reviewed Python line endings and record stack validation 2026-11-09 10:48:20 +08:00
阿白叔 b1c36e3ca6 Merge branch 'codex/review-residual-release' into codex/runtime-lifecycle-safety
# Conflicts:
#	src/cbb_refresh_verify/residual_sessions.py
2026-11-09 10:41:24 +08:00
阿白叔 651b539d0e fix: isolate unreadable residual sessions and bound release evidence 2026-11-09 10:39:16 +08:00
阿白叔 35daa77118 Merge branch 'codex/review-ui-integration' into codex/review-residual-release 2026-11-09 10:26:20 +08:00
阿白叔 e73f9c6edc Merge branch 'codex/review-native-backend' into codex/review-ui-integration 2026-11-09 10:26:13 +08:00
阿白叔 b7baa24b5e fix: identify foreign CBB checkpoints in release evidence 2026-11-09 10:26:09 +08:00
阿白叔 ca39fb3517 fix: clear verified queue blockers and exit idle orphan workers 2026-11-09 10:11:36 +08:00
阿白叔 96e179ba65 docs: record corrected icon candidate verification 2026-11-06 17:29:18 +08:00
阿白叔 44bb734de8 fix: preserve the current application icon in lifecycle candidate 2026-11-06 17:24:58 +08:00
阿白叔 1494dc260c docs: link draft runtime lifecycle review 2026-11-06 17:07:20 +08:00
阿白叔 8e946c6e7a docs: record runtime lifecycle validation and candidate limits 2026-11-06 16:59:58 +08:00
阿白叔 5873b7146b chore: prepare runtime lifecycle candidate 0.2.4b2 2026-11-06 16:44:12 +08:00
阿白叔 051498ba57 fix: require a durable boundary before native add submission 2026-11-06 16:41:36 +08:00
阿白叔 d9a79b6535 fix: reconcile reused identities and protect every native dispatch 2026-11-06 16:21:08 +08:00
阿白叔 cb11624b68 fix: observe retained sessions without blocking independent libraries 2026-11-06 15:42:40 +08:00
阿白叔 6278091f21 fix: supervise management calls across cancellation and parent loss 2026-11-06 15:42:36 +08:00
阿白叔 8d3eab1164 fix: preserve native calls on stop and keep status reads observational 2026-11-06 15:42:33 +08:00
阿白叔 97a3de20c9 feat: persist and reconcile owned native sessions 2026-11-06 15:42:29 +08:00
阿白叔 7bd7cd3966 feat: distinguish save close and resource release facts 2026-11-06 14:33:10 +08:00
阿白叔 3e7ae2b76f docs: plan native lifecycle safety and read-only status boundaries 2026-11-06 14:25:09 +08:00
阿白叔 5eb4b2d7ed fix: persist release outcomes and guard active native backup sessions 2026-11-06 12:08:54 +08:00
阿白叔 d40192ee58 Merge branch 'codex/review-ui-integration' into codex/review-residual-release 2026-11-06 11:41:05 +08:00
阿白叔 3c1998f2ef Merge branch 'codex/review-native-backend' into codex/review-ui-integration 2026-11-06 11:41:03 +08:00
阿白叔 807aa26baf test: guard actual reads of unrelated CBB content 2026-11-06 11:41:00 +08:00
阿白叔 71029b19a2 Merge branch 'codex/review-ui-integration' into codex/review-residual-release 2026-11-06 11:36:21 +08:00
阿白叔 8c2c60fab1 fix: distinguish native outcomes from report and item recovery status 2026-11-06 11:36:19 +08:00
阿白叔 5b22787418 Merge branch 'codex/review-native-backend' into codex/review-ui-integration 2026-11-06 11:34:27 +08:00
阿白叔 679f33b8cc fix: keep prelaunch release-probe failures from stopping independent work 2026-11-06 11:34:25 +08:00
阿白叔 746e5b5145 Merge branch 'codex/review-native-backend' into codex/review-ui-integration 2026-11-06 11:21:21 +08:00
阿白叔 8eefecd9f0 fix: reconcile historical leases and record scoped native changes 2026-11-06 11:21:15 +08:00
阿白叔 d8156c57f0 Merge remote-tracking branch 'origin/main' into codex/review-native-backend 2026-11-06 11:14:58 +08:00
abaishu0730 959399b974 Merge pull request '审查拆分 1/4:只读占用探测与可取消任务队列' (#9) from codex/review-infrastructure into main 2026-11-06 10:25:10 +08:00
abaishu0730 46dae81190 Merge pull request 'docs: CBB Verify 全量扫描与阻塞分析(关联 #4)' (#5) from docs/scan-20261104-blockers into main 2026-11-06 10:20:23 +08:00
阿白叔 dc536da555 docs: record published review chain and completed verification 2026-11-05 23:33:46 +08:00
阿白叔 173dee1980 feat: add confirmed client release with durable consent and server protection 2026-11-05 23:31:36 +08:00
阿白叔 282be7be7f feat: integrate independent background checks and native management UI 2026-11-05 23:25:25 +08:00
阿白叔 da67de026f feat: integrate native diagnostics and coordinated CBB transactions 2026-11-05 23:18:00 +08:00
阿白叔 9e230e1a46 feat: add bounded read-only owner probes and cooperative native queue 2026-11-05 23:04:35 +08:00
abaishu0730 a56fd17b60 Merge pull request 'fix: release private desktop resources on launch failure' (#8) from codex/desktop-leak-main into main 2026-11-05 15:23:08 +08:00
阿白叔 766d67cb57 test: enforce desktop cleanup interfaces and guard reader setup 2026-11-05 14:59:19 +08:00
阿白叔 311d0dd9a4 fix: release private desktop on worker launch failure 2026-11-05 14:47:03 +08:00
abaishu0730 3dbfca0f44 docs: record full project scan and blocker analysis (#4) 2026-11-04 15:20:37 +08:00
阿白叔 39985f7cfd chore: release v0.2.3-beta.1 2026-10-29 09:54:10 +08:00
abaishu0730 ac9836a2d5 Merge pull request '增加 ICDB 全库维护与 CBB 备份恢复弹窗,完善会话安全处理' (#1) from codex/icdb-global-repair into main
Reviewed-on: #1
2026-10-28 20:57:02 +08:00
阿白叔 cdb8a6a28b feat: add ICDB maintenance and verified CBB backup recovery dialog 2026-10-28 19:43:07 +08:00
阿白叔 a851e47eca docs: record verified iCDB recovery trial and delivery scope 2026-10-27 18:15:00 +08:00
阿白叔 9cd4968a97 fix: enforce native repair ownership and cancellation boundaries 2026-10-27 18:08:14 +08:00
阿白叔 2490067b2d fix: prevent iCDB disconnects and recover failed projects 2026-10-27 17:51:53 +08:00
阿白叔 8a517d6f38 fix: diagnose iCDB lost sessions and stop unsafe verification 2026-10-27 16:38:51 +08:00
278 changed files with 39770 additions and 1161 deletions

No files matched your search

+3
View File
@@ -1,3 +1,6 @@
# Keep the verified Windows source and binary assets byte-for-byte.
# Do not normalize the r4 baseline's line endings during add/checkout.
* -text
# Normalize only these two reviewed Python files at the chain tip.
src/cbb_refresh_verify/application.py text eol=lf
src/cbb_refresh_verify/ui/main_window.py text eol=lf
+32 -8
View File
@@ -1,8 +1,32 @@
# CBB 中心库上传后校验工具
当前补丁:**[v0.2.2-beta.1](docs/releases/v0.2.2-beta.1.md)(Beta 预发布,待现场验收)**,替代 0.2.1。数据库所有权或关闭状态不确定时停止批次、保留现场;不自动移走地址文件、接管带锁设计或强杀 PCB 进程树。已修复真实试跑发现的已验证块重复 Forward Annotation 问题,以及工程文件编码、目录越界、互斥和依赖漏洞。详见 [本地验证与安全审查](docs/releases/2026-10-26-local-validation-and-audit.md)。下方日期记录描述历史版本,以本补丁说明为准。
当前临时分支的备份策略(2026-11-03):应用不再自动备份中心库或 CBB 工程。新增、替换、移除、校验、ICDB 维护和恢复在执行前提示手动备份;请自行保留可用副本。导入暂存、恢复用隔离验证库和轻量操作证据仍会生成,Mentor 原生 Repair 自身的备份行为保持不变。详见[自动备份检查与调整](docs/releases/2026-11-03-manual-backup.md)。此条优先于下方历史版本的备份说明。
当前开发版本:**[0.2.4b2 生命周期候选](docs/releases/2026-11-06-runtime-lifecycle-candidate.md)(开发候选,待现场验收)**。ICDB 批量检查在后台逐项运行,普通校验、管理和恢复可排队;READY 工程在实际执行前再次排除。检查不自动 Repair、Restore 或选择历史版本,也不代表中心库 READY。
本目录是独立的 CBB 中心库上传后校验工具,不属于 Part Replacement,也不负责 CBB 工程复制或中心库上传。
停止、超时或应用失联只停止后续原生动作,不结束正在 Save/Close 的调用进程。普通停止等待 5 秒,可能正在写入时最多等待 120 秒后交给后台观察;这不是强制结束时限。保存结果、关闭结果和资源释放分别记录。相关库等待释放,独立库可以排队继续;界面、筛选和日志保持可用。重启只核对未完成会话,不重放管理写操作。legacy 状态读取只观察已打开且匹配库的 LM,不启动 LM 或回答弹窗;无法读取保持 UNKNOWN。
历史释放记录会触发实际占用复核,确认释放后归档继续;会话释放不等于历史数据恢复。释放结果逐项保存;记录保存失败会单独显示,不把已确认释放的会话重新标成占用。可查看后台窗口的原生提示;仅对当前可识别的原生取消按钮提供确认操作。
自动流程不强杀原生会话;释放入口默认正常关闭。另有单独确认的“强制结束客户端”操作,仅限属于当前 Windows 用户和会话、归属及进程身份已确认的 PCB、Library Manager、DxDesigner/viewdraw、iCDB Project Backup 客户端。**ICDB 数据库服务器、后台导入器和归属未知的进程不允许强制结束**,即使命令指向当前库也不例外。客户端中其他已打开工程可能一并退出、未保存更改可能丢失;必须先记录确认名单,结束后重新证明库已释放,不能宣称数据库已修复。详见 [操作规程](SOP.md) 与 [版本说明](docs/releases/v0.2.4-beta.1.md)。下方日期记录为历史行为,以本说明为准。
本目录是独立的 CBB 检验、ICDB 维护和中心库管理工具,不属于 Part Replacement;管理入口接收已整理好的完整 PRJ/PCB 工程。
导入不运行 ASCII、CSV 或 EDIF 导出。新增/替换确认原生注册、目录复读、工程关联、顶层块及 Layout;顶层块允许保持来源名,或由原生导入改为本次 CBB 注册名,映射会单独记录。其余工程文件差异保留清单供核对,不以原生改写 PRJ 或运行历史判定导入失败。原生重写 ICDB 后不比较其原始字节,也不宣称已证明原理图语义等价。上传后自动校验可独立勾选,只有完整原生 Verify 和权威 READY 才显示校验通过。无效来源或已释放的单项失败逐项报告,不影响后续独立条目。
针对 `The last server session ... lost the connection to the database`,修复分支增加
`ICDB_REPAIR_REQUIRED` 专项识别、共享符号库路径诊断及停止批次处理。现场原生修复步骤及实现边界见
[iCDB 旧服务器会话失联分析](docs/diagnostics/2026-10-27-icdb-lost-server-session.md)。
当前应用入口仅检查工程打开情况,不自动 Repair。需要修复或回退时由用户在原生版本与备份界面选择,操作前请手动备份;共享符号库故障不得通过修复无关的 CBB 工程替代。
## 当前验证范围与已知限制
Windows 11 / Mentor EE7.9.5 隔离库已完成原生更新、备份恢复、校验到 READY 和释放验证,记录见 [2026-11-12 验证](docs/releases/2026-11-12-scoped-release-validation.md)。历史候选包仅证明对应提交,后续代码合并不等同于现场验收或正式发布。
- A/B 输入的独立 EDIF 导出曾返回 `0xC0000005`,根因尚未定位;该导出已从普通导入流程移出,不能据此判定导入失败或 ICDB 损坏。
- Windows 10、跨机器共享库和现场服务器会话失联的一致故障副本尚未验收。跨机器释放依赖 SMB 共享模式语义,目前没有跨机器实测证明。
- 自动 ICDB Repair 保持关闭。共享库原生服务器若无法删除自身地址文件,或早停后仍有原生弹窗,需要继续核对;不以进程列表为空或端口不可达代替释放证明。
- 验收文档中的本机路径、原始日志、截图、测试 XML 和冻结包不随 Git 分发;仓库保留说明及摘要,原始材料须在验收机器查看或另行归档。
## 功能边界
@@ -135,8 +159,8 @@ python -m cbb_refresh_verify
- **不注入鼠标或键盘输入,不切换 Windows 桌面,不改写中心库源文件。** 生产路径在本次运行创建的私有桌面内启动中心库目录绑定的 ReusableCircuit PCB,随后用 COM 完成刷新、保存和关闭;只读状态桥在结束后确认 LMC 的 READY。Library Manager 菜单派发仅作为显式诊断路径保留。`tests/test_safety.py` 会在离线测试中阻止真实输入注入 API 重新进入生产代码。
- 所有自动化都跑在本进程创建的**私有 Windows 桌面**上:用户看不到窗口,光标不会被移动。
- 弹窗只认领本次运行自己启动的进程,并在该进程的私有桌面内投递 `BM_CLICK`。数据库异常恢复提示默认选择“最后一次用户保存的数据库”;其他弹窗优先确认/继续/恢复,只有 Project Integration 进度窗(仅有 Cancel)保持不动。所有弹窗文本和实际控件 ID 都写入 `dialogs.jsonl`。
- 超时或失败时停止自动化客户端,保留可能仍在写库的原生会话并停止批次。监督器核对进程是否退出,记录 `process_exit_confirmed` 或 `process_retained`;无法确认释放时输出 `recovery-required.json`,不以强杀代替数据库安全关闭。
- 弹窗只认领本次运行的私有桌面/进程,依据已知规则投递 `BM_CLICK`。数据库恢复、会话失联和设计锁接管提示会阻断并保留现场;不会自动选择恢复或接管。未知弹窗也会阻断,Project Integration 进度窗保持观察。动作/错误弹窗和实际控件 ID 写入 `dialogs.jsonl`。
- 超时或失败时请求合作停止,保留可能正在原生调用的 worker 和保存/关闭助手,并交后台观察。内容检查超时同样不强杀进程树。保存结果未知时不再自动丢弃关闭;无保存助手且身份、空闲状态已确认的启动/集成失败仍可正常收尾。无法确认释放时保留 `recovery-required.json` 和相关库租约。
## 环境要求
@@ -163,7 +187,7 @@ Windows 版本判断以 Build 为准:`22000` 及以上归为 Win11,`10240–
## 批量策略
每个 CBB 独立执行并写入自己的 evidence 和结果行。缺少 PCB/PRJ、内容检查失败、刷新失败或超时只影响当前项,记录 `BLOCKED/FAIL/TIMEOUT` 后继续下一项;不会因为单项失败终止整批。只有点击“当前项完成后停止”(或执行器返回 `QUEUE_STOP`)才把后续项目标为 `SKIPPED`。
每个 CBB 独立执行并写入自己的 evidence 和结果行。资源已释放的单项失败允许继续;未释放时跳过后续同库写入,独立库仍可运行。ICDB 错误本身不等于占用。用户取消或执行器明确返回 `QUEUE_STOP` 才停止本批次后续项,不自动恢复或重放该批次。
GUI 中状态为 `绿色 / Ready` 的条目不能勾选、也不会进入批量队列。
@@ -196,11 +220,11 @@ Mentor 桥耗时需在目标机器另行测量。
- `save.log`:`LICENSE_OK / SAVE_OK / IS_SAVED / POST_SAVE_SYNCHRONIZED / CLOSE_OK / QUIT_OK`;
- `result.json`:状态、中心库标志读取结果、阻断原因;
- `image-status-map.json`:按中心库路径隔离的本机动态 `image_id` 校准快照(当前格式 `schema_version=2`);旧版本或无版本缓存会自动忽略并重新校准,日志会记录当前样本、缓存样本、Ready 主 ID、未映射 ID 和逐项决策原因;
- `backup/`:仅本地盘操作前的稳定文件副本;网络盘/UNC 跳过前置递归备份(`backup_skipped`);`database/LogFiles/tmp` 等易变目录和日志文件会排除,备份超时或失败不会阻断 PCB 校验。每个 CBB 结束后默认自动删除该目录,只保留 `events.jsonl`、`dialogs.jsonl`、`save.log` 和 `result.json` 等轻量证据。
- `backup/`:历史版本的辅助文件副本;当前分支不再生成,所有路径记录 `backup_skipped / manual_backup_policy`。已有历史副本不由本轮改动清理。
超时采用无进展计时:界面和批量请求默认 600 秒无进展超时;它不是整个 CBB 的固定总时限,而是连续 600 秒没有可观察进展时才终止。PCB/COM 阶段切换、Project Integration 状态变化、保存标记变化和弹窗处理都会刷新计时器;重复的状态轮询不算进展。需要更快失败时仍可在界面将单项预算调低,但 30 秒只适合已确认 PCB 启动稳定的环境。
超时采用无进展计时:界面和批量请求默认 600 秒没有可观察进展时进入停止与观察流程,不强杀正在进行的调用。PCB/COM 阶段切换、Project Integration 状态变化、保存标记变化和弹窗处理都会刷新计时器;重复的状态轮询不算进展。需要更快失败时仍可调低单项预算,但 30 秒只适合已确认 PCB 启动稳定的环境。
结果不会把“内容检查 PASS”冒充为中心库绿色状态:`library_flag` 只来自对条目状态的只读读取,读不到就是 `UNKNOWN`。Mentor 的树节点 `iImage` 是本机资源列表索引,不能跨安装固定写死为绿色;工具会在日志中为每个 CBB 记录 `image_id`,并从独立的 `Cert/Work` 持久化证据动态校准本机 ID。树 ID 可读时用于交叉核对,冲突不允许标记 Ready;LM 忙导致树 ID 暂时读不到时,完整的持久化证据仍可保留 Ready,缺少持久化证据的条目仍进入待校验。右键菜单文字(包括 `Unverify`)不参与状态判定。
结果不会把“内容检查 PASS”冒充为中心库绿色状态。默认权威桥读取 READY/raw=1;桥失败保留未知/不可用。显式 legacy 模式只观察已有匹配 LM 的树图标,图标不可读时保持 UNKNOWN,不以 Cert/Work 文件直接推断 READY 或 PENDING,也不自动回答原生提示。右键菜单文字(包括 `Unverify`)不参与状态判定。
### 状态接口审计
+49 -1
View File
@@ -1,4 +1,52 @@
# CBB 中心库上传后校验操作规程
# CBB 检查、校验、管理与残留释放操作规程
适用开发版本:0.2.4b2。未完成现场验收,不自动发布或关闭工单。以下为当前规程,下方旧上传校验检查表保留为历史参考。
## 当前操作与队列
选择中心库 `.lmc`,核对 CBB 名称、分区及完整 PRJ/PCB 工程。写操作和人工修复前由操作员保存可用一致备份;应用不自动备份整个中心库,隔离验证/暂存副本不代替人工备份。
普通校验完成原生打开、身份确认、Project Integration、保存和关闭后,必须由权威状态 READY/raw=1 确认成功。ICDB 检查仅尝试打开并检查本次错误,不自动 Repair、Restore 或选择版本,CHECKED 不等于 READY。排队期间变成 READY 的工程在执行前跳过。
原生任务串行排队,检查每项结束后让出机会;缓存筛选保持可用。失败项确认释放后继续独立项目;未释放会话转后台观察,只保留相关库的写入限制,独立库可继续。“停止检查”只取消检查,“取消当前任务并停止队列”取消当前批次后续动作;正在保存/关闭的调用只等待返回。普通等待 5 秒,可能正在写入时最多再等到 120 秒后交后台,这不是结束进程的期限。
保存已返回成功、关闭失败、资源仍占用可以同时出现。查看本轮保存/关闭标记和独立释放结果,不能因进程退出就认定工程已保存。管理更新若已经移除、尚未重新导入就取消,按“需恢复”核对,不自动补做下一次导入。重启发现未完成任务时只核对身份和资源,不自动重放。
权威状态桥不可用时保留未知/不可用;legacy 读取只观察已打开且库身份匹配的 Library Manager。没有匹配窗口、存在模态提示或树不可读时返回 UNKNOWN,不自动启动或应答窗口。
新增拒绝同名冲突;更新先原生移除再导入,失败可能需要人工备份恢复;移除后重新读取目录确认。版本回退由操作员在原生界面选择,核对工程内容后单独校验。
新增和替换不调用 ASCII/CSV/EDIF 导出器;原生成功回执、重新读库、目标工程关联、顶层块及 Layout 确认后记录上传完成,不等同于 READY 或原理图语义等价。顶层块允许来源名或本次 CBB 注册名,保留原生命名变换记录;其他名称仍拒绝。其余文件差异单独保留清单并提示核对,不因 PRJ 规范化或历史记录差异阻止后续条目。可在批次开始前取消“上传后自动校验”。来源旧库路径可在暂存副本中改为所选目标库,来源原件不改;无效来源按行报告,已释放的失败不阻止后续条目。
## 历史记录、操作结果与报告
校验和管理遇到历史释放记录时,先复核实际进程、地址、独占文件及导出副本。确认释放后归档记录再继续,不以历史 JSON 本身判定真实占用;同目标未完成写入仍需核对,不自动重放。释放证明在管理首次原生调用前写入检查点,并在结果中保留。
管理操作生成目标工程、库配置和共享依赖的写前/写后主要文件清单及新增、删除、修改差分;不增加自动全库备份,也不声称检查了其他 CBB 内容。报告不可用与原生操作失败分别记录;本任务已释放时可继续独立项。
## 默认释放与单独确认的强制客户端操作
1. 停止新任务,预览当前库的工程、程序、PID 和历史记录。默认“确认释放”仅正常关闭作用域及当前身份已确认的客户端。未保存更改由操作员选择保存、放弃或保留;未知提示保持现场。
2. 数据库服务器可能服务同库其他用户。本工具不允许强制结束服务器,命令行指向本库也不构成独占授权;由库管理员核对用户和服务器状态。
3. “强制结束客户端”是另行确认的异常处理,只允许属于当前 Windows 用户和会话、已确认作用域和精确进程身份的 Expedition PCB、Library Manager、viewdraw、iCDB Project Backup 客户端。后台导入器、脚本宿主和归属未知的进程同样不在强制名单。
4. 警告明确告知客户端中其他已打开工程可能一并退出、未保存更改会丢失、写入中的工程可能需要恢复。执行前持久保存库外 `consent.json`,包含目标库、名单、创建身份和排除项;写入失败不执行。派发处核对快照身份和原预览范围,最终句柄处核对创建时间、完整映像、用户 SID、Windows 会话和原生活动;变化时拒绝。
5. 预览和执行前检查进度与本轮 Output。本工具登记的 Save/Close/原生调用尚未确认返回,或 Backup/Restore/Repair 进行中、状态无法确认时,不放行普通“强制结束客户端”。可查看后台窗口的标题、输出和所在桌面;仅当当前窗口唯一存在已识别的 Cancel/取消按钮时,提供单独确认的原生取消。核对身份、用户会话和按钮快照后发送请求,再重新检查实际结果;没有识别到按钮时不猜菜单参数,不抢占前台。
6. 每项动作前后持久记录实际结果,异常保留已完成/未执行项。若最终记录保存失败但独立库释放证明已确认,界面明确提示记录失败并接受释放事实,不伪造新的占用。
7. 客户端退出仅证明进程结束,不表示修复成功或 READY。服务器仍活跃或库状态未知时保留 PARTIAL、检查点和映射。只有完整的独立释放证明才解除匹配的历史记录;空进程列表本身不是释放证明。
## 失败、证据和回退
保留原生错误、操作员、Mentor 版本、库/工程身份和证据目录;原生日志上传前脱敏。不得删除原生地址/锁文件或修改 LMC 伪造状态。强制客户端退出不可撤销;工程恢复依靠人工一致备份或原生历史版本,不自动回退共享库或重放写操作。
程序回退须先关闭当前客户端,再运行此前候选包;它不恢复丢失更改或被中断的原生事务。工程恢复另行在隔离副本验证,保留前后证据并重新校验。Windows 10、共享库跨机器并发和现场服务器失联恢复仍待验收,fake 测试和文件头损坏试验不代替现场验收。
## 已知限制与证据位置
A/B 输入的独立 EDIF 导出曾返回 `0xC0000005`,尚未定位;普通导入已不依赖该导出,导入是否完成以本次原生操作与复读证据判定。Windows 10、跨机器共享库和现场失联故障副本仍待验收;跨机释放依赖 SMB 共享模式语义,目前没有跨机实测。自动 ICDB Repair 保持关闭,共享数据库地址残留或晚到弹窗按现场状态继续核对。
代码合并不表示现场验收完成。文档中的本机路径、日志、截图、测试 XML 和候选包未入库;仓库仅保留验证摘要,原始材料需在验收机器查看或另行归档。
## 历史上传校验检查表
## 1. 输入与证据
+89
View File
@@ -0,0 +1,89 @@
# iCDB 原生手动修复与工程更新
适用:本机 Mentor EE7.9.5。菜单已从实际安装的原生程序资源核对;修复、失败诊断和修复后重新打开已在隔离工程实测。
## 先确定要处理的目标
以本轮原生日志的数据库路径为准。`ReusableBlocksLP/<CBB>/Work/database` 属于该工程;`SymbolLibs/__ReusableBlocksSymb` 属于中心库共享符号数据库。共享符号库不能靠修复无关的 CBB Work 工程替代。
操作前正常关闭使用相同库的 PCB、Library Manager、原理图/符号编辑客户端,核对原服务器会话已结束,保留包含数据库、原备份和日志的完整一致副本。以下写入先在副本上进行。
## 残留客户端与共享服务器
0.2.4b2 的默认检查、校验、取消和释放流程保留正在原生调用中的 worker 和保存/关闭助手。停止只阻止后续动作,必要时转后台观察;保存、关闭、进程退出和资源释放分别记录。独立确认的“强制结束客户端”也不放行本工具尚未返回的 Save/Close。符合其他释放条件的受支持客户端仍可另行确认结束;这会影响其其他工程,属于异常退出处理,不能替代 Repair。
ICDB 数据库服务器即使命令行指向当前中心库,也可能服务其他用户,**本工具不允许强制结束服务器**。归属未知的进程、后台导入器和脚本宿主同样不允许强制结束;由库管理员核对用户和服务器状态后处理。
强制客户端动作必须先在库外证据目录持久写入确认名单、库和进程创建身份,再核对当前进程句柄、用户 SID 和 Windows 会话;记录失败或身份变化时不执行。客户端结束后仍需独立证明库已释放,重新打开工程并核对版本,必要时从人工一致备份或原生历史版本恢复。不能把“进程已结束”解释为“ICDB 已修复”。具体步骤见 [操作规程](../SOP.md)。
原生 Backup/Restore/Repair 进行中时不强制结束。释放预览可查看后台桌面上的原生输出;只有当前窗口唯一可识别的取消按钮才提供确认请求,发送后仍需重新检查是否停止。输出或取消按钮无法确认时保留现场,不猜测原生命令。
## 原生工程数据库 Repair
1. 启动本机的 iCDB Project Backup,并打开实际报错工程对应的 `.prj`。本机可用 PowerShell 命令形式如下,工程路径需替换为自己的隔离副本:
```powershell
& 'D:\Mentor\7.9.5EE\SDD_HOME\iCDB\win32\bin\iCDBProjectBackup.exe' -p 'F:\隔离副本\ReusableBlocksLP\IP101GR\Work\IP101GR.prj'
```
2. 核对窗口标题中的完整 PRJ 路径,确认它关联本轮日志中的数据库。
3. 选择 **Project → Repair**,阅读确认框后执行。原生工具会检查工程并尝试修复,事先创建当前状态备份。
4. 查看 **View → Output** 中的完整输出;必要时使用 **Backup → View operation log**。记录选择了哪份历史备份、是否恢复旧版本,以及是否明确报错。
5. 正常关闭原生修复工具,再打开原先失败的同一工程。检查原数据库错误是否消失,并执行下节同步/Verify。
前面的自动化测试调用的就是此原生 Repair 入口。手动操作可直接看到原生诊断和恢复选择,但不能保证对同样的损坏取得不同修复结果。
### 如何判断结果
| 原生结果 | 后续操作 |
| --- | --- |
| 原位检查/修复完成 | 再次打开同一目标,核对数据库加载、工程同步、保存和关闭 |
| 从某个历史备份恢复 | 核对备份日期、原理图、PCB 和约束内容版本,再决定是否使用;不能直接等同无损修复 |
| `Cannot repair the project - there is no backup of missing iCDB` | 停止反复重试;当前状态备份只保留损坏现场,寻找有效恢复源或厂商支持 |
| 仍有占用或原生操作未结束 | 先确认实际会话和操作状态,不通过强杀或删除地址/锁文件替代修复 |
文件头损坏且没有历史备份的本机实测已得到第三种结果。会话失联故障是否能够原位修复仍需按实际原生诊断单独验证。
## 能够正常打开后的手动工程更新
1. 打开当前工程的 PCB,进入 **Project Integration** 窗口。
2. 查看 Forward Annotation、CES/约束加载与同步、Back Annotation 状态。对原生允许且标记 Required 的动作逐项执行,每次执行后重新观察状态。
3. 确认所需项目达到同步状态,保存工程并正常关闭。
4. 在 Library Manager 中选中对应 Reusable Block,使用 **Verify**,再读取真实校验结果。工具中的权威状态检查可以进一步确认 `READY / raw=1`。
本机生产流程及实机日志已验证四项同步、保存、关闭和权威 Ready 状态。这些更新动作要求工程数据库能够加载;若一打开就报告 ICDB 数据库无法加载,应先处理修复/恢复。
## 检查与升级相关入口的实际用途
| 本机确认的入口 | 用途与验证边界 |
| --- | --- |
| iCDB Server Manager → Tools → Diagnostics → Check database | 数据库诊断;本轮只确认菜单存在,未在现场库执行。不能视为另一种已验证的修复方式 |
| iCDB Project Backup → Project → Create support package | 创建支持资料,供对应版本技术支持分析;本轮只确认菜单存在 |
| Library Manager → Tools → Update DxSystems Designer Cache | DxSystems Designer 缓存更新,不能据菜单名称推断它能恢复损坏的工程或共享符号数据库 |
| `conv2iCDBpi` | 本机内置帮助标明用于旧 CDB/CES 到 iCDB 的转换,`-updatepowers` 只更新已转换库的 POWER 属性;未验证为损坏库修复路线 |
| `SideFiles2iCDB` | 包装到 `sandboxfile.exe`,帮助标明从文件导入 pin package length 数据,要求已有 iCDB、snapshot、topblock;没有验证其具有通用重建能力 |
本次实际核对的 iCDB Project Backup 菜单中没有独立的“强制升级损坏数据库”入口。更新 Mentor 软件、安装补丁或正常格式迁移应根据工程创建版本、目标版本兼容说明及正式向导,在完整副本上操作;升级软件不能保证补回损坏或丢失的数据。
本机旧 CHM 帮助重定向到 InfoHub,但当前安装的完整 InfoHub 文档不齐全。上述菜单以实际二进制菜单资源为依据,转换工具用途以本机内置帮助字符串为依据;未确认的升级步骤没有作为可执行指令列出。
## 本仓库实机记录
- `docs/releases/2026-10-28-icdb-open-repair-reopen-validation.md`:实际报错 → 原生恢复 → 同一工程重新打开 PASS/READY。
- `docs/releases/2026-10-28-icdb-no-history-repair-validation.md`:没有历史备份时同类文件头损坏未能修复,保留原生 no-backup 错误文本。
若现场报错明确指向共享符号数据库,应继续核对该共享存储支持的原生恢复/重建入口和原始符号来源。目前没有已验证的共享库强制更新修复步骤。
## 工具中的“从备份恢复 CBB”弹窗
读取中心库后,点击数据库维护区的“从备份恢复 CBB…”,选择目标名称及独立备份中的同名工程 PRJ,再点击“恢复并校验”。备份必须包含完整工程目录,包括原理图 ICDB、PCB、布局数据库和相关工程文件;仅有 PRJ 或单个 `icdb.dat` 不够。
程序保留完整目标库副本,先在独立库副本中验证所选备份。验证通过后把原 Work 保留为 `Work.before-restore-*`,恢复完整 Work,再打开目标执行集成、保存、关闭和 Ready 检查。副本准备阶段会显示文件数量,运行时需等待原生操作完成再关闭弹窗。整个过程需要存放两个中心库副本及工程副本的额外磁盘空间。
恢复结果采用所选备份的工程版本。原工程、来源副本、库快照和原生日志都保留在恢复记录中。程序不会在失败后自动覆盖共享库回退,也不会把未确认结果标为成功。
此入口用于已有同名 CBB 的完整工程恢复,不删除库条目,不等同跨库原生重新导入。共享符号库自身损坏、备份引用外部工程或数据库、工程不完整、仍有活动会话时会停止;当前工程数据库需要位于完整 Work 目录中。
公开网络资料核对见 `docs/diagnostics/2026-10-28-icdb-web-recovery-research.md`,包含可读原文链接及适用范围。原生 Repair 的图文用户案例与上述菜单步骤一致;新的网络监听配置案例不能代替数据库修复。文件头损坏的无备份试验也不能代表原始会话失联故障必定不可原位修复。
@@ -0,0 +1,116 @@
# iCDB 旧服务器会话失联:分析、恢复步骤与分支改动
分支:`codex/icdb-lost-session-diagnostics`,基于 `a11eb3c`(`v0.2.2-beta.1`)。
## 错误的含义和影响范围
现场消息为:
```text
The last server session on different server machine lost the connection
to the database. Please use iCDB Project Backup 'Repair project'
functionality to fix this issue.
Machine: [200091-CBB]
Session: [2026-10-24 08.22.29-10308]
```
原生 iCDB 检测到先前服务器会话的数据库状态需要检查/修复。这不是
“当前网络连接已经恢复就可以继续”的提示,也不能仅凭它认定端口被 Windows 保留。
`Machine` 和 `Session` 是故障记录中的原服务器、会话标识,不能当作当前进程 PID。
用户贴出的路径包含 `5:\5ymbolLibsReusableBlockssymb`,存在文字识别/转录歧义。
本机隔离样本确实存在 `SymbolLibs\__ReusableBlocksSymb\icdb.dat`:如果现场原文
指向这个结构,问题影响的是中心库共享符号数据库,而非单个 CBB 的
`ReusableBlocksLP\<CBB>\Work\database`。必须以现场原始日志为准,不能自动把
`5:` 改成 `S:`,或根据 CBB 名称推导修复目标。
异常关闭、原服务器/网络存储断开、写库期间复制工程、跨机器访问不一致的
路径,都可能涉及此类状态。现有消息不能区分这些原因,也不能证明
“校验失败一定导致损坏”;数据库异常本身同样会导致校验失败。共享符号库
出问题时,不同失败 CBB 可能只是访问了同一个有问题的数据库。
## 现场恢复步骤
1. 停止批量校验,核对 `200091-CBB` 和其他访问同一中心库的客户端。
正常关闭占用该目标的 Library Manager、PCB、原理图/符号编辑会话,并确认
原数据库服务器的实际状态;只看本机没有 PCB 或 TCP 探测失败不足以确认独占。
2. 在会话正常关闭后保留完整、一致的工程/中心库副本。共享库问题需包括
`.lmc`、相关 `SymbolLibs` 数据库、原有 `ProjectBackup`/数据库备份和日志。
工具日常的 `backup/` 排除了 `database` 等目录,网络操作还可能跳过备份,
因而不能把它当作这次修复所需的完整回滚副本。
3. 使用现场相同 Mentor 版本的 **iCDB Project Backup**,先核对打开的工程或
备份存储确实关联报错数据库,再执行 **Project → Repair**(错误提示称为
`Repair project`)。如果目标是共享符号库,而工具无法识别对应库/存储,
应由库管理员按该版本支持的库恢复流程处理,不能改选无关的 Work PRJ。
4. 保留原生工具的修复输出及 `Project Repair` 备份,确认修复结果。
不通过删除 `sAddress.adr`、锁文件、`icdb.dat`,也不通过强杀数据库服务器
来代替 Repair。如果原生修复失败,再依据原生日志选择一致备份恢复。
5. 正常重新打开原先失败的目标,先复测一个 CBB,检查本轮原生日志、
Project Integration、Save/Close 和进程释放,再以 `IsVerifiedReuseBlock`
返回 `READY/raw=1` 确认校验成功。之后再扩大批次。
本机已确认原生入口:
```text
%SDD_HOME%\iCDB\win32\bin\iCDBProjectBackup.exe
```
只读检查其命令行帮助显示 `-p <project file>`、`-ver`、`-h`;菜单资源确认存在
`Project → Repair`。没有查到公开的直接 Repair 命令行开关,因此本分支没有
编造 `-repair` 参数,也没有自动投递写库修复命令。曾在本机既有隔离样本上
打开原生管理界面进行入口检查,未执行 Repair;本机没有用户本次故障库,
未在 `200091-CBB` 或现场网络库上执行恢复。
## 代码修复
- 在内容检查输出、实时弹窗和本轮 `PCBLogFile.txt`、`ForwardAnnotation.txt`、
`MsgBoxResponse.log`、`PartPkg.log` 中识别完整的服务器会话失联消息。
- 分类为 `ICDB_REPAIR_REQUIRED`,保留原始错误和 `Machine/Path/Session`,
区分共享符号库、Work 工程数据库及不能确定的目标;写入
`diagnostics/icdb-recovery.json` 并在失败清单显示恢复说明。
- 该错误优先于通用打开失败、JobPrefs 错误及清理失败;即使内容检查同时
输出成功文字和退出码 0,也不能变成 PASS。标记 `safe_to_continue=False`,
后续条目标记 SKIPPED,沿用现有会话、证据、网络映射保留机制。
- 将当前日志与启动前检查点比较,支持追加、截断、等长/增长重写、UTF-16
及 UTF-8;恢复识别每次最多读取两个 128 KiB 片段。不能确认日志新旧时
保留原始失败,不据旧记录推荐本轮修复。重写后保留的同一历史会话不作为
新证据;可验证的追加则允许识别同一会话再次报错。
- 通用 `Could not run server` 不再直接推断端口保留并提示重启 WinNAT。
启动前独立端口绑定探测保留原逻辑。
## 验证和边界
原分支基线:`python -m pytest -q`,383 项通过。
新增回归包括原错误、共享库身份、内容检查停止队列、多行集成日志、
日志重写及历史错误隔离、编码、证据写入失败和监督器失败摘要。
诊断修复阶段验证(后续生命周期修复见下方链接):
- 全量 Python 测试 **417 项通过**,含 34 项新增回归;仍有基线已有的
一条 pywinauto STA COM 模式提示。
- 两组 PowerShell 测试、`python -m compileall -q src tests`、
`git diff --check` 通过。
- 只读解析仓库留存的真实 TUNER_R836_A 现场日志,正确提取到机器 `EDA03`、
`S:\ReusableBlocksLP\TUNER_R836_A\Work\database` 及会话
`2025-01-21 14.44.46-2323356`。该记录仅用于解析验证,不代表本次现场故障。
- 独立代码复查发现的集成日志遗漏、通用端口建议覆盖具体原因、历史日志
重写误判、不可读/超出窗口的基线问题,均补充回归并通过复核。
本分支修复自动化的错误识别、误导性建议和失败后的继续执行风险,
现在还会在目标明确、会话完全释放且完整备份成功时,自动调用同版本原生
Project → Repair,并只在原生诊断、Project Repair 备份、目标数据库关闭等
证据全部满足时重试一次校验。共享符号库路径没有 PRJ 入口时会明确阻断,
不会猜测或改修某个 CBB 的 Work 数据库。
这次在新复制的 IP101GR 工程上完成了真实隔离验证:Repair 菜单确认、完整
备份、原生 `dbcheck`/数据库日志、`Project Repair` ZIP 校验和数据库关闭均
成功;Repair worker 退出码为 0,随后才允许重试。该验证没有接触生产库。
仍然**没有修复现场受损数据库,也没有在 `200091-CBB` 上执行恢复**。
恢复识别仅覆盖已知日志末尾的有限窗口;错误出现在窗口外、相同历史会话
在重写时被原样重报、超出基线窗口的大日志发生重写、以及现场不同日志位置/格式,
仍需结合完整原生日志确认。这些不能确认新旧的情况不会自动提升为本轮修复诊断。
用户后续确认事故版本为 r4 或更早。失败强杀根因、正常关闭修复、自动 Repair
范围和 448 项最终回归详见
[失败生命周期与恢复验证](../releases/2026-10-27-icdb-failure-lifecycle-and-recovery.md)。
@@ -0,0 +1,47 @@
# ICDB 故障修复公开网络资料核对
检索日期:2026-10-28。目标是寻找原生会话失联、无备份恢复以及中心库共享符号数据库的可核实修复步骤。
## 能够读到原文的资料
1. **《Mentor XP如何修复文件》**,CSDN 用户经验文章:
https://blog.csdn.net/qq_53931654/article/details/147240707
已获取实际正文,内容为:打开 iCDB Project Backup、指定损坏文件路径、执行 Project → Repair,并有三张操作截图。该路线与本机 EE7.9.5 实际菜单及隔离实测一致。文章没有提供无健康恢复源时的通用强制修复办法,也没有验证共享 SymbolLibs 存储的修复入口。
2. **《Xpedition 2409 Designer 无法打开 icdb 连接》**,CSDN 用户经验文章:
https://blog.csdn.net/kkisscj/article/details/144323677
已获取实际正文。作者参考 VX2.8 的 icdb_admin 文档,将工作目录下 Server 配置中 Network/Address 设置为本机监听地址,解决其连接失败。这是 2409 版本的连接配置案例,不能直接当作 EE7.9.5 的数据库损坏或旧服务器会话失联修复方法,本轮未据此修改任何网络或数据库配置。
3. **Siemens Support Center 官方入口**:
https://support.sw.siemens.com/en-US/
本环境请求返回 HTTP 403,未读取到官方知识库文章。因此没有将检索摘要、第三方说法或猜测写成官方恢复结论。可以由具备相应产品支持权限的用户在此检索 iCDB administration、Project Backup Repair 和原始失联错误文本。
## 未找到能够验证的公开方案
本轮没有找到可核实的公开说明,能够保证在缺少有效恢复源时重建已经破坏的 icdb.dat,或直接修复 `SymbolLibs/__ReusableBlocksSymb` 的跨机器会话失联。检索无结果不能证明厂商没有内部恢复方式,只能说明当前没有依据提供相应可执行指令。
已排除 DLL 修复下载广告、AI 聚合回答,以及与原始故障不同的连接配置说明。没有根据这些结果操作现场库或删除数据库/锁文件。
## 对前面试验结论的必要限定
人为清零文件头得到的是 `old, unsupported format`。在无历史备份时,该特定试验原生 Repair 报告 `Cannot repair the project - there is no backup of missing iCDB`。
用户最初讨论的是 `The last server session on different server machine lost the connection to the database`。两者不是同一种故障,不能从文件头损坏试验推出“实际会话失联没有备份就一定修不好”。后者仍应在完整副本、实际占用已释放、目标身份明确的前提下尝试同版本原生 Repair,并根据修复后再次打开的结果判断。
## 当前可执行路线
对明确属于 Work/database 的工程数据库:正常结束实际写入会话 → 保留完整工程副本 → 用原生 iCDB Project Backup 打开对应 PRJ → Project/Repair → 查看 Output 是否原位修复、选择历史备份或明确失败 → 正常重新打开同一工程 → Project Integration/保存关闭/Verify。
若错误路径属于共享 SymbolLibs 数据库,本轮未找到已验证的 PRJ 替代入口。不能把任意 CBB 的 Work PRJ 指给它。需要针对该存储使用对应版本厂商支持的恢复/重建路线。
本机静态资源复核也显示 iCDBProjectBackup 的工程选择过滤器为 `Project file (*.prj)|*.prj||`,没有据此推断它可直接接受 LMC 或共享符号库目录。
已有 r4 现场日志中还保留一条具体工程失联记录,路径为 `S:\ReusableBlocksLP\TUNER_R836_A\Work\database`、原服务器 `EDA03`。这是旧日志,不能自动等同于当前 `200091-CBB` 故障,但说明现场历史中也存在工程数据库故障,需要逐条按原生 Path 区分。
网络检索原始页面及正文摘录保存在 `diagnostics/icdb-web-research-20261028`;未随源码发布第三方完整网页。
@@ -0,0 +1,65 @@
# ICDB 持续失败:公开资料与实际入口核对
调查日期:2026-11-03。当前源码 `c856960`。本轮是网上资料检索及只读诊断,没有修改库、服务器设置或产品代码,不能作为修复验收。
## 本机确定的缺口
目前找到最近一次实际失败为隔离完整库 IP101GR 的 2026-11-03 16:19(北京时间)记录:
`diagnostics/feedback-final-ui/evidence/verify-85fd17bc6ed2/result.json`
错误为 `DATABASE_RECOVERY_REQUIRED`,阶段为 `PCB_STARTING`。原生提示询问:
> Continue to open the design with read/write access permission?
提示说明可能是文件系统/网络在 15 秒内未确定谁打开了设计,也可能是上一会话异常退出;要求确认没有其他用户正在使用。它没有证明数据库内容已损坏,也不是本轮原生 Repair 的失败结果。
代码及只读复核证据 `diagnostics/icdb-web-research-20261103/routing-evidence.json`:
1. `maintenance_entry.maintenance_needed` 仅在存在库阻止检查点或数据库地址记录时返回真。
2. 当前 IP101GR 没有地址记录、没有阻止检查点,尽管请求 `maintenance=True`,仍返回 `routes_to_native_repair=false`。
3. `select_maintenance_target` 额外要求恰好一个地址记录;无地址时返回 `需要唯一工程地址记录`,因此只改外层判断也不能打通流程。
4. `verify_runner` 的自动补救仅针对 `ICDB_REPAIR_REQUIRED`;当前读写确认错误归入 `DATABASE_SAFETY_STOP`,不会触发该分支。
5. 修复后一次性读写确认已有 `PostRepairProof` 机制,但只有本轮原生修复成功且释放已核实时才授权。当前入口绕过 Repair,自然没有这份证明。
因此,明确维护不能以“没有 sAddress.adr”推断无需维护。地址记录用于定位/占用判断,不应成为识别异常关闭状态的唯一依据。
## 网上资料:已读取原文
### 原生 Project Repair
[Mentor XP 如何修复文件](https://blog.csdn.net/qq_53931654/article/details/147240707)
原文步骤为打开 iCDB Project Backup,指定损坏工程路径,执行 `Project → Repair`。与本机已经接入的官方工具入口一致。本文是用户经验文章,没有证明当前完整自动链路或 CBB 校验限制已经解决。
本轮首次访问返回脚本验证页,后续正常请求取得正文;正文与截图链接保存在 `native-repair.json` / `native-repair.html`。
### 工程备份恢复
[“Unable to open iCDB connection”的解决方案](https://blog.csdn.net/zhangyang125/article/details/136188112)
原文建议从工程 `ProjectBackup/backups` 选择备份,恢复对应文件后重新打开。文章把复制/转移时文件丢失或损坏列为可能原因。该方案会回退版本,不等于保留最新内容的无损 Repair;仍需用户选择可接受版本,恢复后做工程身份与校验确认。
### 连接/监听地址
[Xpedition 2409 Designer 无法打开 iCDB 连接](https://blog.csdn.net/kkisscj/article/details/144323677)
原文描述在工作目录的 iCDB Server 配置中设置 `Network/Address` 为本机地址,并引用 VX2.8 管理文档。这说明“无法连接 iCDB”也可能是监听配置问题,不能一律解释为损坏。
但文章环境是 Xpedition 2409,本机是 EE7.9.5。现有日志未证实本机出现同类监听失败;本轮没有修改 Server 配置、服务或端口。
### 检索限制和排除项
英文 Google/DuckDuckGo 请求连接超时;Bing 多个精确错误查询无结果或结果无关,360 搜索提供了可进一步核对的中文线索。没有取得可直接适用于 EE7.9.5 当前弹窗的 Siemens 官方支持答复。检索及抓取原文保存在 `diagnostics/icdb-web-research-20261103/`。
标题/推荐摘要中含 “iCDB Server Monitor” 的另一页面,正文实际讨论 Android Studio Monitor,已排除,未把无关搜索结果当作技术依据。本机已有帮助文件检索也未找到能补足该弹窗处理条件的准确段落。
## 建议的修正与验证次序
1. 明确维护入口支持“无地址记录但需要检查”的工程:通过用户所选 CBB、唯一 PRJ/PCB 关系和明确数据库映射绑定目标;多个候选数据库必须明确区分,不能猜测共享库或另一个工程。
2. 在本任务 PCB/启动器正常退出、库锁与数据库独占访问确认后,执行一次原生 Project Repair。不要因为看不到地址文件就直接退回打开 PCB。
3. 仅在原生成功、目标一致、进程与地址释放确认后,使用已有修复后读写授权重新打开。未知或外部占用仍停止,不能把同意读写弹窗作为一般重试策略。
4. 如要求选择 PCB 历史版本,明确记录选择及版本回退;随后验证集成、保存、关闭和权威 READY。
5. 如果数据库检查通过,但仍被“已验证 CBB 不允许重新执行 BackAnnotate”阻止,应作为独立的 CBB 注册/校验状态问题处理。此前完整依赖库中“原生重新导入 → 自动校验 → READY”已通过,但不能把重新导入偷偷塞进 Repair 或称为无损修复。
此处已定位入口缺口和可验证的修正方向;尚未实现并完成“无地址记录”维护路径的真实自动链路验收。
@@ -0,0 +1,37 @@
# 普通校验阻塞修正
基准 `477a5a4`。按用户最新指示暂停 ICDB 自动修复研究,本轮只修普通校验的入口、单项失败后的继续条件、取消和退出,以及状态桥部署/重试。没有对原库运行新的校验、Repair、恢复或移除;遗留的 Project Backup 进程未被终止。
## 修改依据与最终行为
| 阻塞来源 | 修改 |
| --- | --- |
| 原生进程已退出,但单项失败仍使整批跳过 | 统一使用本轮、同库、同 CBB 的释放记录判断继续资格。FAIL/TIMEOUT/未知弹窗保持原失败状态和备注;自动化工作进程、保存/失败关闭助手及本任务原生进程全部确认退出后可继续下一项。失败不会变成 PASS。 |
| 保存或失败关闭助手漏检;工作进程已关闭句柄后再查询退出状态 | 停止和检查两类精确脚本路径、精确父 PID 的助手。退出状态在关闭句柄前读取并缓存,清理可重复调用;助手和原生 PID 合并记录。任何查询异常或客户端仍活着都不解除执行锁。 |
| 超时只写取消文件,客户端可能继续 Save/Close | 先请求协作取消,宽限到期后仅停止本任务自动化工作进程及已识别的自动化助手。保留原生 PCB/iCDB,不终止进程树。普通校验的取消事件已传入监督循环。监督程序丢失后,Verify 看门狗也限时停止已登记客户端。 |
| 启动器和迟到子进程未完整纳入清理 | 监督器清理前重读剩余事件中的目标/启动器 PID;追踪这些已确认原生进程的新后代,排除任务开始前的无关会话。 |
| 任意 PCB 已打开就禁止校验 | 精确命令参数指向同一 PCB 时才阻止启动;其他工程保留。实际 COM 文档身份和保存助手身份检查仍必须通过。保存关闭后存在其他文档时,不调用该应用的 Quit。 |
| WMI 占用查询可能无限等待 | 普通校验的进程查询统一复用已有隔离查询助手,最多等待 10 秒。超时表示无法确认,保留具体原因;不在 GUI 线程做 WMI。 |
| 端口少量抽样被当作整个原生端口区间不可用 | 默认仅发出警告并执行真实原生调用。保留内部显式严格诊断参数,不作为默认入口条件。 |
| `0 errors` 被错误关键字命中;原生工程编码误判 | 仅忽略完整的零错误计数,仍拒绝非零错误、明确错误或坏退出码;复用现有 UTF-8 BOM / UTF-16 / Windows ACP 工程读取器。 |
| 状态桥 x86 MFC 运行库缺失;加载失败对每项重复启动 | 打包时验证并携带 x86 MFC/VC 运行库到桥的独立目录,避免误用 x64 Qt DLL。识别明确的 Windows DLL 缺失/架构错误,只记录一次全局桥故障并为余项保留状态;不因此禁用维护或管理入口。 |
| 状态查询重试复用旧 TIMEOUT/ERROR | 断点读取仅复用 READY/PENDING;失败状态下次重查,不要求修改库文件才能重新查询。普通界面读取仍使用本轮权威状态。 |
执行互斥只用于实际仍运行/释放未确认的客户端;历史诊断和 CBB 内容问题不应变成跨功能永久禁用。处于原生操作中的未知弹窗不会被盲目确认:当前项失败并留证,是否继续仍取决于该操作是否实际结束。
## 验证
新回归先复现单项已释放仍停批、取消未传递、零错误误判、编码与端口拦截等问题,再验证修改。还覆盖原生迟到子进程、保存/失败关闭助手保留,以及已关闭 Win32 句柄不再被读取。
使用真实 Windows 子进程验证监督程序退出后的客户端停止和原生模拟进程保留;VBS 在真正的 32 位 cscript 中使用伪 COM 对象验证 Save/Close、取消及剩余文档不被 Quit。它们没有加载现场工程,也不等于 Mentor 实机验收。
最终完整 Python 回归、冻结模块一致性、程序启动/正常退出、桥 JSON 编解码及实际加载 app-local x86 DLL 的结果记录在 `diagnostics/batch-blockers-20261104/`。现场日志和原始证据不随代码提交。
- 最终完整回归:**1,244 passed**,退出码 0,222.90 秒;1 条既有 pywinauto STA 警告。`pytest-final.log` / `pytest-final-result.json`。
- PyInstaller 构建、编译和差异检查通过。10 个关键 Python 模块及两个 VBS 脚本与冻结程序一致,启动及正常退出冒烟返回 0。
- 桥的 Unicode/UNC 编解码返回 0。通过真实进程模块枚举确认 `mfc140.dll`、`MSVCP140.dll`、`VCRUNTIME140.dll` 均从包内桥目录加载;不是仅检查文件名存在。系统 PATH 缩为 Windows System32,本检查没有加载 Mentor 数据库。
- 独立审查发现并修正失败关闭助手漏检;复审无剩余必要 P1/P2。构建记录保留 `icdb_automatic_repair_acceptance=false`、`release_ready=false`。
## 仍待验证
没有把本次阻塞修正称为 ICDB 自动修复成功。Project Backup 挂起问题保持暂停;Windows 10 干净系统、其他 Mentor 环境、两个真实 PCB 同时打开的 COM 注册行为、跨机并发写库、3000 项网络库完整耗时仍需实机验证。状态桥无法读取时仍不能宣称 READY;本轮补齐了已确认的 x86 部署依赖,没有伪造状态,也未加入新的全功能禁用入口。
@@ -0,0 +1,40 @@
# ICDB 批量检查
## 当前行为
应用原“非 READY ICDB 检查与修复”入口改为“ICDB 批量检查”。检查可见非 READY 工程,有勾选时仅处理可见勾选项,READY 即使被勾选也排除。普通 CBB 校验、中心库管理和手动“版本历史与备份…”继续使用各自入口。
检查通过原生 Project Backup 加载所选工程,收集本次 Output 和占用结论,不启动 PCB,不调用 Repair、Restore 或版本选择。检查入口即使收到旧请求的 `auto_repair=True` 也只执行检查;其原生请求始终携带 `inspection_only=True`。内部显式恢复辅助 API 及其既有测试保留,应用批量检查不再调用它们。
结果分为:
- 未发现异常:返回 CHECKED,仅表示本次原生检查未发现已识别的 ICDB 异常,不推定 CBB READY。
- 发现 ICDB 问题:保留 FAIL 和明确的 ICDB 故障分类,不执行修复。
- 工程占用:记录占用,不把它解释成数据库损坏。
- 无法确认:缺少有效工程、输出不完整、目标不符、未知错误等均保留原始证据,不显示健康。
本项检查的原生进程确认退出后,发现问题、占用或未知结果可继续下一项;本次检查尚未退出或缺少退出证据时停止剩余批次,不强制终止原生进程。用户取消也停止队列。需要修复或回退时,由用户通过原生备份窗口选择操作。
## 去除检查路径的修复限制
目标绑定复用手动原生入口的唯一主 PRJ 和明确的工程内 `iCDBDir`。检查不要求 PCB、Layout 或 `icdb.dat` 预先存在,也不借用 Repair 的地址记录唯一性和多个数据库候选排除规则。缺失或损坏由原生加载检查给出结论;无法识别的结果保留为未知。
原生 worker 的检查模式不再因本机存在其他 PCB/Library Manager 而直接拒绝,也不执行 Repair 专用的数据库独占准入;它仍在启动前检查所选工程的文件链接,目标是否占用由原生 Output 判定。
检查使用实际库协调锁,忽略历史协调检查点,不自动归档旧记录或删除地址文件。释放必须有明确的原生退出证据,或 worker 明确报告“尚未启动原生进程”;结果字段/PID 缺失不推定释放。该调整只覆盖新检查路径,不能据此宣称维护/管理/释放检查中的所有过宽条件均已解决。
## 界面及报告
批量检查不再显示手动备份要求、自动修复承诺或“修复并校验通过”计数。确认清单、进度、备注、汇总及完整/异常/JSON 报告均按检查目标和检查分类输出。占用和未知备注不加“ICDB 问题”标签。默认副本恢复仍排除缺少 PCB 的工程,检查候选可以包含它们。
## 验证边界
本轮先以失败测试确认旧入口会打开 PCB、可进入 Repair、使用修复准入及误标未知结果,再修改入口。测试覆盖健康、明确故障、占用、未知、异常修复返回、缺少退出证据、明确未启动、取消、队列继续、缺 PCB/Layout/icdb、多数据库、READY 排除、仅检查汇总和报告。
全量测试、冻结模块一致性、启动冒烟及隔离库实际按钮记录保存在 `diagnostics/icdb-batch-check-20261104/`;最终包的 `BUILD.json` 记录实际结果。隔离验证只执行新批量检查,不在原库运行 Repair/Restore。
最终全量 **1304 passed**,270.79 秒,退出码 0,1 条既有 pywinauto STA 警告;编译和差异检查通过。冻结的 14 个关键 Python 模块及两个 VBS 与源码一致,启动/退出、Unicode/UNC 协议及包内 x86 运行库加载通过。独立审查发现的修复准入误用和缺字段推定释放均以先失败后通过的回归修正,复审无剩余必要 P1/P2。
最终冻结包通过真实按钮在自有隔离库的 PENDING `IP101GR` 上检查,原生返回数据库不一致且未占用,应用记录 `ICDB_REPAIR_REQUIRED`、`safe_to_continue=true`,汇总“发现问题 1”。原生请求为 `inspection_only=true`,返回 `repair_requested=false`,没有 PCB 请求或恢复尝试。原生及应用均正常退出,中心库 LMC 和工程 PRJ、DXP、icdb.dat、PCB、LayoutDB 六个文件的 SHA-256 前后一致。
原生加载检查不能保证 PCB 实际打开一定正常,也不能替代普通 CBB 校验。现场自动修复问题不作成功结论;工单和 WIP PR 保持开放。
@@ -0,0 +1,47 @@
# 工单 #4 与独立操作复核
复核基准:最新工单 [#4](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/issues/4)(更新于 2026-11-04 15:20),当前代码起点 `2587d33`,用户随后要求校验与 ICDB 维护独立执行。原工单基准为 `29959e2`,下表按当前源码重新核对,不能照搬原报告的测试数或认定全部已修复。
后续用户要求暂停 ICDB 自动修复、先修阻塞。新的修改和最终 1,244 项完整回归见 [普通校验阻塞修正](2026-11-04-batch-blockers.md);下表保留首次复核状态,不能作为最新未修项数量使用。
## 本次用户失败的实际链路
最新测试程序的日志位于 `dist/issue2-tabs-release-candidate/CbbRefreshVerify-Background/data/`。北京时间 17:41:55 开始维护 `1GPHY_8212`,17:42:24 进入原生检查,17:43:17 启动 Project Backup,17:43:50 报 `TIMEOUT_UNRELEASED`。本轮没有发出 Repair,8 个后续条目被跳过。17:44:54 再运行另一工程,遗留 PID 60000 被全局进程检查拦截。
只读打开对应私有桌面后确认:原生主窗口及 RichEdit Output 控件均存在,但主窗口和 Output 连 WM_NULL 都返回 1460(超时)。不是已经取得 ICDB 损坏结论后修复失败,而是原生检查本身无响应,且本应用没有提供足够的阶段证据。没有向该原库发出新的 Repair、恢复、删除地址文件或强制结束操作。
原有逻辑还把“存在历史检查点”直接解释为整个库只能维护,普通校验默认自动 Repair,并把地址记录存在直接解释为会话未释放。这些产品耦合与用户最新要求冲突。
## 12 项仍需修改或验收
| 工单项 | 当前结论 | 后续工作及验收 |
| --- | --- | --- |
| K2-1 状态桥前置检查 | 仍缺少批次级能力诊断;在原生刷新后才检查权威 READY | 批次开始只诊断一次并明确说明状态不可读取;不能因此封锁 ICDB 和库管理。不能把原生调用完成当作 READY。 |
| K2-1b x86 运行库部署 | 发布候选中的桥为 x86,导入 `mfc140.dll/MSVCP140.dll/VCRUNTIME140.dll`,未随包提供 x86 MFC | 选择静态链接或正式部署 x86 运行库;干净 Windows 实机验证。x64 Python/Qt 的同名 DLL 不能替代。 |
| K2-2 未知弹窗分级 | 输入法误报已有过滤;真正未知交互弹窗仍使当前项失败并停批 | 区分无交互辅助窗口与实际模态提示;后者记录具体原因,正常释放后才继续独立项,不能盲点未知确认按钮。 |
| K2-3 取消与超时 | 协作式取消已存在;看门狗和 `_stop_worker` 仍可能返回时客户端活着 | 检查当前 automation client/保存客户端是否实际退出,防止迟到 Save/Close;不得以删除历史记录代替停止仍在写入的任务。 |
| K2-6 ICDB 自动维护 | 隔离副本曾成功执行 Repair;本次原库原生检查无响应,不能验收 | 当前修复:独立维护、独立校验、缩小检查范围、记录原生等待阶段。仍需一致副本上的真实按钮验收;原生窗口挂起成因待查。 |
| K2-4 跨机共享库并发 | sidecar 排他句柄只协调遵守协议的工具,Mentor 不参与 | 明确共享库操作协议,基于实际原生文件占用处理冲突;两台机器同时写同一工程的验证尚未完成。 |
| K2-5 地址记录及全局 PCB 拦截 | 地址文件和历史记录的普通校验硬拦截在本次拆除;“任意 PCB 已开即拒绝”仍存在 | 改为按工程身份判断占用;独立 CBB 不应相互禁用;跨会话 COM 绑定需实际验证后调整。 |
| K2-7 Windows 10 | 当前没有 Win10 实机完成证据 | 在 Win10 + EE7.9.5 验证私有桌面、启动、保存、释放及 READY;不能以 Win11 回归替代。 |
| K2-8 内容文本与 PRJ 编码 | 探针确认成功文本含 `0 errors` 仍返回 FAIL;preflight 仍按 UTF-8 读取 | 复用已有工程编码读取器,区分零错误计数与真实错误;补 UTF-16、ACP 和真正失败样本。 |
| K2-9 CentralLibrary 改写与说明 | 写入前已有原始 `pcb.prj` 证据副本和原子替换;旧“没有直接改写”说明不准确 | 核对异常回退与说明,按用户要求提示手动备份,不能重新加上自动整库备份。 |
| K3-1 初次扫描规模 | 状态指纹与逐项 preflight 仍有全库开销;本次只缩小了维护检查范围 | 首屏增量读取、扫描进度和取消;381/3000 项及网络盘测量仍需做。 |
| K3-2 队列恢复 | 已有状态/管理检查点,但没有完整校验队列的确认续跑 | 保存目标、已完成项和具体结果,重启后由用户决定继续;管理写操作不得自动重放。 |
共 12 项:5 项 P0、7 项原工单 P1/规模化条目。它们不等于 12 个已复现的代码错误:包含明确缺陷、部分修复、部署风险及缺少实机验收。优先处理操作解耦、原生检查无响应、桥部署、取消后仍存活的客户端;其余独立提交,不混在一次维护修复中。
## 本次实现与验证范围
普通校验默认不调用 Repair;历史检查点不再切换清单读取方式或禁用普通校验。合作式库锁跟随实际客户端释放,不为普通校验创建新的永久诊断阻止记录;已有历史记录保留。已退出的只读原生检查不会因为旧地址记录而锁住管理入口。实际仍存活或尚未确认退出的客户端继续保有执行锁;监督工作进程已经退出、只剩已记录的原生 PID 时,重试会检查这些 PID 是否实际退出,校验和维护均可直接重试,不要求先运行另一个功能。工作进程仍在运行时不采用这一简化判定。
维护成功报告 `REPAIRED / UNKNOWN` 和“待单独校验”,不自动重开 PCB、不执行反标注、不标为 READY。历史备份恢复仍需核对版本。维护预检查只扫描当前 Work、相关共享符号数据库及中心库定义,并保持链接、文件集合变化和独占句柄检查。扫描真实原库的 5,218 项用时 14.109 秒(只读,未启动原生工具);原用户流程的两层预检查合计约 76 秒,不能把这两个口径直接当作完整维护耗时对比。
验证证据在 `diagnostics/independent-operations-20261104/`(原始现场记录不提交):
- 操作拆分后的相关回归 509 项通过;审查发现并补正真实客户端仍在写入时的执行锁保留,以及直接重试维护的入口问题。
- 执行锁、维护、占用、校验、导出保护和恢复等相关回归 **214 passed**,退出码 0;最后“无需修复”展示与独立入口回归 **37 passed**,退出码 0。不是对最终源码重新跑完整 Python 套件的声明。
- 独立静态审查的必要问题已修正。编译及差异检查通过。
- 冻结包核对 10 个关键模块与当前源码一致,并运行无原生写入的启动/正常退出冒烟。构建元数据明确保留 `native_acceptance=false`、`release_ready=false`。
本轮没有重启现场挂起的原生进程、强制结束该进程、在原库执行新的自动修复,或将单元测试当成 ICDB 实机验收。原生窗口长时间无响应的具体内部原因仍未查明;此文档不能作为原生自动修复已验收的证明。
@@ -0,0 +1,31 @@
# 原生版本历史、备份与回退入口
## 用户操作
在“ICDB 维护”页勾选一个非 READY CBB,点击“版本历史与备份…”。应用将所选工程的唯一 PRJ 传给已安装的 `iCDBProjectBackup.exe -p`,打开可见的原生窗口。当前 Layout 数据缺失但 PRJ 仍在时也可以进入。
版本列表、备份详情、操作日志和 Restore backup 由原生窗口提供。选择版本、手动保存/自动保存分支以及恢复确认均由用户操作;应用不代点 Restore、Repair、删除或清理菜单。用户已报告手工回退能够走通,本轮接入该原生入口,不把手工成功当作自动 Repair 验收通过。
原生窗口正常关闭后重新读取受影响 CBB 的权威状态。窗口关闭仅记为 `CLOSED`,始终记录 `restore_confirmed=false`,不自动执行校验,不伪造 PASS/READY。需要验证恢复后的工程时,单独使用“检验”页。
## 会话与独立操作
- 可见原生窗口由独立辅助进程启动和监督;Qt 线程不等待原生会话,清单搜索、筛选、横向页面和库切换保持可用。
- 使用 Windows Job 跟踪本次原生进程及后代,根进程退出但后代仍在时继续等待。Job 不设置 kill-on-close;关闭本应用不强制关闭原生窗口。
- 实际会话持有现有中心库协调锁,同库写入等待该会话关闭;其他库不因这个窗口禁用。没有新增历史 ICDB 失败标记作为普通校验前置条件。
- 状态或结果文件写入失败不结束原生监督。辅助进程退出后,只有返回身份一致且 `safe_to_continue=true` 才清除应用内会话和路径租约;缺失、损坏或释放未确认时保留同库冲突,可通过已有“检查占用…”取得新的释放证明。
- 切换到同一共享上的其他库时,旧会话结束会把临时盘符所有权交给当前租约,避免断开当前路径。关闭应用时为仍打开的原生窗口保留所需盘符。
## 本机验证
证据目录:`diagnostics/native-backup-ui-20261104/`(本地诊断目录,不包含原库发布副本)。
源码实际按钮验证使用自有隔离库 `C:/Temp/CbbTabsRelease20261104/library/mentor_lib.lmc` 的 `1GPHY_8212`,由测试夹具提供 PENDING 清单状态,确认原生 Output 加载同一 PRJ、报告工程未使用、完成备份目录加载,再向该原生空闲窗口发送正常关闭。未点击 Restore/Repair,也未操作原库。详见 `source-acceptance.json`。
冻结候选包读取真实权威清单时,`1GPHY_8212` 为 READY,其维护入口按规则禁用。随后选择同一隔离库中实际 PENDING 的 `IP101GR`,验证真实 Qt 按钮、原生备份列表加载、正常关闭和应用状态刷新;最终仍为“待校验”,应用正常退出。原生 Output 明确报告该隔离副本的数据库不一致,本轮只验证入口,不点击 Repair/Restore,也不将此报错当作自动修复已通过。记录在 `frozen-acceptance.json`。
相关功能回归 88 项通过;最终全量回归 **1260 passed**,188.94 秒,退出码 0,1 条既有 pywinauto STA 警告。冻结的 13 个关键 Python 模块及两个 VBS 与源码一致,冻结启动/退出冒烟、Unicode/UNC 协议和包内 x86 运行库加载通过。全量回归、冻结模块一致性和启动冒烟结果分别保存在 `pytest-final.log`、`frozen-result.json`;最终构建记录随包保存到 `BUILD.json`。一次按系统 GBK 模式运行的全量测试因既有测试未指定 UTF-8 读取原生日志而失败,保留 `pytest-locale-failure.log`,最终回归使用 `python -X utf8 -m pytest -q`。
## 验收边界
本轮覆盖“应用入口 → 原生备份列表加载 → 用户可操作窗口 → 正常关闭 → 状态刷新”。不自动回退数据,不以本轮打开/关闭试验代替恢复后的保存关闭与 READY 验收。现场失联故障的完整自动修复、Win10 干净系统和跨机共享库并发仍未验收;ICDB 自动修复研究按用户要求暂停。工单和 WIP PR 保持开放。
@@ -0,0 +1,366 @@
# CBB 中心库上传后校验工具(cbb-refresh-verify-795)全面扫描与阻塞分析
- **扫描对象**:`https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795`
- **默认分支**:`main` @ `39985f7`(`chore: release v0.2.3-beta.1`,2026-10-29)
- **活跃分支**:`codex/temp-issue-2-icdb-recovery` @ `29959e2`(2026-11-04 14:16,领先 `main` **49 个提交 / +13,173 行**,未合并、未发布)
- **标签**:`r4-stability-20260929`、`v0.2.2-beta.1`、`v0.2.3-beta.1`
- **扫描时间**:2026-11-04
- **扫描方式**:全量克隆 + 逐模块源码阅读(38 个源文件 / 8,180 行)+ 两个分支完整 pytest + 32 位桥 PE 导入表解析与实机启动 + 关键判定函数行为探针 + 与 `docs/` 现场记录交叉核对
---
> 关联工单:<https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/issues/4>
>
> 扫描基准:`main@39985f7`(v0.2.3-beta.1)、`codex/temp-issue-2-icdb-recovery@29959e2`。
> 本文是扫描时的静态与实测记录;修复进展以工单和后续 PR 为准。
## 0. 一页结论
1. **单机、Win11、有 32 位状态桥、CBB 无异常** 的条件下,`v0.2.3-beta.1` 的"ReusableCircuit PCB → Project Integration → Save/Close → `IsVerifiedReuseBlock` READY"链路是成立的(发布说明有隔离实机 PASS 记录),工具没有伪造绿色状态,失败即阻塞的设计方向正确。
2. **批量场景是这个工具真正的短板**:状态判定依赖外部 32 位桥,但**桥的 x86 VC++/MFC 运行时不随包提供**(本机实测 `0xC0000135` 无法启动);没有桥时工具仍会对每个 CBB 做完整刷新再判 FAIL;叠加"未知弹窗即停批""残留 `sAddress.adr` 即阻断""本机任何 PCB 打开即拒跑",批量任务在现场高概率中途停止。
3. **Win10 是明确的未验收边界**:LM 原生菜单在私有桌面上不派发 MFC 命令(`docs/API-FINDINGS.md`),直接 PCB 路线在 Win10 上是否会提交 Verify 状态没有现场证据。
4. **共享中心库并发没有真正的互斥**:`main` 只有进程内 `Local\` 命名互斥 + 本机进程探测;另一台机器/另一个工程师同时操作同名 CBB 时无任何防护。活跃分支新增了 sidecar 库锁,但它是"合作式"文件锁,Mentor 本身不参与。
5. **ICDB 失联修复尚未闭环**:分支已经做到"原生 Repair → 重开 → 历史版本选择 → 校验 → READY",但文档明确"服务器会话失联经实际按钮触发的完整链路仍需通过",并且出现过"Repair 后 BackAnnotate 被原生拒绝"的失败结论。
6. 代码质量整体高于同类现场工具(分层清晰、证据链完整、失败关闭),但存在若干**可复现的功能缺陷**(内容检查文本误判、`.prj` 编码假设、超时后孤儿 worker、save helper 无超时等),详见第 3 节。
**一句话**:这个工具现在能"证明一个 CBB 是否真的绿",但还不能稳定地"把一批 CBB 刷成绿";阻塞点不在算法,而在**判定链的部署完整性、现场弹窗/占用环境、以及批量的工程化**。
---
## 1. 系统定位与运行链路
### 1.1 定位
| 项 | 内容 |
| --- | --- |
| 处理对象 | 已上传到 Mentor 中心库(`.lmc` + `ReusableBlocksLP`)的 CBB 条目 |
| 核心动作 | 打开该 CBB 的 ReusableCircuit PCB → Project Integration 四项同步 → 保存 Reusable Block cell → 关闭 → 只读读取权威 Verify 状态 |
| 不做什么 | 不做 Part Number 替换、不做上传、不直接改写中心库数据来伪造绿色 |
| 成功判据 | `worker` 完成 + 32 位桥 `IsVerifiedReuseBlock` 返回 `READY / raw=1`,二者缺一即 FAIL |
### 1.2 主链路(`main`)
```
GUI (ui/main_window.py)
└─ run_batch (verify_runner.py) # 串行,max_workers=1
└─ run_verify # 会话级互斥 Local\CbbRefreshVerify795
├─ preflight # Work 下唯一 PRJ / PCBDesignPath / 链接越界
├─ unreleased_addresses # sAddress.adr 残留即 BLOCKED
├─ ReuseBlockImporter -chkContents # 可选:LibSpec + DMS 登录配置
├─ icdb_ports_bindable # 10000-10100 端口预检
├─ DesktopWorker (私有桌面) # 32 位桥/弹窗代理同桌面
│ └─ execute_job (mentor_adapter.py)
│ ├─ 备份(仅本地盘) / CentralLibrary 路径修正
│ ├─ ExpeditionPCB.exe <pcb> -ReusableCircuit
│ ├─ wait_for_target_document (COM 身份核对)
│ ├─ refresh_integration (四项 InSynch)
│ └─ cscript save_verified_block.vbs (Validate/Save/IsSaved/Close/Quit)
├─ cleanup_verify_processes # 只观察退出,不强杀
└─ IsVerifiedReuseBlock (status_bridge.py) → READY / PENDING / UNAVAILABLE
```
对话框监督是一条独立链路:`DesktopWorker` 在私有桌面启动 `--dialog-agent` 伴生进程,agent 用 Win32 + UIA 抓窗口快照,`dialog_supervisor` 按 `assets/dialog_rules.v1.json` 的**阶段化白名单规则**决策,通过 JSONL loopback IPC 回传。
### 1.3 每次校验的产物
`evidence/verify-*/`:`result.json`、`events.jsonl`、`dialogs.jsonl`、`save.log`、`performance.json`、`bridge-status.json`、`diagnostics/`(preflight、native-logs、icdb-recovery)、失败时的 `recovery-required.json`。
### 1.4 现场自述的验证状态(文档)
- `v0.2.3-beta.1`:`pytest` 471 passed;EE7.9.5 隔离实测"破坏 ICDB 文件头 → 备份恢复 → 重新打开 → PASS/GREEN/READY"。
- 明确未验收:Win10、真实网络库大批量、现场 ICDB 失联的自动 Repair 全链路。
- 旧批次 68 项中 51 PASS / 17 FAIL,失败类型已在 `docs/2026-09-29-stability-r4.md` 分类。
---
## 2. 规模与结构
| 指标 | main | temp-issue-2 分支 |
| --- | --- | --- |
| 提交数(相对 main) | — | +49 |
| 源文件 / 行数 | 38 / 8,180 | 47 / 约 13,000+ |
| 测试文件 / 行数 | 35 / 5,752 | 约 50 / 9,000+ |
| 测试用例 | 471 | 1,196 |
| 本机 pytest 结果 | **463 passed / 8 failed** | **1,178 passed / 18 failed** |
| Python / 依赖 | 3.12 + PySide6 6.11 + pywin32 + pywinauto + Pillow | 同 main |
| 打包 | PyInstaller onedir(`CbbRefreshVerify-Background`) | 同 main |
> 本机失败均与环境有关(未完成 `pip install -e .`、无 Mentor 安装、缺 x86 VC 运行时、长路径/编码),不是断言暴露的产品逻辑失败。具体归类见第 7 节。
---
## 3. 功能性问题清单
严重度:**P0** 阻塞交付 / 数据安全风险;**P1** 现场高概率失败或明显功能缺陷;**P2** 可用性、可维护性、规模化问题。
### 3.1 判定链与证据
| 编号 | 严重度 | 问题 | 代码证据 | 影响 |
| --- | --- | --- | --- | --- |
| **F-01** | P0 | **状态桥不可用时仍执行完整刷新,最后才判 FAIL**。批量入口不检查桥是否可用;桥只在 worker 成功后才查询 | `verify_runner.py:981-1000`;UI 读库 `ui/main_window.py:63-68`;`batch_status.authoritative_status_map` 失败只返回 `UNAVAILABLE` | 每个 CBB 白做 2-10 分钟原生刷新 + 一次 Save/Close,然后 `BRIDGE_UNAVAILABLE`;3000 项批量等于 3000 次无效写库 |
| **F-02** | P0 | **32 位状态桥依赖 x86 `mfc140/MSVCP140/VCRUNTIME140`,打包清单只带 exe、未声明或检测该运行时**。本机 SysWOW64 无 x86 运行时,桥启动即 `0xC0000135`(发布 ZIP 不在仓库中,需在发布包上复核是否另行分发) | `packaging/CbbRefreshVerify.spec:4-14` 仅 `binaries=[CbbStatusBridge32.exe]`;PE 导入表实测:`KERNEL32, mfc140, MSVCP140, VCRUNTIME140, api-ms-win-crt-*` | 未额外安装 VC++ 2015-2022 x86 运行时的机器,桥永远不可用 → 所有项最终 FAIL |
| **F-03** | P1 | 内容检查结果用正则 `failed\|error\|cannot connect\|bad data` 判失败,**"0 errors"、路径含 `error` 也会判 FAIL** | `verify_runner.py:30-31, 128-141`;本机实测 `classify_output(0, "...successfully! 0 errors...") == 'FAIL'` | 内容检查偶发误报阻断,且现场难以看出是文本匹配导致 |
| **F-04** | P1 | `preflight` 用 `read_text(encoding='utf-8', errors='replace')` 解析 `.prj`;UTF-16/ANSI 工程会读不到 `PCBDesignPath` → 误判"工程没有 PCBDesignPath" | `verify_runner.py:157-161`;对照 `backup_recovery._project_text`(`backup_recovery.py:129-136`)已正确区分 UTF-16/UTF-8/mbcs | 老工程/修复后工程被预检直接判 BLOCKED,且看起来像"工程数据坏了" |
| **F-05** | P1 | 内容检查报告写入**中心库目录** `LogFiles/`;写失败只拼进局部 `stderr`,PASS 路径下该信息被丢弃 | `verify_runner.py:688-693` | 只读共享/权限不足时无任何提示;中心库额外产生日志文件 |
| **F-06** | P2 | 备份只在 PASS 且 `safe_to_continue` 时清理;失败项 `backup/`(可能数 GB)永久保留,无保留策略 | `verify_runner.py:641-651`;`mentor_adapter.cleanup_evidence_backup` | 长时间批量后磁盘被失败证据占满 |
### 3.2 现场自动化(弹窗 / 桌面 / 进程)
| 编号 | 严重度 | 问题 | 代码证据 | 影响 |
| --- | --- | --- | --- | --- |
| **F-07** | P0 | **任何不在白名单里的弹窗 = `UNKNOWN_DIALOG` = 当前项 FAIL + 整批停止**。规则要求精确英文文本、`GXWND`+`Button` 类名 | `dialog_rules.py:216-236`、`188-236`;`dialog_supervisor.py:458-471` | Mentor 版本/语言/主题差异、任何新提示("Reusable block already exists""license checkout failed"…)都会中断整批;现场 6 项 IME 语言栏误判即此类 |
| **F-08** | P1 | 弹窗代理客户端**每请求 2 秒超时**,而 agent 端 `capture()` 最坏为"N 个窗口 × 0.75s UIA + 子控件枚举";UIA 探测超时后线程泄漏继续跑 | `dialog_agent.py:383-388`(默认 2.0s)、`dialog_probe.py:37-44, 242` | 机器繁忙/窗口多时 `DIALOG_PROTOCOL_TIMEOUT` 被当成致命错误;泄漏的 STA 线程与主探测并发调用 UIA,进一步拖慢 |
| **F-09** | P1 | **Win10 私有桌面上 UIA `InvokePattern` 只关闭原生菜单、不派发 MFC 命令**;`native_lm_verify` 默认关闭,只有显式勾选才走菜单路线 | `docs/API-FINDINGS.md` §7、README「Win10/Win11 兼容性边界」;`verify_runner.py:466-470` | Win10 现场两条路线都不保证成功;目前只能以"Win11 已验证"交付 |
| **F-10** | P1 | **本机只要有任何 `ExpeditionPCB.exe` 在跑就拒绝校验**(即使与本 CBB 无关) | `mentor_adapter.py:619-621` | 工程师日常开着 PCB 时无法点击校验;现场"先关掉所有 PCB"成为隐性前置条件 |
| **F-11** | P1 | `sAddress.adr` 任一残留即 `ICDB_SESSION_UNCONFIRMED` 阻断;正常/异常退出后残留都要人工处理 | `icdb_ownership.py:13-16`;`mentor_adapter.py:644-650`;`verify_runner.py:661-670` | 一次现场崩溃会让后续每次校验都失败,且错误信息指向"未释放",与真实原因(陈旧文件)难区分 |
| **F-12** | P1 | save helper 轮询循环**无超时、无取消检查**;helper 卡在 `doc.Save()` 时 worker 只能等监督器 600s 空闲超时 | `mentor_adapter.py:794-816` | 网络库/许可异常时单次长时间挂起;超时后 helper 仍可能继续写 |
| **F-13** | P0 | **超时/取消只"请求停止"(touch 取消文件),不终止 worker**;worker 只在启动前、PCB 启动循环、保存前 3 处检查取消 | `desktop_worker.py:149-157`;`mentor_adapter.py:684-689, 744-746, 787-789`;`verify_runner.py:892-903` | 监督器已返回 TIMEOUT/FAIL 并释放互斥;worker 仍可能在随后的几秒内完成 Save/Close。若清理时恰好观察到 PCB 已退出,会判定 `safe_to_continue=True` 并启动下一项,而上一项仍可能有迟到的原生写入 |
| **F-14** | P1 | supervisor 崩溃看门狗在 `cancel_path` 存在时(**生产总是存在**)只写取消文件然后返回,**不退出 worker**;只有 `cancel_path=None` 才 `os._exit(75)` | `desktop_worker.py:34-52`;`verify_runner.py:724` 恒写入 `cancel_signal` | 与 F-13 叠加:父进程崩溃后可能留下无监督的自动化进程继续写库 |
### 3.3 数据、权限与边界
| 编号 | 严重度 | 问题 | 代码证据 | 影响 |
| --- | --- | --- | --- | --- |
| **F-15** | P1 | 工具会**改写中心库内 `PCB/pcb.prj` 的 `CentralLibrary`**;修改前只在本次证据目录留单文件副本,网络库不做整工程备份 | `mentor_adapter.py:93-162, 707-712`;README 第 22 行亦承认 | 现场(网络中心库)没有可回退的工程副本;与 README「不允许直接改写中心库 .prj」的表述冲突 |
| **F-16** | P2 | `Work` 下 `.prj` 不唯一即预检跳过;修复/导入后残留的备份 PRJ 会被当作"无法唯一确定" | `verify_runner.py:152-155`;`preflight_skip_reason` | 条目被静默跳过(黄行),用户以为已校验 |
| **F-17** | P2 | Cert 完全不参与判定(设计取舍),但也没有"保存成功但未提交"的独立证据维度 | `verify_runner.py:313-330`;`collect_cert_evidence` 仅记路径 | 只能靠桥区分 PASS/PENDING;桥抖动时无法自证 |
| **F-18** | P2 | 备份策略:网络盘直接跳过递归备份(`backup_skipped`),本地盘 3-30s 预算 | `mentor_adapter.py:632-640, 399-453` | 现场中心库基本都在网络盘 → 实际上没有前置备份 |
### 3.4 性能与规模化
| 编号 | 严重度 | 问题 | 代码证据 | 影响 |
| --- | --- | --- | --- | --- |
| **F-19** | P1 | 每次"读取 CBB"都会:整文件 SHA-256 `.lmc` + 顶层目录指纹 + 逐 CBB 桥查询 + **逐 CBB `preflight_skip_reason`(网络 stat/glob/读 PRJ)** | `batch_status.py:95-122, 194-197`;`ui/main_window.py:257-263` | 3000 项网络库首屏可能数分钟到数十分钟;期间只有一个"正在读取中心库…"标签,无进度、不可取消 |
| **F-20** | P1 | 批量无进度条(仅全库 ICDB 模式有)、**不能取消当前项**(只能"当前项完成后停止")、崩溃后队列不持久化、不续跑 | `ui/main_window.py:417-454, 547-548`;`run_batch` 只在项间检查 stop | 长批次一旦中断只能从头再来;现场无法预估剩余时间 |
| **F-21** | P2 | 每次桥查询(单条路径)都新起一个 32 位进程;批量依赖常驻 `--server`,桥崩溃后整段剩余项直接标 UNAVAILABLE | `status_bridge.py:141-203, 206-332`;`batch_status.py:258-270` | 单条校验慢;桥异常时"剩余全部不可用",无法只重试当前项 |
| **F-22** | P2 | 多处 0.2s 轮询叠加 WMI 查询(`Win32_Process` 每次约 50-200ms)、integration 每次 `native_error()` 读 3 个原生日志 | `mentor_adapter.py:744-761, 800-809`;`integration.py:33-39`;`post_verify_diagnostics.py:32-39` | CPU/网络 I/O 放大;网络日志读取可能反过来拖慢原生操作 |
### 3.5 工程性 / 可维护性
| 编号 | 严重度 | 问题 | 证据 |
| --- | --- | --- | --- |
| **F-23** | P2 | 38 个源文件里 **102 处** `except Exception`/裸 `except`,大量 `except: pass`;故障常被降级成 `UNKNOWN/FAIL`,根因只留在日志 | 静态统计 |
| **F-24** | P2 | GUI/CLI 顶层异常只 `return 1`,不打对话框、不打印到控制台;批处理用户只看到退出码 | `application.py:134` |
| **F-25** | P2 | 无 CI 配置、无 lint/类型检查、无 LICENSE/CHANGELOG;300KB 二进制入库;`.gitattributes` 全量 `-text` | 仓库根目录 |
| **F-26** | P2 | 测试依赖"本机已 `pip install -e .` + 已装 Mentor + 有 x86 运行时",新克隆机器直接 pytest 会有 8 项环境失败 | 第 7 节 |
| **F-27** | P2 | 分支 49 个提交、+13k 行,`pyproject.toml` 版本仍是 `0.2.3b1`,候选包与正式包同版本号 | `pyproject.toml:6`(两分支相同) |
---
## 4. 阻塞点划分(任务视角)
把"阻塞"分成三类,避免把平台限制、工程缺陷、规模问题混在一起:
- **K1 平台/产品硬约束**:Mentor/Windows 决定,改代码无法消除,只能绕行、限定验收范围或推动替代方案。
- **K2 交付阻塞**:团队可修,但当前版本不满足"可交付/可批量"的最低条件。
- **K3 规模化阻塞**:单机少量可用,上批量/上团队前必须解决。
### 4.1 阻塞点总表
| 编号 | 阻塞点 | 类型 | 证据 | 受影响任务 | 解除条件 | 优先级 |
| --- | --- | --- | --- | --- | --- | --- |
| **K1-1** | Library Manager 没有公开的 CBB `Verify()` COM 方法,只有内部 32 位导出 | K1 | `docs/API-FINDINGS.md` §3;`LibraryManager.tlb` 审计 | 所有"编程触发 Verify"的路线 | 接受"只读判定 + ReusableCircuit 刷新"路线,或继续 ABI 研究 | — |
| **K1-2** | 状态判定只能靠 32 位 MFC ABI 桥,64 位 Python 不能直连 | K1 | `docs/API-FINDINGS.md` §3、§9 | 状态读取 | 保持独立 x86 桥(现状) | — |
| **K1-3** | 私有桌面上 LM 原生菜单不派发(Win10 UIA),`SwitchDesktop` 在本机不可用 | K1 | `docs/API-FINDINGS.md` §7 | Win10 现场 | 现场 Windows 10 真机验收;或限定仅 Win11 | — |
| **K1-4** | iCDB 服务器端口必须落在 10000–10100,可能被 Hyper-V/WSL 保留 | K1 | `mentor_adapter.py:978-1082`;文档 §8 | 所有 PCB 启动 | 管理员 `net stop winnat && net start winnat`(工具已给提示) | — |
| **K1-5** | Mentor 对"已验证工程"禁止 BackAnnotate;共享符号库没有 PRJ 入口 | K1 | 工单 #2 文档、`integration.py:93-100` | 已绿工程复检、共享库修复 | 按原生限制记录为"已同步/不支持",或人工处理 | — |
| **K2-1** | **桥不可用(缺 x86 运行时 / 未打包 / 路径找不到)仍可启动批量** | K2 | F-01、F-02 | 全部批量 | 打包 `VC_redist.x86` 或 `/MT` 静态链接;启动自检;无桥禁止批量 | **P0** |
| **K2-2** | **未知弹窗即停批**,白名单覆盖不了现场提示 | K2 | F-07 | 批量、Win10 | 规则分级(致命/可确认/仅记录)、未知弹窗可配置停机或继续并留证 | **P0** |
| **K2-3** | **超时/取消不终止 worker,孤儿进程可能继续写库** | K2 | F-13、F-14 | 数据安全、连续批量 | 明确"取消=停自动化客户端、保留原生会话"的边界;对 worker 进程做可验证的终止/对账;看门狗在崩溃时真正退出 | **P0** |
| **K2-4** | 共享中心库无跨机互斥;`main` 只有进程内互斥 + 本机 PCB 探测 | K2 | `verify_runner.py:504-547, 742-746`;分支 `library_lock.py` | 多人/多机使用 | 合并分支库锁并让上传工具/Mentor 侧协同;或规定"单人独占窗口" | **P1** |
| **K2-5** | 残留 `sAddress.adr` 永久阻断;本机任意 PCB 打开即拒跑 | K2 | F-10、F-11 | 日常使用 | 区分"陈旧地址文件"与"活会话"(探测可达性已具备,但策略过严);PCB 占用按 CBB/工程匹配而非全局 | **P1** |
| **K2-6** | ICDB 失联的自动 Repair 全链路未验收;Repair 后 BackAnnotate 被拒 | K2(分支) | `docs/releases/2026-11-03-field-feedback.md`、`2026-11-04-icdb-review-fixes.md` | 库损坏恢复、全库维护 | 现场真实失联库端到端验收;修复后重开/保存/READY 全绿 | **P0(分支)** |
| **K2-7** | Win10 未验证,且没有可用的菜单触发兜底 | K2 | F-09 | Win10 现场 | Win10 真机单 CBB 验收,或书面限定 Win11 | **P1** |
| **K2-8** | 内容检查文本误判 + `.prj` 编码假设 | K2 | F-03、F-04 | 启用内容检查的批次 | 修正解析/判定,补回归 | **P1** |
| **K3-1** | 首屏扫描 O(全库) + 逐 CBB 预检,无进度/不可取消 | K3 | F-19 | 3000 项批量 | 增量扫描、缓存指纹、预检并行/惰性、进度条 | **P1** |
| **K3-2** | 队列不持久化、不能取消当前项、无断点续跑 | K3 | F-20 | 长批次 | 队列清单落盘 + 逐项检查点 + 取消当前项 | **P1** |
| **K3-3** | 失败证据/备份无上限 | K3 | F-06 | 长期运行 | 证据保留策略(按天/按大小) | **P2** |
| **K3-4** | 质量门禁缺失(无 CI、版本号不变、环境耦合) | K3 | F-25、F-26、F-27 | 发布/回归 | CI(无 Mentor 的 mock 层 + 一台 Mentor 自托管 runner)、版本号规范 | **P2** |
### 4.2 任务可达性矩阵
| 任务场景 | 结论 | 关键阻塞 |
| --- | --- | --- |
| 单 CBB,Win11,本地/网络库,桥可用,无人占用 | ✅ **可用**(有隔离实机 PASS 记录) | 无 |
| 单 CBB,桥不可用/未装 x86 运行时 | ⛔ **必然 FAIL** | K2-1 |
| 小批量(10–50),工作时段 | ⚠️ **可用但易中断** | K2-2、K2-5、F-12 |
| 大批量(数百–3000) | ⛔ **时间与稳定性不可接受** | K3-1、K3-2、K2-2 |
| Win10 现场 | ⛔ **未验收** | K2-7、K1-3 |
| 共享中心库多人同时操作 | ⛔ `main` 无锁;分支为合作式锁 | K2-4 |
| 库损坏/ICDB 失联恢复 | ⚠️ 诊断与手动路径可用;自动 Repair 未闭环 | K2-6 |
| 无 Mentor 的开发机 | ✅ 仅单元测试(需先装包) | F-26 |
### 4.3 建议的解除顺序
1. **先让"批量的失败是可信且廉价的"**:桥预检 + 打包运行时(K2-1)→ 不做无用刷新。
2. **再让"批量的中断可控"**:弹窗分级(K2-2)、取消/超时语义(K2-3)、占用与残留地址策略(K2-5)。
3. **然后才谈规模化**:增量扫描、进度、续跑(K3-1、K3-2)。
4. **平台边界单独验收**:Win10(K2-7)、共享库并发(K2-4)、ICDB 修复闭环(K2-6)。
---
## 5. 现场失败模式 → 代码根因映射
| 现场现象(文档) | 代码根因 | 对应问题 |
| --- | --- | --- |
| 6 项 `UNKNOWN_DIALOG: TF_FloatingLangBar_WndTitle` | IME 语言栏过滤条件过窄(类名+标题+无控件同时满足) | F-07 |
| `TUNER_R836` Save/Close 后桥返回 PENDING | 桥判定 + Verify 未提交;或原生 BackAnnotate 被拒 | F-17、K1-5 |
| `TUNER_R836_A` 数据库打开失败被记 UNKNOWN_DIALOG | 早期靠文本分类;现走规则白名单 | F-07 |
| `1GPHY_8211` 打开时失联 → 后续 Repair `REPAIR_DATABASE_IN_USE` | 失败打开的 PCB 未被关闭(分支已修:启动失败关闭路径) | K2-6 |
| 5 项 Project Integration 符号错误 | 工程/符号数据问题,工具只负责分类与留证 | — |
| 3 项 JobPrefs / 本地 Cell Library 失败 | 环境/工程状态;工具仅诊断不修复 | — |
| 端口 10000-10100 被保留 | `WinError 10013`,Hyper-V/WSL 动态预留 | K1-4 |
| 桥 UNAVAILABLE 但报告"四绿"风险 | 已被 fail-closed 设计排除(不会伪造 READY) | — |
---
## 6. 活跃分支现状(`codex/temp-issue-2-icdb-recovery`)
### 6.1 新增能力(相对 main)
- 库锁与占用探测:`library_lock.py`、`owner_probe.py`、`native_occupancy.py`(与上传工具兼容的 `.cbb-upload.lock` / `.blocked.json` 协议)。
- CBB 管理:`management.py`、`native_management.py`、`management_transaction.py`、`native_engineering_identity.py`、`native_export_guard.py`(新增/同名替换/移除、身份与导出副本保护)。
- 恢复:`reimport_recovery.py`、`scoped_manifest.py`、`post_repair_consent.py`、`pcb_restore_prompt.py`、`maintenance_entry.py`(库外完整工程副本恢复、历史 PCB 版本选择)。
- 策略调整:取消应用自动备份,改为**弹窗提醒手动备份**(`docs/releases/2026-11-03-manual-backup.md`)。
- 启动失败关闭:`failed_session.py` 扩展为"预检失败/数据库打开失败也协作关闭 PCB"。
### 6.2 本机验证结果
- 1,178 passed / 18 failed;其中 8 项与 main 同因(环境),新增失败集中在:
- **长路径**(`native_add_failures` 两个用例,150 字符目录名 → Windows `MAX_PATH`);
- **owner probe 依赖安装**(`native_export_guard` 6 个用例:子进程 `-m cbb_refresh_verify` 不可用);
- **编码**(`native_repair` 一个用例按 cp1252 解码失败);
- **无 Mentor 安装**(`native_repair` 取消用例)。
### 6.3 分支仍未满足的门槛(文档自述)
- 服务器会话失联 → 实际按钮触发 → 自动 Repair → 重开 → 保存关闭 → READY 的**完整链路未验收**。
- `1GPHY_8212` 原生 Repair 后 **BackAnnotate 仍被拒**,结论未变。
- Windows 10 未验证(当前实机 Win11 / EE7.9.5)。
- 历史 PCB 版本恢复记为 `RESTORED_REVIEW_REQUIRED`,**不等于无损修复**。
- 目标缺 `PartsDB` 分区时无法完成完整校验。
- 共享符号库不支持自动修复。
- 版本号未递增、分支未合并。
> 结论:分支在"管理 + 恢复"上补齐了很多能力,但**没有解除 K2-6(ICDB 自动修复闭环)和 K2-7(Win10)**;同时引入了新的环境敏感性(长路径、owner probe 子进程、编码)。
---
## 7. 测试与质量评估
### 7.1 本机结果
```
main: 463 passed, 8 failed, 1 warning, 37.09s
branch: 1,178 passed, 18 failed, 1 warning, 92.29s
```
main 的 8 项失败归因:
| 失败 | 原因 |
| --- | --- |
| `test_application`(2 项)、`test_abnormal_shutdown`、`test_extended_safety`、`test_failure_lifecycle`(共 5 项) | 子进程 `python -m cbb_refresh_verify` 依赖 `pip install -e .`,本机安装未完成 |
| `test_native_repair::test_repair_cancellation...`、`test_verify_runner::test_pcb_launch...` | 本机无 `D:\Mentor\7.9.5EE` 安装 |
| `test_packaging_status_bridge::test_compiled_bridge...` | 缺 x86 VC/MFC 运行时,`0xC0000135` |
### 7.2 覆盖情况
**做得好的**:状态判定(PASS 只能来自桥 READY)、对话框规则/后置条件、ICDB 日志新鲜度、备份/恢复、进程释放、UI 交互都有大量单测,且测试直接编码了"不得伪造绿色"的安全契约。
**缺口**:
- 没有真实 Mentor 的集成测试(全部依赖 fake COM/进程边界);
- 没有 Win10 测试矩阵;
- 没有网络库并发/多人场景;
- 没有长时间稳定性与性能回归(600s 空闲超时、3000 项批量);
- 测试与"本机安装 + 本机 Mentor 路径"耦合,换机即红;
- 无 CI,测试结果靠人工粘贴进 release note。
### 7.3 代码静态指标
- 38 个源文件 / 8,180 行;**102 处**宽泛异常捕获;15 处 `time.sleep`;15 处 subprocess 调用。
- 硬编码 `D:\Mentor\7.9.5EE\SDD_HOME` 兜底 5 处(可作为默认,但需在 UI/日志里明确"发现失败")。新机器上会静默落到不存在的路径,报错信息偏底层。
---
## 8. 修复路线图(建议)
### P0(1–3 天,先让批量"失败得正确")
1. **桥部署闭环**
- 打包 `VC_redist.x86.exe`(或桥改 `/MT` 静态链接),安装脚本检测/安装;
- 启动时执行一次桥自检(`--codec-test` 或空查询),失败则禁用"批量校验"并给出可操作提示;
- `read_library_fast` 返回 `UNAVAILABLE` 时,UI 明确"无法判定绿色,批量将全部失败",不静默入队。
- 验收:干净 Win11 + 无 VC 运行时 → 工具提示安装而不是跑 3000 次无效刷新。
2. **未知弹窗分级**
- 规则增加 `on_unknown: stop | record_continue | block_item`;
- 默认对"无按钮/纯文本/IME/浏览器宿主"仅记录,对"数据库恢复/许可/保存失败"阻断;
- 每次未知弹窗都落 `dialogs.jsonl` + 截图证据,批量结束汇总"待人工确认弹窗"。
- 验收:新增一个未登记弹窗的模拟场景,批量不中断且证据可查。
3. **取消/超时语义**
- 明确"取消 = 停止自动化客户端,保留原生会话";对 worker 增加强制终止开关(仅在未进入 Save 阶段可用);
- 看门狗在 supervisor 退出时按"是否处于 Save/Close"决定终止或保留,并落 `watchdog-decision.json`;
- `run_verify` 在 worker 未确认退出时不得释放互斥、不得继续下一项(当前已部分满足,需把"进程仍活"纳入 `safe_to_continue`)。
- 验收:模拟 Save 卡死 → 工具超时后 worker 确实退出或明确标记"仍活",下一项不启动。
### P1(1–2 周,现场可用性)
4. 弹窗代理超时预算与 `capture()` 并发控制(F-08);UIA 探测改为按进程白名单 + 单窗口超时,禁止泄漏线程。
5. 占用/残留策略(F-10、F-11):PCB 占用按 CBB 路径匹配;`sAddress.adr` 增加"不可达 + 非本机进程 + 超时"三条件判定为陈旧并可清理(需用户确认)。
6. 内容检查判定(F-03)与 `.prj` 编码(F-04)。
7. 中心库写入保护(F-15):改写 `pcb.prj` 前做整文件副本 + 变更清单,网络库至少保留原文件并可一键回滚。
8. 合并分支库锁(K2-4),并与上传工具约定锁协议。
### P2(2–4 周,规模化)
9. 增量扫描/指纹缓存、预检惰性化、进度条、取消当前项、队列持久化与续跑(F-19、F-20)。
10. 证据保留策略与磁盘配额(F-06)。
11. CI:mock 层全量测试 + 一台 Mentor 自托管 runner 做冒烟;版本号规范(`0.2.3b1+candidate.49`)。
12. 清理宽泛异常,至少在关键路径保留 `error_code` 与原始异常链(F-23)。
---
## 9. 附:关键证据索引
| 主题 | 文件:行 |
| --- | --- |
| 成功判据(桥 READY) | `src/cbb_refresh_verify/verify_runner.py:313-330, 981-1000` |
| 内容检查判定 | `src/cbb_refresh_verify/verify_runner.py:30-31, 128-141` |
| 预检(PRJ/PCB/链接) | `src/cbb_refresh_verify/verify_runner.py:144-174` |
| 端口预检 | `src/cbb_refresh_verify/mentor_adapter.py:1061-1082` |
| 数据库地址阻断 | `src/cbb_refresh_verify/icdb_ownership.py:13-16` |
| PCB 全局占用检查 | `src/cbb_refresh_verify/mentor_adapter.py:619-621` |
| CentralLibrary 改写 | `src/cbb_refresh_verify/mentor_adapter.py:93-162, 707-712` |
| save helper 循环 | `src/cbb_refresh_verify/mentor_adapter.py:790-816` |
| 取消信号 | `src/cbb_refresh_verify/desktop_worker.py:149-157`;`mentor_adapter.py:684-689, 744-746, 787-789` |
| 看门狗 | `src/cbb_refresh_verify/desktop_worker.py:25-56` |
| 弹窗规则 | `src/cbb_refresh_verify/dialog_rules.py:188-236`;`assets/dialog_rules.v1.json` |
| 弹窗代理超时 | `src/cbb_refresh_verify/dialog_agent.py:383-388`;`dialog_probe.py:37-44, 242` |
| 状态桥 | `src/cbb_refresh_verify/status_bridge.py:115-203, 206-332` |
| 批量状态扫描 | `src/cbb_refresh_verify/batch_status.py:95-122, 184-277` |
| UI 读库/队列 | `src/cbb_refresh_verify/ui/main_window.py:225-335, 417-548` |
| 打包清单 | `packaging/CbbRefreshVerify.spec:4-25` |
| 分支库锁 | `src/cbb_refresh_verify/library_lock.py:80-200`(分支) |
### 复现命令
```powershell
git clone https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795.git
cd cbb-refresh-verify-795
python -m pip install -e .
python -m pip install pytest pytest-qt
python -m pytest -q # main: 463 passed / 8 failed(本机环境)
git worktree add ..\cbb-branch origin/codex/temp-issue-2-icdb-recovery
cd ..\cbb-branch; python -m pytest -q # branch: 1178 passed / 18 failed(本机环境)
```
桥依赖验证:
```powershell
# 1) 导入表:KERNEL32 / mfc140 / MSVCP140 / VCRUNTIME140 / api-ms-win-crt-*
dumpbin /dependents .\tools\status_bridge\bin\CbbStatusBridge32.exe
# 2) 实机启动:缺 x86 运行时时的退出码 -1073741515 (0xC0000135)
.\tools\status_bridge\bin\CbbStatusBridge32.exe --codec-test
```
@@ -0,0 +1,32 @@
# 按本次工程启动错误决定 ICDB 维护
## 问题
旧的显式维护入口对 `maintenance=True` 恒定返回“需要维护”,所有可见非 READY 候选都先进入 Project Backup 检查。虽然 Repair 仍要求原生检查明确报告故障,这一流程没有先确认 PCB 是否实际打不开,也会让健康工程进入维护环境和占用检查。
非 READY 表示未通过 CBB 校验,不能作为 ICDB 损坏证据;普通服务器、授权、COM、路径及内容错误也不能据此转换成 ICDB 修复。
## 调整后的流程
1. 维护按钮保持针对可见非 READY 候选。每项先通过既有 `diagnostic_only` 路径实际打开所选 PCB:核对工程/中心库身份,不改工程路径、不执行集成、不保存、不提交 Cert、不运行普通 CBB 校验。
2. 同一工程正常打开并确认会话释放后返回 CHECKED,备注为“无需 ICDB 修复”,不启动 Project Backup,不推定 READY。
3. 普通失败保留原状态和原始错误。没有完整 ICDB 原生失联特征、数据库路径或会话信息时,不进入维护。历史地址、协调检查点或旧诊断文件不代替本轮启动证据。
4. 仅本轮诊断 FAIL、会话已释放,且失联报错数据库属于当前工程时进入原生维护。共享库、其他工程、未知目标、超时及取消结果不自动修复当前 CBB。
5. 原生维护取得锁及工程证明后,再核对目标必须与本次报错数据库相同。原生检查仍需确认空闲且明确要求修复,才调用既有单次 Repair 路径。目标不一致时不启动原生工具,不因已释放的单项错误阻塞其他独立 CBB。
6. 诊断在文档身份确认后和关闭完成后各复查本轮日志,避免延迟写入的启动错误被误判为健康。日志沿用启动前基线和增量判定,不从历史日志猜测故障。
普通“检验”按钮继续独立执行,不要求先通过 ICDB 维护;手动“版本历史与备份…”继续直接进入可见原生窗口,由用户选择版本。此修改只调整维护触发条件,不宣称修复了原生 Repair 内部失败。
## 测试与边界
先新增回归测试,在旧代码上验证健康工程及普通错误仍会进入 Project Backup 的失败,再实现入口修正。测试覆盖完整失联特征、无会话/只含错误码、共享库/其他工程、目标变化、正常打开、未释放、超时、取消、旧诊断文件、日志写入失败和延迟启动错误。
关联回归 151 项通过,后续新增的报告失败及等价路径用例纳入最终回归;维护入口专项最终 21 项通过。最终全量 **1283 passed**,643.89 秒,退出码 0,1 条既有 pywinauto STA 警告。编译和差异检查通过,冻结的 13 个关键 Python 模块及两个 VBS 与源码一致,启动/正常退出、Unicode/UNC 编解码和包内 x86 运行库加载通过。
独立静态审查发现目标的字面路径比较可能误拒绝映射盘与 UNC 身份,已改为比较两边解析后的工程及数据库路径,实际原生启动路径保持不变;等价路径回归先失败后通过。真实网络共享与 Win10 验收仍保留。复审无剩余必要 P1/P2。
关联回归、全量回归、构建与冻结检查保存在 `diagnostics/icdb-startup-gate-20261104/`,最终测试包的 `BUILD.json` 记录实际执行结果及源码哈希。
最终冻结包通过实际按钮在自有隔离库的 PENDING `IP101GR` 上再次打开手动备份列表、正常关闭并刷新为“待校验”,应用正常退出。没有点击 Repair/Restore;该试验用于确认手动入口独立性,不作为新的启动诊断或自动修复实机验收。
本轮不对原中心库执行 Repair/Restore,不以模拟诊断或隔离副本备份窗口打开成功代替现场自动修复验收。ICDB 自动修复内部问题仍未验收,工单及 WIP PR 保持开放。
@@ -0,0 +1,37 @@
# 后台 ICDB 检查与原生任务排队
## 用户约定
ICDB 检查保持界面可用;校验、库管理、恢复、原生版本窗口等操作提交后串行排队,检查每完成一个 CBB 让出原生执行机会。检查与校验相互独立;检查不自动 Repair、Restore,不改变权威 READY 状态。
## 已确认的原因与修改
- 旧检查占用 MainWindow 的整批 busy 标志,缓存筛选及其他入口随整批禁用。改为独立 IcdbCheckTask、独立取消信号和捕获的工程/库快照;NativeQueue 每项准入,可取消等待,暂停检查不挡后续任务。
- 全局 PCB COM/ROT 可能等待其他工程的模态窗口。检查改为本任务完整 PCB 参数/PID、当前私有桌面、目标 MDI 和本次原生日志联合取证;正式校验继续使用原 COM 集成接口。
- PCB 参数匹配原为子串匹配,会把 `.pcb.backup` 或 `-ReusableCircuitOther` 误认。现按完整命令行参数匹配。
- DialogAgent 在读取子控件/UIA 之前按本任务 PID 范围过滤,执行前重新确认 HWND/PID/class;不读取或点击同桌面的无关弹窗。
- PCB 的临时启动窗口、普通/Reused Block 标题转换及 WM_CLOSE 后 IE 辅助窗口的短暂变化,不能解释为 ICDB 损坏。关闭前必须有目标加载证据;关闭后等待本任务退出,未知窗不点击、不重新发 WM_CLOSE。持续未知窗至期限结束才保留现场并报告。
- 诊断跳过无关集成历史日志,日志读取限定内容和两秒读取期限;超时结束该项,不反复堆积读线程。历史目录较多、历史日志较大不能直接判工程异常。
- ProcessWatch 用已打开的进程句柄观察退出,避免 COM 等待阶段每次轮询都启动 WMI 辅助进程。
- 原生退出后才产生完整 PCB Job Name 的缓冲日志必须在关闭后再核对。PASS 同时要求新 PCB 成功日志、新数据库路径和 PCB PID 装载日志,以及完整 PCB Job Name。
- 失败性质和实际释放事实分别记录。错误包含 ICDB 才标明 ICDB 错误;读写确认、版本选择和未确认原因单独显示。单项失败且释放已确认时继续下一项。
- 后台切库时只更新匹配的库清单;旧工程检查建议在后续管理操作后失效。旧库结果的释放入口不能释放当前另一个库。
- 网络映射由全部活跃 lease 登记保护,包括读取线程尚未交付给界面的 lease;拥有者结束时向仍在使用者转移映射。网络收尾需离开 Qt 线程,避免慢网络同步冻结界面。
## 原生验证范围
Windows 11、Mentor EE7.9.5。实验仅使用 `C:/Temp/CbbBackground-*` 中的完整隔离库;原始六个主要文件记录 SHA-256,来源保持不变。故意修改副本 `icdb.dat` 文件头得到 `SingleFile: ERROR ... in old, unsupported format`,用于验证当前错误分类和失败后的安全退出,不能代替现场失联故障验收。
`diagnostics/icdb-authority-20261105/validate_background_native.py` 运行应用的 `run_verify(maintenance=True)` 完整检查入口,在每次工作桌面放置另一个 PID 的真实模态窗口。要求损坏项报告明确 ICDB 错误并安全退出,下一正常项完成打开检查;无关弹窗在本任务结束前保持未操作;不得执行自动修复。
原始日志及结果在 `diagnostics/icdb-authority-20261105/background-native-result.json` 和对应 C:/Temp 证据目录。冻结包的 BUILD.json、VALIDATION.json 分别记录源码哈希与本包验收证据。
源代码完整链路于 19:16—19:17 通过:损坏项 FAIL / ICDB_REPAIR_REQUIRED / safe_to_continue=true,耗时 62.062 秒;下一正常项 CHECKED / safe_to_continue=true,耗时 26.704 秒。两个其他 PID 的模态窗口均保持未操作,来源六文件哈希不变。此记录另存 `background-native-source-result.json`;最终候选包必须再次通过自身冻结执行器的原生验证。
`validate_background_gui.py` 额外通过真实检查按钮提交检查,再提交权威状态读取并测试排队期间缓存筛选。其单行目录 PENDING 状态为测试注入,原生打开、退出和后续状态读取均实际执行;这不构成现场真实库状态的验收。
r9 冻结执行器实测通过同一批次:故障项 68.531 秒,安全释放;正常项 33.313 秒,CHECKED 且安全释放,其中启动 17.093 秒、关闭 8.703 秒;两个无关弹窗未操作。界面实测 34.703 秒,检查和状态读取顺序为 check-start → check-end → status-start → status-end,排队期间缓存筛选可用,50ms 事件循环计时器最大间隔 79ms,后续原生状态为 READY。该时间只是本机当前样本结果,不作跨样本速度提升比例。
## 保留限制
检查仍需实际启动 Mentor。去掉 COM/WMI 和无关日志开销,不等于消除原生程序启动和数据库加载时间。日志或文档身份不足时报告未确认,不推断 ICDB 损坏。实际未释放的当前任务会停止后续原生写入并提供释放入口,界面缓存操作继续可用。ICDB 自动修复和现场服务器会话失联恢复未验收;本候选包不关闭工单、不作为正式发布。
@@ -0,0 +1,28 @@
# 阻塞范围收紧记录
> 后续审查已修正本记录中“切库清除旧标志”和“只检查 Work”的不足。当前行为与验证请以 [全链路审计](2026-11-05-blocking-lock-audit.md) 为准:状态按库保存,释放包含共享数据库并绑定原任务范围。
本轮处理的是“一个 CBB 出问题后把整批和其他库一起停掉”的误阻塞。
## 已收紧
- 批次继续条件保持按实际释放证据判断。单项 FAIL、ICDB 检查发现问题或普通内容错误,只要本次原生/自动化客户端已经退出并返回 `safe_to_continue=true`,下一项继续;只有进程仍存活、退出状态无法确认或共享写入安全无法证明时才停止后续写操作。
- 管理失败状态现在绑定实际中心库。切换到另一个中心库会清除旧库的 `_management_unsafe`,不会把库 A 的失败带到库 B;释放检查完成回调也只清除同一库的状态。
- 显式维护的原生占用检查按目标 PRJ 命令行过滤无关 PCB/Library Manager。旧的零参数占用探针仍兼容,目标路径可用时不再被其他 CBB 阻塞。
- 释放证明支持目标 CBB 范围。提供目标名称时,只检查该 Work 工程的地址记录、主要数据库文件和命令行包含该工程的原生客户端;其他 CBB 的 `sAddress.adr` 不再阻塞当前恢复。无目标范围的全库释放检查继续保守处理。
- 释放接口新增参数保持旧调用兼容;旧插件或测试没有 `block_name` 参数时继续走全库证明路径。
- UI 比较中心库身份不再对不可达 UNC 路径调用会访问网络的 `Path.resolve()`。网络共享暂时不可达时保持可用状态和错误提示,不在界面刷新中抛异常。
## 仍然必须停止的情况
- 当前项的 PCB、Project Backup、保存助手、Importer 或管理工作进程仍在运行。
- 进程查询失败、原生窗口身份不明、退出状态缺失,或库锁/共享写入归属无法确认。
- 用户明确点击取消,当前批次停止后续项目。
这些停止条件保护共享数据库和原生写入现场;移除它们会把一个仍在写入的工程与下一个 CBB 并行运行,可能造成更大范围的数据损坏。
## 验证
新增回归覆盖单项已释放失败继续批次、切库清除管理阻塞、目标 CBB 过滤无关进程/地址、旧释放接口兼容和不可达 UNC 路径。最终全量回归 **1309 passed**,1 条既有 pywinauto STA 警告;`compileall` 与 `git diff --check` 通过。
本轮没有修改图标等其他工作区文件,也没有对现场中心库执行写入、Repair 或 Restore。
@@ -0,0 +1,132 @@
# 全链路阻塞与锁审计(2026-11-05)
本次目标:枚举从按钮到批次结束的阻塞条件;消除把单项失败、历史记录或无关进程当成本任务仍占用的情况;用实际运行核对退出和下一项继续。
这是一份开发与验证记录,不把维护说明加入产品 UI。ICDB 批量检查不执行自动 Repair,不把普通打开失败推定为 ICDB 损坏。真正仍在运行的同库写会话继续串行;不能通过删除 Mentor 地址/锁文件、强杀数据库进程来制造“已释放”。
## 已复现的现场链路
旧候选包对 IP101GR 打开检查时,原生 PCB 显示完整的 `Continue to open the design with read/write access permission?` 问题。程序报 `DATABASE_RECOVERY_REQUIRED`,启动收尾函数却只接受 ICDB/数据库加载失败类别,返回 `STARTUP_FAILURE_UNCONFIRMED`,未取消打开。PCB 60544 和启动器 63824 留在本任务私有桌面,导致后续会话不释放。
2026-11-05 使用修改后的真实退出函数,核对本次进程、工程参数、私有桌面和精确原生全文后点击 **No (7)**;两个进程均退出。6 个主要文件(LMC、PRJ、PCB、工程数据库、Layout、PCB工程配置)前后 SHA-256 一致。原有两个 Project Backup 会话没有被终止,没有执行 Repair/Restore。
证据:`diagnostics/icdb-authority-20261105/field-readwrite-cleanup/result.json`。旧候选包原始 evidence 保留,不覆盖。
## 逐阶段清单
“保留”表示正在执行或归属无法确认时仍需要该条件;“修正”表示本次已定位误阻塞并实施回归修复。最终运行结果在文末登记,不能仅凭表格认为现场验收成功。
|序号|阶段 / 代码入口|触发条件及原有影响|处理|
|---|---|---|---|
|1|UI `busy` / ServiceWorker|真实任务执行中禁用启动、编辑路径、关闭;任务异常后必须恢复按钮|保留串行;检查 finished/failure 收尾|
|2|UI 已加载路径|输入路径改变但仍使用旧清单|保留身份检查,不启动旧目标|
|3|UI 选择 / 筛选|隐藏项、READY、缺工程进入检查队列|保留:隐藏项取消勾选;READY 即使选中也排除检查;管理选择独立|
|4|UI 状态刷新|检查结束后条目仍按旧状态禁用或勾选|刷新受影响条目,保留搜索;READY 清旧勾选|
|5|UI management unsafe|切换库清掉唯一的未释放标志,返回原库失去状态|修正:按库保存;A 不影响 B,回到 A 仍保留真实未释放事实|
|6|UI 原生版本会话|正在运行的同库版本窗口与写任务冲突|保留;其它库和清单筛选独立|
|7|版本窗口返回|启动器退出但结果缺失/身份错/子会话未确认|保留当前会话,不因窗口消失虚报恢复成功;释放入口可独立重查|
|8|全局原生 mutex|真实另一个校验/管理/恢复正在使用共享原生通道|保留实际串行;不把互斥失败持久化成本任务数据库 owner|
|9|库协调 OS handle|上传工具/本程序对同库持有独占句柄|保留真实冲突;不能用删文件绕过|
|10|协调文件创建|权限/路径/网络错误也被统一报“有锁”|修正:区分 sharing/lock violation 和访问错误;启动前失败可重试|
|11|历史 checkpoint|同库旧记录、pending、损坏 JSON 一律阻止管理|提供有证据的释放/归档;归属完全丢失时不能证明未知分析副本,列明未确认原因,不擅删|
|12|retained 管理 lease|失败时保留的句柄没有可再次检查的 release probe|修正可重查的精确 operation / scope;未退出仍保留|
|13|显式释放 scope|全机 retained exporter/worker 阻止另一库释放|修正按 operation / library 范围,不采用同名即归属|
|14|释放范围|只检查目标 Work,遗漏共享符号库;或遍历全部库和快照|修正目标库 / 目标 CBB / 实际共享路径,保留共享库互斥|
|15|owner 匹配|原始字符串包含 Work 会误匹配 WorkOld,job.json worker 又漏匹配|精确参数/目录边界及记录的 operation 归属;无法读取归属单列未确认|
|16|PID 重用|旧 PID 恰巧分给另一进程,形成永久旧 owner|新记录绑定创建时间/句柄,旧格式需独立释放证据|
|17|工程 preflight|缺 PRJ/PCB、无工具、非法参数|保留单项失败;未启动会话不保留执行锁、不停其它项|
|18|post-repair proof|非法凭证在任何 worker 创建前被标为 unsafe|修正为启动前拒绝,下一项可继续|
|19|content-check timeout|只读辅助进程超时与真实原生会话混淆|必须区分子进程是否退出,不以 timeout 字样推断 owner|
|20|DesktopWorker 构造|CreateDesktop/CreateJob/CreateProcess 失败,未创建 worker 仍被标 unsafe|修正句柄回滚并返回显式 no-process 证据;已部分启动仍未确认|
|21|原生读写确认|要求确认无其他用户,原程序不 Yes 也不 No,留下 PCB|修正:仅精确全文、PID、工程、桌面一致时 No;等待退出,绝不自动 Yes|
|22|PCB 历史版本选择|有两个版本,需要用户选择;不能代选|记录候选版本;扫描不执行历史回退,取消已识别的本次打开后收尾|
|23|其它已知 fatal|确认错误后仍存在空 PCB|正常关闭本任务空壳;不能要求先判为 ICDB 才允许收尾|
|24|未知弹窗 / 文档|不能证明是空壳、存在文档、非本进程、不同桌面|保留,不盲点按钮;显式给出未释放窗口证据|
|25|PCB 先退出|common 启动器延迟退出|等待 PCB 与启动器,不在任一仍活着时说释放|
|26|No 后旧地址|尝试打开被明确拒绝,但旧地址让本任务空壳不能退出|修正:取消本次打开不要求先取得外部数据库;保留地址,不声称数据库无人占用|
|27|COM 无文档 / ROT|COM 指向他人会话或 ActiveDocument 为空|只依据本任务进程/路径/桌面关闭空壳,不借全局 ROT 关闭他人工程|
|28|保存 / Close 超时|COM 仍可能在写;第二个 close helper 会重复操作|保留已有 helper,观察其释放,不强杀 PCB/数据库或重复保存|
|29|取消 / 主窗口关闭|取消发生在启动、校验、保存任意阶段|合作停止本任务,禁止新项;收尾确认后可再次启动|
|30|会话释放证据|worker 已退出,但 native/automation client 仍在|保留真实未释放;只有独立退出证明才能提升安全状态|
|31|可选报告/性能记录|释放成功后写报告失败又变成 unsafe|修正:报告失败保留告警,不覆盖执行结果和退出事实|
|32|progress / 批次报告|回调/磁盘写入异常终止循环,UI generic failure 挂锁|修正隔离展示错误,保留已完成结果与释放事实|
|33|批次单项 FAIL/BLOCKED/TIMEOUT|某项失败但已正常退出,被错误扩大成全批失败|依据实际 release 继续;用户取消/真正未知会话仍停止同通道任务|
|34|管理预检查|desktop/mapping/capability/source 失败,尚未原生激活即 unsafe|修正显式 activation-start 状态;未启动可重试|
|35|管理 catalog 失败|返回 success=false/safe=true 被异常丢掉 release|修正操作成功与会话释放分别传播|
|36|管理检查点恢复|catalog_before 中断就阻止所有 CBB,和实际 remove 中断混同|区分 mutation 前失败和已发生修改;后者保留数据恢复要求|
|37|无关 LM/PCB/viewdraw|全机任意同名进程阻止目标库检查/恢复/导出|绑定目标工程、库和共享数据库;COM 激活若无法证明隔离仍单独说明|
|38|工程内容导出|收养所有同名 iCDB server / exporter,等待无关进程永不退出|修正仅本次后代和精确分析副本 owner;保留实际后代|
|39|导出副本回收|一个库的 retained export 挡住另一个库|修正 registry 库/副本身份,配合数据库独占读取|
|40|sAddress.adr|存在即被称为“有人占用”|存在只表示需原生确认;保留文件,NOT_IN_USE 只能由严格绑定的 inspection 得出|
|41|备份恢复异常|源路径/清单预检失败也报 unsafe、UI 挂锁|修正沿用是否实际启动/释放事实;目标改动与内容冲突仍阻止安装|
|42|批量状态读取协议|A 响应不匹配就把未查的 B 等都标 MALFORMED|修正重启桥接并逐项读取,不伪造后续状态|
|43|状态缓存身份|只凭字节/名称复用另一库的结果|修正规则版本 + canonical library / block type 身份|
|44|映射关闭|先置 closed,再取消映射;失败以后不能重试|修正确认成功才关闭;保留用户/被改指向的映射|
|45|无关盘枚举失败|另一个盘查询失败阻止目标 share 复用|修正独立确认目标盘;未知盘只作为不可用盘符|
|46|真实地址/共享库占用|同目标 / 实际共享数据库活动 writer|保留实际写互斥;普通错误不得扩展成永久禁用其它独立功能|
|47|未知执行异常|无法知道是否已经启动/改数据|保持未确认;修已知 prelaunch/reporting 根因,不能把一切异常默认放行|
|48|退出后 cscript owner 查询|3 秒包含 helper/Python/COM 启动,现场实际约 4.75 秒,误报查询超时|真实隔离批次复现;改为统一 10 秒有上限查询,超时仍是未确认而非确认占用|
|49|导出全进程 WMI|直接 WMI 卡住会让 supervision 长期保留 worker|移入有上限只读 helper,保留所有名称的真实后代;启动前查询失败不会制造 native owner|
|50|操作后内容/状态失败|移除/新增已返回安全退出,但后续读取失败又丢失释放结论|内容恢复状态与进程释放分别保留,不能用 mutated 标签代替活动会话证明|
|51|启动前证据磁盘错误|目录/request/worker.log 创建失败,被通用异常当原生会话未释放|明确尚未创建 worker 的失败可继续;runtime 指纹写入为可选,不掩盖真实结果|
|52|证据查看器|打开证据路径失败进入通用 worker 错误处理,错误保留映射|只显示查看失败,不创建数据库未释放状态|
|53|维护库归属|目标 RepairTarget 可证明所属库,却仍全局检查 retained worker/export|从原 PRJ 的唯一有效 CentralLibrary 解析身份,复用统一归属检查;普通扫描保持独立|
|54|同库路径别名|同库 drive/UNC/大小写别名被当成另一个库,或 UI resolve 访问失联网络|使用已有 lease 映射和本地规范键,不在控件更新中访问网络|
|55|同盘符多个 retained 库|A 释放后所有权转到当前 A,关闭 A 会断掉仍有 B 会话使用的盘符|关闭前把所有权交给同盘符/共享路径的 retained B;B 未释放不取消映射|
|56|目录输入的库身份|原始输入为目录,释放同目录任意 LMC 都可能误匹配|读取时绑定选中的实际 LMC;未绑定目录不接受 sibling LMC 释放证明|
|57|已释放但待数据恢复|同目标正确阻止重放,却把旧 safe=true 改成 false,进而停止独立目标|保留同目标数据恢复要求,同时保留已释放事实,独立目标可继续|
|58|真实 EDIF 参数形式|程序发出 `-icdb <目录>`,归属解析器只认 `-icdb=<目录>`|兼容实际分离参数并按完整目录边界匹配,不把明确无关的导出器当未知 owner|
|59|Add 的 pre-capture 准备|原始库引用/清单/工程对齐失败发生在导出前,却继承 unsafe|准备阶段失败明确未启动;实际 capture 后始终沿用真实释放证据|
|60|最后一笔导出进程记录|native 和数据库已释放,但 finally 中的 process.json 写入异常覆盖结果|最终报告 I/O 保留真实 release;无退出证明的分支仍保留 owner|
|61|冻结代理启动与 PCB 门禁|代理十秒未就绪可误报,工作进程又只等十五秒|代理启动 30 秒、工作进程门禁 45 秒共享常量;日常 IPC 仍为 2 秒,监听以 0.2 秒轮询响应取消|
|62|连接握手/门禁取消竞态|用户在 handshake 时取消,父进程仍可能先放行 PCB|认证后、门禁放行前、worker 执行原生前都再次检查取消;等待门禁时也响应取消|
|63|残留释放入口|只显示存在进程即拒绝,没有正常关闭、保存提示或确认后结束的路径|增加精确名单、逐项关闭、保存选择、独立强制确认、重新证明与继续未执行项;未知归属也显示供定位|
|64|释放后的全库证明|对普通输出逐个重复 resolve,同一副本 23,218 条记录导致原生退出后仍等待约 97 秒|一次规范库路径;复用已拒绝链接的扫描 metadata,先筛原生数据库候选再独占读取;同一库证明约 6.9 秒|
|65|管理启动前历史阻止|旧记录让新任务尚未启动便失败,却被 LibraryBusy 类型强制改成 unsafe,UI 永久禁用;扫描也不显示记录和无 JSON 的 retained lease|新任务在互斥内先做完整复核,归档旧记录并恢复句柄/映射;未启动不制造 owner,UI 旧标志转为重查要求,历史/内存记录可见;同目标未恢复修改仍禁止重放|
## 执行与验收顺序
1. 保存现场弹窗、PID、request、release 和主要文件 hash;正常取消本次遗留打开。
2. 各域先写失败回归,分别修空壳/弹窗、UI/批次、库协调/管理、导出/恢复、网络/状态桥接。
3. 统一串行运行全量测试,避免测试之间竞争真实 Windows named mutex。
4. 在新隔离库运行应用检查入口:故障/提示项 → 正常项;确认无自动 Repair,无遗留本次 native owner,原来源文件保持不变。
5. 新目录生成候选冻结包;校验冻结源码一致、启动/退出、x86 桥接、冻结检查链路,再打开供用户测试。
## 验证记录(持续更新)
- 现场遗留读写确认:真实 No 取消,PCB 60544 / launcher 63824 退出,6 项 hash 一致。
- startup / desktop / native repair 相关回归:194 passed(后续统一全量再次覆盖)。
- 第一轮真实副本批次:**未通过**。成功复现原始读写确认;新取消路径正常退出,但随后 cscript owner helper 的 3 秒超时将结果重新标为 unsafe,后两项 SKIPPED。原库 6 项 hash 一致。保留 `blocking-live/result.json` 与完整原始记录。该误阻塞已新增回归修正,原副本重跑结果见下一条。
- 修正后的真实副本批次:**通过退出与继续验收**。`blocking-live/retry1/result.json`:现场副本 `FAIL / DATABASE_SAFETY_STOP / safe=true`(No 正常取消);故意损坏副本 `FAIL / ICDB_REPAIR_REQUIRED / safe=true`;健康副本 `CHECKED / safe=true`。三项各自 `session-release.json` 均为 worker 已退出且 remaining_pids=[]。源 6 项 hash 一致,无 Repair/Restore/保存集成。此结果证明失败项能够退出并继续,不证明故障内容已修复。
- 第一轮统一全量:1452 passed / 3 failed。三项为旧测试的相对路径归属 fixture、缺 library 的内部请求 fixture,以及新增的应用 JSON 回收 callsite 未纳入静态审计白名单。已限定修正 fixture 和 JSON callsite;未放宽未知原生归属、未允许删除 Mentor 文件。审查额外发现的 55–60 项已补回归并纳入下述复跑。
- 统一全量复跑:**1479 passed**,1 条既有 pywinauto STA warning;`blocking-final-pytest.xml`。编译与 diff 检查通过。
- 后续冻结实测:现场副本 FAIL 退出后继续;损坏样本遇到 `DIALOG_AGENT_START_TIMEOUT`,同样已释放并继续;健康样本 CHECKED。该结果只通过退出/继续验收,损坏样本本轮未进入 PCB,不能算内容检查通过。由此补充 61–62 的启动/取消修正。
- 启动修正增量:**239 passed**,含代理、worker 门禁、普通验证、批次、保存/退出、修复凭证与 UI 回归;`startup-delta-pytest.xml`。本机另有独立 pytest 使用相同产品 mutex,增量回归使用专有测试 mutex 名,产品互斥名不变。
- **最终 r3 冻结链路通过**:`blocking-live/frozen-r3/result.json` 中现场副本 `FAIL / DATABASE_SAFETY_STOP / safe=true` → 损坏样本 `FAIL / ICDB_REPAIR_REQUIRED / safe=true` → 健康样本 `CHECKED / safe=true`。三项实际启动 PCB,三项本次会话均退出、没有未执行项、没有 Repair/Restore,原库 6 项主要文件 hash 一致。
- 冻结验证使用与包内字节码逐项比对一致的控制层,worker、弹窗代理、原生日志和进程探测均运行实际冻结 exe;没有把源码子进程冒充冻结子进程。24 个 Python 模块及 2 个 VBS 内容一致;实际 GUI 启动/退出、x86 codec、包内 VC runtime 加载、完整进程快照 helper 通过。
- 最终独立只读复核:已报告的 P2 修正后无剩余 P1/P2;后续启动预算/取消竞态也单独复核通过。当前实测环境为 Windows 11 / Mentor EE7.9.5,Windows 10 未实机验收。
- 候选包目录:`dist/blocking-locks-20261105-candidate-r3/CbbRefreshVerify-Background`。`BUILD.json` 记录源码基线/实际文件 hash,`VALIDATION.json` 记录全量与增量测试和原生链路结果;仍是候选包,不合并发布、不关闭工单。
本次不宣称 ICDB 自动修复已通过验收。生产库的其它原生 Project Backup 会话保留;它们连接失败不等于数据库损坏,也不等于可强夺写权限。
## 确认释放会话(后续增量)
用户反馈 r3“释放检查”遇到两个 Project Backup 进程只返回不能解除,没有关闭入口。本次增加“释放残留会话…”:先列当前库关联进程和工程,确认后逐项正常关闭。已加载 PCB 允许正常关闭;标准保存问题由用户明确选择保存、放弃或取消。已知启动确认可正常取消。单项未退出继续处理其它项;全部退出后再证明库文件可独占读取,归档本应用旧 checkpoint,解除保留句柄与映射,恢复按钮。
正常关闭无法完成时,提供独立的“强制结束所列会话…”警告确认,默认取消,列出项目、进程和 PID,明确未保存修改丢失及写入中断风险。仅对已证明属于当前库、重新核对 command/creation/image/进程句柄身份的列表发送结束请求;不是全机按进程名清理。此显式功能不改变普通检查/关闭/取消任务的合作退出策略,不删除 Mentor 地址、数据库或锁文件。
不安全批次结果可直接进入释放;取得当前库释放证明后,重新显示结果框,用户可点击“继续未执行项”。只恢复原检查/校验中 SKIPPED 的条目,重新套用当前可见性及非 READY 资格。失败项不自动重放,库增删改不自动重放。
原生实际验证:`diagnostics/icdb-authority-20261105/confirmed-release-b00c3b7c/result.json`。在 `C:/Temp/CbbBlocking-15cb2f99/healthy` 一致副本运行真实 Qt 确认按钮,正常关闭 Project Backup PID60404,监督 worker PID13008 随后退出,full release proof 通过;6 个主要文件 SHA-256 前后一致,未执行 Repair/Restore。截图 `preview.png` / `released.png` 保留。初次试验遇到不存在的 pywin32 查询 API,已改用 Windows QueryFullProcessImageNameW 并增加真实句柄回归后重跑通过;初次证据不覆盖。
当前边界:跨机器会话、不可读归属、操作系统拒绝权限或原生数据库地址未释放,不能通过本机结束请求制造成功。最终证明失败会保留原始原因与证据。强制结束仅证明进程结束,不证明工程数据完好;ICDB 自动修复仍未验收。标准 PCB 保存提示有精确消息/按钮与 UI 单元验证,尚无真实未保存 PCB 工程的端到端保存验收。
验证记录:统一全量 **1509 passed**(`residual-release-pytest.xml`,328.25 秒,1 条既有 STA warning);最新释放/未知归属/确认名单竞态/界面继续入口/库协调/文件保护增量 **83 passed**(16.42 秒)。未知归属进程现在显示为诊断行;只有预览时和执行时都证明属于当前库的项才可以关闭,执行时恢复可读不能扩大用户确认过的名单。代码复核发现的结果框隐藏及确认名单竞态均补先失败的回归后修正,最后只读复核未发现剩余 P1/P2。编译与 diff 空白检查通过。
r4 冻结增量的第一次实际试验没有通过 100 秒测试门槛:原生 PID25260 / worker PID61916 已正常退出,旧 checkpoint 已完整归档且 release proof 成功,但全库证明对 23,218 条记录反复路径解析约 97 秒,测试控制器已提前超时。证据 `confirmed-release-dfb29e88` 保留,不能算该轮通过。新增失败回归后修正了普通文件的多余解析,同一副本实际 proof **6.906 秒 / 12 个独占文件**;最新涉及库释放、维护范围、网络映射和 UI 的回归 **105 passed**(17.09 秒)。新的 r5 候选需再次执行完整冻结释放链路。
**r5 冻结链路已通过**:`confirmed-release-99f3f4e0/result.json`。真实 Qt 确认入口关闭 Project Backup PID48080,包内监督 worker PID23040 退出,旧 checkpoint 归档并清除,12 个原生文件独占读取证明通过,6 个主要文件 hash 一致。整个试验约 27 秒(含启动后等待 15 秒、列表查询、关闭及复查),原生退出至释放完成约 6 秒。随后立即使用同一 r5 exe 运行真实 PCB 检查,`next-check-result.json` 返回 `CHECKED / safe=true`,实际打开正常并退出、remaining_pids=[]、没有 Repair/Restore,证明清理后可以继续后续任务。此检查耗时约 100 秒,其中 PCB 启动约 86 秒;不能把该启动耗时称为释放卡死。
r5 包内 26 个 Python 模块及 2 个 VBS 与当前源码一致,实际主窗口启动/退出、x86 codec、包内 runtime 和冻结进程探测 helper 均通过。性能改动经独立只读复核,未发现新 P1/P2。只交付候选包,不关闭工单或宣称 ICDB 数据已自动修复。
r6 用户中心库误阻止的根因、源日志、修正和冻结管理链路见 `2026-11-05-management-phantom-blocker.md`。统一全量 1518 passed;完整原生移除与重新读目录验证通过。历史记录本身不再被直接当作活跃会话,管理入口允许重新复核;生产库工程未改动。
@@ -0,0 +1,47 @@
# Issue 5:私有桌面泄露
## 现象
代码与回归测试确认:原生 worker 创建私有 Windows Desktop 后,如果 Job Object 创建或 worker 进程启动失败,构造函数直接抛出异常,已创建的 Desktop 和 Job 句柄没有释放。重复失败存在累积私有桌面资源的风险;本次未对现场所有桌面异常作归因。
状态读取路径还有一个相同的边界:`read_library_flag` 在进入资源清理保护前加载 UI 依赖;依赖加载异常时,刚创建的私有桌面无法执行 `CloseDesktop`。
## 根因
1. `DesktopWorker.__init__` 的资源申请跨越多个可能失败的步骤,但没有事务式回滚。
2. 进程句柄、Job 句柄和 Desktop 句柄的释放顺序没有覆盖构造阶段异常。
3. `read_library_flag` 的依赖导入位于 `CreateDesktop` 之后、`try/finally` 之前。
4. `read_library_flag` 和 `read_library_tree_image_map` 都在清理保护外先创建 Desktop,再执行 `Path(library)` 等准备逻辑;准备阶段抛异常时也会泄漏。
## 解决方案
- 在 `DesktopWorker` 构造开始时初始化资源字段,并把 Desktop、Job、worker 创建放入同一异常边界。
- 构造失败时按 worker、Job、Desktop 顺序回滚;已启动的 worker 先终止,避免留下无父级的原生进程。
- 在状态读取创建 Desktop 前完成 UI 依赖加载,确保依赖异常不会产生未受保护的 Desktop。
- 两处状态读取均在准备逻辑完成后、`try/finally` 内创建 Desktop,清理时检查资源是否存在。
- 测试中分离 Desktop、Job、Process、Thread 的接口,断言失败后关闭顺序;覆盖四个构造失败点与进程创建后的终止分支。
## 影响范围
- 覆盖原生 worker 构造失败,以及状态读取准备和启动阶段的资源清理路径。
- 正常任务的私有桌面、Job Object、进程树和数据库释放策略不变。
- 不会切换用户输入桌面,也不会改变中心库写入策略。
## 验证
- 修复分支完整 `python -m pytest -q --tb=short`:480 passed。
- 同环境、同工作树切换到 `origin/main`(`39985f7`)完整运行相同命令:471 passed。两次运行依次执行,均仅有一条 pywinauto STA 警告。
- `tests/test_desktop_worker.py`:9 passed。两处状态读取准备阶段泄漏的新增测试在修复前 2 failed,修复后通过。
- 变异验证:把回滚中的 `self.job.Close()` 故意改为 `self.job.CloseDesktop()`,测试产生 2 failed;恢复正确代码后通过。
- `python -m compileall -q src tests`:通过。
- `git -c core.whitespace=cr-at-eol diff origin/main HEAD --check`:通过。命令显式识别 Windows CRLF;仓库 `.gitattributes` 为 `* -text`,保留源文件换行,不依赖本机 `core.whitespace` 配置。
此前 #7 将一次运行中的 `test_backup_recovery.py::test_invalid_source_does_not_touch_target` 失败称为既有基线问题,缺少同环境对照,撤回该归因。本次该用例在 main 与修复分支均通过。审查者在旧 WIP 基线测得的 19 个失败不属于本次从 main 独立提交后的测试范围。
## 合并范围修正
原 PR #7 以 ICDB WIP 分支为父提交,却以 main 为合并目标,实际携带 59 个提交、118 个文件。现从 main 单独 cherry-pick 桌面修复并补充上述审查修正;相对 main 只有本工单、两个源码文件和一个测试文件,共 4 个文件。独立代码复审未发现待处理问题。
## 分支
`codex/desktop-leak-main`
@@ -0,0 +1,47 @@
# 导出身份比对与备份恢复:阻塞审计及修正
本记录只覆盖 `native_engineering_identity.py`、`native_export_guard.py`、`backup_recovery.py`。没有启动原生工具,没有修改生产库、Mentor 地址、锁或数据库文件。完整应用现场验证由主任务单独记录。
## 从前到后的阻塞点
| 阶段/触发条件 | 修正后行为 | 保留原因/证据 |
|---|---|---|
| 输入工程身份、库引用、工程完整性或独立目录不符 | 本项拒绝;没有创建原生会话时可继续下一项 | 防止替换错误工程;不是占用锁 |
| EE7.9.5 导出程序缺失或二进制版本未通过能力探测 | 本项拒绝;未启动即不宣称会话未释放 | 不猜测原生接口 |
| CBB 操作互斥量实际被其它操作持有 | 不并行启动;保留原有串行约束 | 原生 COM/共享库任务串行运行 |
| 库协调句柄确实独占或已有未释放任务 | 保留互斥 | 句柄/释放证明由 `library_lock` 负责 |
| 机器上存在其它工程的 PCB、LM 或原理图进程 | 不再单凭进程名阻塞恢复 | 完整工程/数据库/库路径参数匹配;`WorkOld` 不匹配 `Work` |
| 有原生进程但没有可识别的工程参数 | 本项返回 `TARGET_NATIVE_OWNER_UNCONFIRMED` | 尚不能通过进程名称判断它打开的文档;不称为确认占用 |
| 进程参数明确属于目标工程或目标库 | 本项返回 `TARGET_NATIVE_OWNER_ACTIVE` | 不抢占用户或其它任务会话 |
| 目标/共享数据库仍有 `sAddress.adr` | 本项返回地址状态未确认;保留地址原件 | 地址存在不等于活动占用;目前该写入入口仍需原生判断 |
| 目标 LMC、工程/PCB 的 `icdb.dat` 或 Layout 无法独占读取 | 拒绝安装 | 补上实际文件句柄探测,包含共享 `__ReusableBlocksSymb` |
| 源、目标、验证副本内容在复制/验证期间变化 | 本项拒绝覆盖;已证明释放时不制造未释放状态 | 保留原文件与清单 |
| 其它工程的 iCDB 导出器/服务器存在 | 不再全机拒绝导出,也不收养为当前任务后代 | 仅追踪本次后代和命令明确指向本次分析副本的原生进程 |
| 当前导出器或后代仍活跃/句柄未释放 | 保留导出任务及它所属库的排除 | 不杀原生进程;库 A 的已绑定记录不排除 B |
| 创建导出进程遭明确 FileNotFound/Permission/CreateProcess 拒绝 | 返回失败且本任务会话安全;可重试 | `native_started=False` 及 `export-launch=false` 绑定证明 |
| 导出构造异常但可能已经启动原生进程 | 保持未确认,不能因没有返回 Python 对象就放行 | 明确区分未启动和部分启动 |
| 导出前完整进程树查询超时/失败 | 本项失败且明确未启动;释放本任务未启动的 guard,可继续独立项 | 不把查询失败视为空进程列表或数据库无人占用 |
| 已启动导出后的完整进程树查询超时/失败 | 10 秒以内返回未确认,保留本次进程与已记录句柄 | 不无限等待 WMI,也不强杀原生进程 |
| 导出器已退出,但输出错误或不完整 | 内容失败与释放结论分开 | 不因业务失败制造活动会话 |
| 导出后的汇总报告写入失败 | 保留已确认释放;报告写入错误另行返回 | 先完成释放证明及清除本次导出 guard,再写可选汇总 |
| 恢复开始前检查失败或恢复结果报告写入失败 | 保留 `release_confirmed`;没有原生会话则允许其它独立项继续 | 不再统一返回 `safe_to_continue=False` |
| 程序重启后导出 PID 被其它进程复用 | 新记录比对 creation identity 与 executable;不同身份不当成旧 owner | 旧记录没有创建身份时仍需新鲜独立证明 |
| 正常导出 checkpoint 存在 | 重新核对库、lease、token、独立副本、进程身份、地址和数据库句柄 | 不把其它同名服务器当作当前副本 owner |
| 应用 checkpoint 损坏 | 默认拒绝;显式释放入口持有完整库/原生证明时可使用 `allow_unknown_checkpoint` | 此路径仍要求全机已知导出 owner 和 retained registry 均空;调用者必须归档未变化的原字节 |
## 回归验证
首次新增的六项失败测试均先观察到旧实现失败,然后实现修正。领域测试曾串行运行 `81 passed in 62.78s`;后续增加了未知启动、损坏 checkpoint 显式释放、无 PID 证明、报告 I/O 及 PID 复用的正反测试,新增子集 `12 passed`,汇总报告 I/O 正反 `2 passed`。主任务须再进行最终全量运行;多进程并行运行这些测试会争用产品全局 named mutex,不能把相互争用的结果当成业务失败。
全进程树查询现已移入现有 `--owner-probe` 只读 helper,使用版本化 snapshot 协议并保留 PID、parent、未知可执行文件名称、命令、路径和创建身份。上限统一为 10 秒,为 helper 启动及 WMI 查询保留余量;超时只结束读取进程的 helper。回归覆盖启动前与启动后的查询超时、未知后代、PID 0 系统项、协议版本、重复 PID、缺少创建身份等。新增相关子集 `17 passed`。实际本机只读 helper 返回 457 个进程(包括非 `.exe` 系统名称),457 项创建身份,耗时 4.75 秒;该数值是一次观察值,并非上限,没有启动 Mentor。
最后补充了 `capture_identity` 的启动前异常边界:来源校验、当前 lease 证明、证据目录范围、导出器能力检查、目录创建或 mutex 创建失败,均返回明确未启动的安全失败,不把被调用者异常变成活动会话。六项对应的失败测试先观察到旧实现抛异常,再验证修正;与查询预算、已启动失败的正反测试合并为 `11 passed`。这些测试没有取得产品全局 mutex。
最后一次只读复审补齐了进程诊断记录写入边界:已证明导出进程/后代退出且副本数据库已释放后,最终 `*-process.json` 写入失败只附加报告警告,不能抹去释放事实;仍有活跃原生进程时保持未确认。首个 `export-launch.json` 在任何启动前写入失败,则返回明确未启动;仅凭本进程当前 lease、匹配的一次性 token、独立副本 owner 和零 process records,清除此任务尚未启动的 guard。缺少日志不能由重启后的无身份记录借用此通路。三项报告异常回归先失败,修正后与未释放正反测试合计 `7 passed`,未使用产品全局 mutex。
## 仍需明确保留的验收缺口
- 没有在真实 Mentor 环境验证本轮恢复/导出功能。上述证据为回归测试及只读代码审查。
- 恢复写入入口中的旧地址,需要原生 inspection 确认;本次没有自动删地址,也没有仅凭文件不存在就确认释放。
- 无工程参数的外部原生会话仍是未确认;不能自动 Attach 到全局 COM 并操作他人的文档。
- 当前没有解决所有原生内容失败;本轮不表示 ICDB 自动修复或现场问题验收成功。
@@ -0,0 +1,124 @@
# ICDB 判定接口与本次检查失败的只读调查
日期:2026-11-05。基于 `1acfbd6`。本轮新增离线元数据探测脚本,读取安装的
类型库、PE 导出和既有日志;没有改变应用判定、打开工程、调用 Repair/Restore、
删除地址文件或终止原生进程。自动修复仍未验收通过。
## 结论
“打不开 PCB 并出现弹窗”是有价值的直接观察,但一般数据库打开失败、服务器
连接失败、版本恢复选择,都不能单独等同于 ICDB 数据损坏。现阶段最可靠的
ICDB 维护依据,是**本次打开的同一工程/数据库发出的明确原生诊断**。
尚未找到已验证、无需打开数据库、能直接预测 PCB 将发生 ICDB 故障的独立接口。
底层确有原生错误类别和错误码,但只有导出名称,没有取得对应 SDK 声明和
完整枚举,也没有建立真实故障与数字的映射;不能猜测参数调用后接入产品。
## 1. 已解析的 PCB 原生类型库
前一轮探测对 PCB 启动器执行 LoadTypeLib 失败,并不意味着安装缺少类型库。
本轮按 32 位注册表定位到:
```text
HKCR\TypeLib\{EDEDED00-D5F6-4B04-8FE7-EDEDEDEDED00}\1.0\0\win32
D:\Mentor\7.9.5EE\SDD_HOME\wg\win32\bin\XtremeDesignSessionWG.exe
```
成功读取 `MGCPCB (AutoActive series) Type Library`,共 614 个类型。没有创建
COM 实例,也没有连接正在运行的 PCB。
| 元数据 | 实际声明 | 能证明什么 |
| --- | --- | --- |
| `IMGCPCBApplication.OpenDocument(filename)` | 返回 Document,没有 ICDB 专用返回码声明,`scodeArray` 为空 | 可作为实际打开尝试;不能据声明直接解码 ICDB 故障 |
| `ActiveDocument` | 返回当前 Document | 空文档只表示尚未取得文档,不说明失败原因 |
| `IMGCPCBError` | `ErrorString`、`Severity`,没有 ErrorCode 属性 | 提供文字/严重级别;不是统一的打开错误码接口 |
| `EPcbErrorSeverity` | `epcbWarning=0`、`epcbError=1`、`epcbFatalError=2` | 是错误严重级别,不是三种 ICDB 健康状态 |
| `Errors` 集合使用方 | CopperBalancing、DFFSliverAnalysis、IDFImport、DXFImport | 不能把这些集合当成 PCB 启动错误队列 |
| 应用事件 | 打开前/打开后事件;`OnOpenDocument` 标志为 Open=1、Reload=2 | 没有声明 ICDB 打开失败事件和专用数字码 |
类型库没有专用错误表,不代表运行时绝不会返回 HRESULT/EXCEPINFO。真正执行
调用时仍应记录 HRESULT、EXCEPINFO 的 wCode/scode/source/description 和调用阶段,
但尚未实测的 HRESULT 不能赋予“数据库损坏”的含义。
## 2. 底层 iCDB 候选接口
静态解析 `iCDBPI.dll`、`iCDBDiagPI.dll`、`iCDBCAPI.dll`,三者均为 x86 PE。
`diagnostics/icdb-authority-20261105/metadata.json` 保存实际文件 SHA-256、
原始符号名称、类型库说明及常量,避免跨版本混用。
| 接口线索 | 已证实内容 | 未证实内容 |
| --- | --- | --- |
| `Result_get_iErrorCategory` / `Result_get_iErrorCode` / `Result_get_sResult` | 原生 Result 有错误类别、编号、文字 | 对象布局、调用约定、错误枚举及故障映射 |
| `CDBPI_IsOpenCDB` / `IsOpenCDBEx` | 存在数据库打开状态查询符号 | 未打开、不可达、损坏之间如何区分;不是已验证的健康检查 |
| `PIMgr_GetStatus` | C++ 对应声明返回/填写 `ESynchStatus` | 不能把同步状态当 ICDB 健康状态 |
| `Diag.GetProjectStatus` / `GetActiveIssues` / `GetStatus` | 存在诊断、工作区及项目状态接口 | 结构体、枚举、初始化方式、查询范围及副作用 |
| `Diagnostic.Check` / `CDBPI.IsDatabaseAvailable` | 存在相关诊断符号 | 参数语义、是否只读、超时/释放行为;未执行 |
导出名的存在不证明这是厂商支持的外部自动化 API。不能用 ctypes 默认 int
返回类型和猜测指针去调用这些接口;尤其不能在主界面线程内调用。
## 3. 本次“全部失败”的具体证据
旧记录:`diagnostics/live-open-20261105/evidence/icdb-check-1738989c1dae/`,
原生 PID `63480`,目标为 IP101GR 的 `Work/database`。
这次补读该 PID 的原生进程日志:
```text
D:\Mentor\7.9.5EE\SDD_HOME\standard\iCDB\ProjectBackup\Logs\
2026-11-05 08.08.40-63480\2026.11.05.iCDBProjectBackup.txt
```
日志从 08:08:41 读取该数据库的 ServerProperties,依次尝试所记录的多个地址
和主机名,端口 10002。08:09:14 报 `Network: ERROR: Could not connect to IP [...]`
后,再次读取同一数据库的服务器属性并继续重试。调查时读到的后续日志中仍有
相同循环。摘录和来源保存在 `diagnostics/icdb-authority-20261105/network-evidence.json`。
因此,这一次没有取得 Output 的直接线索是**原生工具正在反复连接数据库记录的
服务器地址**,不是仅仅窗口标题不匹配。此前允许通用标题的修改不足以解决它。
尚不能仅凭这些日志确定是服务器已退出、地址过时、监听配置或防火墙问题,
也不能证明数据库内容损坏,更不能据此确认目标无人占用。
同批另两项缺少唯一 PRJ,不能把它们与此连接失败合并成一个损坏结论。
本轮没有再次启动原库检查,也没有强制结束 PID 60000/63480。
## 4. 检测规则的遗漏与证据等级
安装 DLL 包含以下明确的原生维护消息:失联、整理中断、升级中断、重要操作
中断、跨机失联、自动修复中断,均带厂商的 Repair project 指引。
把这六段原生模板传给当前 `parse_session_loss`,只有跨机失联模板被识别。
这确认了规则覆盖范围偏窄;**模板存在不证明此次工程触发了这些错误**。
| 本轮实际证据 | 合理结论 |
| --- | --- |
| 同一数据库的完整失联/不一致/检查失败原生诊断 | 明确 ICDB 异常,记录子类、数据库路径、会话及证据 |
| 服务器地址重试、连接失败、一般 Could not run server | 连接/启动失败,尚不能认定损坏或无人占用 |
| `problem encountered while opening ...` / `loading ... failed` | 一般打开失败,还需具体数据库日志/弹窗 |
| Database Restoration 的手动/自动保存版本选项 | 需要用户选择版本,不自动判为损坏或代选 |
| Project Backup 未占用、备份目录已加载 | 占用/备份信息,不保证 PCB 完整打开或设计健康 |
| 无 Output、超时、未知错误 | 无法确认,不能推成健康或需要 Repair |
| READY/PENDING、地址文件、历史日志 | 均不能单独决定本次 ICDB 是否有问题 |
## 5. 建议的接入顺序与验证缺口
普通检验继续实际打开工程;同步捕获本次弹窗、增量日志和同一工程身份。
打开成功就继续普通检验,不以 Project Backup 预检作为其前置门槛;打开失败
仅在有明确 ICDB 原生诊断时标注 ICDB 子类,其他错误分别记录。检查结果不应
禁用普通检验或原生版本管理,也不据单项诊断设置永久的全库失败标志。
独立批量检查仍只做用户明确启动的检查。原生日志补采应绑定启动时间/PID、
目标路径和读取预算,保持增量及有界;网络日志中的“连接失败”不等同会话释放。
如果新检查不能退出,应显示实际滞留目标和原生连接阶段,不能靠伪造释放证明
继续对同一目标执行写操作。
下一轮动态探测应使用完整隔离库,分别记录正常打开、会话失联、文件损坏、
连接不可达、版本恢复选择的 PCB/原生证据;只运行诊断打开,不执行 Repair/Restore。
提取真实 HRESULT/EXCEPINFO 与原生文字的对应关系,并验证取消与正常关闭。
即使没有数字码,已确认的原生消息仍可用于分类;不能为等一个状态码阻塞普通流程。
本轮只验证元数据提取、既有日志关联和解析器覆盖范围,没有执行新的 PCB 打开
对照,没有验证底层 C API、解决原生网络重试或修复 ICDB。没有生成新应用候选包。
后续经用户授权完成了真实损坏/正常/缺文件对照,见
[损坏弹窗与错误码实测](2026-11-05-icdb-corruption-error-code-probe.md)。取得了 PCB
COM 两层错误码,但损坏与缺文件返回相同值,仍不能把该码当 ICDB 健康状态。
@@ -0,0 +1,102 @@
# ICDB 损坏弹窗与错误码实测
2026-11-05,Mentor EE7.9.5,PCB `2013.0.543.380`。按用户授权,只在新建的
`C:\Temp\CbbCodeProbe-7f1b0307` 内制造损坏。应用判定代码没有修改,没有执行
Repair、Restore、版本回退、集成或保存。
## 实测结论
成功触发数据库打开失败弹窗,并取得 `OpenDocument` 的 HRESULT 和 EXCEPINFO。
但**数据库损坏与文件不存在返回完全相同的两层错误码**,因此这两个数字不能
单独用于判断 ICDB 异常,更不能单凭它们自动请求 Repair。
| 对照 | `OpenDocument` 结果 | 外层 HRESULT | 内层 EXCEPINFO.scode | 原生证据 |
| --- | --- | --- | --- | --- |
| 未修改副本 | 返回正确工程文档 | 没有失败异常 | 不适用 | 工程身份匹配,数据库 GUARD OK,连接成功 |
| 损坏 `icdb.dat` 前 64 字节 | 失败,ActiveDocument 为空 | `0x80020009` / `-2147352567` | `0x8004021E` / `-2147220962` | 数据库文件打开失败弹窗;本轮日志明确指出损坏副本的数据库格式不受支持,并建议 Repair |
| 不存在的 PCB 路径 | 失败,ActiveDocument 为空 | `0x80020009` / `-2147352567` | `0x8004021E` / `-2147220962` | 文件不存在弹窗,没有数据库损坏依据 |
两次失败的 EXCEPINFO 全部字段相同:
```text
wCode: 0
source: Expedition PCB - Reusable Block
description: Failed to open document.
helpFile: ...\hssd\win32\bin\mgcpcbautomation.hlp
helpContext: 10187
scode: -2147220962 (0x8004021E)
```
外层 `0x80020009` 是 COM 调度异常。内层码在本次对照中表示通用的
`Failed to open document.`,尚不能赋予它 ICDB 专用含义。这里取得的是 PCB
自动化接口的错误,**没有调用未验证的 iCDB C API,也没有取得其内部 Result
错误枚举的可靠映射**。
正常、损坏、缺文件三种情况在等待 COM 注册时,都出现过
`0x800401E3` / `-2147221021`。正常副本随后成功打开,故此码也不能视为 ICDB
故障;它记录的是当时 COM 对象尚不可取得。
## 复现条件与证据
种子来自已有的隔离测试库:
`diagnostics/icdb-auto-recovery-20261027/verify-library`,不使用生产库作破坏对象。
完整复制得到 control 和 damaged 两份库,每份 21,029 个文件、557,187,955 字节。
复制后核对 LMC、PRJ、DXP、icdb.dat、PCB、LayoutDB 六个主要文件的 SHA-256。
仅在 damaged 副本清零工程 `database/icdb.dat` 的前 64 字节,其余字节保留。
正常副本和损坏副本在启动前彼此独立。
通过同一个原生入口启动空白 Reusable Block PCB,然后在专用私有桌面执行
`app.OpenDocument(绝对PCB路径)`。调用前核对 COM 主窗口 PID 的启动器父子关系,
记录 InstanceGuid,确认没有已有文档,且 PRJ/PCB 工程配置的 CentralLibrary
均解析到该副本自己的 LMC。没有创建生产库 COM 写会话。
正常对照 PID 15536,10:16:44 开始 OpenDocument,10:17:06 返回正确文档。
随后授权匹配的关闭助手执行 `doc.Close False`,未保存,正常退出。
损坏对照 PID 63384,10:18:10 开始 OpenDocument,10:18:51 取得异常。
弹窗原文:
```text
Problem encountered while opening one of the database files.
See PCBLogFile.txt for details. Loading of the job has failed.
Do you wish to view the log file now?
```
截图:
`diagnostics/icdb-authority-20261105/live-damaged/database-failure-75566502.png`。
先记录弹窗,再点击“否”关闭可选的查看日志提示,未发送修复指令。
本轮 `PCBLogFile.txt` 增量为:
```text
Database cannot be loaded and the server cannot be started, the project will
not be opened. Please use iCDB Project Backup 'Repair project' functionality
to fix this issue. (Database [C:\Temp\CbbCodeProbe-7f1b0307\damaged\
ReusableBlocksLP\IP101GR\Work\database\icdb.dat] in old, unsupported format)
```
“旧格式”是原生对被清零文件头的诊断文字;本试验没有证明实际存在版本过旧。
iCDBManager 同一 PID 的日志也指向该损坏副本。原生层先重复读取损坏数据库后
才显示弹窗;COM 异常在确认弹窗后返回,故不能只等 COM 异常而省略限时的
独立弹窗/日志观察。
缺文件对照最终 PID 61776,记录为 `live-missing-3174b7/com-result.json`,
10:25:08 发起调用,10:25:10 取得异常。首轮缺文件试验的单按钮提示未被助手
识别,助手按 180 秒上限停止,原生会话保留;之后核对窗口 PID 和明确的缺文件
文字,确认原生按钮 ID 为 2,正常确认提示并关闭空白 PCB。修正试验助手后重跑
取得上述完整错误码。该超时不是 ICDB 故障证据,首轮记录保留。
## 验证结果与边界
`diagnostics/icdb-authority-20261105/verify_live_probe.py` 对真实记录执行断言,
汇总保存在 `live-comparison.json`:正常文档身份、两种失败完全相同的 EXCEPINFO、
损坏弹窗与数据库路径、来源六文件哈希、损坏文件未被修复、测试进程退出及
已有原生会话保留均核对通过。三个最终试验都正常结束,前台窗口句柄前后相同。
没有剩余测试 PCB 或 iCDBNetServer;既有 Project Backup PID 60000、63480 保留。
检测可使用“实际打开失败 + 本次明确 ICDB 诊断 + 数据库目标一致”的组合证据。
文件不存在、一般打开失败和 COM 注册等待要分别记录。明确的单项故障只应
成为该项备注,不据此永久禁用普通检验或版本管理。
本次验证了**文件头损坏**,没有复现现场“先前服务器会话失联”,也没有验证自动
修复、READY 或完整产品维护入口。没有运行/宣称全量应用测试;本轮只增加
调查脚本与记录。不能将本次复现算作现场 ICDB 修复通过。
@@ -0,0 +1,86 @@
# ICDB 扫描按实际打开错误内容分类
## 当前行为
批量检查复用 PCB 诊断打开路径,不再先启动 Project Backup 检查所有条目。
诊断请求固定关闭自动修复、原生 Verify 菜单及恢复确认;只打开、核对目标并
正常关闭,不执行集成、保存、Repair 或 Restore。普通检验和原生版本管理
继续使用独立入口,界面既有 READY 排除规则保留。
只有实际打开错误中包含 iCDB 内容,或本轮原生日志明确给出 iCDB 错误,才
将该条目标为 ICDB 问题。通用错误码、工具内部类别名称、路径中出现 icdb、
成功输出以及历史错误均不能单独决定分类。没有 iCDB 具体原因的一般打开
失败仍保留原始错误和未确认结果,不显示成数据库损坏或健康。
正常打开只返回 CHECKED,不推定 CBB READY。单项失败在实际会话已释放后
继续后续项;未确认释放或用户取消时仍保留真实状态。没有增加永久的故障
锁,也没有把扫描结果作为普通检验或版本管理的前置条件。
## 重复扫描的证据
实机发现同一工程连续打开失败时,PCBLogFile.txt 可能逐字相同。仅比较内容
会把本次故障误当成旧日志。补充采集当前 PCB PID 对应的 iCDBManager 日志,
核对日志创建/修改时间、PID 头和目标数据库路径后,保留具体 ERROR 内容。
采集在既有的限时只读助手中执行,保留 16 KiB 头和最多 128 KiB 尾的读取
预算,不在 Qt 线程中等待日志,不递归扫描整个库,也不调用修复接口。
文件日志仍采用启动前检查点及有界增量读取;未知基线、无法确认历史的日志
重写,不提升为本轮证据。扫描只读取本次诊断子目录的错误证据,不能引用
上一次操作的证据目录来标记当前条目。
## 实际验证
使用上一轮完整复制的两个隔离库,通过应用的 `run_verify(maintenance=True)`
及 `run_batch` 执行真实生产调度路径。请求故意带旧 `auto_repair=True`,内部
诊断仍强制关闭修复。
- 损坏副本:保留清零前 64 字节的 icdb.dat。原生再次弹数据库打开失败提示;
扫描读取本轮 PID 3060 的日志,返回 FAIL / ICDB_REPAIR_REQUIRED,并保留
`in old, unsupported format`、目标数据库路径及日志证据。
- 随后正常副本:原生 PID 28948 打开正确工程,正常关闭,返回 CHECKED。
- 两项均 `safe_to_continue=true`、`library_flag=UNKNOWN`、恢复尝试为空;没有
请求 Project Backup、Repair、Restore、集成或保存。测试 PCB 和数据库服务器
均退出;没有终止已有 Project Backup 会话。
证据:`diagnostics/icdb-authority-20261105/product-scan-comparison.json`,以及
相邻的 `product-scan-damaged` 和 `product-scan-control`。首次复测暴露的重复日志
漏判记录也保留,没有清空故障日志来让测试通过。
回归覆盖实际损坏报文、未知 iCDB 错误内容、相同错误码的非 ICDB 失败、正常
输出、旧日志残留、日志重写、旧操作证据隔离、当前/其他 PID、日志新旧、
其他数据库路径、取消、会话未释放、失败后继续,以及原有界面/报告行为。
最终测试命令为 `python -X utf8 -m pytest -q`,1326 项通过,436.32 秒,保留一条
既有 pywinauto STA 提示;详细结果保存在同目录 `pytest-scan-utf8.xml`。
系统默认 GBK 模式的一次运行中,既有测试用默认编码读 UTF-8 报告失败;该项
在 UTF-8 模式下单独复测通过,未因此修改原生修复逻辑。
冻结候选包构建及启动/正常退出冒烟通过,16 个关键 Python 模块和两个 VBS
与源码一致,包内 x86 运行库及 Unicode/UNC 协议检查通过。使用冻结程序的
限时日志采集入口回放当前 PID 证据,确认能保留实际 ICDB 原因;未在冻结包中
再次执行整条原生扫描批次。独立候选包不覆盖此前的程序目录,未合并发布。
只读独立复核未发现必要 P1/P2,指出批量报告残留旧的 Project Backup 流程名称。
随后仅将该报告名称改为实际的 PCB 打开检查,并增加报告输出断言,104 项相关
回归通过;同步重建并复核最终 r2 候选包。完整回归记录保留在上述 XML,文案
修正后的相关回归记录为 `pytest-scan-post-review.xml`。
## 文件头损坏与版本管理
“版本历史与备份…”打开原生 iCDB Project Backup,入口只核对 LMC 和唯一 PRJ,
不以 icdb.dat 文件头可读作为准入条件。有效的完整历史备份包含数据库文件,
原生 Restore 可以替换损坏状态,而不是计算或补写丢失的 64 字节。
这份隔离样本的备份配置为相对 `./backups`,列出的多个历史 ZIP 中包含
`database/icdb.dat`。文件头非零仅是清单检查,不能代替原生验证备份有效性。
清单保存在 `version-backup-inventory.json`。
已有同类隔离实测中,原生 Repair 从已有备份恢复了该文件头损坏,随后重新
打开并验证成功;没有有效备份的对照则明确失败。见
[此前有备份的恢复记录](../releases/2026-10-28-icdb-open-repair-reopen-validation.md)
及[无备份的失败记录](../releases/2026-10-28-icdb-no-history-repair-validation.md)。
那次是 Repair 调用原生备份恢复,不等同于本轮已通过当前版本管理按钮执行
Restore;本轮没有选择恢复版本或发起恢复。
恢复会回到所选备份的内容版本,应保留原始损坏副本,恢复后重新打开并单独
检验。PCB 启动时“最后手动保存/自动保存”的选择不应直接视作工程 iCDB 已
恢复。没有有效恢复源时不能承诺恢复。现场会话失联和自动修复仍未验收通过。
@@ -0,0 +1,58 @@
# 管理、协调租约与状态扫描阻塞审计
审计范围:`library_lock.py`、`management.py`、`native_management.py`、`management_transaction.py`、`native_backup.py`、`network_path.py`、`batch_status.py`、`status_bridge.py`、`owner_probe.py`、`native_export_guard.py`、`icdb_ownership.py`、`native_occupancy.py`。本文仅说明这些边界,原生窗口清理、普通校验入口与界面由本轮其他修改覆盖。
本轮没有在该审计任务中启动 Mentor、Repair、Restore,未修改现场中心库,也没有删除原生地址、锁或数据库文件。测试使用临时文件和替代原生边界。
## 已落实的误阻塞修正
| 入口或条件 | 原误阻塞 | 修正及验证重点 |
| --- | --- | --- |
| `native_management.NativeOperationError`、`management.run_management.invoke` | 原生目录失败已退出,异常丢失释放事实 | 操作成功与释放证据独立传播;已退出目录失败可以重新取得协调锁 |
| `management_worker_main` | 桌面、映射、能力或来源校验在原生启动前失败,却报告未释放 | 原生启动前保持 safe;进入实际原生边界前才变为未确认 |
| `NativeManagementAdapter._worker`、`_launch_worker` | 请求准备或桌面构造失败制造假会话 | 准备失败为 safe;构造失败仅消费明确的 process_created=false、worker_exited=true、remaining_pids=[]、safe=true 协议;部分启动和缺证据仍未确认 |
| `NativeManagementAdapter._add_transaction` | Add 已退出后,路径、引用对齐、被动占用检查失败再次保留库锁 | 仅实际启动下一原生调用前重置释放状态;异常在租约退出前传播已知释放事实 |
| `NativeManagementAdapter.prepare_add_transaction` | 来源缺 CentralLibrary、staged/asset/lease 校验失败制造假未释放 | 原生 capture 前的完整准备块返回 safe=true 失败;capture 后准备事务记录失败保留 capture 的实际释放事实 |
| `management_worker_main` 的 CleanWGLib remove | wait 已退出但输出文件读取失败,或明确创建拒绝仍 unsafe | wait 确认退出立即记录 safe=true 与 exit_code;FileNotFoundError/PermissionError 的创建拒绝为 safe,未知创建错误和 timeout 保持未确认 |
| `management.run_management` | 移除后被动检查异常、报告写入异常把已释放改成未释放 | 保留释放事实;报告存储错误写入返回 detail;不重复抛出最终报告异常 |
| `management.RECOVERY_REQUIRED` | 目标数据恢复要求被混同为原生会话仍存活 | 可同时返回 RECOVERY_REQUIRED 和 safe=true;同目标禁止自动重放,明确不同目标不被旧数据恢复记录误挡 |
| `management._may_have_mutated` | 末阶段看似 prewrite 即忽略曾经写入的 history | 仅完整且一致的 prewrite history 可确认未写入;缺失、混合历史保持未知 |
| `LibraryLock.__enter__` | retained checkpoint 租约永远不再检查回调 | 同一租约 release probe 证明退出后,可清理身份相符且无未决 export/pending 的应用检查点并重新取得锁 |
| `NativeManagementAdapter.release_confirmed` | 超时 worker 后来正常返回仍永久保留 | 按库跟踪原 worker;只有它已退出且其独立结果 safe=true 才回收;缺失/损坏/unsafe 结果不推定释放 |
| `LibraryLock`、`release_retained_library` 的 CreateFile | 权限、网络、路径失败统一称 competing writer | 仅 Windows sharing/lock violation 32/33 分类为 LibraryBusy,其余保留实际错误 |
| `has_blocker` | 完整快照中的异库 pending 一律阻止 | 主记录与 pending 采用一致规则:只有完整、有效且明确搬迁的源记录可忽略 |
| `release_retained_library` | torn、malformed 应用检查点没有恢复路线 | 显式释放强制全库 fresh owner/native-file/export proof,复核原字节未变化,先归档再清应用 JSON;未知 proof 标记不足时拒绝归档 |
| `release_retained_library` 的范围 | 选择 Target 却清除全库旧检查点,可能漏 Other 真实会话 | 只有检查点和进程内 owner 都绑定相同 block_name 才使用所选目标范围;旧无 scope、范围不符、损坏记录一律 full proof |
| `_prove_library_released` 的目录范围 | 目标释放仍扫描所有 CBB,且漏共享 SymbolLibs | 已绑定目标时仅扫描目标 Work、共享 SymbolLibs 和所选 LMC;共享地址与数据库始终参与证明 |
| `_prove_library_released` 的 retained registry | 库 A 的 worker 阻止库 B | 新 worker 绑定 cbb_library;明确异库可排除;旧无 scope registry 保留未确认 |
| `_owner_matches_scope` | Work 子串匹配 WorkOld,worker 只带 job 路径时反而漏检 | Windows argv 精确路径边界;读取有大小限制的 worker 请求以绑定 library/project/database;没有可判定路径时不推定无关 |
| `_owner_matches_scope` 的 EDIF 命令 | 不识别产品实际 `-icdb <database>`,异库 exporter 被当全局未知 owner | 同时支持实际位置参数与 `-icdb=`、`-project=`,带空格路径和大小写按 Windows argv 解析,目录前缀相似不当作同库 |
| full known library process proof | 全机同名原生程序都被称本库占用 | 命令行明确指向异库可排除;无范围证据仍保持未确认;损坏检查点 full recovery 不使用范围排除 |
| `_persist_blocker`、`_recorded_supervisor_alive` | maintenance 只凭旧 PID 存在,PID 复用会误挡 | 新 version=1 记录附 machine 和 supervisor_created;只有进程创建身份匹配才称原监督进程仍在;旧身份缺失需额外 fresh native-idle 和原独占/目标 guards |
| maintenance 新 owner | retained 后缺 release_probe | 保存明确的 release callback,复用协调租约的再证明路径 |
| `BatchStatusSession.scan` | 单个请求/CBB/path mismatch 把后续未查询项全部标错 | 错配记录只属于当前项;支持 server 时先 restart 再逐项查询;已确认基础设施不可用仍批量标 UNAVAILABLE |
| `fingerprint_library`、batch record | 相同字节/时间的另一库或另一 block_type 复用旧 READY/PENDING | cache 绑定绝对库路径和 block_type;不 resolve 映射路径,不递归扫描工程负载 |
| `LibraryPathLease.close` | 映射查询或取消一次失败后 closed 永久为 true | 成功后才结束租约,瞬时失败可再次 close |
| `release_after_recovery`、`release_retained_path_leases` | retained mapping 永久不释放,旧界面丢引用后也不可回收 | 核对 RELEASE_CONFIRMED 与该库 display/mentor/已知 UNC 身份;registry 保留旧对象;共享当前映射先转移所有权再释放旧租约 |
| `WindowsWNetBackend.mapping`、`mappings` | 无关盘符读取失败让目标映射不可用 | 目标盘直接查询;全枚举跳过不可查盘但把它保留为已占用,避免抢占未知盘符 |
对应集中回归:`tests/test_management_retry_blockers.py`。既有管理、事务、租约、网络路径、状态扫描、导出与维护测试也纳入定向回归。
## 仍保留的真实互斥和未确认边界
| 条件 | 当前行为与可用路线 |
| --- | --- |
| uploader 或真实同库任务仍持有独占协调句柄 | 继续互斥;不删除 `.cbb-upload.lock`,文件中的旧 PID 文本不作为当前持锁证据 |
| 全局 `Local\\CbbRefreshVerify795` mutex | 仍序列化本应用原生 COM/管理操作。尚未证明所有 Mentor 全局状态可按库并发,未直接删掉此保护 |
| `native_management._catalog_com` 已有 LibraryManager.exe | 仍在 COM 激活前保守拒绝。尚无证据证明本机 DispatchEx 不会复用已有服务、Quit 不会关闭他人窗口;本轮仅修为 prelaunch safe,不声称已支持并存 |
| `_catalog_native` 激活后无 native_pids、原生 PID/退出状态缺失 | 仍未确认,可能 COM 已启动不可追踪服务。新请求不自动把空 PID 列表视为已释放;提供显式 fresh release 路线 |
| `native_management._wait_native_exit` | 运行时仍以已观察 PID 等待退出,未新增 Library Manager 全部后代的 JobObject/creation-time 追踪;超时转显式释放证明 |
| 旧无创建身份的外部/导出进程记录 | 不能把活 PID 直接证明是旧进程,也不能无条件忽略;新记录创建身份由本轮相应 exporter 修改提供。无法独立确认时保留现场与明确未确认原因 |
| `sAddress.adr` 仍存在 | 地址存在本身不证明当前活跃,但显式“释放”也不冒充原生 NOT_IN_USE。应走既有 inspection-only 的精确 project/database 原生占用检查;本任务不手删地址,也不自动 Repair/Restore |
| `owner_probe` 超时、访问受限、空 command、请求文件不可读 | 不把它称已确认活跃;也不猜已退出。明确异库证据可以排除;范围不明时保留未确认,并允许独立只读检查 |
| export ownership 元数据有效但副本目录/数据库缺失,或 token/lease 不匹配 | 仍拒绝自动清理,因为无法证明原副本的原生写入已结束;未知元数据恢复通路不能覆盖掉已知但尚未证明释放的 export copy |
| native backup 的自身 JobObject/子进程仍活动或查询失败 | `native_backup.py` 已使用 checkpoint=false;等待其自身会话树退出,不因主窗口/launcher 先退就推定全部释放,不 terminate/kill 原生事务 |
| 二进制 hash、flow、ASCII removal contract、来源/目标/证据隔离、Add nonce 和 duplicated lease handle | 继续作为能力或身份校验;它们不是 native busy。失败不授权绕过未验证原生写入路径 |
| 损坏检查点的全局 fresh-proof 路线 | 为弥补未知 scope,可能要求全机已知 native/app workers 均退出;这是显式未知记录恢复的限制,不适用于具有明确异库范围的普通重试 |
维护入口的 PID 创建身份、原生文件独占和 fresh guards 是不同证据:创建身份匹配只说明原监督进程仍在;创建身份不同/旧 schema 缺失只消除错误 PID 归属判断,不能替代原生或数据库释放证明。
@@ -0,0 +1,37 @@
# 中心库无活跃会话却被阻止(r5 现场反馈)
## 现场证据
用户运行 `blocking-locks-20261105-candidate-r5` 后反馈中心库操作仍提示上次未安全释放,扫描看不到活跃会话。
- r5 `data/logs/application.log` 中,15:54(北京时间)的 IP101GR PCB 检查因原生读写确认退出;相应 `session-release.json` 为 `safe_to_continue=true`、`worker_exited=true`、`remaining_pids=[]`。这次打开失败不等于释放失败。
- 随后版本工具 `native-backup-6bc7146a0eee/result.json` 为 `CLOSED / safe_to_continue=true / native_exit_code=0`,原生 PID60660 已退出。
- 中心库仍存在 11 月 4 日的 `.mentor_lib.cbb-upload.blocked.json`:PID57076、lease `eae80a06f23e4664b00c70b6bf81b01d`、`OWNER_RELEASE_UNCONFIRMED`。这是一条旧操作记录,并非当前进程存在的证据。
- 本轮只读实查:关联进程列表为空,协调文件可独占读取,库内没有 `sAddress.adr`,原有完整释放证明也通过。未为诊断删除源库任何记录或工程文件。
## 根因
`run_management` 在 `LibraryLock.__enter__` 因历史记录拒绝时尚未启动任何原生会话,但异常收尾用 `isinstance(error, LibraryBusy)` 强制把结果改成 unsafe。互斥通道尚忙也返回相同 unsafe。UI 随后把这一结果记为按库保留的 unsafe 标志,直接禁用后续管理;此时没有 PID 可供扫描。失败发生在创建本次 checkpoint 之前,也没有对应的管理尝试日志。
原残留扫描只列进程,不列历史 JSON 或 `checkpoint=False` 的进程内 retained lease,进一步造成“明明没有会话但永远不能继续”的表现。
## 修正
1. 有旧 JSON、同库进程内 retained lease、旧管理标志或未确认释放的历史修改时,在操作互斥范围内、任何新原生调用前执行已有完整释放证明。证明通过才归档本应用旧记录并释放本应用句柄;真实 owner、地址、共享访问冲突仍拒绝。未知归属不假定无人占用。
2. 管理尝试先记录 `release_check`;未启动的新操作被拒绝时保留本次 `safe=true`,不制造新的原生 owner。已启动原生后仍沿用实际退出证据,不能把超时统一放行。
3. UI 的旧 unsafe 标志成为重新复核要求,不再直接禁用管理。匹配当前库的证明且本批结果全部安全后,先恢复 retained 路径 lease,再清旧标志。映射恢复失败保留重试状态。
4. 扫描明确显示历史记录日期与内存保留记录,和活跃进程分开。空进程列表不再隐藏历史阻止原因。
5. 同目标历史修改未完成仍保留“需恢复,不能重放”;会话已释放与数据是否恢复分别处理。没有修改的 BLOCKED 结果不再触发额外原生目录读取。
6. 管理结果记录操作类型、CBB、状态、安全状态、原因及证据位置,包含启动前拒绝。
## 验证
- 按现场旧记录结构新增回归,初次 4 项均失败;修正后通过。覆盖无 owner 继续、真实地址保留、执行通道忙不制造 owner、空列表显示历史记录。
- 后续覆盖无 JSON 的 retained Verify 锁、匹配证明后恢复路径 lease、UI 可以再次发起复核。相关 **119 passed**。
- 实际隔离 UI 链路 `diagnostics/icdb-authority-20261105/legacy-management-a1c609ec/result.json`:从已验证原生 CRUD fixture 创建新隔离副本,预置相同旧记录与 UI unsafe 状态,通过应用“移除 CBB”确认入口完成复核、旧记录原字节归档、原生移除 IP101GR、重新读取目录确认缺失、UI 与路径 lease 恢复。**REMOVED / safe=true,59.016 秒,原始 fixture 全文件哈希不变**。生产库工程与旧记录未改动。
- 统一全量 **1518 passed**(`management-release-pytest.xml`,268.10 秒,1 条既有 STA warning);编译与 diff 检查通过。
- **r6 冻结复验通过**:`legacy-management-b3a65315/result.json`。控制层源码与包内字节码一致,真实管理 worker 与进程探测运行 r6 exe;相同 UI 链路返回 `REMOVED / safe=true`,原生目录再次确认缺失,旧记录归档、保留映射与 UI 标志恢复,原 fixture 未修改;96.313 秒。包内 26 个 Python 模块及 2 个 VBS、实际 GUI 启停、x86 codec 和包内 runtime 加载通过。
- 独立复核确认没有新增 P1/P2。候选包为 `dist/blocking-locks-20261105-candidate-r6/CbbRefreshVerify-Background`。
生产库的旧记录保留到用户下一次实际管理操作或确认释放时,由同一完整证明流程复核、归档。没有直接删除源库锁文件,也没有替用户重放增删改。不把本次阻塞修复算作 ICDB 数据自动修复验收。
@@ -0,0 +1,27 @@
# r9 补充审查:4 个已复现问题
本次只审查和构造回归复现,未修改产品源码、未启动 Mentor、未操作真实库。源码与 r9 BUILD.json 的 SHA-256 比对另行确认。先前 1,564 项测试通过没有覆盖以下组合场景。
复现:`python -X utf8 -m pytest -q diagnostics/icdb-authority-20261105/test_r9_remaining_review.py --junitxml=diagnostics/icdb-authority-20261105/r9-review.xml`。四项均在预期断言处失败,收尾完成,无残留测试线程。
1. **P2:停止整队列不会取消后台检查。** 后台 Beta 检查期间提交前台任务,再点击“取消当前任务并停止队列”。`request_stop()` 在 busy=true 时只设置前台 stop,没有设置 IcdbCheckTask.stop。前台任务取消后后台继续执行 Gamma。实测 calls=['Beta', 'Gamma'],期望仅 ['Beta']。位置:`ui/main_window.py:1484`。
2. **P2:排队项目变成 READY 后仍重复检查。** 检查启动时捕获目标列表,后续权威刷新将 Gamma 更新为 READY,恢复执行时只检查 invalidated,未重新核对 READY 操作资格。实测 Gamma 仍进入 verifier。用户要求 READY 即使被勾选也应排除。位置:`ui/icdb_check_task.py:66`、`ui/main_window.py:781`。
3. **P2:释放失败被误显示成读写确认。** 注入 `DATABASE_SAFETY_STOP` 和原始错误 `PCB_RELEASE_UNCONFIRMED: launcher still running`,表格固定显示“未确认:需处理读写确认”。该分类也包含普通会话释放失败,不能据此断定存在读写提示。位置:`ui/main_window.py:819`。
4. **P3:普通校验排队时隐藏后台检查进度。** 检查 Beta 仍运行时提交普通 Gamma 校验;`_run(maintenance=False)` 无条件隐藏 icdb_progress 和 icdb_phase,后台任务仍活跃。实测 isHidden=true。位置:`ui/main_window.py:1215`。
建议先修 1、2,再修 3、4;把这四个复现并入正式 tests 后复测。没有依据将这些结果扩大成数据库损坏或“所有释放又失败”。
仍保留此前验收缺口:ICDB 自动修复、现场服务器失联完整恢复以及 Windows 10 关键流程没有因本轮检查验收而变成通过。
## r10 修复
- “停止队列”同时取消后台 ICDB 任务和当前前台队列;独立“停止检查”仍只取消 ICDB 检查。
- 每项在真正取得原生执行机会后检查最新 READY 集合。权威状态读取在让出队列之前发布状态,不等待界面回调;重新加载和局部状态刷新均按库匹配,其他库的同名 CBB 不受影响。
- 仅本次错误明确含 read/write access permission 时显示读写确认;释放未确认和其他安全状态分别显示,原始错误保留在提示中。
- 普通校验排队时保留活跃 ICDB 任务的进度条和阶段标签。
4 个原始复现已转入 `tests/test_background_queue_regressions.py`,修复前均红,修复后均绿;另补权威状态在 Qt 回调前发布、跨库同名隔离以及不同安全原因显示,共 10 个回归。第一轮相关 49 项通过。产品源码仅修改 `ui/main_window.py`、`ui/icdb_check_task.py`;具体最终测试、冻结和原生验收见 r10 的 VALIDATION.json。
最终全量 1,574 项通过(0 失败、0 错误、0 跳过);有既有 pywinauto STA COM 初始化提示 1 条。编译和 diff 检查通过。r10 冻结包 37 个模块/脚本与源码比对、GUI 启动冒烟和包内 x86 状态桥运行库加载检查通过。
r10 实际冻结执行器隔离批次通过:损坏项 FAIL / ICDB_REPAIR_REQUIRED / safe=true(68.563 秒),随后正常项 CHECKED / safe=true(26.812 秒);无关的同桌面模态窗口未被操作,来源六文件哈希不变。实际界面按钮检查及排队状态读取通过,顺序 check-start → check-end → status-start → status-end,筛选可用,最终 READY,50ms 定时器最大间隔 79ms,整体 23.656 秒。目录行的初始 PENDING 为测试注入,原生打开和状态读取实际执行;不冒充现场服务器失联恢复验收。
@@ -0,0 +1,99 @@
# r4 失败后 iCDB 断库:根因修复与受控恢复
分支:`codex/icdb-lost-session-diagnostics`。用户确认现场事故使用 r4 或更早版本。
## 工具侧根因
在 r4(`11a2b2e`)中,单项校验失败和监督器超时都会进入强制进程树清理:
- `DesktopWorker` 设置 `JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE`,`kill()` 调用
`TerminateJobObject`,回退路径是 `taskkill /T /F`。
- `cleanup_verify_processes()` 对目标 PCB 执行同样的强制进程树终止。
- `prepare_icdb_address()` 会在 TCP 探测失败后移走地址文件。连通性失败
不能证明服务器已安全退出;移走地址也不能修复数据库中未完成的会话状态。
这条失败收尾路径能连带杀死 PCB 启动的 iCDB 服务器,打断数据库事务或关闭过程,
留下 dirty session。下次由其他机器打开时,iCDB 拒绝继续并要求 Repair,
与用户描述的“未校验成功后才出现失联消息”吻合。现有代码足以确认该缺陷,
但没有 200091-CBB 本次完整进程/数据库日志,不能确定具体中断的是哪次事务。
`a11eb3c` 已修掉主要 PCB 强杀路径;继续检查发现内容检查超时仍保留
`taskkill /T /F`,以及失败文档只保留在隐藏桌面、没有正常关闭尝试。
这些遗漏在本分支继续修复,不能让用户继续用 r4 的收尾逻辑测试。
## 本轮行为
- 内容检查超时保留 importer 及原生子进程,使用文件承接输出,防止父进程
退出造成管道阻塞/断管;记录 PID、命令和退出状态并停止后续队列。
- 校验超时/监督器丢失改为协作取消。阻塞中的原生调用先返回,再在操作边界
停止后续动作;不终止正在 Save 的助手。
- 原生调用返回且已确认身份的失败文档,由 x86 助手核对 PRJ 和 PCB 名称后
执行 `Close(False)`,释放引用后正常 Quit。若另一个文档仍活动则保留应用;
慢 Close 同样保留助手,不用强杀代替完成。
- 写入前和成功前同时核对 Work、PCB 及中心库
`SymbolLibs/__ReusableBlocksSymb` 的地址所有权。隐藏 Library Manager
在失败 PCB 正常关闭后也请求正常关闭;所有权未知时继续停止批次。
- 只读状态桥先关闭标准输入并等待 EOF 清理,避免正常退出也被立即终止。
## 自动 Repair 的范围
只有本轮明确的 `ICDB_REPAIR_REQUIRED`、完整会话身份、可映射到当前
Work/PCB PRJ 的数据库,才进入一次原生恢复尝试。TIMEOUT、未释放的
importer/PCB/Library Manager/助手、外部目标及路径歧义都不会启动 Repair。
恢复前通过 Windows 独占文件访问确认目标 `icdb.dat` 没有仍打开的客户端,
完整复制工程全部文件(包括数据库、锁、原备份、日志),逐项校验副本及
源文件集合。该副本与平日排除数据库的轻量 evidence 备份不同。
Repair worker 绑定监督进程和确切私有桌面。它从安装程序资源解析
`Project → Repair`,核对原生窗口中的完整 PRJ,只接受实际验证过的
Repair 确认文本。备份期间取消会阻止后续启动;原生 Repair 已经开始后,
超时或监督器丢失不会强制终止它。
恢复成功需要本次原生 PID 的诊断完成、数据库关闭、完整 `Project Repair`
ZIP、原生进程正常退出及地址释放。满足后只重试一次完整校验,仍以
`IsVerifiedReuseBlock READY/raw=1` 为最终成功条件。原错误、原 evidence
和恢复结果保存在 `recovery_attempts`,完整修复备份保留。
**共享符号库边界:** 本机同版本 Project Backup 直接打开符号数据库目录时,
明确拒绝并要求 `.prj`。因此对 `SymbolLibs/__ReusableBlocksSymb` 的已损坏
数据库,本分支会报告 `SHARED_DATABASE_REPAIR_UNSUPPORTED`,不会改修一个
不相关的 Work 工程,也不会删地址/锁或猜测私有 ABI。正常关闭和共享所有权
检查用于防止再制造这类问题;已有共享库损坏仍需匹配该库的原生恢复入口。
## 实际验证
以下写入均针对本轮新副本,未修复或改动现场 200091-CBB 数据:
- 真实 Windows 无害 importer/子进程试验:超时后均存活,后续队列停止。
- x86 cscript 测试:核对身份、失败关闭用 `Close(False)`、不保存错误结果、
另有活动文档时不 Quit、Save 返回后响应取消。
- 新 IP101GR 副本主动注入空闲时的同步失败:输出 `FAILURE_CLOSE_OK`、
`FAILURE_QUIT_OK`,随后确认 PCB 进程退出;失败结果保持 FAIL。
- 同一隔离库随后正常校验:PASS/GREEN,Save/Close/退出和
`READY (IsVerifiedReuseBlock, raw=1)` 均确认。
- 原生 Repair 模块真实执行:完整备份、Repair 确认、本 PID 的 dbcheck/
数据库关闭日志、Project Repair ZIP 校验齐全,最终 `REPAIRED`、退出码 0。
这验证了原生恢复链,不代表复现并恢复了现场同一个 dirty session。
- 完整自动恢复链:向隔离副本的首次校验注入合成失联错误,之后实际执行
正常关闭、完整备份和原生 Repair,再启动第二次真实校验,最终
PASS/GREEN、`safe_to_continue=True`。只启动两次校验 worker、一次 Repair;
原错误及 evidence 保留。没有故意破坏数据库,也没有恢复现场损坏库。
- PyInstaller 目录包构建和冻结 GUI 生命周期冒烟通过;直接使用生成的 EXE
在另一个独立工程副本上运行 Repair worker,最终 `REPAIRED`、退出码 0。
因此原生修复入口也已验证能在冻结包内工作。
- 原样本 21,011 个文件在上述试验前后 SHA-256 内容指纹一致。
- 最终 Python 全量回归 **448 项通过**(含前次 417 项基线);仍有基线已有的
一条 pywinauto STA COM 模式提示。两组 PowerShell 测试、编译和 Git 空白检查通过。
- 独立复查指出的未释放 importer 进入 Repair、备份期间取消、修复 worker
父进程丢失、共享 COM 应用退出等边界均已修正,并补充对应回归。
本地原始证据位于 `diagnostics/icdb-auto-recovery-20261027`,不随包发布。
## 分支试用包
本地 `CbbRefreshVerify-icdb-recovery-20261027.zip` 包含完整目录程序、试用说明、
本报告和逐文件 SHA-256 构建清单;压缩包旁另有 SHA-256 文件。源码构建提交为
`9cd4968`,版本号仍为 `0.2.2b1`,这是分支修复试用包,不是新正式版本。
解压整个目录后启动 `CbbRefreshVerify.exe`,必须保留 `_internal`。尚未部署到
200091-CBB,也未推送远端;现场已有共享库损坏仍受上述原生入口限制。
@@ -0,0 +1,47 @@
# CBB 完整工程备份恢复弹窗实机验证
分支:`codex/icdb-global-repair`。本轮新增“从备份恢复 CBB…”入口,弹窗仅包含目标 CBB、备份工程 PRJ、“恢复并校验”和“关闭”。
## 已验证的行为
现有同名 CBB 的完整工程备份先在独立中心库副本中验证;只有原生流程、权威 Ready 和会话释放全部通过,才保留原 Work 并恢复目标,再对目标实际打开、保存、关闭和读取状态。全程保留完整库回退副本、来源副本、原工程和日志。
## 真实损坏与恢复
测试材料位于 `diagnostics/icdb-backup-dialog-live-20261028`,只改动新建的隔离副本,CBB 为 `IP101GR`。
1. 从健康库复制目标,移除目标 Work 中的 `ProjectBackup`、`cdbback` 历史目录,清零 `Work/database/icdb.dat` 的前 64 字节。
2. 实际打开该目标,得到 `MENTOR_DATABASE_LOAD_FAILED`。原生日志明确为 `Database cannot be loaded ... Please use iCDB Project Backup 'Repair project' ... icdb.dat ... old, unsupported format`。正常关闭未加载工程的原生窗口后继续。
3. 在真实主窗口点击“从备份恢复 CBB…”,选择独立健康来源 `verify-library/ReusableBlocksLP/IP101GR/Work/IP101GR.prj`,再点击“恢复并校验”;没有替换 reader、recoverer 或 verifier。
4. 验证库位于 `C:\Users\ABS_Windows\.cbb-restore\b963898c4e91`。17:47:59 原生 COM 确认该副本工程身份;四项集成状态均为 InSynch。17:48:19 已确认原生退出,结果 `PASS / GREEN / READY (raw=1)`。
5. 保留旧工程为 `Work.before-restore-b963898c4e91`,安装验证过的完整 Work。
6. 17:50:54 原生 COM 确认重新打开的正是最初失败的目标路径。四项集成状态均为 InSynch,Save、IsSaved、Close、Quit 标记完整;17:51:24 确认退出。目标结果 `PASS / GREEN / READY (raw=1)`,`safe_to_continue=True`,原来的数据库加载错误消失。
`comparison.json` 的七项检查全部通过:真实打开失败、备份副本验证成功、相同目标重新打开、最终 Ready、损坏 Work 保留、原始源库未变、原生加载错误消失。原始源库 21,029 个文件的 SHA-256 对照一致。
主要证据:
- `open-before.json`、`open-before-PCBLogFile.txt`。
- `data/evidence/backup-restore-b963898c4e91/recovery-result.json`。
- `source-verify/verify-bec9008be868`、`target-verify/verify-22808a7f330a` 下的结果、事件和原生日志。
- `dialog-before.png`、`dialog-after.png`、`window-after.png`、`ui-state.json`、`comparison.json`。
## 停止条件和兼容修正
实际观察到“工程已打开保存、但最终仍为 PENDING”的失败情形,恢复流程在替换目标前停止;损坏目标字节保持原样。短路径复核取得 Ready 后,生产实现采用真正较短的用户目录,避免深层证据目录及 MSIX 对 AppData 的重定向。
原生 PCB 工程允许多个配置段具有 `CentralLibrary` 引用,所有需要变更的引用均对齐。语义已指向目标库的引用保留原字节及时间。绝对工程/数据库引用、目录链接、不完整来源、来源/目标内容变化、未释放会话均会阻止安装。原生目标操作保留映射盘/别名;文件快照和 Work 替换使用实际路径。
## 回归与交付
- `python -m pytest -q`:471 passed,1 个既有 pywinauto STA 提示。
- 16 项新增恢复和弹窗测试覆盖输入校验、来源失败、最终失败、来源保护、并行快照、junction 拒绝、目标别名、等价引用、界面响应及异常终态。
- PyInstaller 构建及冻结程序启动/退出 smoke 检查通过。
- `frozen-modules.json` 确认恢复模块、弹窗、主窗和 Mentor 适配模块的冻结代码与当前源代码一致。
- 程序:`dist-icdb-backup-dialog-20261028/CbbRefreshVerify-Background/CbbRefreshVerify.exe`。
复现脚本:`tools/validate_backup_recovery_dialog.py`,依次执行 `setup`、`open-before`、`restore`、`compare`。`setup` 仅创建全新的测试目录;再次试验前保留现有证据,并将脚本中的输出 `root` 改为另一个全新诊断目录。
## 范围
本功能恢复已有同名 CBB 的完整工程,依赖目标库中已有的依赖数据,不删除库条目,不等同原生跨库重新导入或共享符号库重建。测试复现的是数据库文件头损坏;没有复现原始不同服务器会话丢失的问题,不能据此承诺所有 ICDB 故障均可恢复。恢复内容采用用户选择的备份版本。
@@ -0,0 +1,46 @@
# 全库 ICDB 检查与修复按钮实机验证
日期:2026-10-28。分支:`codex/icdb-global-repair`。
## 行为与界面
独立“数据库维护”面板提供“全库 ICDB 检查与修复”按钮。确认框展示当前库、可用项目数、Ready 项数和缺文件跳过数,说明操作会重新校验并保存工程。队列包含 Ready 项,串行执行,显示当前检查/备份/原生修复阶段及已处理数量;可请求当前项结束后停止。
复用现有本轮失联证据、目标身份、独占访问、完整备份、原生 Repair 和单次重试约束。共享符号库自动修复仍不支持。Ready 项同样预检工程文件,缺少 Work/PRJ/PCB 时跳过。失败后清除本次无法确认的绿色状态。
结果分别报告校验通过、失败/受阻、队列未执行、原生修复完成、恢复旧备份待复核和修复未确认。额外 JSON 报告保留每项原始错误、恢复尝试和证据路径。
## 实机按钮路径
使用 Windows 本机 Qt 界面,通过 QTest 点击实际按钮和实际确认框,未替换 reader/verifier,未注入合成失联错误。测试工具为 `tools/validate_icdb_button.py`。
输入是新复制的本地隔离库,包含一个实际可校验的 IP101GR(读取时 Ready)。按钮仍运行此项目,最终:
- `PASS`、`safe_to_continue=True`。
- `READY (IsVerifiedReuseBlock, raw=1)`。
- 四项集成状态 InSynch;Save/IsSaved/Close 成功,PCB 正常退出。
- 本轮正常校验不需要原生 Repair,恢复尝试数为 0。
- 测试源库 21,029 个文件逐项 SHA-256 比对一致。
原始证据:`diagnostics/icdb-button-live-20261028/outcome.json`、`data/evidence/verify-ebe807433b4f/result.json`、`data/reports/icdb-20261028-120446-f28be8.json`。`loaded.png`、`confirmation.png`、`finished.png` 是实际运行截图;`final-layout.png` 使用该次真实结果回放验证最后的两行摘要布局。
## 真实损坏试验及修复边界
`tools/probe_icdb_corruption.py` 在另一个新隔离工程副本中将 `database/icdb.dat` 前 64 字节清零,然后直接调用生产原生修复 worker。完整备份、原生 Repair 备份均保留。该试验直接验证原生修复 worker,不代表按钮已经复现现场跨机器失联故障的自动恢复链。
原生工具在本机从工程内的 `2026-09-18 10.44.14 - consDefUpgr.zip` 恢复数据库,输出 dbrestore DONE 和 Diagnostic FINISH。程序识别这属于已有备份恢复,返回 `RESTORED_REVIEW_REQUIRED`,正常关闭空闲原生窗口并确认进程退出,未将其提升为 `REPAIRED`,未自动重试校验。恢复版本和工程内容仍需复核,不能据此宣称无损修复。
原始证据:`diagnostics/icdb-corruption-probe-20261028-r2/damage.json`、`repair/repair-result.json`、`repair/complete-backup/backup-manifest.json`。原生测试 PID 29096 已退出;前次保留 PID 18452 也已核对空闲状态并请求正常关闭。
## 验证与试用程序
- 全量 Python 回归 455 项通过;一条既有 pywinauto STA COM 提示。最终摘要布局另跑 21 项界面回归通过。
- 独立代码审查提出 Ready 缺文件预检遗漏,已补充先失败后通过的回归并修正。
- 首次回归与实机校验并发,12 项被真实全局互斥锁拦住;实机结束后完整重跑得到上述 455 项通过,未改弱互斥保护。
- PyInstaller 目录程序位于 `dist-icdb-button-20261028/CbbRefreshVerify-Background/CbbRefreshVerify.exe`。已核对冻结包内四个变更模块与最终源码语义一致。
- 最终冻结程序启动冒烟完成,记录 `gui_smoke_window_created` 和 `application_clean_shutdown exit_code=0`;日志在 `diagnostics/icdb-button-live-20261028/frozen-smoke-final/logs/application.log`。
- 未部署或修改现场库。实机正常路径仅覆盖这个隔离库中的一个有效 CBB;共享符号库原生修复入口尚未支持。
## 后续实际打开对照验证
用户要求确认修复前工程实际报错、修复后再次打开。后续已在新隔离库完成:原生打开报告 ICDB 数据库格式不支持,原生恢复后同一工程重新打开并达到 PASS/READY raw=1。恢复使用旧备份,仍保留内容版本复核要求;没有复现现场跨机器失联报错。完整范围和前后证据见 `2026-10-28-icdb-open-repair-reopen-validation.md`。
@@ -0,0 +1,41 @@
# ICDB 无历史备份修复试验
日期:2026-10-28。分支:`codex/icdb-global-repair`。
## 实机结论
针对本次清零 `icdb.dat` 前 64 字节产生的文件头/格式损坏,没有可用历史备份时,EE7.9.5 原生 Repair 未能修复。此结论限于该故障类型,不应推断所有会话状态或一致性故障都必须使用历史备份。
原生 Project Backup 输出:
> The iCDB database is corrupted.
> There is no backup of iCDB.
> Repair project error [Cannot repair the project - there is no backup of missing iCDB].
> The project is probably in inconsistent state. Please restore the project from one of previous backups.
修复尝试前后数据库 SHA-256 相同:`b3a026b0bc9f695444220008527cbc3c5c2e53a7ce4eaf7bbccac297158b7e20`。本轮新建的 Project Repair ZIP 保存的是已经损坏的状态,不能充当损坏前的健康恢复源。原生输出也区分了“修复前状态备份”与缺失的有效 iCDB 备份。
## 测试范围与证据
使用新的隔离工程副本,复制时排除所有 ProjectBackup 和 cdbback 目录,只复制使用相对路径 `./backups` 的配置,启动前断言工程树内没有 ZIP 历史档案。完整损坏副本另行保留,再调用生产原生修复 worker,没有删除源工程的任何备份。
程序未取得修复成功证据,结果为 `UNCONFIRMED`,没有自动重新校验。读取原生 Output 面板确认明确的 no-backup 终止错误、窗口空闲且地址释放后,正常关闭测试进程 PID 18092。
原始证据目录:`diagnostics/icdb-no-history-probe-20261028`。
- `damage.json`:破坏方式和无历史备份测试标记。
- `native-output.json`:从原生 RichEdit Output 控件读取的完整错误文本。
- `probe-result.json`:结果及修复前后字节一致的 SHA-256 证据。
- `repair/complete-backup`:完整损坏状态保留副本。
可复现命令(需先设置 `PYTHONPATH=src`):
`python tools/probe_icdb_corruption.py --without-history --output icdb-no-history-probe-20261028`
输出目录必须新建,已有目录会拒绝覆盖。
## 没有历史备份时的处理
首先正常关闭写入方并完整保留当前损坏工程,在副本上使用匹配版本的原生工具检查。仅会话状态或部分一致性问题是否能够原位修复,应按实际诊断分别验证。
当原生工具像本次一样明确报告缺少有效恢复源,应寻找服务器快照、文件历史版本、其他机器的完整工程副本或厂商支持的恢复方式。若没有任何有效恢复源且原生修复失败,只能评估数据恢复或由仍完整的设计资料重建,不能承诺恢复全部原始内容。
@@ -0,0 +1,61 @@
# ICDB 实际打开报错、修复与再次打开对照验证
日期:2026-10-28。分支:`codex/icdb-global-repair`。环境:Windows 11,Mentor EE7.9.5。
## 结论
在新的本地隔离库中,实际打开 IP101GR 工程确认原生 ICDB 数据库加载失败;调用原生 Repair 后,再次打开同一工程,数据库报错消失,完整校验、保存、关闭和权威 Ready 确认均成功。本次补齐了前次试验缺少的修复前打开失败与修复后再次打开对照。
本次错误由清零隔离副本 `Work/database/icdb.dat` 前 64 字节产生,实际原生错误为数据库格式不支持。没有复现现场的 `last server session on different server machine lost the connection` 错误,不能将两种故障混为一谈。
## 修复前实际打开
使用生产 ReusableCircuit PCB 打开与校验流程,设置 `auto_repair=False`,没有注入合成错误或替换原生结果。工程为:
`diagnostics/icdb-open-repair-reopen-20261028/library/ReusableBlocksLP/IP101GR/Work/IP101GR.prj`
2026-10-28 13:49:14,PCB 原生弹窗报告:
> Problem encountered while opening one of the database files. See PCBLogFile.txt for details. Loading of the job has failed.
原生 PCBLogFile.txt 明确报告并指出被破坏的确切路径:
> Database cannot be loaded and the server cannot be started, the project will not be opened. Please use iCDB Project Backup 'Repair project' functionality to fix this issue. (Database [...]\Work\database\icdb.dat in old, unsupported format)
结果为 `FAIL / MENTOR_DATABASE_LOAD_FAILED`,未进入自动修复。原生失败会话经核对启动命令、空工程窗口和数据库地址释放后,请求正常关闭;没有强杀原生进程或删除地址文件。
证据目录 `diagnostics/icdb-open-repair-reopen-20261028` 中保留:
- `open-before.json` 与 `open-before-PCBLogFile.txt`。
- `open-before/verify-95ae0baa92f3/dialogs.jsonl` 中的原生弹窗及控件文本。
- `open-before/verify-95ae0baa92f3/diagnostics` 中的原生日志副本。
## 原生修复
先保留完整一致工程备份,再对同一 `IP101GR.prj` 和同一 `Work/database` 调用生产原生修复 worker。原生工具从工程内 `2026-09-18 10.44.14 - consDefUpgr.zip` 恢复数据库,完成 dbrestore 和 Diagnostic FINISH,并正常退出。
生产修复结果仍为 `RESTORED_REVIEW_REQUIRED`。本次依据用户明确要求,在隔离副本上手动继续再次打开验证;没有放宽旧备份恢复后的生产自动重试限制,也不宣称无损修复。
证据:`repair/repair-result.json`、`repair/repair-events.jsonl`、`repair/complete-backup/backup-manifest.json`、`repair-summary.json`。
## 修复后再次打开
再次使用生产校验流程和相同工程路径,保持 `auto_repair=False`。
- 13:54:45,原生 COM 确认工程身份:相同 `IP101GR.prj` 和 `IP101GR.pcb`;四项集成状态均为 InSynch。
- 保存、IsSaved、保存后同步检查、Close 和 Quit 均完成。
- 13:55:19,确认 PCB 进程退出;数据库地址释放。
- 最终 `PASS`、`safe_to_continue=True`、`READY (IsVerifiedReuseBlock, raw=1)`。
- 修复后的本轮 PCBLogFile.txt 不再出现修复前的 `Database cannot be loaded` 错误。
证据:`open-after.json`、`open-after-PCBLogFile.txt`、`open-after/verify-6b9874897377/events.jsonl`、`open-after/verify-6b9874897377/save.log`。
## 对照检查与可复现步骤
`comparison.json` 的七项检查全部为 true:同一工程、同一数据库、修复前原生 ICDB 报错成立、修复后工程身份匹配、原错误消失、完整校验通过、源工程数据库 SHA-256 不变。
测试脚本:`tools/validate_icdb_open_repair_reopen.py`。设置 `PYTHONPATH=src` 后,按顺序执行 `setup`、`open-before`、`repair`、`open-after`、`compare`。每一步需检查上一步的真实原生日志;失败打开留下的空闲原生窗口应核对目标后正常关闭,不能强杀或删锁。
本次按阶段直接调用生产原生修复 worker,未通过新按钮自动触发格式损坏修复。当前按钮的自动 Repair 仍以受支持的本轮失联诊断为入口。本次证明的是原生恢复确实消除了这个实际打开时的 ICDB 格式损坏报错;已有备份恢复后的工程内容版本仍需复核。
后续又用不含历史备份的副本测试相同文件头损坏,原生工具明确报告没有可用 iCDB 备份,无法修复,数据库字节未变。见 `2026-10-28-icdb-no-history-repair-validation.md`。
@@ -0,0 +1,95 @@
# CBB 管理候选实现(Issue #2 Task 4)
本次在当前应用增加新增、同名更新和移除入口、逐项检查点、库外完整备份、
来源工程暂存和明确的结果状态。READY 条目可以勾选用于管理;原有校验和恢复
仍仅处理当前可见的非 READY 合格条目。
## 原生能力边界
移除路线来自 EE 7.9.5 随附 Tcl 的 `CleanWGLib <lmc> F4 <list>`,输入为
`REUSE_BLOCK\tLogical-Physical\t<name>`。协调端已在独立库副本完成真实移除
和原生目录缺失复读。运行时核对已验证的 LibraryManager、CleanWGLib、
LMCDLL70 和 LMCDocAddin70 文件 SHA256;仅允许匹配版本、DxDesigner 流程、
Logical-Physical 分区及 ASCII 名称。输出必须包含对应名称/分区的 Removed
消息且不含 Warning/Error,之后重新打开原生目录确认条目缺失。
新增和同名更新默认禁用,界面说明缺少哪项隔离验证。已发现原生新增对话框
不等于完成库注册;不能仅凭返回值或出现目录启用。通用引擎已实现新增冲突
拒绝、暂存来源、名称/分区/工程内容复读、可选自动校验,以及明确更新时的
原生移除后重新导入。更新必须同时有两个原生路线和同名端到端验证才可启用。
移除后重新导入失败会报告 `RECOVERY_REQUIRED`,停止队列,不自动回滚或重放。
## 操作与恢复证据
每项结果包含 operation、library、name、partition、source、auto_verify、stage、
status、safe_to_continue 和 evidence_path。`management/management-<id>/`
保存原子更新的 `checkpoint.json`、完整 `library-before`、主数据清单、来源
暂存副本、原生请求/输出和后续校验记录。结果区区分:
- `UPLOAD_FAILED`:上传失败;不能解释为已上传。
- `UPLOADED`:原生注册与工程身份已确认,本批次未自动校验。
- `UPLOADED_VERIFY_FAILED`:已上传,但自动校验没有达到 PASS/GREEN。
- `UPLOADED_VERIFIED`:已上传且自动校验达到 PASS/GREEN 并确认释放。
- `REMOVED`:原生移除且重新读取目录确认缺失。
- `RECOVERY_REQUIRED`:原生写入可能发生,或更新已移除但重新导入未完成;
保留完整库备份和所有中间状态,需要人工审查。
启动时显示未完成和释放不确定的检查点,不自动执行。存在同一库的未完成
检查点时,新的管理任务被阻止。先由管理员检查原生进程、目标目录和备份,
按现场恢复流程处理;确认恢复完毕后把已审查的操作证据目录移至独立归档位置,
再重新读取库。不要删除锁文件,不要强制结束持有数据库的原生程序。
## 并发和来源保护
管理、校验和备份恢复共享 `Local\CbbRefreshVerify795` 及原上传工具兼容的
`.<LMC stem>.cbb-upload.lock` 独占句柄。只有相同线程持有的相同库锁允许嵌套;
完整备份通过已经持有的句柄读取锁内容,不重新打开或删除独占锁。
管理任务不能确认原生所有者释放时,在本应用进程内保留该独占句柄,阻止旧上传
工具抢入;不会仅因自动化线程返回或超时而释放锁。
直接校验与备份恢复也保留释放不明确的锁。库旁保存
`.<stem>.cbb-upload.blocked.json`,本应用重启后拒绝写入和原生读取。
该记录在取得库锁后、原生调用前写入,正常确认释放才清除。只有精确保留文件名、
协议版本和所有权字段匹配的记录被归类为运行时元数据;完整副本仍保留其字节,
主数据比较忽略其生命周期变化。同名普通文件或损坏记录保持原样并阻止自动解除。
“检查会话释放并解除协调阻止”入口先确认管理工作进程已返回、相关原生进程
均已退出、库内不存在 sAddress.adr,且能同时以独占只读句柄打开所有 LMC、
icdb.dat 和 LayoutDB.lyt。全部通过才归档阻止记录并关闭本应用保留的句柄;
不会删除上传锁文件,也不把会话释放解释为数据恢复成功。
进程崩溃会使 Windows 释放其句柄;旧上传工具不认识新增阻止记录,因此本方案
不能保证本应用崩溃后旧上传工具仍被排除。崩溃后应先正常结束原生会话,并通过
上述释放检查和未完成任务审查,再使用本工具或旧上传工具继续写入。
备份与来源不能置于目标库内部,来源必须是完整且引用位于工程内的 PRJ/PCB。
来源工程根目录和目标库根目录也不能相互包含或相同,避免操作嵌套库时改变原始来源。
链接、外部数据库引用、源文件变化、备份失败和同名新增冲突均会阻止写入。
来源先完整复制;工程身份比较使用顶层块、原理图数据库和布局数据库内容指纹,
原生规范化若改变数据库字节则保守拒绝确认,需要进一步语义验证,不能声称等价。
原生管理在私有 Windows 桌面运行,不移动鼠标或占用前台输入。只操作当前
已识别原生进程。读取目录遇到旧库升级或 Select flow type 对话框时取消并报错,
绝不将升级作为只读读取的一部分。超时保留原生所有者和证据,不强杀数据库进程;
确认前不继续下一项,不启动最终 Verify。
通过网络盘租约选择的盘符路径在原生 OpenLibrary、CLI、暂存工程库引用和后续
Verify 中保持原样;规范化路径仅用于身份、包含关系和锁键比较。工作进程按原
租约的盘符/共享目录上下文确认映射,不把原生盘符路径改回 UNC。
## 独立新增诊断
`python tools/validate_native_management.py SOURCE.prj NEW_OUTPUT_DIRECTORY NAME`
只接受不存在的新目录,先完整复制来源,再由私有工作进程调用原生
`CreateLibrary(..., kFLOW_DX=1)` 创建固定的新库。随后使用已验证的
Reusable Blocks / UIA Logical - Physical 页签和 New 按钮、1103 对话框字段。
诊断会记录原生消息、关闭后的重新打开清单、工程内容比较和原始来源不变检查。
它不接收生产库参数,不存在跳过生产能力门禁的开关,也不自动修改能力门禁。
可加 `--replacement-source OTHER.prj` 在同一个新建隔离库中验证同名更新:
先备份完整旧库,再原生移除并检查缺失,然后重新导入替换工程。重新导入必须
匹配本次 CreateLibrary 记录的固定路径和随机所有权令牌,不能指向外部库。
监督进程先创建新的空 fixture 目录并持有库锁,原生工作进程核对准备令牌、
检查点协议和监督 PID 后才创建 LMC。初次创建、所有复读和替换阶段均按生产
操作的释放规则持锁;超时或释放异常保留独占句柄和重启阻止记录,必须重新
通过会话释放检查才能解除。
本阶段单元测试通过注入文件模拟的原生边界执行,不启动 Mentor、不操作实际库。
候选冻结包、最终 Windows 11 原生场景由协调端单独验收。Windows 10 和真实
现场失联样本仍未验证;文件头损坏与模拟故障不能替代这些验收。
@@ -0,0 +1,77 @@
# 工单 #2 候选包验收记录
分支:`codex/temp-issue-2-icdb-recovery`。本记录区分软件回归、隔离原生试验和现场验收;未合并、发布或关闭工单。
最终候选程序源码提交:`8e486c1`。新增和同名更新保持禁用;原生新增虽已成功注册并复读,但原理图数据库被原生工具重写,尚未证明内容等价。移除已在新建隔离库通过完整管理流程验证。
最终全量回归:`python -m pytest -q` 在 `122bafc` 上 **887 passed,1 个已有 pywinauto STA 模式警告,68.62 秒**。`122bafc` 只调整安全测试,`src` 和 `packaging` 的 Git 树与打包提交 `8e486c1` 完全一致。编译检查及 `git diff --check` 通过;整分支审查和后续修正复审均无未处理问题。
日志:`build/issue2-final-tests-122bafc.log`。安全测试明确保留工程文件、上传锁以及损坏/外来检查点,只有本工具拥有且验证通过的运行时检查点允许清理。
## 已实现范围
- ICDB 启动失败后,仅在任务进程、工程路径、私有桌面、空闲窗口及地址释放可确认时正常关闭 PCB;同时等待启动器退出。Repair 区分缺少健康备份、原生失败、占用、未知窗口和释放超时。最终重新打开、校验及 READY 状态共同决定修复成功。
- 名称/分区搜索和状态筛选使用已加载数据;隐藏条目清除勾选。READY 可以用于管理,不能进入默认校验、维护和恢复队列。受影响条目刷新后重新判断资格。
- 完整备份保留全部文件;版本化清单对主要工程文件和库依赖计算 SHA-256,复制时同时核对文件集合、大小和时间。日志及其他运行时变化不再等同于工程内容变化。
- 管理请求、逐项结果、完整旧库备份、检查点、来源暂存、共享锁和安全释放入口已集成。新增/更新未达到原生验收门槛时禁用。重启只展示未完成任务,不自动重放写操作。
## 原生证据与边界
| 场景 | 实际观察 | 限制 |
| --- | --- | --- |
| 最终冻结程序启动失败退出 | `8e486c1` 的 PCB 和启动器自动正常退出、无数据库地址;`startup-close.json` 为 CLOSED,safe_to_continue=true | 人工损坏副本,不是现场服务器失联 |
| 最终冻结程序 Repair 缺少健康备份 | `8e486c1` 返回 MISSING_HEALTHY_BACKUP,原生工具自动退出、地址为空、允许安全继续 | 验证明确失败和释放,不代表修复成功 |
| 官方原生移除 | 独立副本中 CleanWGLib/F4 返回 0,之后原生目录重新读取为空 | 旧库升级存在告警;生产读取遇到升级必须拒绝 |
| 隔离新增首次完整探测 | 新建库后打开编辑器失败,尚未提交新增;来源保持不变,保留失败证据及协调阻止记录 | 不启用新增或同名更新,不作为成功验收 |
| 最终移除适配器命令 | 实际捕获 `# Note: Removed REUSE_BLOCK 'IP101GR' from partition 'Logical-Physical'.`,释放确认成功,来源清单未变 | 随后的旧库复读拒绝 Select flow type;不能宣称该库完整自动移除验收通过 |
| 新建隔离库完整移除 | 管理引擎完成原生读取、完整旧库备份、原生删除、重新读取确认缺失;最终 REMOVED,safe_to_continue=true | 仅代表此安装版本、库流程和 Logical-Physical 分区 |
| 新建隔离库原生新增 | 收到成功消息,正常关闭、重新打开仍有正确名称/分区,原始来源不变;布局哈希一致 | 原理图数据库哈希改变,identity_matches=false;新增/更新不启用,未执行同名更新和重新导入恢复验收 |
原始证据位于 `diagnostics/issue2-frozen-20261102/`、
`diagnostics/issue2-management-native-20261102/` 和
`C:/Users/ABS_Windows/.cbb-management-e2e-20261102-a/`。
首次新增失败后,仅向已确认的隔离 Library Manager 主窗口发送正常 WM_CLOSE;
随后进程查询为空,没有强制终止数据库所有者。
第二次新增探测的 `dispatch-diagnostics.jsonl` 在加载 pywinauto 前记录方法
DISPID 17/26/6,加载后全部返回 `CO_E_OBJNOTCONNECTED`(-2147220995)。
这证明失效发生在 UI 自动化依赖初始化边界,尚未提交新增;来源未变。
第二次隔离会话同样正常关闭。移除适配器及旧库拒绝证据保存在
`diagnostics/issue2-remove-adapter-20261102/`;旧库拒绝流程后出现的
“Unable to determine flow type”通知由协调端确认后正常退出,不能记为无人值守释放通过。
`ffa7e84` 冻结包的 GUI 冒烟通过,但真实批处理在启动 Mentor 前报
`No module named 'win32timezone'`。此包不能作为最终可用包交付;必须补齐打包依赖并重建验证。
`1f69480` 补齐依赖后运行了真实 PCB 流程;`8e486c1` 又收紧了隐藏基础设施窗口的精确识别条件,最终冻结测试自动通过退出分支。
最终证据:
- `diagnostics/issue2-frozen-20261102/full-8e486c1-startup/evidence/verify-97173dae8a21/startup-close.json`
- `diagnostics/issue2-frozen-20261102/full-8e486c1-nohistory/repair-result.json`
- `diagnostics/issue2-management-final-20261102/probe-result.json`
- `diagnostics/issue2-management-final-20261102/full-remove-result.json`
- 移除前完整旧库保留在 `C:/Users/ABS_Windows/.cbb-management-e2e-20261102-e/full-remove/management-e90d69ad7f624fb18f5401119b96856d/library-before/`。
冻结启动失败试验的批处理退出码为 2,因为输入是损坏工程;通过项是自动安全退出,而不是工程校验成功。缺少健康备份的 Repair 同样是已验证的明确失败分支。
## 仍需现场验收
工单附件只有日志,没有现场 `1GPHY_8211` 故障工程及其必要共享库的一致副本。
因此现场服务器会话失联尚未复现,也没有完成该现场故障经应用实际维护按钮触发的完整自动链路验收。
必须取得副本、记录来源/工程身份/主要文件哈希,在隔离环境记录失败、退出、Repair 调用、重新打开、保存关闭和 READY 查询的完整证据,并核对来源未改变。
复制后不能复现时应记录“未复现”,不能用数据库文件头损坏试验替代。
Windows 10 尚未验证。现有原生试验环境为 Windows 11 / Mentor EE 7.9.5。
历史备份恢复保持“已恢复,版本待核对”,不宣称无损修复。
## 候选包
`dist/issue2-repair-candidate-877e3b4.zip` 保留独立修复候选包及构建清单。
完整候选程序位于 `dist/issue2-full-candidate-8e486c1/`,由 `git archive 8e486c1` 的不可变源码构建。构建与 GUI 冒烟通过,真实冻结原生证据见上。
分发压缩包:`dist/issue2-full-candidate-8e486c1.zip`。解压后运行 `CbbRefreshVerify-Background/CbbRefreshVerify.exe`;包根目录保留构建清单、本文及关键验证证据。
`dist/issue2-full-candidate/` 和 `dist/issue2-full-candidate-1f69480/` 是被后续修正取代的中间试验构建,不作为交付包。
## 后续验收顺序
1. 取得现场故障工程及必要共享库一致副本,优先完成实际维护按钮触发的完整自动链路验收。
2. 针对原生导入会重写 ICDB 的行为,使用经过验证的 Mentor 语义读取/导出建立工程内容等价证据;不能只放松哈希检查。之后才能启用新增,并验证重复冲突、同名更新、部分失败及备份重新导入。
3. 在 Windows 10 / EE 7.9.5 重跑冻结关键路径,并在具备网络测试环境时验证真实断网、取消和恢复场景。现有模拟测试不能替代这些环境验收。
@@ -0,0 +1,182 @@
# Issue #2: release the PCB launched by a failed database open
Branch: `codex/temp-issue-2-icdb-recovery`.
## Field failure
The issue attachment records an iCDB lost-server-session error while opening
`1GPHY_8211`. The supervisor declined the database log viewer and cancelled the
worker. Because document identity had not been established, the existing
document-close helper was never called. PCB and its launcher remained alive;
the subsequent Repair attempt returned `REPAIR_DATABASE_IN_USE` and the other
380 queued entries were skipped. There is no evidence of native Repair actually
running on that field database.
## Change
The worker now has a separate startup-failure close path. It requires a current
iCDB diagnosis or a database-load-failure dialog belonging to this PCB during
startup. It checks the private desktop, excludes pre-existing process IDs, and
matches the complete PCB path and ReusableCircuit argument. Only an enabled
empty PCB main window, without modal dialogs, MDI documents or database address
records, receives a cooperative `WM_CLOSE`. A requested close is not treated as
success until process exit is observed. Ambiguous or busy sessions are retained.
The supervisor allows up to 40 seconds for fatal-error cleanup so that the
worker's 20-second startup-close window can complete before recovery begins.
The existing repair preconditions, backups and success checks remain in force.
Each attempt writes `startup-close.json` and close-request/result events.
## Verification
Regression tests cover the missing pre-identity cleanup route, real observed
empty-window titles, exact path matching, pre-existing processes, another
desktop, live address records, modal and MDI windows, disabled windows, unrelated
failure records and a close request that does not result in exit.
Delayed dialog/address release and delayed process exit are also covered.
Validation: `python -m pytest -q` — 491 passed, one existing pywinauto COM-mode
warning; `python -m compileall -q src tests` and `git diff --check` passed.
A new isolated local library was created with the existing
`tools/validate_icdb_open_repair_reopen.py` tool, output
`diagnostics/issue2-startup-20261102`. No production library was changed.
The test damages only the new copy's database header; it does not reproduce the
field server-session-loss condition.
The real Mentor opening run produced `MENTOR_DATABASE_LOAD_FAILED`, then:
- `startup_close_requested` for the launched PCB PID 6532;
- `startup_close_result: CLOSED`;
- worker and supervisor both recorded `process_exit_confirmed`, with no
remaining PCB processes.
The subsequent separate native Repair run was able to start and completed as
`RESTORED_REVIEW_REQUIRED`, using the fixture's historical backup. This proves
the failed-open session no longer blocks the next repair operation in this
fixture. It does not prove automatic recovery of the field database or establish
that an older backup contains the desired design revision.
The separate `open-after` run on the same restored fixture completed native
integration, Save/IsSaved/Close/Quit, confirmed process release and returned
`PASS`, `safe_to_continue=True`, `READY (IsVerifiedReuseBlock, raw=1)`.
The `compare` phase passed all seven checks, including absence of the original
opening error and unchanged source-fixture database SHA-256. Its
`server_session_loss_reproduced` field is explicitly `false`.
Reproduction commands (set `PYTHONPATH=src`; setup requires a new output name):
```powershell
python tools/validate_icdb_open_repair_reopen.py setup --output issue2-startup-20261102
python tools/validate_icdb_open_repair_reopen.py open-before --output issue2-startup-20261102
python tools/validate_icdb_open_repair_reopen.py repair --output issue2-startup-20261102
python tools/validate_icdb_open_repair_reopen.py open-after --output issue2-startup-20261102
python tools/validate_icdb_open_repair_reopen.py compare --output issue2-startup-20261102
```
The stages are deliberately separate: the test fixture has a format-corruption
error and historical-backup recovery, not the field lost-session auto-repair
trigger. The test does not change production handling of old-backup recovery.
READY filtering, hash-scope changes and CBB CRUD are outside this focused fix.
## Approved Task 1 follow-up: lifecycle and repair outcomes
The empty-PCB close path now receives the launcher process handle and waits for
its normal exit after PCB exits. It checks database addresses again during that
wait, so a late address record prevents a false `CLOSED` result. The startup
record includes PCB, launcher and address release state. A connected COM server
with no active document emits `pcb_document_wait`; it remains in startup and
continues reading the current native failure rather than implying identity.
Native Repair reads bounded Output text and records only the text appended after
this run's Repair invocation as operation evidence. Database logs are restricted
to the current native PID and start time. Output, native log copies, the complete
backup, native result and attempt record remain available under `native-repair`.
Detailed native evidence is preserved separately from its directory path.
The result distinguishes `MISSING_HEALTHY_BACKUP`, `NATIVE_REPAIR_FAILED`,
`DATABASE_BUSY`, `UNKNOWN_DIALOG`, and `TIMEOUT_UNRELEASED`. A failed tool receives
cooperative close only after a terminal native error, an enabled exact-project
main window, no other windows/prompts and no target database address. The worker
then waits for normal process exit. Unknown/custom prompts and incomplete native
operations receive no close action. A failure classification can coexist with
unreleased state; that state always stops the queue. Terminal `DATABASE_BUSY`
errors also retain the native tool without close, reopen or queue continuation.
Unreadable, absent, hung or truncated initial Output waits within the deadline
and retains the tool without requesting Repair; a readable empty string is a
valid invocation baseline. A busy-project message in
this fresh native process's initial loading Output prevents Repair invocation
entirely; it is not hidden by the later invocation baseline.
Before reopening or continuing, the parent independently checks relevant PCB,
Library Manager, Repair, importer and close-helper processes, all known project/
PCB/shared-library addresses, and exclusive read access to every existing known
database. Process-observation errors and exclusive-access failures block reuse.
Only a conclusively failed, released, independently revalidated project-local
target may allow the next CBB. Shared or unknown scope, busy owners, timeouts,
unknown prompts and historical restores stop for review.
Before accepting native success, the parent validates native process identity
and true exit, exact project/database, empty address state, confirmed backup/
repair evidence and absence of restore/failure/unknown-prompt contradictions.
Missing or wrong-typed fields fail closed. Independent process, address and
database-handle probes remain additional requirements.
Native `REPAIRED` is retained as `native_status`; summaries count a repair only
after the same request reopens, completes Verify and returns authoritative
`PASS/GREEN` with confirmed release. A failed reopen becomes
`REPAIR_VALIDATION_FAILED`; incomplete or contradictory native success/release
becomes `UNCONFIRMED` and prevents reopening.
Historical restoration remains `RESTORED_REVIEW_REQUIRED`. The original error,
stage and evidence references, a `pre-repair-result.json` snapshot, native
evidence and validation evidence remain attached even if the retry raises.
`tests/fixtures/issue2-lost-session-sanitized.json` contains selected fields from
the actual issue attachment, with paths, machine and process identities
sanitized. Replay asserts `PCB_STARTING`, the selected PRJ/database, normal PCB
and launcher release before native Repair, and exactly one automatic repair and
one reopen even if the opening error repeats. Separate replays cover the actual
2026-10-28 missing-backup Output, delayed exits/addresses, unknown custom prompts,
successful native repair and historical restoration. These are nonnative tests.
The attachment contains logs only. No matching `1GPHY_8211` faulty project was
found in the sibling `Skyworth_CBB_Lib` collection. This host runs Windows 11;
Windows 10 behavior and recovery of the real field database remain unverified.
The coordinator's prepared `diagnostics/issue2-frozen-20261102` fixture damages a
copied database header; it does not reproduce field lost-server-session loss.
Candidate packaging and frozen/native tests remain coordinator work after review.
Task 1 checks: full suite once, 532 passed with the existing pywinauto COM warning;
after the final initial-busy gate regression, the related final suite passed all
234 tests. Compileall and `git diff --check` passed. The coordinator will run
candidate/frozen validation against the final implementation.
Task 1 review fix round: 259 related tests passed (17.86s); compileall and
`git diff --check` passed. These checks include busy retention, real readback
failure branches, 30 malformed-success variants at both release and reopen/
counting boundaries, and a complete actual worker-result replay control.
Runtime fix round 2 adds `iCDBProjectBackup.exe` and `ReuseBlockImporter.exe` to
the process helper's fixed query whitelist. Without these entries, the real
parent release probe rejected its own required queries and always denied safe
release. New tests keep the release validator and process helper real and stub
only WMI: no owners permits release, either native owner prevents it, and
arbitrary query names remain rejected. Focused validation: 172 passed. Candidate
`c823a4b` must be rebuilt with this correction before frozen/native validation;
field recovery remains unverified.
Runtime fix round 3 uses the actual frozen-worker window capture. A single Afx
shell titled exactly `iCDB Project Backup` now waits, before invocation only,
for the exact project title within the existing deadline. Two owned-process
input-indicator classes (`UAC_InputIndicatorOverlayWnd`, `UAC Input Indicator`)
are ignored only with empty titles. Wrong/duplicate target windows, ambiguous
shells, named/lookalike auxiliary windows, unknown prompts, missing Output and
busy verdicts still retain the tool without unsafe commands. The native loading
line `Checking if project is in use.` is excluded from busy evidence; the actual
ownership verdict continues to control the busy gate.
Sanitized recorded-shape replay includes real shell children, RichEdit Output
readback, startup-to-loaded transition and both input indicators before and
after load. Focused validation: 189 passed (12.40s); compile and scoped diff
checks passed. New source/frozen native validation and rebuilding the candidate
remain coordinator work; these replay results do not establish field recovery.
@@ -0,0 +1,251 @@
# Scoped recovery manifests and complete verified backups
Status: implemented; review finding P1 addressed with focused validation. Started on b90a9bb; paused at
the RED checkpoint for the coordinator's native startup-window repair fix and
resumed on 877e3b4. No native UI/process/live-library actions were performed by
this implementer. Original untracked review.diff was preserved and not staged.
## Result and scope
Complete backup trees are still copied and retained. SHA256 and semantic
before/after comparisons now cover only primary design/project/database/
constraint files and required central-library dependencies. Runtime changes
after a successful snapshot do not stop install. Primary content changes,
additions and deletions do stop install, with copies retained as evidence.
The validate-copy -> conflict checks -> retain original Work -> install ->
reopen/native verification flow is preserved. Source equality now runs after
incoming Work preparation, immediately before target equality, closing the old
late-source-change window. Source idle/address ownership is rechecked there as
well: excluding address bytes from semantic hashes does not bypass idle checks.
Initial implementation: 29c154d. The review correction is described below.
Durable documentation lives here; an ignored review copy remains at
.superpowers/sdd/2026-11-02-issue-2-management/task-3-report.md.
Scoped production files: backup_recovery.py and new scoped_manifest.py. Scoped
tests: test_backup_recovery.py and new test_scoped_manifest.py. No Verify public
types, Task 2 helpers/READY logic, native repair classifiers/process whitelist,
or library binary contents were changed.
## Exact classification rules
Project scope retains every unclassified file as primary. This includes PRJ,
PCB, DXP, icdb.dat, Layout databases, schematic/logic/symbol assets, CES/config,
unknown binary/engineering formats, and text files outside explicit excluded
categories. Rules are case-insensitive; manifests preserve relative path case.
Explicit semantic exclusions, still copied and metadata-validated:
- Runtime/history child directories **at a project workspace root**, its PCB
workspace root, a selected Work/Cert root, or the library root: log, logs,
temp, tmp, __pycache__, backup, backups, output, outputs, report, reports,
gerber, gerbers, odb++, Log Files, LogFiles, and Work.before-restore-*.
- ProjectBackup/backups only at those workspace roots. Other ProjectBackup
content remains conservative primary data.
- Known native runtime below database/cdbsvr and PCB/database/cdbsvr: log,
dbcheck and dbrestore subtrees. In shared library databases, those same
subtrees below SymbolLibs/<partition>/cdbsvr or <shared-root>/cdbsvr. Other
unknown files below cdbsvr remain primary; the directory is not dropped.
- File suffixes: .log, .tmp, .temp, .lck, .lock, .bak, .backup, .pdf.
- File names: sAddress.adr and editor files starting with ~$.
Directory exclusions are contextual rather than arbitrary ancestor matching.
ReusableBlocksLP/<selected-block>/Work and Cert are structural identity
components, never runtime labels. CBB names Logs, Temp, Backup, Output, Report,
Log Files, ProjectBackup and Work.before-restore-engineering remain valid and
their primary files are hashed in both semantic manifests and complete-copy
validation. Case variants have the same protection.
Shared dependency partitions and nested engineering folders keep their names:
SymbolLibs/temp/icdb.dat, SymbolLibs/Temp_a/device.sym,
SymbolLibs/Backup/device.sym, hdl/Logs/design.v and hdl/Backup/design.v are
primary. Runtime directory labels apply at the known roots above, not inside
arbitrary engineering/dependency hierarchies. File suffix/name exclusions are
applied to files, not to engineering directories with matching suffixes.
The uploader-compatible .<stem>.cbb-upload.lock falls under .lock, so it is
runtime and never primary. It is **not** silently removed from complete copies.
Central-library scope includes only target ReusableBlocksLP/<block>/Work and
Cert, root configuration files (the selected .lmc, other root config files),
and shared/configuration dependency directories outside ReusableBlocksLP. Known
examples include SymbolLibs/__ReusableBlocksSymb, CellDB and PartDB; new unknown
dependency directory names remain primary conservatively. Other root .lmc files,
other ReusableBlocksLP CBBs, target historical/non-Work/non-Cert trees and the
explicit runtime/generated categories above do not enter semantic equality.
Those unrelated files still enter the complete copy and its metadata checks.
Later semantic scans prune ignored/runtime/unrelated CBB directories before
entering them, so transient/unavailable runtime or unrelated trees cannot
interfere with the post-snapshot content check.
## Reusable API contract for Task 4
Import from cbb_refresh_verify.scoped_manifest:
```python
scope = ManifestScope.library(block_name, selected_lmc.name)
before = copy_verified(library_root, private_backup, scope=scope, progress=callback)
current = build_manifest(library_root, scope=scope, exclude=private_incoming)
if current != before:
# stop install; retain evidence
...
```
- `ManifestScope()` is project scope. `ManifestScope.library(block_name,
library_name)` requires nonempty single-component names; no path traversal.
- `build_manifest(root, *, scope=None, exclude=None, progress=None,
hash_function=hash_file)` returns a semantic manifest. `exclude` is an optional
private incoming subtree, **not** a copy exclusion. Hash injection is a test
hook; normal callers use the default.
- `copy_verified(source, destination, *, scope=None, progress=None,
hash_function=hash_file)` requires a fresh destination outside source. Copies
all files/directories, returns the same semantic schema, retains partial
destination on failure, and raises ValueError/OSError for unsafe/changed data.
- `scan_tree(root)` scans complete membership and refuses links/junctions and
special files. Its optional scope/exclude is used by semantic scans only;
complete copies always scan without filters.
- `hash_file(path)` streams SHA256 in 1 MiB chunks. Files are processed with up
to eight workers, retaining the existing concurrency bound.
- Progress callback accepts **one dict**, not the old private `(count,total)`
pair: `stage` (`copy` or `hash`), `hashed_files`, `hashed_bytes`, `total_files`,
plus `copied_files` for copy. Hash counts/bytes count unique primary snapshot
files/logical bytes, not aggregate disk IO. `total_files` counts all files for
copies and primary files for standalone manifest generation. Initial zero and
each 256/final-file event are emitted. Recovery keeps existing public progress
stage/message keys and adds `manifest_stage` and these counters.
Version 1 JSON-compatible output (relative paths are POSIX, no machine-specific
absolute paths or mtimes in equality):
```json
{
"version": 1,
"scope": {"kind": "library", "block_name": "A", "library_name": "target.lmc"},
"files": {
"ReusableBlocksLP/A/Work/A.prj": {
"size": 123, "sha256": "<sha256>", "scope": "target_work"
}
}
}
```
Entry scope labels are project, target_work, target_cert, library_config and
shared_dependency. Default project's descriptor uses empty block/library names.
Recovery persists both library-before-manifest.json and
source-before-manifest.json. The shape changed only for private backup helpers;
VerifyRequest/VerifyResult contracts are unchanged. There is no old-manifest
loader or destructive migration: existing historical evidence remains intact.
## Copy integrity and old strict equality compatibility
Copy validation remains strict for the **entire** snapshot: before/after source
file/directory membership, file type, size and nanosecond mtime must agree;
destination membership/type/size/mtime must match too. Primary regular source
files are SHA256 read before copy and again for validation; destination hashes
must match. All native icdb.dat and .lmc files retain exclusive read handles
during copying. For scoped primary native files, the expected digest is built
from the source ReadFile stream independently of destination SHA256. Identical
size/mtime destination corruption is therefore rejected, including locked DBs.
Unrelated native DBs are still locked/copied; their bytes are not SHA256 hashed.
The old final `_manifest(source) == complete_copy_record` was an all-file hash
comparison that rehashed every runtime and unrelated project file. It is
replaced by full-tree copy metadata validation and primary byte verification at
snapshot time. Later equality compares version/scope and primary relative
path/size/hash/scope only. Thus log-only additions/changes/deletions after a
successful copy are accepted, while primary keyset/content changes remain real
conflicts. No conflict tests were weakened or deleted; additional source,
target, Cert, shared dependency, late-source and active-address regressions were
added. Empty directory metadata is intentionally not part of semantic equality.
## RED/GREEN and verification evidence
The original full-suite evidence below belongs to initial commit 29c154d. The
P1 review correction has fresh focused validation, and has **not** rerun the
full suite; the coordinator requested focused tests only for this fix.
1. Initial RED, before production edits:
`python -m pytest tests/test_scoped_manifest.py tests/test_backup_recovery.py -q`
-> **29 failed, 26 passed in 7.89s**. Failures demonstrated missing versioned
manifest/schema/progress and post-snapshot runtime/unrelated tolerance.
Copy/conflict protections already present continued passing.
2. Initial GREEN -> **55 passed in 11.93s**.
3. Additional RED for semantic traversal of an unavailable ignored/unrelated
tree -> **1 failed, 36 passed in 2.79s**; fixed by pruning semantic scans.
4. Additional RED for source mutation during incoming Work preparation and
source address reappearance -> **2 failed, 20 deselected in 1.56s**; both had
incorrectly installed before the final-source-check changes.
5. Final focused:
`python -m pytest tests/test_scoped_manifest.py tests/test_backup_recovery.py tests/test_backup_recovery_dialog.py -q`
-> **64 passed in 9.93s**.
6. Coordinator was notified **before** the full suite and explicitly confirmed
no native owner/mutex and paused all native probes. Exactly one final suite:
`python -m pytest -q` -> **693 passed, 1 warning in 47.99s**. Warning:
pywinauto's existing "Revert to STA COM threading mode" warning in
test_library_reader.py::test_status_log_records_unseen_id_inference.
7. `git diff --check` passed. Review confirmed no unrelated/native-helper edits.
Coverage includes every primary category, unknown engineering formats,
runtime/history/generated exclusions with complete-copy retention, hash-path
scope, relocatability, source changed/deleted/added during copy/validation,
target changes/deletions/additions, Cert/shared-library conflicts, unrelated
CBB tolerance, copied corruption with preserved metadata, locked stream bytes,
source content changes with preserved metadata, complete copy membership and
nonprimary size consistency, idle/address rechecks, retained copies on failure,
and unchanged native reopen/retained-Work recovery behavior.
## Review correction: contextual runtime directory classification
Review found that the initial unconditional directory ancestor rules could
classify valid selected CBB names (Logs/Temp/Backup) or real SymbolLibs/temp
engineering partitions as runtime. That removed primary paths from both the
baseline manifest and later conflict comparison, and from copy byte checks.
The classifier now resolves the structural role first and only applies the
runtime directory rules at documented workspace/native DB locations. Semantic
directory traversal and complete-copy byte classification share that rule.
Complete tree copy/metadata validation remains unchanged. This also protects
nested engineering folders with names Logs/Backup, and avoids broad dropping
of unknown cdbsvr files.
Independent regressions cover Work and Cert under 11 colliding CBB names/case
variants, real SymbolLibs/temp and Temp_a partitions, arbitrary nested
engineering folders, source and destination corruption with unchanged size/
mtime, independent locked database destination corruption, and end-to-end
recovery conflicts that previously overwrote concurrent target/shared edits.
Known native Log Files, ProjectBackup/backups and DB server log/dbcheck/
dbrestore data remain semantically ignored and completely copied.
Review-fix RED:
`python -m pytest tests/test_scoped_manifest.py tests/test_backup_recovery.py -q --tb=short`
-> **47 failed, 74 passed in 18.41s**, before production changes. The failures
included silently accepted primary corruption and installs over concurrent
target/shared edits. Additional conservative-boundary regressions prevented
reintroducing the same bug through Log Files/ProjectBackup/retained-Work names
or broad cdbsvr directory exclusion.
Final review-fix focused GREEN:
`python -m pytest tests/test_scoped_manifest.py tests/test_backup_recovery.py tests/test_backup_recovery_dialog.py -q --tb=short`
-> **141 passed in 18.28s**. No native UI/process actions, live-library mutation,
or full-suite run was performed during this fix round.
## Limitations / follow-up boundary
- No real field lost-session reproduction, native GUI success reproduction, or
Windows 10 run was performed for this task; file-based tests do not substitute
for those required native/field validations.
- Task 4 must adapt complete-copy access to a live uploader lock **only when the
operation actually owns that coordination lock**. The current helper copies
readable locks and fails closed on unreadable/live exclusively owned files;
it does not delete locks or broadly drop engineering data.
- Native idle guards and later coordination locks remain necessary. Final
equality and filesystem rename are not one cross-process atomic transaction
against arbitrary noncooperating external writers.
- Nonprimary byte hashes are intentionally absent. Their copy integrity uses
complete membership and size/mtime checks, as specified; same-size,
timestamp-preserving nonprimary corruption is outside the semantic guarantee.
- All snapshots must be stable while copied, including runtime files. This
deliberately differs from post-snapshot semantic checks, which tolerate
runtime changes. Original and partial recovery evidence is retained on failure.
@@ -0,0 +1,122 @@
# 既存地址记录下的明确 ICDB 维护入口
2026-11-03 的现场报告显示,点击“非 READY ICDB 检查与修复”后,IP101GR 在
0.172 秒内返回 BLOCKED,没有启动官方 Repair。原先维护按钮和普通校验使用
相同请求;普通校验对任何 sAddress.adr 的阻止条件也挡住了明确维护入口。
随后保留的库协调检查点使重新读取与维护都无法继续。
本次为用户明确确认的维护增加独立入口。普通校验遇到地址记录仍停止,不依据
文件日期、TCP 不通或本机无 PCB 进程判断地址失效,不删除、移动或隔离地址。
没有地址阻止时,维护继续沿用原有校验及本轮失联后的自动修复流程。
存在地址记录时,明确维护需要唯一可确认的工程 PRJ/database 映射。共享符号库
地址、所选工程内多个地址、外部引用、歧义目标、不完整工程均会阻止执行。
其他独立 CBB 的 Work 数据库地址不纳入当前修复目标,原文件保持不变。工具检查相关
原生程序和保留工作进程,并同时独占读取库中的原生数据库文件;记录目标工程
引用指纹和地址字节哈希,检查期间及完整备份后重新核对。完整工程备份保留
原地址文件,再由官方 iCDB Project Backup 打开工程。只有其实际 Output 明确
报告 `Project is not in use. Full iCDB Project Backup's functionality is available.`,
且没有占用或未知窗口时才请求 Repair。
库旁已有协调检查点时,明确维护可以接续有效的同库记录,条件是原监督进程
已退出,或当前进程确实持有已闲置的保留锁。相关所有者和目标独占访问检查
必须先全部通过,再原样归档旧检查点并建立本次检查点;库 sidecar 和全局 mutex
期间始终持有。未知、损坏、其他库的记录或仍存活的外部监督进程不会被接管。
普通释放检查的地址要求没有放宽,上传锁文件不删除。
重启后有有效同库检查点时,界面仅按工程目录显示 UNKNOWN 状态,明确标注
“状态未确认,不代表损坏”。此视图不调用原生状态读取,只允许明确维护或严格
释放检查;普通校验、上传/更新/移除及备份恢复均禁用。安全完成维护后再重新
读取权威状态,保留当前搜索条件。
Repair、原生退出、地址消失和最终校验仍是不同的判据。只有完整原生修复证据、
所有者与地址释放及同一工程后验 PASS/GREEN 全部成立才计为修复通过。缺健康
备份、恢复旧版本、占用、超时或不完整证据不会提升为成功,也不会盲目重试。
协调端在保留旧地址字节的用户工程副本上观察到:官方工具报告数据库曾在服务器
运行时被复制、工程当前未使用,随后官方 Repair 自行清除副本地址并返回成功。
这证明了明确维护入口的必要性;原始用户库没有由本次开发或测试修改。实际按钮、
冻结包及最终全套回归的实际验收结果见下。
## 修复后的本地读写访问提示
实际副本验证发现,原理图 iCDB Repair 成功并清除地址后,PCB 仍可能显示上次
异常退出后的读写访问确认。这与选择恢复旧数据库不同。明确维护确认现在说明:
仅在本地固定磁盘、严格确认修复后,工具可对本次启动的这一完整提示确认一次。
该授权不能由普通 Verify 或通用对话框规则开启。维护代码先验证完整原生修复
证据,生成绑定原库、PRJ、PCB 的内部凭据。实际 PCB 启动前,重新确认地址缺失、
无其他原生所有者,并同时独占读取 LMC、相关 icdb.dat 和选中 LayoutDB.lyt,
在本次私有桌面生成短时有效的启动证据。出现提示时再核对当前 PCB 与启动器的
实际 PID、父子关系、安装路径和完整设计参数,以及其他所有者缺失。
只接受原始完整英文提示正文(仅忽略空白差异)、精确窗口类型/标题和唯一可用
Yes6/No7 按钮。专用代理在自己的私有桌面再次读取实际窗口和控件;先消耗授权,
再发送一次按钮消息。没有证据、提示变更、重复提示、额外弹窗或身份不符均停止,
不使用鼠标、前台输入或通用 Yes 回退。后续文档身份、保存关闭和 READY 判据不变。
路径必须经 GetDriveType 确认为 LOCAL_FIXED,且没有重解析点祖先。UNC、网络
映射盘、可移动盘和链接路径不自动确认。该检查不宣称具备跨主机分布式排他能力;
数据库只读句柄在交给官方 PCB 启动前释放,任意非协作外部写入者之间仍不存在
跨进程原子事务保证。普通校验及其他数据库恢复选择继续保持硬性阻断。
## PCB 恢复版本待用户决定
后续实际副本已完成 iCDB Repair 和一次本地读写确认,但 PCB 又要求在“最后
用户保存数据库”和“自动保存数据库”之间选择恢复版本。本次两项显示的日期
均为 `2026/9/24 23:06`;同日期不代表内容相同,工具没有自动选择任何版本。
这类结果单独标识为 `PCB_VERSION_CHOICE_REQUIRED`,展示候选日期,并在
`pcb-version-choice.json` 保存完整窗口和候选状态。维护摘要显示“ICDB 已修复 /
PCB 版本待选”,原生状态仍为 REPAIRED,但整项保持未完成、需人工决定,不能
计为 PASS/GREEN。工具也不会因为显示了某个默认选中项就认可该版本。
## 最终验证(2026-11-03)
程序源码提交 `d76475a`:全量 `python -m pytest -q` **969 passed,1 条已有
pywinauto STA 模式警告,107.69 秒**;编译、diff 检查和代码复审通过。
由不可变 `git archive d76475a` 构建的 EXE 通过 GUI 冒烟。
在第二份完整隔离库上,通过打包 EXE 的实际“非 READY ICDB 检查与修复”按钮
确认并运行 IP101GR:有效旧阻止记录接续、旧地址完整备份、官方 Repair 成功并
正常释放、一次受约束的读写确认均实际执行。之后准确停在原生 PCB 版本选择,
显示 `version_choice_required=1`、`repair_unconfirmed=0`、`repaired=0`。
这是维护入口和结果分类通过验收,不代表未经用户选版本就达到 READY。
原始证据:
- 用户最初 0.172 秒失败:`diagnostics/issue2-user-maintenance-20261103/user-reports/`。
- 冻结 EXE 实际按钮:`diagnostics/issue2-user-maintenance-20261103/actual-button-frozen-d76475a/outcome.json`。
- 原生版本选项:上述目录的 `data/evidence/verify-8fa461b6d6fe/pcb-version-choice.json`。
- 全量测试:`build/issue2-maintenance-final-tests-d76475a.log`。
### 用户明确选择最后手动保存版本后的副本验证
用户选择“用最后手动保存版本继续验证”,授权范围仅为隔离副本。诊断续跑使用
真实校验器、原生工作进程、对话框代理及权威状态读取;只为这次用户决定提供
版本动作:先点击 6213,重新观察其已选中且 6206 未选中,再确认 OK 1。
选择前保留完整工程副本;没有改变程序的默认版本选择规则。
工程成功打开并核对身份,但在原长路径下两次 Project Integration 均产生本轮
JobPrefsDB.jpf / local Cell Library 加载错误。原文件、临时目录及备份中的 JPF/CEL
可读且哈希一致,日志前缀与时间证明是本轮错误,不能断言二进制数据已损坏。
随后保持同一工程数据,通过临时本地 `T:` 短路径进行对照,完成原生 Integration、
保存关闭、进程释放及权威状态查询,结果为 **PASS / GREEN / READY
(IsVerifiedReuseBlock, raw=1),safe_to_continue=true**。所有原生进程退出后已移除
该临时盘符。此结果说明短路径试验可通过,尚不能证明确切路径长度限制或永久
解决原长路径下的 JobPrefs/Cell Library 兼容问题;产品没有自动增加短路径映射。
这是**用户指定历史版本后的恢复与验证**,不是无人值守或无损自动修复验收。
验证后的完整库副本保留在 `diagnostics/issue2-user-maintenance-20261103/frozen-library/`,
原用户库没有被替换。结果和选择证据分别位于:
- `user-authorized-last-saved-r2/user-selection-events.jsonl`(实际 6213 → 复读 → OK 1)。
- `user-authorized-last-saved-short-path/result.json`(最终 PASS/GREEN)。
- `short-path-trial.json`(临时盘符及正常退出后清理记录)。
- `source-unchanged-after-user-choice.json`(全部试验后原库 21,013 个主要文件清单仍一致,原地址字节哈希未变)。
以上相对路径均位于 `diagnostics/issue2-user-maintenance-20261103/`。
现场原工单其他工程、网络共享读写确认和 Windows 10 仍不能由此验收代替。
交付候选包为 `dist/issue2-maintenance-20261103-d76475a.zip`。不合并发布、不自动关闭工单。
@@ -0,0 +1,46 @@
# 工单 #2:用户实测失败后的修订记录
分支 `codex/temp-issue-2-icdb-recovery`。本轮修订不能视为现场验收通过;未合并、发布或关闭工单。
## 用户失败的实际原因
用户运行 `b26e2f2` 冻结包。真实日志位于程序旁的 `data` 目录。中心库存在有效的未释放会话检查点,应用进入文件系统恢复视图,因此管理按钮被禁用;旧界面没有清楚显示原因,禁用外观也像可用按钮。该次没有启动增删改操作。
ICDB 批次的首项 `1GPHY_8212` 在预检查报 `MAINTENANCE_TARGET_UNCONFIRMED`,原生 Repair 没有执行。旧检查硬性要求 `PCB/pcb.prj`,但该工程的 PCB 明确反向引用主 `1GPHY_8212.prj`。主 PRJ 指向 `database`;存在的 `PCB/template.prj` 不能当作活动工程猜测使用。后续八项被跳过。
## 修订
- 只有 PCB 唯一、精确反向引用主 PRJ 时,允许缺少辅助 `pcb.prj`。预检查、Repair 后重新打开、管理来源身份及库引用核对使用一致规则。`template.prj` 保持原样并参与资产哈希。
- 显示库会话阻止横幅、管理禁用原因、灰色禁用按钮及首项具体失败阶段。
- 集成校验跳过原生明确禁止调用、且已同步的动作;仍要求四项最终全部同步。必需动作被禁止或原生拒绝时继续判失败,不伪造通过。
- 识别原生 EDIF 中数字开头的精确标识符,例如 `&1GPHY_8212`;不放松设计内容比较。
- 私有桌面上的原生库编辑器若提示其他已确认缺少 PCB 的条目,只确认准确匹配的已知通知。当前目标、未知弹窗或身份不符的窗口不自动确认。
- 原生新增共享明确截止时间;父进程超时发出取消信号。阻塞调用返回后,以及所有日志和证据 I/O 完成、提交 OK 之前,重新检查监督进程、取消状态及期限,防止超时后迟到写入。
## 隔离原生证据及限制
证据根目录为 `diagnostics/issue2-user-feedback-20261103/`。
完整现场库副本保留原生地址和所有工程文件,共 38,954 个文件。原用户库始终不参与写入,完整恢复新增结束后 `source-final-recheck.json` 再次确认 25,214 个主要文件与试验前完全一致。
`d36b6bc` 冻结程序的实际维护按钮已在该副本完成完整备份、官方 Repair、数据库地址释放及同一 PCB 重新打开。随后原生要求选择历史 PCB 数据,应用返回 `PCB_VERSION_CHOICE_REQUIRED`,没有显示修复完成。
用户选择最后手动保存版本(2026/9/24 15:15)后,在确切所属的隔离会话中继续。SynchCES 和 LoadCES 成功,但原生 BackAnnotate 仍报已验证工程不允许执行。未保存、未达到 READY,失败 PCB 已正常关闭。这段人工续接不算无人值守自动修复通过。
空隔离库中的重新导入及工程身份核对通过,但自动校验因目标缺少 PartsDB 分区失败,不能算完整校验通过。完整依赖库中的首次同名替换完成原生移除后,新增被其他条目缺少 PCB 的提示阻塞而超时;该部分失败的检查点及完整旧库备份保留在 `diagnostics/full-update-events/`,没有自动重放。
完整隔离库中 IP101GR 的旧数据库地址通过官方 Repair 释放,证据为 `dependency-ip101gr-native-only/result.json`。这只是依赖数据库的原生修复诊断,没有重新打开或 READY 验收。
修订后对缺失的 `1GPHY_8212` 显式执行恢复新增,启用自动校验;独立证据目录为 `diagnostics/full-recovery-events/`。结果为 `UPLOADED_VERIFIED`,`safe_to_continue=true`。已知的其他缺 PCB 条目提示被自动准确确认;新增后独立重读库、三种原生逻辑导出及主要资产比较通过。随后自动执行 ForwardAnnotate、SynchCES、LoadCES、BackAnnotate,四项最终均同步,保存、关闭和进程退出确认完成,权威 `IsVerifiedReuseBlock` 返回 `raw=1 / READY`。自动校验链路耗时 126.422 秒(不含完整备份和新增身份检查)。
最终结果为 `full-recovery-add-result.json`,完整检查点为 `diagnostics/full-recovery-events/management-03a9dbc537f84e0faaea2ad5a2a732c2/checkpoint.json`。此结果证明修订后**重新导入加校验**的恢复路径有效,不能替代直接 ICDB Repair 后仍被原生 BackAnnotate 拒绝的失败结论,也不把用户选择历史数据后的工程称为无损修复。
## 尚未满足的门槛
服务器会话失联经实际按钮触发、自动 Repair、重新打开、保存关闭及权威 READY 的完整链路仍需通过。历史数据选择及重新导入均可能改变恢复版本,不能宣称无损恢复。Windows 10 尚未验证;当前实机为 Windows 11 / Mentor EE7.9.5。
## 自动化验证
修订代码全量 `python -X utf8 -m pytest -q`:**1095 passed,171.09 秒**。保留一条已有 pywinauto STA COM 线程模式警告。`compileall`、`git diff --check` 通过。取消发生在日志证据 I/O 中的回归先复现错误提交,再验证修复;相关集中测试 108 项通过。独立审查已复核全部代码修订,最后一项取消时序 P2 已解决,没有剩余实质问题。
候选包按提交归档构建。最终冻结按钮冒烟结果及构建、压缩包校验记录分别保存在证据目录的 `final-frozen-buttons/result.json`、`build-result.json`、`package-result.json`;按钮冒烟只证明界面响应,不等于现场 ICDB 自动修复验收。
@@ -0,0 +1,46 @@
# 无地址 ICDB 维护及 PCB 版本选择
沿用 `codex/temp-issue-2-icdb-recovery` 临时分支。依据实际错误日志与公开资料修正入口,用户明确授权在需要时弹窗选择版本。应用自动备份仍取消,操作前保留手动备份提醒;未修改原用户库。
## 本次行为
- 明确发起 ICDB 维护时,不再因为没有 `sAddress.adr` 或协调检查点而跳过原生检查。
- 无地址时,所选 PCB 必须唯一反向引用主 PRJ,工程内数据库映射必须唯一。多数据库、共享地址、路径身份不符、原生进程/脚本占用及无法独占读取仍停止。
- 原生 Repair 成功并确认释放后,沿同一任务重新打开。若原生要求选择历史 PCB 版本,主应用显示实际候选时间和“最后手动保存 / 自动保存 / 取消”。不默认选择任一历史版本。
- 用户选择后,私有桌面代理重新核对窗口、进程、候选时间及单选状态,再确认恢复。选择过期、窗口变化或执行失败不重试确认。等待期间应用保持响应;取消停止当前项并保留原生现场。
- 最终仍要求集成校验、保存关闭、进程退出及权威 READY。使用了历史 PCB 版本时,即便校验通过,也记录 `RESTORED_REVIEW_REQUIRED`(已恢复,版本待核对),不标记为无损 Repair。
- 未提供交互入口的调用保留待选择结果,不自动选版本;普通 Verify 不获得修复后授权。
## 过程证据
无地址隔离工程 IP101GR 经实际应用维护按钮完成原生 Repair,地址为空且进程退出。之后严格的修复后授权通过读写确认,继续到 PCB 历史版本选择。证据为 `diagnostics/noaddr-ui/evidence/maintenance-c05e9c4b06b2/result.json`。
用户此前已选择最后手动保存版本(2026/9/24 23:06)。首次诊断续接沿用该选择,完成校验、保存关闭,`IsVerifiedReuseBlock` 返回 READY/raw=1;记录在 `diagnostics/icdb-addressless-20261103/authorized-last-manual/result.json`。该次还通过诊断操作确认了保存弹窗,不能记为完整自动链路通过,因此继续实现上述应用内选择流程。
后续应用内选择试验两次在原生修复前被其他脚本占用阻止。进一步日志显示来自另一工具的并行 `run_bridge.vbs` 测试;没有强制结束或忽略该进程。失败记录保留在 `source-choice-button/`、`source-choice-button-retry/`。
## 验证边界
集中回归覆盖无地址选目标、地址变化、共享/多个数据库、修复后授权、选择/取消、版本日期改变、重复确认、原生动作失败、错 PID/桌面、真实单选状态复读和历史恢复归类。独立代码审查无剩余实质问题。
最终全量测试、冻结构建及实际按钮结果统一记录在 `diagnostics/icdb-addressless-20261103/`。本文件不将历史版本恢复视为无损修复,也不将模拟测试或人工续接替代最终冻结链路结果。
## 最终冻结包结果
程序源码提交 `de952a6`。全量 **1135 passed,228.63 秒**,一条已有 pywinauto STA COM 线程模式警告;编译、diff 检查及独立审查通过。候选程序从该提交的不可变归档构建。
最终试验使用原有完整隔离副本。先由官方 Repair 做独立准备,释放旧地址且不打开 PCB;这只用于构造此前真实遇到的无地址状态,不作为验收。启动最终冻结程序前确认:**地址为空、协调阻止检查点不存在**。
随后通过应用真实维护按钮执行,没有替换原生适配器或直接调用分阶段校验:
1. 原生检查确认未占用,执行 Repair,记录本轮原生日志并确认退出/释放。
2. 同一工程重新打开,应用弹窗显示手动保存和自动保存日期均为 `2026/9/24 23:06`。
3. 在应用弹窗选择用户此前已批准的最后手动保存版本。私有桌面代理完成单选复读及原生确认。
4. 原有监督器自动处理保存 Reusable Block cell 提示,完成校验、保存、关闭及进程退出,无诊断脚本手动点击原生窗口。
5. 权威 `IsVerifiedReuseBlock` 返回 `READY / raw=1`。最终 `PASS / GREEN / safe_to_continue=true`,恢复结果为 `RESTORED_REVIEW_REQUIRED`。
证据:`frozen-choice-button-retry/result.json`、`version-choice.png`,以及
`diagnostics/choice-frozen-ui-retry/evidence/verify-7b0cd3fb8608/result.json`。
之前被其他任务脚本阻止的各次试验均保留,没有计入成功。用户授权关闭并行测试时,该测试已经自行退出,因此没有终止 Mentor 进程或外来测试进程。
该结果证明本机 Windows 11 / EE7.9.5 上 IP101GR 的无地址维护、应用内用户选择和后续完整链路可执行;恢复采用历史手动保存版本,不证明无损保留了该版本之后的修改。未据此合并发布或关闭工单。
+53
View File
@@ -0,0 +1,53 @@
# 自动备份检查与调整
按用户 2026-11-03 最新要求:取消应用操作前自动备份,改为弹窗提示手动备份。本要求覆盖早期计划中的“必须完整备份后执行”。仍在 `codex/temp-issue-2-icdb-recovery` 临时分支,未合并或发布。
## 检查结果与调整范围
| 操作 | 检查到的旧行为 | 当前调整 |
| --- | --- | --- |
| 新增 CBB | 每项复制整个中心库,即使没有旧同名工程 | 取消,记录只读内容基线 |
| 同名替换 | 每项复制整个中心库,再移除并导入 | 取消,保留逐项阶段及失败记录;失败时使用手动备份恢复 |
| 移除 | 每项复制整个中心库 | 取消,原生移除后重新读库确认缺失 |
| 普通校验 | 本地工程辅助备份,网络路径跳过 | 统一取消,记录 `manual_backup_policy` |
| ICDB 修复 | 应用复制完整工程,原生工具另外备份 | 取消应用复制,保留独占访问、原生自身备份及成功证据要求 |
| 从备份恢复 | 整库回退备份,再从中复制验证库;额外保留来源副本 | 去掉回退备份和重复来源副本,直接生成一份隔离验证库 |
| 读取、搜索、筛选 | 无自动备份 | 保持只读 |
## 仍需生成的数据
- 新增/替换的来源暂存及原生内容导出副本:防止原生工具直接改写用户提供的源工程。
- 恢复的隔离验证库:用于在安装前完成实际校验,会占用磁盘并花费复制时间,不能等同于未经修改的整库备份。
- 恢复安装时保留旧 Work:仅同卷目录改名,不复制数据,用于安装失败时还原目录交换。
- 工程库引用修正前的单个 PRJ 原文、日志、清单及检查点:属于轻量变更证据,不是工程或中心库备份。
- Mentor 原生 Repair 自身生成的备份:属于原生修复流程,应用没有绕过。
独立研究探针中显式创建的实验备份及现存历史备份未删除。桌面生产路径不再触发上述旧的自动工程/整库备份辅助函数。
## 用户交互和约束
管理操作沿用原确认窗口,增加“应用不会自动备份,请先手动备份中心库及相关工程”。普通校验、维护、恢复同样在启动前提示;每批一次,取消不启动后台任务。应用不检查也不声称用户已经创建了手动备份。
取消备份不会取消串行任务、库锁、数据库独占检查、目标变更检查、来源身份核对、重新读库验证或未完成任务检查点。替换仍是移除后重新导入,非原子操作;部分失败必须使用手动备份及检查点恢复,不自动重放。
直接 ICDB Repair 的现场完整验收缺口仍保留,本次备份策略调整不代表该故障已解决。
## 隔离原生验证
在既有独立实验库 `diagnostics/reimport-8212/native-add/fixture/mentor_lib.lmc` 通过正式管理引擎实测:
- 原生移除 `1GPHY_8212` 后复读确认缺失,结果 `REMOVED`,安全释放,耗时 39.391 秒。
- 随后原生重新导入同一独立来源,复读名称/分区、原生逻辑导出及主要资产身份确认通过,结果 `UPLOADED`,安全释放,耗时 101.359 秒。
- 两项操作均没有生成 `library-before` 整库备份,来源主要文件清单未变。测试未启用自动校验,不将上传成功解释为 READY。
证据:`diagnostics/manual-backup-20261103/native-cycle-result.json`、`native-cycle-accepted.json` 和 `diagnostics/mb-events/`。上述耗时包含原生启动、复读和内容检查,不能当作与旧版同环境对照的提速比例。
开始实测前发现上一版应用在完整隔离库 IP101GR 上保留了“继续以读写方式打开”提示。仅向已核对进程命令和私有桌面的该提示发送“否”,两个 PCB 进程正常退出;没有强杀、保存或删除原生地址。原失败证据与取消记录保留在 `previous-test-cancel.json`。随后通过正式释放检查解除小实验库旧阻止记录,未绕过库锁。
## 代码验证
最终全量 Python 回归:**1111 passed,192.49 秒**,一条已有 pywinauto STA COM 线程模式警告。集中回归 297 项通过;占用检查修订后相关 151 项通过。编译及 diff 检查通过,独立复审无剩余实质问题。
审查发现取消整库复制时一并丢失了全库数据库独占检查,已改为不复制数据的 `build_exclusive_library_manifest`:记录基线和写入前检查均同时持有所有 `.lmc` / `icdb.dat` 的独占读取句柄。回归覆盖主库、共享库、其他 CBB 数据库仍被共享读取句柄占用的情况,确认未进入原生写入。
候选包从提交归档构建。最终冻结程序手动备份提示及取消测试记录位于 `diagnostics/manual-backup-20261103/frozen-prompts/result.json`,构建和交付信息保存在同一证据目录。
+77
View File
@@ -0,0 +1,77 @@
# 原生 CBB 增删改查接入与候选包验证
程序源码提交:`b26e2f2f6232c22a94ee1269bd4449fe0fe06623`。
分支:`codex/temp-issue-2-icdb-recovery`。本地候选包,未合并、未发布、未关闭工单。
## 已接入的操作
| 操作 | 原生入口与验收条件 |
| --- | --- |
| 读取 | `LibraryManager.Application.OpenLibrary`、`Partitions(7)`;核对库身份、分区和条目,正常关闭会话。 |
| 新增 CBB | `OnReusableBlocksEditor` → Logical-Physical → New;私有桌面 UIA 和有时限的控件消息提交完整 PRJ,确认成功提示后关闭重开库,再核对工程内容。重名拒绝覆盖。 |
| 用工程替换已选 CBB | 完整工程及中心库备份 → 原生移除 → 原生重新导入 → 重新读库和内容核对。失败保留恢复证据并停止后续写操作。 |
| 移除已选 | 安装脚本确认的 `CleanWGLib.exe <lmc> F4 <list>`,输入为 `REUSE_BLOCK`;先完整备份,要求明确 Removed 输出,再重新读库确认不存在。 |
“用工程替换已选 CBB…(原生重新导入)”与已有“从备份恢复 CBB…”是不同操作。前者更新中心库注册条目,采用移除后重新导入,**不是原子替换**;后者沿用备份 Work 的副本验证与安装恢复流程。
新增和替换默认继续自动校验,允许批次开始前取消。结果分别显示上传失败、上传成功但校验失败、上传并校验通过;取消自动校验时明确显示“已上传 / 未自动校验”。
## 支持范围与保护
- 已验证本机 Mentor EE7.9.5、DxDesigner、Logical-Physical、ASCII CBB 名称。原生核心组件和三种内容导出程序均核对固定 SHA-256;接口或版本不符时禁用并显示原因。
- 所有写操作使用串行任务、共享互斥和上传工具兼容的库锁;暂存来源、完整备份、目标身份、事务随机标识、监督进程及实际独占句柄必须相互匹配。
- 不直接修改 LMC 二进制,不依赖独立上传工具安装目录,不退回前台鼠标。遇到中心库升级或流程选择提示拒绝自动迁移。
- 原生导入会改写 ICDB 存储字节。内容身份采用官方 ASCII、CSV 和 EDIF 原理图导出,加上 Layout、约束及其他主要资产的 SHA-256。只规范化已实测的报告时间和路径字段;未知工程文件继续参与比较。
- 原生复制可能留下不正确的 PCB 库相对引用。仅在本任务导入、会话释放及库锁持有得到确认后校正已导入副本,再复读目录与内容。原始来源不改写。
- 导出副本所有权随库检查点持久保存;超时、重启、地址记录仍存在或进程、独占访问无法确认时,不能解除库锁或接续维护。
- 完整来源和预计目标路径达到 260 个 UTF-16 单元时,在原生写入前拒绝;同名替换在移除旧条目前检查。保留所有文件,提示缩短操作数据或目标库路径,不宣称已实现原生长路径支持。
- 本轮已确认的原生复制失败即时记录。只正常确认本任务进程的已验证错误对话框;未知提示不自动点击,会话释放不明确时保留阻止状态。
## 实际验证
环境:Windows 11,版本 `10.0.26200`;Mentor EE7.9.5。
### 原生完整管理引擎
真实新建隔离库完成:新增 A、拒绝重复名称、替换为 B、备份后移除、将独立备份工程重新导入。各项会话均安全释放。B 的 Layout 哈希与 A 不同,并与来源 B 一致。原始来源主要文件清单未变。
证据:`diagnostics/issue2-native-crud-20261103/engine-e2e/cycle-result.json`。
### 最终冻结程序公开界面
从应用真实按钮、来源文件选择器和确认清单执行,没有替换原生适配器或绕过能力检查。
| 试验 | 结果 |
| --- | --- |
| 275 字符暂存路径 | `UPLOAD_FAILED`,明确 `NATIVE_PATH_TOO_LONG`,`safe_to_continue=true`;未启动内容导出或原生 Add。 |
| 正常路径新增 A | `UPLOADED`,重新读库与工程内容核对通过。 |
| 同名替换为 B | `UPLOADED`,实际 Layout 匹配 B 且不同于 A。 |
| 原生移除 | `REMOVED`,重新读库确认不存在。 |
| 最终退出与来源检查 | 原生进程已退出;两份来源的 153/147 个主要文件哈希及 541/506 个文件的大小、修改时间保持一致。 |
证据位于 `diagnostics/issue2-native-crud-20261103/`:
- `frozen-public-ui-path-block/result.json`:写入前长路径拒绝。
- `frozen-public-ui/result.json`:最终冻结程序完整按钮流程及截图。
- `final-source-baselines.json`、`final-acceptance.json`:来源和会话释放证据。
- `build-result.json`、`validation.json`、`package-result.json`:源码、测试、构建和包校验记录。
本轮 CRUD 原生及冻结界面试验均在批次开始前取消自动校验,**上传成功不等于 READY**。这些结果不能代替上传后完整 Verify/Save/Close 或现场 ICDB 失联修复验收。
### 实测发现并修正的长路径问题
初版冻结程序在 264 字符暂存文件路径下弹出“系统找不到指定的路径”,日志记录 `Cannot copy iCDB base of Reusable Block project`,旧逻辑只检查成功提示,直到超时才返回。该失败未计入通过。
对同一文件,旧式 32 位 Win32 CopyFile 复现错误码 3;保持同一冻结程序、测试库、完整来源和空描述,仅缩短暂存路径后,原生新增和内容核对通过。最终修订增加完整路径预检和本轮失败识别,并在新冻结包实测提前拒绝。没有删减长路径中的日志或其他文件来绕过问题。
保留原始失败、正常关闭及库锁重新核验记录:`frozen-public-ui-longpath-failed/`、`longpath-failure-release/`、`longpath-failure-catalog/`、`path-copy-probe/`、`frozen-public-ui-shortpath-control/`。
## 自动化验证与交付
- 全量 `python -m pytest -q`:**1071 passed**,90.98 秒,1 条已有 pywinauto COM 线程模式警告。
- `python -m compileall -q src tests`、`git diff --check`:通过。
- 独立整体代码审查及长路径修订复审:无未解决的实质问题。
- 从提交归档构建冻结程序,启动与退出冒烟测试通过;上述公开界面验收使用同一构建。
- 候选包:`dist/issue2-native-crud-20261103-b26e2f2.zip`,旁附 SHA-256;包内含使用说明及验证摘要。
尚未完成 Windows 10 实机验证,也未将本轮 CRUD 试验视作现场服务器会话失联修复通过。旧版库迁移、其他 Mentor 版本、非 Logical-Physical 分区及原生长路径支持不在已验证范围。原用户库不参与本轮写入试验。
@@ -0,0 +1,24 @@
# ICDB 失败后的副本恢复入口
原生修复失败、缺少有效备份,或 Repair 后完整校验失败时,结果窗口提供“选择副本恢复…”;主窗口保留“选择工程副本恢复失败项…”,允许关闭结果窗口后继续。单纯占用、未知诊断、仅检查或成功结果不提示替换。
入口固定使用本次失败任务的库、名称和分区,不使用用户后来勾选的其他条目。切换中心库使旧入口失效。选择的是库外完整工程的 PRJ 文件,相关 PCB、数据库和依赖资料仍由现有来源检查验证。
点击入口只打开来源选择窗口。用户明确确认手动备份、目标库、目标条目及副本后,才在后台检查释放,并复用现有原生移除/导入流程;不自动备份整个库,不自动删除目录代替原生操作。自动校验默认开启。
释放检查继续要求原生所有者退出、数据库地址记录处理完毕及独占可读。WMI 查询通过最多 10 秒的只读助手执行,超时不当作空闲;同时检查脚本与校验/修复工作进程。检查不通过显示具体原因、保留阻止记录和恢复入口。未完成的管理写入仍不自动重放。
原维护失败记录保持原样。副本恢复建立独立 `reimport-recovery/*/recovery.json`,关联原证据、来源、释放检查和管理结果。上传成功但校验失败继续显示失败;上传并取得 READY 后显示“副本恢复校验通过,版本待核对”,不改称原 ICDB 无损修复成功。
按用户要求精简界面:默认只展示目标、副本选择、备份确认和操作结果。开发流程说明已移除,诊断细节和证据路径放入默认收起的日志。恢复执行前仍明确说明先移除原条目再导入副本。
## 验收边界
- 核心流程专项测试 57 项通过;随后新增的两项主窗口取消/退出复核回归均先复现失败再通过。
- 完整回归记录为 **1,194 passed / 1 failed**(1,013.66 秒)。该运行启动后用户要求精简 UI,已收集的测试仍断言旧文案“尚未修复成功”,运行时加载的界面已使用“修复未完成”,因此失败。未把该次结果标成全量通过。
- 最终界面与更新后的测试重新验证 **77 passed**(43.00 秒),包含该失败用例及新增的日志默认收起检查。其余产品逻辑未在此期间修改。
- 编译、差异检查、独立审查通过。最终冻结构建及启动/正常退出、占用辅助进程冒烟通过,EXE 内 5 个关键模块与当前源码一致。记录在 `diagnostics/copy-reimport-20261104/`。
本次验证覆盖 Qt 真实事件循环中的按钮、取消、来源确认、后台等待及故障分支,原生写入边界使用替身,不把这些测试当作 Mentor 修复验收。
既有隔离副本仍有 `IP101GR/Work/database/cdbsvr/sAddress.adr`,因此完整库释放条件目前不满足。该情况不能通过忽略地址或强制清除检查点解决,需要先处理对应工程。此前 `1GPHY_8212` 的原始 Repair 后 BackAnnotate 失败结论保持不变,工单未关闭。
@@ -0,0 +1,29 @@
# ICDB 维护审查修正(候选)
替代 `8180a8a` 的诊断实现。该旧候选曾把完整校验当作诊断,且存在缺失证据后直接进入 Repair 的分支,不应继续用于原库。
## 行为
- READY 始终不进入维护或默认备份恢复队列,即使被勾选。混合选择只处理可见的、可用的非 READY 项;全部 READY 时没有可执行目标,不回退到处理 READY。
- 先取得上传工具兼容的库锁,验证检查点、工程身份、进程和数据库独占访问,再启动诊断。
- 独立的 `diagnostic_only` 模式只打开并确认目标,随后通过原生 `Close(False)` 关闭。不执行 Project Integration、保存、原生 LM Verify 菜单、工程库路径改写或 READY 校验。Mentor 启动本身仍可能生成运行日志/地址记录,因此不宣称整个原生过程绝对只读。
- 诊断拒绝配置中指向其他中心库的引用,包含缩进/制表符格式。不会为了检查而改写引用。
- 原生关闭助手最多调用一次。关闭返回后最多观察 30 秒的进程/地址释放;超时保留现场并停止。
- Repair 只接受本次独立证据目录中的结构化 `ICDB_REPAIR_REQUIRED` 记录,要求工程级范围、会话身份和精确匹配的数据库路径。修复前再次确认目标及释放状态。
- 删除通过 Python 函数名、模块名判断可信度的逻辑,以及吞掉断言/pytest 失败后直接修复的分支。缺少证据、通用数据库安全错误、其他工程或历史轮次证据均不能授权 Repair。
- 诊断通过在报告中单列“启动检查通过、未修复”,不冒充修复完成或 READY。只有修复后完整校验取得权威 GREEN/READY 才算修复验证通过;历史恢复仍需核对版本。
## 验证范围
- 最终从 `ef652f3` 导出的固定源码运行完整回归:`python -X utf8 -m pytest -q --tb=short`,**1,151 passed,375.48 秒**;仅既有 pywinauto STA 警告。
- 此前的专项覆盖包括库锁、证据缺失/其他工程/历史轮次、无集成保存、关闭失败、路径格式、READY 选择范围和延迟退出。最终源码副本与构建输入哈希已核对。
- `compileall` 与 `git diff --check` 通过。
- 独立审查发现并修正重复关闭和路径格式遗漏;冻结构建和启动结果另存于 `diagnostics/icdb-review-20261104/`。
- 冻结启动/退出检查返回 0;EXE 内 5 个变更模块与固定源码编译结果一致;ZIP CRC 校验通过。
- 最终候选:`dist/issue2-icdb-reviewed-ef652f3.zip`,50,871,172 字节;SHA-256:`f4565f1696caf620522d621bd8555817a6d7d5d6ed4193cf87f2b53758a5d8c7`。构建和测试证据对应代码提交 `ef652f3ada0b9b8422e49f2ebc5b18305204d8ab`。
## 保留的限制
本轮不在原库执行原生操作,未重新完成现场失联故障的端到端验收。仅有 `sAddress.adr`、历史版本选择提示或一般数据库错误不足以认定 ICDB 损坏;这些情况会停止并保留证据,不自动 Repair。若原生启动后会话未释放,也不会继续修复或处理下一项。
本候选不推送、不合并发布、不关闭工单。测试中的模拟边界用于验证队列和安全条件,不代替现场 Mentor 验收。
@@ -0,0 +1,52 @@
# 原生占用检查候选:完整修复验收失败
本记录更新此前 `2026-11-04-icdb-review-fixes.md` 的维护入口说明。工单 #2 保持未解决;本候选不合并、不发布正式版、不关闭工单。
## 本轮改动
- 维护入口先调用原生 iCDB Project Backup 的工程加载/占用检查,不先打开 PCB。旧 `sAddress.adr` 只是待核实证据,不再单凭它阻断检查,也不删除或改写该文件。
- 仅本轮 Output 明确绑定目标工程、目标数据库,确认未占用且要求 Repair,原生检查正常退出,并再次通过工程身份和占用检查,才调用一次 Repair。其他工程、共享库、未知错误或未释放会话均阻止后续操作。
- WMI 占用查询在独立只读辅助进程执行,最多 10 秒;超时是未知,不是空闲。文件扫描在后台运行并支持取消。原生准备阶段预算 60 秒,另加原生操作超时及 5 秒监督余量;取消后再次核对,避免迟到启动。
- 停止请求传入维护流程,原生写入不强杀;释放未确认时停止后续批次。仅检查结果使用 `CHECKED`,不计入修复成功。READY 即使已勾选也不进入维护。
- 精确的 verified/once-verified Reusable Block BackAnnotate 拒绝归类为 `CBB_REIMPORT_REQUIRED`,不再被后续释放告警掩盖。该分类不会执行重导入,也不改变 `safe_to_continue`;原生错误及释放错误都保留在报告中。
- 历史版本选择继续通过应用弹窗;只有完整校验及权威 READY 通过才允许成功。历史恢复仍标记版本待核对。
## 隔离环境实测
证据根目录:`diagnostics/native-occupancy-20261104/`(含本机路径和原生日志,不纳入 Git)。测试通过实际应用维护按钮和版本选择弹窗完成,没有以手工分阶段调用替代验收。
一致副本包含 38,954 个文件、1,220,129,120 字节。复制期间源文件集合/大小/修改时间一致,253 个主要文件 SHA-256 核对通过;追加目标 PRJ/PCB 后,最终再次核对原库的 255 个已记录文件,全部未变化。原库未执行写操作。
最终尝试 `source-ui-fourth`,目标 `1GPHY_8212`:
1. 原生检查明确返回未占用,并指出当前数据库不一致、要求 Repair。
2. 原生 Repair 创建自身备份,完成数据库检查、整理和关闭,返回 `Project should now be fixed.`,并确认退出释放。
3. 应用弹窗选择用户已授权的最后手动保存版本(2026/9/24 15:15),重新打开同一工程。
4. SynchCES、LoadCES 通过;BackAnnotation 为 Required,实际调用被 Mentor 拒绝:`Back Annotation is not allowed on verified (or once verified) Reusable Blocks.`
5. 未完成保存与 READY 校验。最终 **FAIL / UNKNOWN / REPAIR_VALIDATION_FAILED**,`validation_passed=false`、`safe_to_continue=false`。原生 Repair 完成不等于整体修复成功。
6. 失败关闭助手记录 Close/Quit 成功,但最终释放检查仍看到 PID 21968,因此保留检查点并停止批次。后续只读复查该原生进程已消失;这不追溯修改原失败结果。测试应用关闭结果对话框后正常退出。
实测界面响应记录:614 次 WM_NULL 检查,200 毫秒超时 0 次,最大约 78 毫秒。这只证明本次运行的界面响应,不保证任意网络故障下所有系统调用可立即取消。
关键证据:
- `source-ui-fourth/acceptance.json`:`accepted=false`。
- `source-ui-fourth/evidence/maintenance-43479c21aa59/result.json`:完整维护结果。
- `source-ui-fourth/evidence/maintenance-43479c21aa59/native-repair/repair-result.json`:原生 Repair 证据。
- `source-ui-fourth/evidence/verify-99a675e0399c/`:重新打开、集成拒绝、正常关闭及释放未确认记录。
- `source-ui-fourth/ui-responsiveness.json`、`version-choice.png`、`finished.png`。
- `source-final-check.json`:原库 255 个哈希均保持不变。
## 代码与冻结候选验证
- `python -X utf8 -m pytest -q --tb=short`:**1,176 passed**,302.56 秒;1 条既有 pywinauto STA 警告。
- `compileall`、`git diff --check`、独立只读代码审查通过。
- PyInstaller 构建通过;冻结程序创建主窗口及正常退出通过,新 `--owner-probe` 在冻结程序中返回有效结果。
- EXE 内 11 个变更模块与当前源码编译结果一致。验证脚本及结果在证据根目录的 `check_candidate.py`、`frozen-result.json`。
- 本地候选目录:`dist/issue2-native-occupancy-candidate/`。冻结包完整故障修复链路未执行,不能称为已验收的修复包。
## 尚未解决
已验证或曾验证的 CBB 注册状态限制仍阻止 BackAnnotate。不能跳过 Required 操作、强行设置 READY 或把移除/重导入偷偷加入 ICDB Repair。此前隔离试验的独立重导入路径见 `2026-11-03-field-feedback.md`,其行为涉及库条目更新,不能据此宣称本次无损修复通过。
本轮没有完成 Windows 10/11 双系统验收;冻结包的完整现场故障链路仍需验证。程序测试和启动冒烟均不能代替上述失败的实际验收。
@@ -0,0 +1,45 @@
# 三页界面与原生检查、退出修正
界面按“检验 / ICDB 维护 / 中心库管理”横向切换,共用中心库、清单、搜索和选择状态。默认收起运行日志,长状态信息限制高度,避免纵向堆叠操作区或报错撑长窗口。1000×620 布局预览保存在本轮诊断目录中。
## 本轮现场日志定位
用户运行的是 `29959e2` 冻结包。2026-11-04 14:21(北京时间)的维护在原生检查启动后报 `(2, 'EnumWindows', '系统找不到指定的文件。')`,并没有调用 Repair。随后手动释放检查发现 `1GPHY_8212`、`IP101GR` 的地址记录仍存在;它们不能直接当作已释放或直接删除。第二次在准备检查时取消,助手没有及时结束文件扫描。
## 修正
- 在实际空私有桌面复现了 Win32 旧错误码问题:先 `SetLastError(2)` 再枚举空桌面,pywin32 会报与现场相同的错误。现在枚举前清零旧错误;真实枚举异常继续上报,不把未知错误当作空闲。
- 将取消信号传入修复助手的文件扫描。文件标记最多每 100 毫秒读取一次,取消后锁存;原生启动、Repair 命令和确认前仍立即读取取消信号。冻结实测曾因逐文件读取取消标记而在启动前超时,节流后已推进至实际原生检查和 Repair。
- 手动备份模式下,助手只在启动前执行一次完整目标保护,移除原先自动备份取消后留下的重复检查。同一保护内复用初始完整扫描作地址和文件选择,取得全部独占读句柄后再做第二次完整扫描;地址变化或原生文件集合增删均停止。没有复用跨操作的旧快照。
- 发出唯一正常关闭请求前仍严格确认任务进程、工程、私有桌面、空闲窗口和地址状态。关闭后只等待进程、启动器及地址释放,不再因退出途中 WMI 暂时缺少命令行而提前报身份未确认,也不再次关闭窗口。未实际退出仍保留未释放状态。
## 已有验证记录
本轮证据目录为 `diagnostics/tabs-release-20261104/`,含本机路径,不提交原始数据。
- 初轮完整回归 1,200 项通过,2 项旧测试替身未接收取消参数;同步接口后维护模块 48 项通过。
- 扫描优化后的维护、原生修复等相关测试 225 项通过;随后退出等待等 91 项通过。包含实际私有桌面的 Win32 回归,而不只是窗口模拟。
- 冻结程序取消试验 `frozen-cancel-local`:预检查中取消约 0.61 秒返回,未启动原生 Repair,应用正常退出。
- 源码实际入口 `source-optimized`:原生确认未占用并要求修复,Repair 成功,按用户授权恢复最后手动保存版本;最终因 verified/once-verified CBB 禁止 BackAnnotate 失败。PCB 正常关闭,没有附加 PCB 释放未确认错误。
- 冻结实际入口 `frozen-polling`:原生检查及 Repair 已完成,取消标记只读取 214 次、耗时 0.313 秒。随后 PCB 因数据库服务器启动晚于客户端截止时间而加载失败。服务器日志显示它后来实际启动并自行关闭,不据此宣称完整修复通过。
- 同一次失败退出中,先记录了 `startup_close_requested`,随后 WMI 缺少进程信息导致 `STARTUP_PROCESS_UNCONFIRMED`,下一秒却已确认进程退出;该具体时序已转为回归测试。
最终完整回归:**1,207 passed**,588.26 秒,仅既有 pywinauto STA 警告;记录在 `pytest-final.log` / `pytest-final-result.json`。最终冻结构建、启动退出冒烟和 6 个关键模块的源码一致性检查通过。独立审查未发现剩余必要缺陷。
最终冻结实际入口为 `frozen-local-final`,使用 `C:\Temp\CbbTabsRelease20261104\library` 的独立副本:原生 `NOT_IN_USE` 且明确要求修复 → Repair 完成并释放 → 重新打开同一 PCB → 用户已授权的最后手动保存版本(2026/9/24 15:15)→ SynchCES / LoadCES → BackAnnotate 被原生拒绝。最终 **FAIL / UNKNOWN / REPAIR_VALIDATION_FAILED**,未取得 READY;退出记录确认进程结束,没有附加 `PCB_RELEASE_UNCONFIRMED`。应用正常退出返回 0。此前服务器迟启动的失败记录保留,不能从一次对照断定其全部成因。
原库 255 个已记录主要文件哈希复核全部未变,见 `source-final-check.json`。
最终包的 `frozen-cancel-final` 再次验证取消:约 1.16 秒返回,检查助手报告 `CANCELLED`,批次保持 `BLOCKED`,未启动 Repair,应用正常退出。取消只证明操作已停止,不计作修复成功。
## 验收限制
原库未执行本轮自动化写入。第一套 F 盘测试副本出现目录枚举属性与直接读取属性不一致,被链接检查阻止,未绕过检查。测试随后迁移到独立本机目录;`C:\Users` 目录会被 Mentor 转成共享路径,因此最终试验选择独立的 `C:\Temp` 路径,并保留前序失败记录。
完整 ICDB 修复仍必须取得权威 READY;原生 Repair 成功、能够取消、正常关闭或界面测试通过都不能替代该验收。未合并发布,工单保持未解决。
## 结果展示收尾
实际冻结运行截图还暴露了结果弹窗包含长路径和 COM 异常、错误列挤压 CBB 名称的问题。结果正文改为简短计数、用户可理解的失败原因和副本恢复入口;原始异常、统计明细及日志路径保留在可展开详情和日志中。名称与结果列共同分配可用宽度,长内容不再把表格撑出窗口。历史备份待核对和待选 PCB 版本仍直接提示。
该收尾只调整展示,不改变占用检查、关闭、Repair、校验或恢复行为。以已保存的真实失败结果回放检查布局,未额外写入原生库。相关界面、筛选和副本恢复回归 84 项通过;记录为 `pytest-presentation.log` / `pytest-presentation-result.json`。原先完整回归 1,207 项及冻结原生流程的失败结论仍分别保留,不能把展示回放当作新增原生验收。
@@ -0,0 +1,90 @@
{
"review_comment": "https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/3#issuecomment-249",
"version": "0.2.4b1",
"base_main": "a56fd17b60d9f67997d7f48c862f3367d4502f84",
"tests": {
"infrastructure": {
"tests": 491,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_sha256": "12c2cd40542cb01d4fa374e98908c8a77a8deb83f95d0833645b1666ea5574e9",
"xml_file": "codex-review-infrastructure-pytest.xml",
"seconds": 52.986
},
"native_backend": {
"tests": 1376,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_sha256": "8db65d11dd918d2a1b141d72627654a990ea903b68e20511e982dfb927d6be58",
"xml_file": "codex-review-native-backend-pytest.xml",
"seconds": 275.957
},
"ui_integration": {
"tests": 1545,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_sha256": "5a3e6d58d611240c6e34cc9bd2350a8bf605516ef453240333836c1f88233af6",
"xml_file": "codex-review-ui-integration-pytest.xml",
"seconds": 325.065
},
"final_stack": {
"tests": 1601,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_sha256": "bab74328facfbf512416b62a074fb5cb65ea39b04f0039d42083f96b5349c351",
"xml_file": "codex-review-residual-release-pytest.xml",
"seconds": 246.75
},
"umbrella": {
"tests": 1601,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_sha256": "566f50b4ba537d4e54939946a5b48cad9ed6dbd8fb69c5ffbabcc5da0fbaf507",
"xml_file": "r10-pr-pytest.xml",
"seconds": 313.479
},
"force_boundary": {
"tests": 43,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_sha256": "832425306b5fea3a150cc2188e00c97a771bb6d953e54b69c091d36e8062dca9",
"xml_file": "pr249-force-focused.xml",
"seconds": 3.231
}
},
"compileall": "passed",
"git_diff_check": "passed",
"final_content": {
"file_count": 195,
"sha256": "2784b81ff0ae4d47f85ac8ea4b217292bbd9a1e716667e729863bfd4a6a372cd",
"umbrella_equals_stack": true
},
"post_test_formatting": "MainWindow line endings aligned with UI review base (AST equality asserted); unchanged README lines retain main line endings",
"regression_red": {
"baseline": "e4266ae",
"selected_new_ownership_tests": 3,
"expected_failures": 3,
"method": "in-memory baseline module; no production files or native processes modified"
},
"force_contract": {
"clients_only": true,
"same_user_sid_and_windows_session": true,
"servers_never_terminated": true,
"durable_consent_before_action": true,
"independent_library_release_proof_required": true
},
"not_validated": [
"field server-session loss recovery",
"Windows 10",
"cross-machine shared-library concurrency",
"actual Mentor force termination",
"new frozen package"
],
"delivery_policy": "Draft review only; no merge, publish, automatic issue closure or native production-library operation"
}
@@ -0,0 +1,127 @@
{
"candidate": "r10",
"candidate_base_commit": "1acfbd637452e8f64d96981044194661dfb4ec1b",
"python_full_suite": {
"name": "pytest",
"errors": "0",
"failures": "0",
"skipped": "0",
"tests": "1574",
"time": "207.493",
"timestamp": "2026-11-05T21:09:55.032807+08:00",
"hostname": "Abs"
},
"frozen_modules_and_scripts_compared": 37,
"native_check_statuses": [
"FAIL / ICDB_REPAIR_REQUIRED / released",
"CHECKED / released"
],
"native_check_seconds": [
68.563,
26.812
],
"foreign_same_desktop_modals_untouched": true,
"source_primary_files_unchanged": true,
"gui_native_queue_order": [
"check-start",
"check-end",
"status-start",
"status-end"
],
"gui_cached_filter_available": true,
"gui_max_timer_gap_seconds": 0.079,
"automatic_icdb_repair_acceptance": false,
"field_server_session_loss_acceptance": false,
"tested_environment": "Windows 11 / Mentor EE7.9.5",
"candidate_code_sha256": {
"src\\cbb_refresh_verify\\application.py": "babeefe4ddc2fb78b4af3a0413f60cb351eeca57f6f2862e2bc1b8a94de59f32",
"src\\cbb_refresh_verify\\backup_recovery.py": "ea7bb90151e825efb6163e43ed344b62407565005f0a0459c423ba2205539373",
"src\\cbb_refresh_verify\\batch_status.py": "918c80dd4f75146baa6b7616ce415ac89ee28f6c1f46b2bfda77bacc998b5b62",
"src\\cbb_refresh_verify\\close_failed_block.vbs": "e5f0d9678e07a239e96e634b90cdc761de52fc136311fae31484fa38d6fd9781",
"src\\cbb_refresh_verify\\com_runtime.py": "f0f3802d16c791a8bf9dfef44a94917072bfbe8fb3a927d76be8ef0341c7ed35",
"src\\cbb_refresh_verify\\content_check.py": "8239c17b6e2452917ed573a7deb3e4c8583eaef91bf3630eff5f424d2e398aa9",
"src\\cbb_refresh_verify\\defaults.py": "19aaec03822468b18099f358a5aac3433346ff81345b58a896545bf508840e3d",
"src\\cbb_refresh_verify\\desktop_worker.py": "3b79dcab16b67b68550957c09c9de1ba08d85109356274c8cff4d0ae02dec3fb",
"src\\cbb_refresh_verify\\diagnostic_open.py": "d6c49ffe5a9969d95edbbc896d47a7e100f248380a287f99ba7bb8b92dbb3072",
"src\\cbb_refresh_verify\\dialog_agent.py": "6a9b9802912afc4dd670ee9b28845d97bd64fe55fd577815ef729850fcff78db",
"src\\cbb_refresh_verify\\dialog_models.py": "f68cee01d927b48364276d3c1f79e63ce8af231878db0b907d292780cfbafb56",
"src\\cbb_refresh_verify\\dialog_probe.py": "d61f0c955c961980c9635940eefb9c7947c1fe90b4b6fd844720df41ddb0aa0e",
"src\\cbb_refresh_verify\\dialog_rules.py": "3189b476f7ff4678b59212ed7b4081164e038a7cf7662cd895f9019cb3c1edc5",
"src\\cbb_refresh_verify\\dialog_supervisor.py": "15c415c2d2e916f0b64ba04416164ff3b50996d70b22d3b4ac2226b5547ac247",
"src\\cbb_refresh_verify\\failed_session.py": "7e6f7fa5ebcf2d49f00c5efc5f5d26412704b68e9122e476ac1f672009a98c09",
"src\\cbb_refresh_verify\\icdb_maintenance.py": "6ab1d469b09e92641ff60a4b6acd4cc13d40cc200a6fae880e864181526994c4",
"src\\cbb_refresh_verify\\icdb_ownership.py": "7bf2342c1efa34a2ebcbf27964a40a490220f7146fbb6ef957b8d8dd1e511f03",
"src\\cbb_refresh_verify\\icdb_recovery.py": "358c0e9a004f1e0b2127513286e1dffd94b0180a8b7314aa9655462f570b6360",
"src\\cbb_refresh_verify\\integration.py": "86669ad73ae1d2d724d406c3644bb0c297236a4ffdc4b66117930ec660613e88",
"src\\cbb_refresh_verify\\library_lock.py": "315b3cba411713aea870b0a773b3cb986be73b85b88732d8cd82862f22f650db",
"src\\cbb_refresh_verify\\library_manager_verify.py": "71e16a8581ad44b646be78b480f9812d596a6d162b3eec03d078bf4ea4503195",
"src\\cbb_refresh_verify\\library_reader.py": "47d58d1518ba7e69c22b41db2d34c0a61e2cc1362cf28414f0dae43d4a011753",
"src\\cbb_refresh_verify\\maintenance_entry.py": "3b93c25f69d7a961facd8004e20e155a84cc18f06d57b741a9055786ed058990",
"src\\cbb_refresh_verify\\management.py": "64e6fc1382092f1d2154052ec456b9c511934d3f2b231a163be28dca27eb3873",
"src\\cbb_refresh_verify\\management_transaction.py": "32c53caaead05d5db3a31d3e30721e65434e5837095dc0a7812f825603aa37a0",
"src\\cbb_refresh_verify\\mentor_adapter.py": "26a73074ef162d240c80747e371f357c8ec87b00cdbbd3509acc4ac58e68e955",
"src\\cbb_refresh_verify\\mentor_paths.py": "ba48c0003b3eacc88906497b2e43b299ca4536a9f7dae44bbacf6a6ec694c116",
"src\\cbb_refresh_verify\\models.py": "9e8209a8b006df923f1d07ccab64bbcfe5d674c4fc5f5426bfbc9b11da4ee105",
"src\\cbb_refresh_verify\\native_add_failures.py": "192202732423dc624c5548c75e80bb20973e5087c21d4798c9637f25b6de7e94",
"src\\cbb_refresh_verify\\native_backup.py": "7276fa3d9298e85550151cf0c7191d84bd08a18a72df5d854a3c38f1a88b001d",
"src\\cbb_refresh_verify\\native_engineering_identity.py": "a241bc3be7dc5a922ce728f1febd3684e79e6e45935589c80a4b1a5933e05df5",
"src\\cbb_refresh_verify\\native_export_guard.py": "5120c13e4ef1255d4c61316eb40005c4039c23e41edca4437bd0ef28b543a959",
"src\\cbb_refresh_verify\\native_management.py": "bdb42f0bbbc964e56cfe08f66804a03dfc73157eb98911531c9d4c8f940c7595",
"src\\cbb_refresh_verify\\native_occupancy.py": "7d686079d12217382adace6361cd343d977b91075e3b157cf410ca92d07ffc49",
"src\\cbb_refresh_verify\\native_repair.py": "65d3e5b28b1f375402b002f56527dafbcc79e21cea66822e3bc26332d59e76d7",
"src\\cbb_refresh_verify\\native_repair_ui.py": "3eb2af181befea94af8b3b3131edff09589f340bcba777abbe3b67fd31b80393",
"src\\cbb_refresh_verify\\network_path.py": "6b5b159502d42a46bf4ee26d5698fd2c6498b359088e2138eae46e9065b13c6f",
"src\\cbb_refresh_verify\\operation_queue.py": "57ad9da8aeedd9cd75a8c5b5fda44044bcb457670a4a323e9e8bb247198074ab",
"src\\cbb_refresh_verify\\owner_probe.py": "8dcfd60246cb2979db34d02e0a2d605c334b6f7e2666f22daa2f50c0408bc903",
"src\\cbb_refresh_verify\\pcb_bridge.py": "745ef117e984021e8a3d9087a2783c1efe19bed97edcfbcfae7703a291cc6eaa",
"src\\cbb_refresh_verify\\pcb_restore_prompt.py": "5342612ad666e3faf5a9a4ce4710e9af458d357c44037135f2837dad436d5cf7",
"src\\cbb_refresh_verify\\post_repair_consent.py": "3b1eaff1db58fd311a9dbc5fdcd850911b04cc5afd4e747f70a62b721b8fafa4",
"src\\cbb_refresh_verify\\post_verify_diagnostics.py": "2442de485bc0d6a34c4b2d9b10bc5f323ea38f9ff66674119a50f5c6043bac63",
"src\\cbb_refresh_verify\\reimport_recovery.py": "66b2ba8f8c2ec9ae8c386d6b1aa74a1fbb6bfb509c4df0a262f8d7a0ca48469e",
"src\\cbb_refresh_verify\\residual_sessions.py": "5fa8a0f87d6aa4c7e0dec4ab8eb1d649d20fdbea35016fbd65fefefd42607eef",
"src\\cbb_refresh_verify\\runtime_logging.py": "44ac25430a89c5ffc9e48e88c227e88052f4c815365e8556f67918f3edaba39e",
"src\\cbb_refresh_verify\\runtime_timing.py": "c4ed4057b5000e0b86ccc7dd1fe2004d6e0dae29f397fec77b01ad41a81c6367",
"src\\cbb_refresh_verify\\save_verified_block.vbs": "2ede0a1297e44533cd6333b775cdd70c86b5f2aaaaa18ccd6df158379ef1fd31",
"src\\cbb_refresh_verify\\scoped_manifest.py": "54cf4288e7850e220b394ae971ea98785eba631f80784a3f9354209e649f6498",
"src\\cbb_refresh_verify\\status_bridge.py": "05d627d02934a14f5de409472c291d37565a95b836f9c130111aae80612e9196",
"src\\cbb_refresh_verify\\verify_diagnostics.py": "041b77d7d49e4c86338ed5e5741d0d27a2c42bc358f4da54b3efe64af847e9b8",
"src\\cbb_refresh_verify\\verify_probe.py": "3ed743df49d195c74f5045985ab23491d103ee2c42c07b558c1e037176402ed2",
"src\\cbb_refresh_verify\\verify_runner.py": "bb5bae2616e3440a6adc083a2a6941176205f574fde077cf89a6121077833fed",
"src\\cbb_refresh_verify\\__init__.py": "be4027b9b6c4659a7f7d499a14f75ec84c410bd9a706d9ffd9f97d44a52b3806",
"src\\cbb_refresh_verify\\__main__.py": "dc4be034a0e43d4b659a9300137c29a6a6b7a32b7eaef02b6dff9a88c41305c0",
"src\\cbb_refresh_verify\\assets\\dialog_rules.v1.json": "3911080fc799a819662e225a7ad73e883abd8dcc9936cc30ec1b2d6d51a03c6e",
"src\\cbb_refresh_verify\\ui\\backup_notice.py": "1a3fa5ac18a267907faf95f36d61b9f08bcbb939eef4d480dd06af1391a81599",
"src\\cbb_refresh_verify\\ui\\backup_recovery_dialog.py": "621ea2efea85367b0c9bb9790040860a1ac001f40f8834289cb67c96ea0648d1",
"src\\cbb_refresh_verify\\ui\\icdb_check_task.py": "03e6416ee3d2fa11ecedb624a558516eeb56e634f1f22e41e57e10db6a13d656",
"src\\cbb_refresh_verify\\ui\\main_window.py": "4526f59b7f26374ff119d45453b278780a51ef7632eb1611c4e06a205cd30795",
"src\\cbb_refresh_verify\\ui\\management_dialog.py": "27d920284e508f19fae71b04a3b3d81a251559d52c4cc8d691c41186686572b7",
"src\\cbb_refresh_verify\\ui\\pcb_restore_dialog.py": "b7228d828df235ac51502dc68760d28c4896af02c780e9806e11c32dba7f62da",
"src\\cbb_refresh_verify\\ui\\residual_release_dialog.py": "515aaa236ad6a0bee9e5383c6c9d093baeb8bc7dc98f1b978b1197ce672c6764",
"src\\cbb_refresh_verify\\ui\\workers.py": "4cc9360a4820ded27a7d5ef709fc9f04b1d4804cb1e7a614f6c357ed547da888",
"src\\cbb_refresh_verify\\ui\\__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
"scope_note": "Candidate icons are local workspace assets and are excluded from this change. Native evidence files and engineering copies remain local.",
"pr_integration": {
"base_commit": "a56fd17b60d9f67997d7f48c862f3367d4502f84",
"python_full_suite": {
"name": "pytest",
"errors": "0",
"failures": "0",
"skipped": "0",
"tests": "1582",
"time": "194.662",
"timestamp": "2026-11-05T21:54:33.463053+08:00",
"hostname": "Abs"
},
"compile_check": true,
"diff_check": true,
"candidate_code_differences": [
"src\\cbb_refresh_verify\\mentor_adapter.py"
],
"difference_scope": "Merge main: defer private desktop allocation into protected cleanup in the two legacy status readers; retain PCB diagnostic/integration behavior.",
"both_cleanup_regression_suites_preserved": true,
"candidate_rebuilt_after_main_integration": false,
"automatic_icdb_repair_acceptance": false,
"field_server_session_loss_acceptance": false
}
}
@@ -0,0 +1,45 @@
{
"date": "2026-11-06T09:27:28.849706+00:00",
"source_commit": "44bb734de80afbe3ff04ba72d52a465ff3b91684",
"version": "0.2.4b2",
"reason": "New user icon was uncommitted in original workspace and absent from isolated worktree; synchronize all three assets.",
"assets": [
{
"name": "cbb_refresh_verify.ico",
"sha256": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"bytes": 123139
},
{
"name": "cbb_refresh_verify.png",
"sha256": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"bytes": 1187049
},
{
"name": "cbb_refresh_verify.svg",
"sha256": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328",
"bytes": 1582896
}
],
"exe_icon_frames_match_current_ico": true,
"exe_icon_frame_count": 7,
"qt_window_icon_matches_current_ico": true,
"frozen_product_module_bytecode_matches_source": true,
"module_count": 62,
"packaging_tests": {
"passed": 13
},
"frozen_smoke": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2-iconfix\\smoke-334dde93\\result.json",
"exe": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2-iconfix\\dist\\CbbRefreshVerify-Background\\CbbRefreshVerify.exe",
"exe_sha256": "7c4a78d9d2116f637c2a236a82979db2ce49b9b5fa6493a16e66fc803b38d999",
"zip": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2-iconfix\\CbbRefreshVerify-0.2.4b2-iconfix-44bb734.zip",
"zip_sha256": "4a0a96321801fdebf13fed0f850a0c4b32d6928480288fd35c2d36f534e6e5b5",
"zip_bytes": 56846008,
"runtime_changes": false,
"full_runtime_suite_rerun": false,
"prior_runtime_suite": {
"passed": 1717,
"source_commit": "5873b7146b61d0cdd0eb22f6f2941797b02f38fc"
},
"pr": 13,
"draft": true
}
@@ -0,0 +1,75 @@
{
"date": "2026-11-06",
"review_comments": [
275,
283,
286
],
"tests": {
"backend_full": {
"tests": 1385,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_file": "cbb-refresh-verify-795-backend-fixes-fixes.xml",
"xml_sha256": "b1af9d0025abbbbcf25fe134b02da980c9402dd22c0fa39e1f96b9f8124183ee"
},
"backend_read_guard": {
"tests": 9,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_file": "cbb-refresh-verify-795-backend-fixes-fixes-focused.xml",
"xml_sha256": "25dac539945d9ba71f2f9dafeb342e8f6110e094c62364369013e16e551b1f94"
},
"ui_integration": {
"tests": 29,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_file": "cbb-refresh-verify-795-ui-fixes-fixes.xml",
"xml_sha256": "9eeeff28c6fcd31d8f2e6d7fb38e0bdf01b0058ba7b7f9e5df2f173f71a4fca0"
},
"final_integrated": {
"tests": 1631,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_file": "cbb-refresh-verify-795-review-stack-fixes-full.xml",
"xml_sha256": "7d75049e4feecb4a6026062321d4a0fcb1c92e30f8f1ba23d11a4ea28ee19c9c"
},
"final_release_focused": {
"tests": 63,
"errors": 0,
"failures": 0,
"skipped": 0,
"xml_file": "cbb-refresh-verify-795-review-stack-fixes-focused.xml",
"xml_sha256": "469923faf0919ab2e3dffac183f2cb44a6b606aa15edacce92a88da1bde81424"
}
},
"compileall": "passed",
"git_diff_check": "passed",
"source_and_tests_sha256": "6fe6f02a3e0e731c4c9d2ff2f2c5e86e537139ef5e59f15441a9059522109526",
"post_full_suite_change": "GUI proof path comparison now uses lexical absolute paths, with no filesystem resolution; final 63 release regressions cover this one-line change. No further full-suite run was performed for this isolated UI comparison.",
"ui_preview": {
"file": "2026-11-06-release-preview.png",
"sha256": "e13645ed6b8234a2d46f6c462a262c7ef2092459c8e94f60a9fa273fd02c3613",
"mode": "offscreen simulated sessions; local Windows fonts loaded for visual inspection"
},
"red_regressions": {
"initial_backend": 6,
"initial_release": 12,
"ui_outcomes": 2,
"additional": "report storage, prelaunch evidence/probe timeout, cancel release propagation"
},
"scope": "Historical records trigger actual ownership proof; no automatic repair, server termination, native lock/address deletion or library backup.",
"native_cancel": "Only a unique enabled standard Cancel/取消 (IDCANCEL=2) on a current matching Project Backup window; identity, user/session, title, desktop and button rechecked; request does not prove cancellation.",
"not_verified": [
"actual Mentor native cancellation",
"actual Mentor force termination",
"field ICDB recovery",
"new frozen package",
"Windows 10",
"cross-machine shared-library concurrency"
]
}
@@ -0,0 +1,43 @@
# 0.2.4b2 原生操作生命周期候选
本候选处理 PR #12 评论 297 的三条 P1 及直接相关的停止、释放记录问题。ICDB 自动 Repair 仍关闭,现场失联恢复尚未验收。本轮不合并、不发布正式版、不关闭工单。
差分审查入口:[Draft PR #13](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13),依赖 #12。
**当前图标修正版:** `44bb734` 将原工作区的新版蓝色对勾/环形箭头 ICO、PNG、SVG 同步进候选分支。已核对 EXE 内嵌的七个尺寸图标、Qt 窗口图标及三份打包资源一致,13 项打包测试和冻结入口冒烟通过。62 个产品模块字节码保持与当前源码一致,未为资源替换重跑业务全量。当前便携包为 `CbbRefreshVerify-0.2.4b2-iconfix-44bb734.zip`(56,846,008 字节),SHA-256:`4a0a96321801fdebf13fed0f850a0c4b32d6928480288fd35c2d36f534e6e5b5`。实际程序路径及验证明细见[图标修正记录](2026-11-06-icon-candidate-validation.json)。下文首次候选包哈希保留用于历史追溯。
## 行为
- 停止、超时、失败收尾和监督器失联只请求停止后续动作,不强杀可能正在 Save/Close 的 worker 或 cscript。保存助手先持久登记精确身份,再通过启动门进入 COM。保存返回、关闭返回和独立资源释放分别记录;进程消失不能把未知保存升级为成功。
- 普通停止等待 5 秒;可能正在写入时最多等待 120 秒后转后台观察。相关库的租约、映射和精确进程观察继续保留,不占全局队列票据;独立库可以运行。用户取消的批次不自动恢复。
- 管理 catalog/add/remove 使用统一监督器身份、取消信号、启动门和会话记录。更新在 remove 后停止,记录需恢复,不继续 add。异步 Add 提交前必须成功保存 NATIVE_CALL;提交后记录失败仍保留监督。未知 Add 结果不触发自动 Close/Quit,明确且已应答的原生失败可正常收尾。
- 重启在后台核对受控记录,不执行记录中的命令或重放写操作。PID 复用只观察替代进程,继续独立资源核对;证明成立才解除对应等待。报告错误、损坏 JSON 本身不生成全局占用。
- 权威状态桥保持默认;legacy 读取只观察已打开、匹配库且可读取的 LM,不启动程序、不回答提示、不关闭用户窗口。无法观察保持 UNKNOWN。
界面保持三个页签。新增说明写在本文和代码中;界面仅呈现当前状态和操作结果。原工作区、用户图标改动和已运行程序未替换。
## 实现与审查
基线为 `5eb4b2d`,独立分支为 `codex/runtime-lifecycle-safety`。保存与只读接线共用 mentor_adapter,审查顺序为:事实/会话协议 → 保存与停止 → 管理监督 → 界面交接 → 独立审查修正。共享文件的 A/C 接线合并在同一提交,候选仅在三单元联通后生成。
独立审查发现并修正:IDENTITY_CHANGED 提前结束观察、异步 Add 阶段不准确、权限 COM 查询后未再次检查取消,以及写入阶段记录失败后仍继续提交 Add。新增回归先复现失败,再验证修正。该审查不等于真实 Mentor 数据恢复验收。
## 验证口径
可机读结果、源码身份、XML 与候选包哈希见 [验证记录](2026-11-06-runtime-lifecycle-validation.json)。Python 全量回归、实际 32 位 cscript 的 FakeDoc Save/Close、真实 Windows 测试进程的父进程退出,以及冻结入口冒烟分别记录。
最终源码提交 `5873b71`:**1,717 passed**,编译与 diff 检查通过。正式候选 GUI 及四类 worker 入口冒烟通过;62 个产品模块的冻结字节码与当前源码一致。独立冻结夹具的保存/管理 × 用户取消/父进程退出共四个场景通过。唯一已知测试警告为 pywinauto 的 STA 模式提示。
首次候选便携 ZIP 为 `CbbRefreshVerify-0.2.4b2-runtime-lifecycle-5873b71.zip`,54,227,147 字节;SHA-256:`5983a4e99884d9551d1dba3d81af88f754ce876c19a780fe82e8ea9fd58a566b`。未上传为正式 Release。构建、XML 和各专项结果文件的实际路径保存在验证 JSON。
冻结测试夹具是独立测试程序,使用同一批产品模块并替换外部原生边界;不随候选交付,也不是应用实际按钮操作或真实数据库修复。冻结产品的 GUI、启动前取消、拒绝错误桌面的管理入口、进程探针及仅观察的弹窗代理单独冒烟。
可复现脚本在 `tests/support/runtime_lifecycle_frozen_*.py`。它们是实际执行脚本的逐字节副本,最终套件完成后归档,未改变产品源码或 pytest 收集范围。先按现有 spec 构建产品,再以 `runtime_lifecycle_frozen_fixture.py` 为独立 PyInstaller onedir/console 入口、产品 `src` 为搜索路径构建夹具;`runtime_lifecycle_frozen_smoke.py <worktree> <artifact-root>` 和 `runtime_lifecycle_frozen_boundaries.py <worktree> <artifact-root>` 分别验证产品与夹具。产物目录结构见验证 JSON,不应将测试夹具放入便携包。
本轮没有在生产库执行原生写入、删除地址/锁文件、强杀 Mentor、选择历史版本或重放旧管理任务。下列项仍为 **未验收**:
- 使用本候选实际按钮完成真实 Mentor 隔离副本的 Save 中停止、延迟 Close、管理失联及独立库继续。
- Windows 10、共享网络库和跨机器并发。
- 现场故障一致副本上的 ICDB 失联恢复、数据版本和 READY 验收。
原生 COM 调用本身可能不可取消。后台观察提供状态与资源保护,不承诺把任意卡死进程自动安全结束。回退程序不撤销数据库事务;工程恢复仍依靠人工一致备份或明确选择的原生历史版本。
@@ -0,0 +1,387 @@
{
"date": "2026-11-06T08:53:02.058981+00:00",
"version": "0.2.4b2",
"base_commit": "5eb4b2d7ed09947f19310ba80ba3b9a2a09b6f7d",
"source_commit": "5873b7146b61d0cdd0eb22f6f2941797b02f38fc",
"src_tree": "ef5ef877665fff179dd6d21d8d6f86e8de0a7e5b",
"pytest_tests_tree": "35f5ad42f2c6150bf5762a46cdeb9880d1fc0d0c",
"environment": {
"platform": "Windows-11-10.0.26200-SP0",
"python": "3.12.10",
"mentor_library_manager_file_version": "2012.0.522.442",
"mentor_library_manager_sha256": "a9c4c3d806794dbdc56d2bc4c637a1cf25e87e98644a7d5fd4eb0067ca5845e0",
"mentor_home": "D:\\Mentor\\7.9.5EE\\SDD_HOME",
"matches_validated_mentor_library_manager_binary": true
},
"tests": {
"final_full": {
"status": "passed",
"tests": 1717,
"failures": 0,
"errors": 0,
"skipped": 0,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-final-1717.xml",
"xml_sha256": "1d427f97dd04afbf8912bbdf787b0b9dfd1ed383d32bfe07f7a94cc24f9c5292"
},
"known_warning": "pywinauto: Revert to STA COM threading mode",
"compileall": "passed",
"git_diff_check": "passed",
"independent_review": "important findings resolved through 051498b"
},
"frozen_product": {
"build": "passed",
"smoke": {
"gui": {
"status": "passed",
"exit_code": 0
},
"verify-worker": {
"exit_code": 1,
"status": "passed",
"evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\verify-worker"
},
"management-worker": {
"exit_code": 2,
"status": "passed",
"evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\management-worker"
},
"owner-probe": {
"exit_code": 0,
"status": "passed",
"evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\owner-probe"
},
"dialog-agent": {
"status": "passed",
"exit_code": 0,
"scope": "empty PID set, observe only"
},
"module_origins": {
"status": "passed",
"module_count": 62,
"source_root": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795-review-stack\\src"
},
"version": "0.2.4b2"
},
"evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\smoke-74da6fd5\\result.json",
"evidence_sha256": "4f354f3700d09e299e6437d36492fd8b380440eae7e5ec859c90645f16004ac2",
"module_bytecode_matches_source": true,
"module_count": 62,
"modules": [
{
"module": "cbb_refresh_verify",
"source_sha256": "dd960394d88657820dba858792abf0de258e05efceb08ae2f0b39c6ad78bc469"
},
{
"module": "cbb_refresh_verify.application",
"source_sha256": "433c22b01df8376651c43cc9fe7f9551b531dcd3b3e590b77cb3ec1bfbfd2de6"
},
{
"module": "cbb_refresh_verify.backup_recovery",
"source_sha256": "ea7bb90151e825efb6163e43ed344b62407565005f0a0459c423ba2205539373"
},
{
"module": "cbb_refresh_verify.batch_status",
"source_sha256": "918c80dd4f75146baa6b7616ce415ac89ee28f6c1f46b2bfda77bacc998b5b62"
},
{
"module": "cbb_refresh_verify.com_runtime",
"source_sha256": "f0f3802d16c791a8bf9dfef44a94917072bfbe8fb3a927d76be8ef0341c7ed35"
},
{
"module": "cbb_refresh_verify.content_check",
"source_sha256": "8239c17b6e2452917ed573a7deb3e4c8583eaef91bf3630eff5f424d2e398aa9"
},
{
"module": "cbb_refresh_verify.defaults",
"source_sha256": "a1c03192f4a61ad0924b24bb635705b1ee4811d35483a02864200f95edbbebe3"
},
{
"module": "cbb_refresh_verify.desktop_worker",
"source_sha256": "1dd449e9885b32cb479970ddb9d1e3b580bc6339f9b491be0a414a1de8054efa"
},
{
"module": "cbb_refresh_verify.diagnostic_open",
"source_sha256": "d6c49ffe5a9969d95edbbc896d47a7e100f248380a287f99ba7bb8b92dbb3072"
},
{
"module": "cbb_refresh_verify.dialog_agent",
"source_sha256": "6a9b9802912afc4dd670ee9b28845d97bd64fe55fd577815ef729850fcff78db"
},
{
"module": "cbb_refresh_verify.dialog_models",
"source_sha256": "f68cee01d927b48364276d3c1f79e63ce8af231878db0b907d292780cfbafb56"
},
{
"module": "cbb_refresh_verify.dialog_probe",
"source_sha256": "d61f0c955c961980c9635940eefb9c7947c1fe90b4b6fd844720df41ddb0aa0e"
},
{
"module": "cbb_refresh_verify.dialog_rules",
"source_sha256": "3189b476f7ff4678b59212ed7b4081164e038a7cf7662cd895f9019cb3c1edc5"
},
{
"module": "cbb_refresh_verify.dialog_supervisor",
"source_sha256": "15c415c2d2e916f0b64ba04416164ff3b50996d70b22d3b4ac2226b5547ac247"
},
{
"module": "cbb_refresh_verify.failed_session",
"source_sha256": "7e6f7fa5ebcf2d49f00c5efc5f5d26412704b68e9122e476ac1f672009a98c09"
},
{
"module": "cbb_refresh_verify.icdb_maintenance",
"source_sha256": "e81d253d8b4d3e7c1000c45335a392c72b110748675c2c3324ebe524a7252e98"
},
{
"module": "cbb_refresh_verify.icdb_ownership",
"source_sha256": "7bf2342c1efa34a2ebcbf27964a40a490220f7146fbb6ef957b8d8dd1e511f03"
},
{
"module": "cbb_refresh_verify.icdb_recovery",
"source_sha256": "358c0e9a004f1e0b2127513286e1dffd94b0180a8b7314aa9655462f570b6360"
},
{
"module": "cbb_refresh_verify.integration",
"source_sha256": "f188856af69ba25e265988c51db7a6d4263326440d972ca78378b733b891c1ed"
},
{
"module": "cbb_refresh_verify.library_lock",
"source_sha256": "eea9021300410cc810eaa0e18aac546c94139f89528f5d68784ef3f943b65ce4"
},
{
"module": "cbb_refresh_verify.library_manager_verify",
"source_sha256": "71e16a8581ad44b646be78b480f9812d596a6d162b3eec03d078bf4ea4503195"
},
{
"module": "cbb_refresh_verify.library_reader",
"source_sha256": "d4007caa361edd467773e49f721e02671d5a9bcb30741769a57349850b12c438"
},
{
"module": "cbb_refresh_verify.maintenance_entry",
"source_sha256": "3b93c25f69d7a961facd8004e20e155a84cc18f06d57b741a9055786ed058990"
},
{
"module": "cbb_refresh_verify.management",
"source_sha256": "3d6e2505ce6e21acdea88d59b920229ba1ce2cee6c914ac1b0b8267cf0d34ffc"
},
{
"module": "cbb_refresh_verify.management_transaction",
"source_sha256": "32c53caaead05d5db3a31d3e30721e65434e5837095dc0a7812f825603aa37a0"
},
{
"module": "cbb_refresh_verify.mentor_adapter",
"source_sha256": "15bde6706c6533d839646b894896237921b89a8a3ce3016aa8161c591dab314f"
},
{
"module": "cbb_refresh_verify.mentor_paths",
"source_sha256": "ba48c0003b3eacc88906497b2e43b299ca4536a9f7dae44bbacf6a6ec694c116"
},
{
"module": "cbb_refresh_verify.models",
"source_sha256": "9e8209a8b006df923f1d07ccab64bbcfe5d674c4fc5f5426bfbc9b11da4ee105"
},
{
"module": "cbb_refresh_verify.native_add_failures",
"source_sha256": "192202732423dc624c5548c75e80bb20973e5087c21d4798c9637f25b6de7e94"
},
{
"module": "cbb_refresh_verify.native_backup",
"source_sha256": "7276fa3d9298e85550151cf0c7191d84bd08a18a72df5d854a3c38f1a88b001d"
},
{
"module": "cbb_refresh_verify.native_engineering_identity",
"source_sha256": "a241bc3be7dc5a922ce728f1febd3684e79e6e45935589c80a4b1a5933e05df5"
},
{
"module": "cbb_refresh_verify.native_export_guard",
"source_sha256": "5120c13e4ef1255d4c61316eb40005c4039c23e41edca4437bd0ef28b543a959"
},
{
"module": "cbb_refresh_verify.native_management",
"source_sha256": "27a835bc31cfe0e1a09d767977e5c348d40e246c58d58ce1ef085411afe6d56e"
},
{
"module": "cbb_refresh_verify.native_occupancy",
"source_sha256": "7d686079d12217382adace6361cd343d977b91075e3b157cf410ca92d07ffc49"
},
{
"module": "cbb_refresh_verify.native_repair",
"source_sha256": "9f024dcb5e3a76369191033474fefd30787b6ae350c315f3cf38e92e5a1f3e98"
},
{
"module": "cbb_refresh_verify.native_repair_ui",
"source_sha256": "3eb2af181befea94af8b3b3131edff09589f340bcba777abbe3b67fd31b80393"
},
{
"module": "cbb_refresh_verify.network_path",
"source_sha256": "6b5b159502d42a46bf4ee26d5698fd2c6498b359088e2138eae46e9065b13c6f"
},
{
"module": "cbb_refresh_verify.operation_lifecycle",
"source_sha256": "28b6cdebd22caaf369eeb8b7236e258b8160a8fa7c7d8bfbf0980979e9eba3ae"
},
{
"module": "cbb_refresh_verify.operation_queue",
"source_sha256": "57ad9da8aeedd9cd75a8c5b5fda44044bcb457670a4a323e9e8bb247198074ab"
},
{
"module": "cbb_refresh_verify.owner_probe",
"source_sha256": "8dcfd60246cb2979db34d02e0a2d605c334b6f7e2666f22daa2f50c0408bc903"
},
{
"module": "cbb_refresh_verify.pcb_bridge",
"source_sha256": "745ef117e984021e8a3d9087a2783c1efe19bed97edcfbcfae7703a291cc6eaa"
},
{
"module": "cbb_refresh_verify.pcb_restore_prompt",
"source_sha256": "5342612ad666e3faf5a9a4ce4710e9af458d357c44037135f2837dad436d5cf7"
},
{
"module": "cbb_refresh_verify.post_repair_consent",
"source_sha256": "3b1eaff1db58fd311a9dbc5fdcd850911b04cc5afd4e747f70a62b721b8fafa4"
},
{
"module": "cbb_refresh_verify.post_verify_diagnostics",
"source_sha256": "2442de485bc0d6a34c4b2d9b10bc5f323ea38f9ff66674119a50f5c6043bac63"
},
{
"module": "cbb_refresh_verify.reimport_recovery",
"source_sha256": "66b2ba8f8c2ec9ae8c386d6b1aa74a1fbb6bfb509c4df0a262f8d7a0ca48469e"
},
{
"module": "cbb_refresh_verify.residual_sessions",
"source_sha256": "69d39648a2f3c98a297847baf51373632acd881f034a2a011d0c3d27dbec3dfc"
},
{
"module": "cbb_refresh_verify.runtime_logging",
"source_sha256": "44ac25430a89c5ffc9e48e88c227e88052f4c815365e8556f67918f3edaba39e"
},
{
"module": "cbb_refresh_verify.runtime_timing",
"source_sha256": "c4ed4057b5000e0b86ccc7dd1fe2004d6e0dae29f397fec77b01ad41a81c6367"
},
{
"module": "cbb_refresh_verify.scoped_manifest",
"source_sha256": "54cf4288e7850e220b394ae971ea98785eba631f80784a3f9354209e649f6498"
},
{
"module": "cbb_refresh_verify.session_record",
"source_sha256": "394719d125b91ff124d707229f4599dcca9229d2c6e653840ef7e02f48c642b6"
},
{
"module": "cbb_refresh_verify.status_bridge",
"source_sha256": "05d627d02934a14f5de409472c291d37565a95b836f9c130111aae80612e9196"
},
{
"module": "cbb_refresh_verify.ui",
"source_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
{
"module": "cbb_refresh_verify.ui.backup_notice",
"source_sha256": "1a3fa5ac18a267907faf95f36d61b9f08bcbb939eef4d480dd06af1391a81599"
},
{
"module": "cbb_refresh_verify.ui.backup_recovery_dialog",
"source_sha256": "621ea2efea85367b0c9bb9790040860a1ac001f40f8834289cb67c96ea0648d1"
},
{
"module": "cbb_refresh_verify.ui.icdb_check_task",
"source_sha256": "01985644641ec623ed440433248d9445ab5b9f37d27a843ec7f26267895de397"
},
{
"module": "cbb_refresh_verify.ui.main_window",
"source_sha256": "a625b2934a34c86ff30eaf115e50b0560cbb24f3dccf15bbb51574a9808c660d"
},
{
"module": "cbb_refresh_verify.ui.management_dialog",
"source_sha256": "93b7a7464161e7448aa78c42ca8742c970e80387f9c6c1b9b4b6a07532da3ebf"
},
{
"module": "cbb_refresh_verify.ui.pcb_restore_dialog",
"source_sha256": "b7228d828df235ac51502dc68760d28c4896af02c780e9806e11c32dba7f62da"
},
{
"module": "cbb_refresh_verify.ui.residual_release_dialog",
"source_sha256": "ca0e18886457800cae7b543286395f05db1a74eb41e53fc54cfee57f93294368"
},
{
"module": "cbb_refresh_verify.ui.workers",
"source_sha256": "4cc9360a4820ded27a7d5ef709fc9f04b1d4804cb1e7a614f6c357ed547da888"
},
{
"module": "cbb_refresh_verify.verify_diagnostics",
"source_sha256": "041b77d7d49e4c86338ed5e5741d0d27a2c42bc358f4da54b3efe64af847e9b8"
},
{
"module": "cbb_refresh_verify.verify_runner",
"source_sha256": "2c7c37d2b510ab5735cd4a71cb834768c711e31b0ce5dd28b23acb8dcfe22ffb"
}
],
"exe": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\dist\\CbbRefreshVerify-Background\\CbbRefreshVerify.exe",
"exe_sha256": "9051ab52acb67d0d291ae230e7d55d1ce6f580f653d58a82d463b7c42cebb90f",
"zip": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\CbbRefreshVerify-0.2.4b2-runtime-lifecycle-5873b71.zip",
"zip_sha256": "5983a4e99884d9551d1dba3d81af88f754ce876c19a780fe82e8ea9fd58a566b",
"zip_bytes": 54227147
},
"frozen_native_boundaries": {
"scope": "separate frozen fixture; fake native COM/management boundary",
"product_native_database_recovery_validated": false,
"results": [
{
"mode": "save",
"stop_kind": "cancel",
"status": "passed"
},
{
"mode": "save",
"stop_kind": "supervisor-loss",
"status": "passed"
},
{
"mode": "management",
"stop_kind": "cancel",
"status": "passed"
},
{
"mode": "management",
"stop_kind": "supervisor-loss",
"status": "passed"
}
],
"evidence": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\runtime-lifecycle-b2\\frozen-boundaries-cdb9d884\\result.json",
"evidence_sha256": "9cdc149a6fa545206c361aaba278ef54c9ee2529e9a09b440c5fcf9378fc8529",
"module_bytecode_matches_source": true,
"module_count": 47,
"validation_helpers": [
{
"file": "tests\\support\\runtime_lifecycle_frozen_fixture.py",
"sha256": "b87761c06a300f0d93bce864d3d31e045f2135324b2a9a42f8682ccbff09ad22"
},
{
"file": "tests\\support\\runtime_lifecycle_frozen_boundaries.py",
"sha256": "bf98533a1c06ccf4453d20b3804323779719e697141b8dc64fa679960a979cfd"
},
{
"file": "tests\\support\\runtime_lifecycle_frozen_smoke.py",
"sha256": "b11e0aac71c1079625ac9832dc5c38197bc80110478c4d9e02c2a3bc58a2a2d0"
}
],
"helpers_copied_after_full_suite": true,
"note": "Tracked helper files are byte-identical copies of the scripts executed from diagnostics. Not shipped; do not replace real application-button acceptance."
},
"not_run": [
"Real Mentor isolated-copy application-button Save/Close and management-loss scenarios",
"Windows 10 and cross-machine shared-library concurrency",
"Field ICDB disconnected-session recovery and data-version/READY acceptance"
],
"auto_repair_enabled": false,
"production_native_writes_performed": false,
"merged_or_published": false,
"issues_closed": false,
"pull_request": {
"number": 13,
"url": "https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13",
"draft": true,
"base": "codex/review-residual-release",
"creation_head": "8e946c6e7a115a1ac22101b97df9b3fc6e2862f0"
}
}
@@ -0,0 +1,109 @@
{
"date": "2026-11-09",
"scope": "New full reviews #344/#345/#348 and runtime re-review #326",
"branch_heads_before_validation_commit": {
"codex/review-native-backend": "e8a1714d956e733648dacda1bfdce387e07e4cba",
"codex/review-ui-integration": "0fca6abb4e1b54bd06e6986782ccf45383306e43",
"codex/review-residual-release": "a7df105616a8f5cfab61b85e0c5d93aa74ded415",
"codex/runtime-lifecycle-safety": "a045683c8a6d6918ec701e2944d0e20c25296b65"
},
"environment": {
"python": "3.12.10",
"windows": "10.0.26200"
},
"full_suite": {
"tests": 1775,
"failures": 0,
"errors": 0,
"skipped": 0,
"duration_seconds": 273.089,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\2026-11-09-full-review-final-1775.xml",
"xml_sha256": "a993473b7784748f671a3d38a0e80f1aa7dfaf714b23d6378ed26d0481c1b904",
"warnings": [
"Existing pywinauto STA COM threading warning"
]
},
"focused_runs": [
{
"scope": "Backend",
"passed": 287
},
{
"scope": "UI standalone",
"passed": 65
},
{
"scope": "Residual standalone forward integration",
"passed": 41
},
{
"scope": "Final runtime/UI integration before last merge",
"passed": 211
},
{
"scope": "Terminal-publication fix lifecycle/management group",
"passed": 159
}
],
"compileall": "passed",
"diff_check": "passed",
"independent_review": "No remaining important introduced findings after fixing two queue timing findings",
"tested_files_sha256": {
"src/cbb_refresh_verify/application.py": "62b9b013563a216d020c8366cccb8f949b02afa72dc63c26940804441cc23057",
"src/cbb_refresh_verify/batch_status.py": "55a4007cf54491ca8e045a5bf86aa4353ac8437cca5a76cd79304962e3d3fa0a",
"src/cbb_refresh_verify/desktop_worker.py": "27d751816552d215dd8ee9cd67941d824f7b4493120ead7c3f87e5eba5ec4a92",
"src/cbb_refresh_verify/library_lock.py": "636e0b1c84061796424da6289361c059fecacad31802df2edc3f3455ec8c40d8",
"src/cbb_refresh_verify/management.py": "29ecb101dacf2bb23b8b8931c01078956dd6c641444e82a69a62e811c7261fc5",
"src/cbb_refresh_verify/native_management.py": "7598a18da12dd527e9403a956b1ade76b253f89a9ee4790f0802244b54616844",
"src/cbb_refresh_verify/operation_queue.py": "a6932d8bc68ac436091f6d362557c66d274ec52d0f295a22f014a3396845c79f",
"src/cbb_refresh_verify/pcb_bridge.py": "2f6c2b09642100468814500569dbfc6695fc2a46b9a3b8333daa8e1530cdeef5",
"src/cbb_refresh_verify/scoped_manifest.py": "26ba8303e2de294374443513d667570abed2f0f2563a2e969a9cb35e74d65c00",
"src/cbb_refresh_verify/session_record.py": "fbf31fb38894f75d725b269229c7d928be54136b491cc5339f7a4b018d7b7f5e",
"src/cbb_refresh_verify/ui/icdb_check_task.py": "cc108974e843f31e59e90acd18ad2d810e6bcd67d7cf303b2b772501d95b6d8e",
"src/cbb_refresh_verify/ui/main_window.py": "a05d9d838be4b9e9f6e2b612c25186e77f23899bffc59b67f50fea597eab47c9",
"src/cbb_refresh_verify/ui/management_dialog.py": "f3fc740197fc109ae3ddd8ead556a8847d5e00ec9a97d5cc2e166d656fb861ef",
"src/cbb_refresh_verify/ui/residual_release_dialog.py": "82382af142379c540721dbfa7ba5a5d766130d89807e1f34ad032a0ad1411f5c",
"tests/test_batch_status.py": "c1f9af0c7c6f3171b3726fb53346f480b13b8d9cd88111a9c12e2fae2392bbff",
"tests/test_batch_status_faults.py": "314e890c9aee439c8a75b4dfd605685240c74f6212da975fd50526bd70b4a0ff",
"tests/test_management_retry_blockers.py": "124dbef291dbe331ba0c3e7de1665c910ea43e37b1563429b387f0f2233953ee",
"tests/test_management_supervision.py": "2dcadd6551a94c52e5d4e74285959f10144a89c48af87e508abaea945652d1f6",
"tests/test_pcb_bridge.py": "527fb63147a203a2e9419da989aff600d3e461580989e39e8ede3a8cc57b901a",
"tests/test_residual_release_dialog.py": "10b23d009703d542e5ce8ecb35a4833e0135bb8852b4116e49eedc7010397a1e",
"tests/test_review326_dispatch_and_receipts.py": "ce4d529246da1c4d53c3dec70ef49542165064404301dec3e32851df62492ecf",
"tests/test_review326_queue_guidance.py": "c2c97aceddd9713618afdd5f2a7be4764b56a1b62fc672282fb8c218b4969c74",
"tests/test_review345_ui_cli.py": "795e7e4f9bda8874c6a65a08863cab19f4adb3412287276ee2960588f0fd2fa8",
"tests/test_review348_release_comparison.py": "ceccdb3d6f7bc6cb65562c059f13aa2bc5d89d98c6f64b0f11d9b943ebbde165",
"tests/test_review_backend_followup.py": "c10704fae250c9e204c995843a2baab0a2562e51984ae4d429aa438ba1c88113",
"tests/test_review_management_ui_followup.py": "746602a84c3ba9cb041c5dd354b39d344355b71a3666b27a47eb9aee231e171c",
"tests/test_scoped_manifest.py": "d22749cd240ab365f91ebb9d0469dc3336150338a84a77c1aeb6fbc20ccd439f"
},
"icon_sha256": {
"ico": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"png": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"svg": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328"
},
"design_choices": [
"Production status always fresh; low-level checkpoint reuse explicit",
"Final source and target hashes retained; copy hashed in stream",
"Optional CLI limit; default all requested targets",
"Release mapping cleanup serialized before waiting task admission",
"New native calls vetoed on supervisor loss; accepted pending calls may record continuation identity"
],
"candidate_rebuilt": false,
"automatic_icdb_repair": false,
"merged": false,
"issue_closed": false,
"not_verified": [
"Real Mentor/native database writes during loss/cancel",
"Frozen execution of this revision",
"Windows 10",
"Shared network/cross-machine release"
],
"first_full_run": {
"tests": 1774,
"failures": 1,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\2026-11-09-full-review-first-failure-1774.xml",
"xml_sha256": "9d7275b0a4122db12b8367e4367759f3051ce29a56645da5098776d8b9ca2bc8",
"reason": "FINISHED permitted watchdog orphan exit before result publication; receipt now precedes terminal phase"
}
}
@@ -0,0 +1,43 @@
# Full-review follow-up: comments 344 / 345 / 348 / 326
This revision follows the new November 9 full reviews. The old November 6 deep-review backlog remains outside the user's previously selected scope.
## Backend: #10 / 344
- Status scans default to fresh queries. The low-level explicit checkpoint reuse API remains for compatibility with controlled read-only scans; production status queries continue to use `resume=False`. Its lightweight fingerprint is not described as proof that payload databases are unchanged.
- Change reports include rule version, compared scope, excluded directory categories/suffixes and positional runtime rules from the classifier constants. Unrelated CBB content is still explicitly outside comparison. Counts in the management result refer to compared engineering files.
- Removed the tests-only `pcb_bridge.execution_outcome` helper with optimistic release defaults; active production release checks remain authoritative.
- SHA-256 is computed during streaming of unlocked primary files instead of a separate preliminary source pass. The final source SHA-256 and target SHA-256 remain. This reduces three source reads to two without dropping same-size/same-mtime mutation detection. The review's suggested removal of final source hashing was not adopted because it would weaken the requested source-change check.
Backend commit `e8a1714`; 287 focused regressions passed. Details and exact command are in `docs/reviews/2026-11-05-native-backend.md`.
## UI/CLI: #11 / 345
- Replaced repeated same-purpose result windows with lifecycle-managed dialogs. Task recovery associations survive independent result windows; deleted dialogs/actions are forgotten. Forward integration keeps #12's enabled release/resume paths and recreates a resume action if its old summary was closed.
- Closing waits visibly, including a persistent still-waiting notice after 120 seconds. It does not promise a kill deadline or interrupt a write. The final idle check includes the independent lifecycle pool.
- Optional positive CLI `--limit` bounds requested names in order. Omission retains the existing all-target behavior rather than silently dropping work. Logs distinguish selected/total/remaining and explain retained mappings after exceptions or unsafe results, pointing to confirmed release instead of an unconditional network-drive deletion.
- Removed `if False` branches/dead reload field in the standalone UI PR; forward integration retains the later enabled release behavior. File line-ending rules from the prior tip remain.
UI commit `342a726`; 65 targeted UI/CLI tests passed on its branch. Integration keeps PR13 stop propagation; CLI test doubles were updated to accept and assert that stop input.
## Residual release: #12 / 348
The unreadable-window poisoning and oversized repeated-output findings target the old `5eb4b2d` tree and are already fixed in `651b539`. This revision additionally displays confirmation scope and actual execution result as separate columns, and counts allowed-but-unreleased rows with their reasons. Preview consent never overrides a fresh activity/identity refusal. Residual commit `14c9a74`; 35 targeted tests passed.
## Runtime and queue: #13 / 326
- Native management launch/open/create/close/quit/Add submission/Remove launch and editor entry use `dispatch_native`. It records the pending phase before callback entry, synchronous return records POSTCALL, callback failure records UNCONFIRMED, and asynchronous submission requires its existing explicit result acknowledgment. Save/failure-close helpers retain their atomic registration/start gate.
- Identity recording for an already-started Remove uses explicit continuation semantics: it must match the operation's current pending phase, cannot authorize a new call, and may continue tracking/waiting after supervisor loss. A real boundary regression demonstrates that loss immediately after Popen cannot abandon its wait. `required=False` controls journal errors, not permission to dispatch after supervisor loss.
- Pre-proof snapshots freeze alias generation, block and operation ID. Full-library proofs and operation receipts list `reconciled_blocks` and exact retained sessions; a replaced operation is not acknowledged.
- Cached queue reasons name the retained CBB and expose a release entry in verification, ICDB and management waiting states. NativeQueue emits an updated notice only when the cached wait reason changes, so a task transitioning from running to retained cannot leave a hidden dead-end action. Queue predicates do no filesystem/native I/O.
- The queued release's mapping finalizer runs inside the serialized release action before it admits the waiting native ticket. The completion signal skips later destructive mapping cleanup. This prevents an old proof from clearing a new task's mapping retention. Both normal confirmation and native Cancel use this finalizer. Closing the residual panel does not mark the still-queued parent action finished.
## Validation and limits
The final focused integration run passed 211 tests. New tests were first observed failing for missing dispatch/receipt facts, dispatch veto after accepted Remove, missing queue explanations, changed wait reasons, stale mapping cleanup and dialog lifecycle boundaries. Independent review's two queue timing findings were corrected and re-reviewed with no remaining important introduced finding.
The first full run exposed one terminal-publication race (1,773 passed, one failed): management wrote FINISHED before its result receipt, allowing the orphan watchdog to exit between them. The result is now flushed before FINISHED. The regression accepts either the normal failure exit or orphan exit only after checking the saved result and the absence of a subsequent native action. A new test first reproduced the missing receipt at the FINISHED transition; 159 focused lifecycle/management tests then passed. The failed full XML is preserved separately, and the full suite is rerun on the corrected tree.
This does not require a final result before every orphan exit: PRECALL/POSTCALL may deliberately exit during an idle non-COM wait after supervisor loss, as requested by review 319. Such an exit is neither operation success nor resource-release proof. A missing final result is returned as `success=False, safe_to_continue=False` by the launcher, with the last call facts retained in the session journal for explicit reconciliation. FINISHED specifically is now published only after its final receipt; requiring a final receipt before all POSTCALL orphan exits would leave the original idle-orphan problem unresolved.
Full-suite counts, source hashes and immutable XML copies are in the accompanying validation JSON. Compilation/diff checks and icon equality are checked on the integrated tree. No frozen package was rebuilt; the old iconfix package does not contain this revision. No real Mentor Save/Close/Add/Remove or shared/network/cross-machine acceptance was performed. ICDB automatic Repair remains off. No merge to main, formal release, issue closure, native address/lock deletion, foreground mouse control, or native process termination is authorized by this validation.
@@ -0,0 +1,85 @@
{
"date": "2026-11-09",
"scope": "Latest comments #309/#310/#313 only; older deep-review backlog excluded by user",
"integration_head_before_validation_commit": "b1c36e3ca6d6680d0b656a725a1db871d5ffabbd",
"branch_heads": {
"codex/review-native-backend": "b7baa24b5ed87256fb846236b08c75ff02887e9c",
"codex/review-ui-integration": "e73f9c6edcb36a18fdd8a17b565cc1fb7c97f26b",
"codex/review-residual-release": "651b539d0ef491b3fd410031b9f981d71272aac9",
"codex/runtime-lifecycle-safety": "b1c36e3ca6d6680d0b656a725a1db871d5ffabbd"
},
"environment": {
"python": "3.12.10",
"windows": "10.0.26200"
},
"full_suite": {
"tests": 1742,
"failures": 0,
"errors": 0,
"skipped": 0,
"duration_seconds": 293.056,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\2026-11-09-latest-stack-full-1742.xml",
"source_xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\cbb-refresh-verify-795-review-stack-fixes-full.xml",
"xml_sha256": "e00376d01fa26dd8e62d065d700f8cc200000665a6958536d109336119f8a0c0"
},
"focused_suites": {
"cbb-refresh-verify-795-backend-fixes": {
"tests": 94,
"failures": 0,
"errors": 0,
"skipped": 0,
"duration_seconds": 41.802,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\2026-11-09-cbb-refresh-verify-795-backend-fixes-latest-focused-94.xml",
"source_xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\cbb-refresh-verify-795-backend-fixes-fixes-focused.xml",
"xml_sha256": "d8580bcc766c7ad6d3ce1d9de7d44b496afaaa8c3489cf01245f1d8a7d15500c"
},
"cbb-refresh-verify-795-ui-fixes": {
"tests": 43,
"failures": 0,
"errors": 0,
"skipped": 0,
"duration_seconds": 5.554,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\2026-11-09-cbb-refresh-verify-795-ui-fixes-latest-focused-43.xml",
"source_xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\cbb-refresh-verify-795-ui-fixes-fixes-focused.xml",
"xml_sha256": "0ed470d756f0b387ca9fbf4f4891bd60abfc3faf535e67c06d6640557d627753"
},
"cbb-refresh-verify-795-review-stack": {
"tests": 136,
"failures": 0,
"errors": 0,
"skipped": 0,
"duration_seconds": 16.117,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\2026-11-09-cbb-refresh-verify-795-review-stack-latest-focused-136.xml",
"source_xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\cbb-refresh-verify-795-review-stack-fixes-focused.xml",
"xml_sha256": "2087bfa02a0251deee535acda7454c0967b1f11aa5c7125296efc78c141fec59"
}
},
"compileall": "passed",
"diff_check": "passed",
"independent_review": "No important introduced findings before or after integration",
"controlled_private_desktop_fixture": "passed",
"tested_files_sha256": {
".gitattributes": "a68c9f317ed6e4131c72269b98403c7a3f9c08d5d03e710425301bd50273e791",
"src/cbb_refresh_verify/application.py": "b76ff891d77f0a7dba8feeb1f5ae5745ee83dee2fa46c585c187dbf9bb1c39d2",
"src/cbb_refresh_verify/library_lock.py": "8b3286d36ad686f65ec7e30eded9c4d0f8a629ca214b39812dfba496292da976",
"src/cbb_refresh_verify/residual_sessions.py": "b5d38a06cb2902c3612edb75b1ef83596524f02b6cf7890f6541f210d3e380ce",
"tests/test_residual_sessions.py": "f34c77a11d2a2b08c5670a9809474afd84b212016a27b104249e5fddb4675f1f",
"tests/test_review313_residual_isolation.py": "4052ca51c35787a8df9b63e79febd38b666da98c09976fffb34f4361381d8b4d",
"tests/test_review_foreign_release_evidence.py": "cbf2af02418f6bd3ec720a7a7658cf97f06d1a6e12009fdff2a99f465711591e"
},
"icon_sha256": {
"ico": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"png": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"svg": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328"
},
"automatic_icdb_repair": false,
"candidate_rebuilt": false,
"not_verified": [
"Real Mentor operations",
"Frozen execution of this revision",
"Windows 10",
"Shared/network/cross-machine release"
],
"merged": false,
"issue_closed": false
}
@@ -0,0 +1,24 @@
# Latest PR review follow-up: 2026-11-09
The user selected the November 9 latest re-review comments, excluding the older November 6 deep-review backlog.
| PR/comment | Result | Source/validation |
| --- | --- | --- |
| #10 / #309 | Proof names foreign CBB checkpoints and distinguishes requested block from effective BLOCK/LIBRARY scope. | `b7baa24`; 94 backend/lease regressions passed. See `2026-11-09-pr10-review309.md`. |
| #11 / #310 | No new blocking finding; backend synchronized in `e73f9c6`. Existing pause semantics retained. | 43 UI/background/queue regressions passed on the UI branch. |
| #12 / #313 | Incomplete window reads isolated by PID; bounded repeated evidence; native Cancel retains preview scope. | `651b539`; 116 relevant regressions passed, including a real controlled private desktop/window. See `2026-11-09-pr12-review313.md`. |
| #13 integration | Both sides of the residual preview conflict retained: runtime write protection and per-PID read/scope metadata. | Integration merge `b1c36e3`; 136 focused integrated regressions passed. Full result and file hashes in the accompanying JSON. |
## Line endings
At the chain tip only, `application.py` is normalized from CRLF to LF. Replacing its LF bytes with CRLF reproduces its prior bytes exactly, and `git diff --ignore-space-at-eol` is empty for this file. `main_window.py` already uses LF. Two specific `.gitattributes` rules pin these files to LF; the global `* -text` rule and every other source file's line-ending policy remain unchanged. No repository-wide normalization or EditorConfig layer is added.
## Independent review
The reviewer found no important introduced P1/P2 in the backend/residual changes. Its focused check passed 45 tests with the private-desktop fixture excluded; the coordinator separately ran that actual fixture successfully. A second inspection of the integration confirmed that PR13's active-write, retained-session acknowledgment and durable release records coexist with the new evidence and window-read boundaries. No tests or native operations ran during that integration inspection.
## Reproduction
Use the existing `diagnostics/run_review_fixes.py` wrapper from the original workspace against each linked worktree; it isolates the test mutex and sets the intended source path/Qt offscreen. The final full run, compileall and git diff --check results are in `2026-11-09-latest-pr-stack-validation.json`, including evidence hashes and source/test file hashes.
Current ICO/PNG/SVG hashes match the previously corrected blue check/circular-arrow assets. No candidate executable or ZIP was rebuilt: the previous iconfix package does not contain these fixes. These are source/PR validations, not real Mentor/Windows 10/shared-network/cross-machine acceptance. ICDB automatic Repair remains OFF. PR #3 remains a historical umbrella already covered by #10–#13. The PRs stay Draft; no merge to main, formal release or issue closure is performed.
@@ -0,0 +1,7 @@
# PR #10 comment 309
Release proof now records the requested CBB, effective BLOCK/LIBRARY proof scope, identities/statuses of archived checkpoints and retained owners, and `reconciled_foreign_blockers`. For example, a BlockA operation which safely reconciles BlockB's historical checkpoint explicitly lists BlockB and the full-library proof. `data_recovery_confirmed` remains false. No extra gate, automatic backup or native action was added.
Three regressions first failed on missing evidence fields. After the fix, 94 backend/lease/release regressions passed; compileall and git diff --check passed. The tests use real temporary file/lease handles with the process-query boundary replaced; no production library was opened. Full regression is run again at the integrated chain tip. Real Mentor/shared-network acceptance and a rebuilt package remain outstanding.
Review: https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/10#issuecomment-309
@@ -0,0 +1,38 @@
# PR11 review 345 follow-up
Repeated CBB verification and ICDB check runs replace the previous result dialog
for the same operation. Closing a result retires its Qt widgets and action
references, while the check task keeps its requests, results, invalidated targets,
and recovery context. A result for the other operation stays available.
During application shutdown, the title and status show that background work and
path release are pending. After approximately 120 seconds a second notice says
the application is still waiting. This is a notice interval, not a deadline;
shutdown still waits for existing workers and never forces native tools to stop.
The batch CLI accepts an optional positive `--limit`:
```powershell
python -m cbb_refresh_verify --batch-lmc 'Z:\library\library.lmc' --limit 2
```
The limit selects the first requested names in their existing order. With no
`--block`, the existing non-READY selection supplies those names; repeated
`--block` options retain their explicit order. Omitting `--limit` retains the
existing all-requested behavior. `batch_selection` logs selected, total, and
remaining counts. On batch exceptions or unconfirmed native release,
`batch_drive_retained` identifies the drive, remote share, display library and
Mentor path, and directs the operator to the confirmed-release entry. It never
disconnects a mapping while a native writer may still be active.
Management change counts explicitly cover the compared engineering files only.
Removed from the standalone PR11 head: all five `if False` blocks for the later
release flow, and `_reload_after_maintenance` assignments and its unused reload
branch. The hidden release control and existing method signatures remain for
the later PR12 implementation. When integrating forward, preserve PR12's live
release/resume behavior and retire its dialog-owned action references as well.
Preserve PR13's asynchronous close and lease guards when adding the wait notice.
Validation uses the isolated offscreen review wrapper with fake native boundaries;
it does not open Mentor, kill native processes, invoke Repair, or back up a library.
@@ -0,0 +1,21 @@
# PR #12 comment 313
## Behavior
Window inspection takes a Windows thread snapshot for the requested processes, finds the desktops assigned to those threads, and opens only those desktops. Failures are recorded per affected PID outside the real window list. Unrelated inaccessible desktops no longer disable healthy rows. Preview, cooperative close, forced close, native Cancel and save-prompt responses all use the same per-PID incomplete-read fact during their fresh action-time observation.
Unknown or active native writes still prohibit forced termination. The review's suggested blanket force override for unreadable windows is not implemented: exact identity and private-desktop ownership do not establish that Save/Repair has returned. A failed read names that session and can be retried, while other sessions remain actionable.
Disk evidence retains window identity and a UTF-8 output excerpt of at most 4,096 bytes, original output length and SHA-256. It omits child-control trees and duplicated native-activity output. The complete preview remains in memory for the existing details action.
Native Cancel carries the preview's `block_names` and checks the same Work + SymbolLibs scope before the exact-process/control checks. It no longer silently widens a scoped preview to the full library.
## Verification
The initial five regressions failed against the old implementation. After the fix, 116 residual/backend/UI/background-queue regressions passed; compileall and git diff --check passed. This includes a real controlled Windows window on a private CbbManagement desktop, read from another process, with clean fixture exit and no Mentor/native database actions.
The real fixture caught a platform limitation missed by API doubles: EnumThreadWindows silently omits windows on another desktop. The final implementation maps threads to desktop names and uses OpenDesktop/EnumDesktopWindows for only those mapped desktops. GetThreadDesktop's borrowed handle is never closed; owned OpenDesktop handles and the thread snapshot are closed.
Independent review and the full integrated-chain run are recorded at the final PR #13 tip. Older deep-review comments #297-#300 remain outside this explicitly selected scope. No candidate was rebuilt; real Mentor, Windows 10 and shared/network release scenarios remain unverified.
Review: https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/12#issuecomment-313
@@ -0,0 +1,7 @@
# PR #12 comment 348 follow-up
The review's process-isolation and oversized-output findings target the earlier `5eb4b2d` tree; both are addressed by `651b539` and remain covered by the real private-desktop and bounded-evidence regressions.
The remaining consent/result presentation gap is fixed here. The residual table retains its original six columns and adds confirmation scope and actual result. A row that was allowed at confirmation but rejected after a fresh activity/identity check now shows both facts beside its reason. The result message also counts confirmation-allowed rows and how many remain unreleased; it does not reinterpret preview consent as successful execution or bypass an active-write guard.
The new regression failed before the change. The release-dialog, residual follow-up and private-desktop regression group passed 35 tests. No production/native database action was performed. Integrated full validation is recorded at the PR #13 tip; no candidate build, merge or field acceptance is implied.
@@ -0,0 +1,53 @@
{
"date": "2026-11-09",
"review_url": "https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-319",
"base_commit": "96e179ba6529eefd1401a012155cd7b7cbc0ffc3",
"environment": {
"python": "3.12.10",
"windows": "10.0.26200"
},
"full_suite": {
"tests": 1732,
"failures": 0,
"errors": 0,
"skipped": 0,
"duration_seconds": 501.166,
"xml": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795\\diagnostics\\cbb-refresh-verify-795-review-stack-fixes-full.xml",
"xml_sha256": "578dd4b01db5c18ce657430ce3b2cd2dba8516d8191bdd31bf4e0df78187b3ba",
"warnings": [
"Existing pywinauto Revert to STA COM threading mode warning"
]
},
"focused_suite": {
"passed": 79
},
"compileall": "passed",
"diff_check": "passed",
"independent_review": "No remaining important findings in the scoped diff; durable completion feedback addressed",
"tested_files_sha256": {
"src/cbb_refresh_verify/desktop_worker.py": "173a951d510e78e088c439768ecfe31ab198723e7717b314b4a74a9d590a1fe0",
"src/cbb_refresh_verify/library_lock.py": "391fb2f0b25f400676ba230472fb3bbd4a0d994ed5a8dfee46f8f32c7f198219",
"src/cbb_refresh_verify/mentor_adapter.py": "1fc8c98d5508120e03bf001a42dd3e0da7b165eb18c90f1aed83147d17db8638",
"src/cbb_refresh_verify/native_management.py": "96c2fe613a657d110302c8f7cc033b91ef256e168036f4794eb39be475e69de8",
"src/cbb_refresh_verify/residual_sessions.py": "a19622be3e959a7e64bf9de953450203499fb82618da8537307e5f61ef4d793b",
"src/cbb_refresh_verify/session_record.py": "c4c5771d11d7469980c02f2fb264b26e5ee26634a37daae008dbb65097ab4e0c",
"src/cbb_refresh_verify/ui/main_window.py": "e46096ce784933f3ab47e4c316f3c84e3e5cf07242489323f6234b61aeb22f80",
"src/cbb_refresh_verify/ui/residual_release_dialog.py": "ec7566bac6d92845f98933bffd4c06f31eeec42946e69699aff94e31f9a8baef",
"tests/test_incident_safety.py": "52f3ccb04db8971bf38628c2bd334d4fd79795e97de6538f6f66cb35f7123ece",
"tests/test_integration.py": "9e9d30692607c889e1e3744a63c79c68e3af7d4c86804e0bcebe48e68765086c",
"tests/test_management_supervision.py": "107196ce8a00dd76e7e3e83fb47ae2e67c857fa234492ba593bf71a7d7e1c5e5",
"tests/test_residual_release_dialog.py": "7d2bf95afc2f9112b9433c7d2fefde3b35b5e85a70a6bd506471c039e2505509",
"tests/test_review_319.py": "831fd34d426abb4436b9132bfb7ed754994155a34ac60a59378dee0964b54d28"
},
"not_verified": [
"Frozen execution of this revision",
"Real Mentor native writes/save/close during supervisor loss",
"Windows 10",
"Shared network/cross-machine release",
"ICDB field recovery"
],
"automatic_icdb_repair": false,
"candidate_rebuilt": false,
"merged": false,
"issue_closed": false
}
@@ -0,0 +1,33 @@
# PR #13 review 319 validation
Review: https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-319
Baseline: `96e179ba6529eefd1401a012155cd7b7cbc0ffc3`.
## Changes
- Successful explicit resource proof acknowledges the retained queue entries captured before proof. The alias-set identity is a generation token: unrelated libraries and newer handoffs remain retained. Scoped proof acknowledges only the matching block.
- Final observer outcomes remain available in the residual dialog after its observer ends. The existing refresh/confirm actions provide a running-session retry path. Successful release records a matching operation's RELEASED observation, so history refresh does not resurrect it as unconfirmed. Journal failure is reported separately from the established release fact.
- Discovery observes process identities only. It never opens production databases exclusively, deletes coordination checkpoints, closes clients, or replays operations. Startup observers use the same read-only mode; only explicit release or already-authorized task reconciliation can establish resource release.
- Supervisor loss sets cancellation independently of evidence-write success. An idle worker exits with code 75 only when its matching journal and synchronized in-memory phase both confirm no pending native write and every registered helper has exited. Missing/unknown/stale-active state retains the worker. The watchdog rechecks returned calls and cannot authorize a subsequent native write/helper. Native children are never terminated by this exit; worker exit is not database-release or Save-success evidence.
- Worker phase persistence and watchdog journal reads share a gate to avoid a Windows sharing violation between reading the JSON and atomically replacing it. The dead `_terminate_pid` function is removed; cleanup tests observe actual process-termination boundaries.
## Verification
Commands run through the existing test wrapper with a dedicated mutex namespace and Qt offscreen; no user/native Mentor process is part of these fixtures.
```
python -u -X utf8 diagnostics/run_review_fixes.py "F:/Sync Tool Skyworth/Work Maps/cbb-refresh-verify-795-review-stack"
python -X utf8 -m compileall -q src tests
git diff --check
```
The focused session/watchdog/management/dialog/lease regression run passed 79 tests. The initial regressions were observed failing before the corresponding fixes: explicit proof left a library unavailable, history scan attempted release, orphan idle workers stayed alive, residual refresh omitted runtime records, and successful release reappeared as unconfirmed. Real harmless Windows subprocess fixtures cover PRECALL/POSTCALL, NATIVE_CALL/CLOSING, unknown/missing/stale journals, failed cancel/evidence writes, and rechecking after return.
Full-suite result is recorded in `2026-11-09-review-319-validation.json`. Independent review found no remaining P1/P2 in this scoped diff; its observation about durable completion was addressed and regression-tested.
## Limits
This is source/PR validation. The earlier `0.2.4b2-iconfix-44bb734` executable has not been rebuilt with these changes and must not be used as evidence for this revision. Its icon assets are preserved.
Not validated here: frozen execution of this revision, real Mentor Save/Close or library writes during supervisor loss, Windows 10, shared/network or cross-machine release. ICDB automatic Repair remains disabled. No field-recovery acceptance, merge, formal publication or issue closure is implied.
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,76 @@
# 2026-11-11:逐按钮模拟操作验证
基线:42e87190263453c8e3a7001d5768741b3b3a2c38。
全量 Python 测试 **1,835 passed**,只有既有的 STA COM 模式警告;Windows 私有桌面的界面组 **276 passed** 并正常退出。记录了 **281 次点击信号**、**78 种控件标识**和 **28 张代表性截图**。新增测试包含真实 Qt 文件选择和确认按钮、连点、停止、取消、窗口关闭和动态结果入口。
## 逐按钮模拟操作结果
Windows 原生 Qt 控件,独立私有桌面。48 个应用按钮/复选项全部触发点击信号,另验证 3 个菜单页签;276 项界面相关测试通过。
文件选择和确认框使用真实 Qt 对话框及其按钮;原生读写、恢复、保存、取消、强制结束均使用隔离替身。通过表示界面连接、参数、状态及错误处理通过,不表示真实 Mentor 操作通过。
| 控件 | 按钮 | 结果 | 验证点 |
| --- | --- | --- | --- |
| BackupRecoveryDialog.browse_button | 选择… | 通过 | 真实备份工程选择框打开/取消 |
| BackupRecoveryDialog.restore_button | 恢复并校验 | 通过 | 无效来源拒绝;确认/拒绝;显示受控恢复结果 |
| BackupRecoveryDialog.close_button | 关闭 | 通过 | 空闲关闭恢复窗口 |
| BackupRecoveryDialog.cancel_queue_button | 取消排队 | 通过 | 取消等待票据,不调用恢复后端 |
| MainWindow.native_lm_verify_check | 使用 Library Manager 原生 Verify(Win10 兼容测试) | 通过 | 勾选状态切换,原生 Verify 选项保持独立 |
| MainWindow.advanced_toggle | 高级设置 | 通过 | 展开和收起高级设置 |
| MainWindow.select_visible_button | 选择可见项 | 通过 | 只勾选可见条目 |
| MainWindow.clear_selection_button | 清空选择 | 通过 | 清空勾选 |
| MainWindow.load_button | 读取 CBB | 通过 | 读取当前库并更新清单 |
| MainWindow.browse_button | 选择 | 通过 | 真实选择框打开/取消;取消不触发读取 |
| MainWindow.selected_batch_button | 批量校验已选 | 通过 | 真实确认/拒绝;仅执行可见非 READY 已选项 |
| MainWindow.batch_button | 校验可见非 READY | 通过 | 真实确认/拒绝;只执行可见非 READY 项 |
| MainWindow.icdb_repair_button | ICDB 批量检查 | 通过 | 开始独立 ICDB 检查,不启用自动 Repair |
| MainWindow.backup_restore_button | 从备份恢复 CBB… | 通过 | 为当前非 READY 目标打开备份恢复窗口 |
| MainWindow.reimport_button | 选择工程副本恢复失败项… | 通过 | 副本恢复仍绑定失败 CBB |
| MainWindow.stop_button | 当前项完成后停止 | 通过 | 设置停止标志,后续目标不再执行 |
| MainWindow.logs_button | 打开日志目录 | 通过 | 打开正确目录;目录及系统打开失败时显示错误 |
| MainWindow.recovery_button | 打开异常证据 | 通过 | 打开正确证据路径;系统打开失败时显示错误 |
| MainWindow.native_backup_button | 版本历史与备份… | 通过 | 只启动一次;收到关闭回执后恢复可用 |
| MainWindow.icdb_stop_button | 停止检查 | 通过 | 停止当前后台检查,不再打开后续项 |
| MainWindow.add_button | 新增 CBB… | 通过 | 打开新增操作窗口 |
| MainWindow.update_button | 用工程替换已选 CBB… | 通过 | 打开所选目标的更新窗口 |
| MainWindow.remove_button | 移除已选… | 通过 | 打开所选目标的移除窗口 |
| MainWindow.release_library_button | 释放残留会话… | 通过 | 打开当前库的释放预览 |
| MainWindow.queue_release_button | 查看残留会话… | 通过 | 打开等待库的释放预览,关闭面板不误解锁任务 |
| MainWindow.runtime_log_toggle | 查看运行日志 | 通过 | 显示/隐藏运行输出 |
| ManagementDialog.sources_button | 选择来源工程… | 通过 | 真实工程选择框打开/取消并更新来源行 |
| ManagementDialog.auto_verify | 本批次上传后自动校验 | 通过 | 切换本批次自动校验选项 |
| ManagementDialog.release_wait_button | 查看残留会话… | 通过 | 传出等待释放的目标库 |
| ManagementDialog.logs_button | 查看日志 | 通过 | 显示/隐藏管理日志 |
| ManagementDialog.execute_button | 预览并确认执行… | 通过 | 真实确认/拒绝,重复点击不重复执行 |
| ManagementDialog.stop_button | 当前项结束后停止 | 通过 | 设置管理任务停止标志 |
| ManagementDialog.close_button | 关闭 | 通过 | 空闲关闭,执行中禁用点击不打断任务 |
| PcbRestoreDialog.manual_button | 最后手动保存 | 通过 | 只选择最后手动保存版本,关闭不覆盖已有选择 |
| PcbRestoreDialog.auto_button | 自动保存 | 通过 | 只选择自动保存版本,关闭不覆盖已有选择 |
| PcbRestoreDialog.cancel_button | 取消 | 通过 | 取消选择,不默认回退版本 |
| ResidualReleaseDialog.refresh_button | 重新检查 | 通过 | 重新扫描预览,不执行释放 |
| ResidualReleaseDialog.confirm_button | 确认释放 | 通过 | 传递当前确认范围,显示实际释放结果 |
| ResidualReleaseDialog.prompt_button | 处理保存提示… | 通过 | 真实是/否/取消,传递对应保存选择 |
| ResidualReleaseDialog.details_button | 查看原生提示… | 通过 | 显示原生提示全文和详细信息 |
| ResidualReleaseDialog.cancel_native_button | 请求原生取消… | 通过 | 真实确认/拒绝后发送受控取消请求 |
| ResidualReleaseDialog.force_button | 强制结束客户端… | 通过 | 真实确认/取消后传递强制标志;未调用实际强杀 |
| ResidualReleaseDialog.close_button | 关闭 | 通过 | 空闲关闭;执行中请求停止并等待当前项返回 |
| Result.batch_release | 查看残留并释放… | 通过 | 从批量失败结果打开当前库释放入口 |
| Result.batch_resume | 继续未执行项 | 通过 | 释放确认后只执行此前未执行的目标 |
| Result.batch_copy | 选择副本恢复… | 通过 | 兼容维护结果中的副本恢复仍绑定失败工程 |
| Result.icdb_release | 查看残留并释放… | 通过 | 从 ICDB 结果打开对应库释放入口 |
| Result.icdb_copy | 选择副本恢复… | 通过 | 从 ICDB 结果打开对应失败工程的副本恢复 |
每项对应的测试编号、点击次数、完整事件记录及代表性截图见同目录 button-matrix.json / windows-all.json。
本轮额外修复:打开日志目录时,目录创建失败或系统拒绝打开不再向 Qt 事件循环抛出未处理异常,改用现有错误提示。
未验证:真实 Mentor 写库、ICDB 修复、Windows 10、跨机器共享库。
## 验证边界与构建记录
实际原生写库、历史回退、保存、原生取消及强制结束均使用隔离替身。未触碰现场工程或中心库,未证明 ICDB 原生修复成功;Windows 10 和跨机器共享库仍未验收。
首次候选构建因 C 盘空间不足在收集文件阶段失败,未计为通过。本轮未完成构建已迁至 F 盘继续,原候选和测试证据保留。最终构建及冻结验证结果见相邻验证 JSON。
逐按钮的测试编号与点击次数、界面 XML、截图路径和文件哈希保存在相邻验证 JSON 及其引用的本机证据中。截图只提供代表性界面,逐项结论以测试断言和点击记录为依据。
@@ -0,0 +1,210 @@
{
"date": "2026-11-11",
"baseline": "fdd07224aac99bee8d1f29e8e82d6a2c49964c87",
"review_comment": "https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-381",
"full_suite": {
"tests": 1789,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 341.04
},
"focused_final": {
"tests": 57,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 10.935
},
"windows_native_direct_runs": [
{
"tests": 21,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 14.625
},
{
"tests": 21,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 11.765
}
],
"windows_platform": {
"platform": "windows",
"desktop": "CbbUiReview381_ea1f0bcdc2",
"exit_status": 0,
"total": 21,
"failures": 0,
"mentor_calls": false
},
"inconclusive_windows_controller_run": {
"controller_exit_code": 1,
"assertion_total": 21,
"assertion_failures": 0,
"counted_as_pass": false,
"controller_cause_confirmed": false,
"followup": "Direct pytest launch and stack diagnostics; two direct runs exited 0."
},
"negative_control": {
"expected_failure": true,
"result": {
"tests": 1,
"failures": 1,
"errors": 0,
"skipped": 0,
"seconds": 3.75
},
"method": "Only baseline _queued_action restored in test memory; no source mutation."
},
"compileall_passed": true,
"diff_check_passed": true,
"tested_production_sha256": "a18d36f893f6e23b8e52b3d7e0b8cfba9ebfa08abb44acb54219cc092b318942",
"full_run_file_hashes": {
"src/cbb_refresh_verify/ui/main_window.py": "a18d36f893f6e23b8e52b3d7e0b8cfba9ebfa08abb44acb54219cc092b318942",
"tests/test_review381_queue_release.py": "56661d607b55d1284fad69105d4457ab6816696a998188d6986ed67765b326e0",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.ico": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.png": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.svg": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328"
},
"final_file_hashes": {
"src/cbb_refresh_verify/ui/main_window.py": "a18d36f893f6e23b8e52b3d7e0b8cfba9ebfa08abb44acb54219cc092b318942",
"tests/test_review381_queue_release.py": "e568a2701337be068af91a03ff3451d82c705109a7b62c3c11663a42bcf552b5",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.ico": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.png": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.svg": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328"
},
"test_refinement_after_full": "Only one test gained an admission barrier; production unchanged; focused and Windows rerun.",
"candidate_rebuilt": true,
"candidate_executable": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-candidate\\dist\\CbbRefreshVerify-Background\\CbbRefreshVerify.exe",
"bundle": {
"module_count": 62,
"source_and_frozen_code_equal": true,
"source_sha256_checked": true,
"packaged_assets_equal": true,
"exe_icon_images_equal": true,
"executable_sha256": "71812c1fdfa6522fad4468f4ca4c7d8f77aa9c6880b70f0d8b7ad58a31d55ec2"
},
"frozen_smoke": {
"gui": {
"status": "passed",
"exit_code": 0
},
"verify-worker": {
"exit_code": 1,
"status": "passed",
"evidence": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-candidate\\smoke-319c4ff4\\verify-worker"
},
"management-worker": {
"exit_code": 2,
"status": "passed",
"evidence": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-candidate\\smoke-319c4ff4\\management-worker"
},
"owner-probe": {
"exit_code": 0,
"status": "passed",
"evidence": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-candidate\\smoke-319c4ff4\\owner-probe"
},
"dialog-agent": {
"status": "passed",
"exit_code": 0,
"scope": "empty PID set, observe only"
},
"module_origins": {
"status": "passed",
"module_count": 62,
"source_root": "F:\\Sync Tool Skyworth\\Work Maps\\cbb-refresh-verify-795-review-stack\\src"
},
"version": "0.2.4b2"
},
"independent_review": {
"scope": "review381 and directly related stale/cross-task release UI",
"reviewer": "review381_final",
"reviewed_files": [
"src/cbb_refresh_verify/ui/main_window.py",
"tests/test_review381_queue_release.py"
],
"finding": "foreground completion erased independent background wait",
"followup": "fixed; both completion orders reproduced failing then passing",
"final_review": "no additional findings",
"review_native_calls": false
},
"native_mentor_operations_verified": false,
"icdb_repair_accepted": false,
"field_library_modified": false,
"windows10_verified": false,
"shared_library_verified": false,
"merged": false,
"artifacts": {
"review381-baseline.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-baseline.xml",
"sha256": "f224548b02b5841f7d3148375eea50f6505c83af912b66a7d67c5d572bc287b3"
},
"review381-red-controlled.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-red-controlled.xml",
"sha256": "15c620cb4ec251501d83fd7ebc4ee654df8b0e4b7aa8f8ccb2d7af30ec162c5f"
},
"review381-interleaved-red.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-interleaved-red.xml",
"sha256": "fea4342c4bdab3b03e70f70585e66281188ac80ae7613e4bf7db9fcd616ce1f5"
},
"review381-completion-red.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-completion-red.xml",
"sha256": "6dab11fbba7878db81885f5d11fadc5c80728a9dab3cab8edd0883cb7015d3e2"
},
"review381-full.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-full.xml",
"sha256": "9f73a2dddae8831c2bad4ae1fb2f2f509b1981508a512fffb208dce1a858860f"
},
"review381-focused-barrier.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-focused-barrier.xml",
"sha256": "ec7fd3dc3ce869b97ed3f22e7e9528f60dc8512a89e451eae434fe665bae838a"
},
"review381-admission-negative-control.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-admission-negative-control.xml",
"sha256": "ecb66304ee5cc1be9c19c4ba33c57a7bd86e65b156a959fa5665cba2274679e9"
},
"review381-windows-direct-first.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-windows-direct-first.xml",
"sha256": "3ba672a9190a5ec715ae99db01c0faca1b3bfcfe9d25a25ba46309af7f5c1880"
},
"review381-windows-direct-first-platform.json": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-windows-direct-first-platform.json",
"sha256": "a255f39b48fe69656c553b6a4feff6f905beb1e18ba2de9724454f15d3d8ea56"
},
"review381-windows.xml": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-windows.xml",
"sha256": "a2d53895c5afaf0907a670d544cd98db6c786bbf75f2e520ac0355d3c4a88ff2"
},
"review381-windows-platform.json": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-windows-platform.json",
"sha256": "e06d76c1c2c297f6d4e11f76a903666a1bdf47cdc81a26a295c2040ef9381bbb"
},
"review381-independent-review.json": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-independent-review.json",
"sha256": "155c0b1c4ae3ecb5b94b1a2d321e47b96a4885f18cc369f36c82408b20959981"
},
"review381-candidate/source-sha256.json": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-candidate\\source-sha256.json",
"sha256": "6028d5cb3f6eeec68ae938fb73223d5343de7c8671ba3b77d9a1d1e6faa37608"
},
"review381-candidate/bundle-verification.json": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-candidate\\bundle-verification.json",
"sha256": "08117158e59192c7ee7f0538968b24d5e4cb8e9f8f230636bd009aa39ffbc4b5"
},
"review381-candidate/smoke-319c4ff4/result.json": {
"path": "C:\\Users\\ABS_Windows\\.codex\\visualizations\\2026\\11\\02\\01a19b86-b23f-7fe0-9407-45a4303e10e3\\review381-candidate\\smoke-319c4ff4\\result.json",
"sha256": "3cefd58746044c0f48455aba9796b0a30687ee5a30084fa1948449e5094c1a10"
}
},
"committed_file_hashes": {
"src/cbb_refresh_verify/ui/main_window.py": "a18d36f893f6e23b8e52b3d7e0b8cfba9ebfa08abb44acb54219cc092b318942",
"tests/test_review381_queue_release.py": "e0d62424cbf70ec9573db78ede0a4c6534775399194eed4c6b28ba8d468307be",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.ico": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.png": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.svg": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328"
},
"post_validation_whitespace_cleanup": "Trimmed one trailing blank line in test file; compiled test code equal; staged diff check rerun."
}
@@ -0,0 +1,43 @@
# PR #13 评论 381:等待入口与交错操作验证
对应审查:<https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-381>。基线为 `fdd07224aac99bee8d1f29e8e82d6a2c49964c87`。
## 修复行为
校验获得原生执行机会后,立即刷新执行状态和残留入口。入口显示及点击均复核现有的内存保留状态,已释放的库不会因旧消息或延迟点击重新打开释放面板。窗口进入关闭流程后,不接受新的释放面板请求。
等待消息在覆盖当前目标前,同样检查消息所指库现在是否仍被保留。另一个库的普通排队消息、已过期的保留消息或 ICDB 开始事件,不会抹掉仍有效的等待入口。
独立复查补充发现:前台任务结束会清除另一个库正在等待的后台 ICDB 入口。现在前台结束时保留该后台任务的有效入口;后台取消或结束时,移除属于它的过期入口,同时保留同库前台仍需要的入口。路径比较使用已知别名,不查询磁盘、网络或 WMI。
没有新增库锁、占用扫描、轮询线程或强制结束逻辑。原生执行仍串行;未确认释放时的同库保护和自动 Repair 关闭状态不变。本次不调整整批调度。
## 实际执行的验证
| 验证 | 结果 |
| --- | --- |
| 既有队列入口基线 | 7 通过 |
| 原问题及交错操作,修复前 | 7 失败、2 通过;随后扩展的交错用例另有 3 项预期失败 |
| 前台结束/后台取消两种顺序,修复前 | 2 项均失败 |
| 全量 Python 测试 | 1,789 通过、0 失败、0 跳过;既有 STA COM 模式警告 1 项 |
| 加强并发屏障后的相关回归 | 57 通过 |
| Windows 原生 Qt 控件,独立私有桌面 | 21 项通过;直接启动的最终验证记录另存 JSON/XML |
| 负向对照 | 仅在测试进程内恢复旧的队列接纳方法,新用例稳定失败;不修改源文件 |
| 编译及差异检查 | `compileall` 和 `git diff --check` 通过 |
| 新冻结候选包 | 5 项冒烟通过;62 个包内模块与源码一致;包内图标及 EXE 图标资源一致 |
全量测试后仅加强了一个测试的时序屏障,业务源码没有再变化;加强后的测试文件已重新执行相关回归和 Windows 控件验证。全量时与最终测试文件的哈希分别保留。
新增的 14 项用例覆盖:执行尚未结束时隐藏旧入口;五次延迟点击;过期等待消息;独立库事件交错;反复打开、关闭和重开面板;重复点校验后停止再点释放;前后台任务先后结束;关闭过程中送达的点击。控件点击使用真实 PySide6 控件与事件循环;库数据和原生扫描采用隔离替身,不操作现场库。
一次较长启动链的 Windows 验证中,21 项断言均通过,但外层控制器返回 1,未计为完整通过。随后缩短验证启动链,直接启动 pytest,并加入超时堆栈记录;直接运行的正常退出结果单独保留。不能据此把那次控制器异常认定为已复现的业务故障,也不隐去该次未完成验证。具体记录见相邻验证 JSON。
## 候选包与边界
新包位置记录于 `2026-11-11-pr13-review381-validation.json`,构建和验证产物保存在本机 Codex visualizations 目录。EXE SHA-256:
`71812c1fdfa6522fad4468f4ca4c7d8f77aa9c6880b70f0d8b7ad58a31d55ec2`
冻结冒烟包括 GUI 创建及正常退出、启动前取消的 Verify worker、桌面不匹配时拒绝操作的管理 worker、空所有者查询,以及私有桌面上空 PID 范围的弹窗观察。后四项是受控边界验证,不代表真实原生操作成功。
本轮未执行真实 Mentor Save/Close/Add/Remove 或 ICDB 修复,未写入现场中心库;也未验证 Windows 10、跨机器共享库或现场故障一致副本。不能将本次界面和生命周期验证作为 ICDB 自动修复成功的依据。不合并发布、不关闭现场工单。
@@ -0,0 +1,235 @@
# 当前程序流程、阻塞点与错误节点
> 证据路径说明:本文的本机绝对路径、日志名、截图、测试 XML 和冻结包指向验收机器上的原始材料,未纳入 Git;仓库仅保留说明和验证摘要。
> 这是修改前 `42d0ceb` 的流程快照。后续修复及真实复测见 [占用范围验证](2026-11-12-scoped-release-validation.md)。
依据提交 `42d0cebc54191681b53dcecb120f53236c1963bb` 的代码及 2026-11-12 冻结程序原生验收记录。本文件只分析当前行为,没有实施下面建议的调整,也没有新增原生验收。
后续只读核查已用外部软件自身日志确认 E01 的两个未知阻塞进程来自 DxPartReplace 测试,创建时间、父进程和私有桌面交叉匹配;外部工程引用原库,本次 CBB 验收使用隔离库。详见 [进程来源核查](2026-11-12-process-origin-audit.md)。这进一步确认了并行软件触发本程序范围判定漏洞,不能将其解释成本程序自身客户端未退出。
红色 E 节点表示真实验收已经发生、仍未解决的问题;橙色 B 节点表示代码中确实存在的等待、拒绝或失败分支,但不表示每个条件都已复现;绿色 F 表示本轮修复并复测通过的位置。各入口在 UI 中独立,底层原生调用仍共享串行通道。
## 一、最需要处理的阻塞链
```mermaid
flowchart LR
A[单个 CBB 失败或被停止] --> B[PCB 或助手未确认退出]
B --> C[safe_to_continue 为 false]
C --> D[B02 同库后续项被跳过]
C --> E[B01 后续任务等待库可用]
E --> F[用户打开释放窗口]
F --> G[正常关闭本工具 PCB]
G --> H[E01 其他任务的未知会话也被纳入必须退出的集合]
H --> I[整库释放仍为 PARTIAL]
I --> E
classDef error fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef risk fill:#fff3cd,stroke:#d97706,color:#78350f
class H,I error
class D,E risk
```
这条链中的核心缺陷是:**当前项是否失败、当前项是否留下占用、整个库能否继续、其他工具是否正在运行,没有彻底分开。** 某项失败但 `safe_to_continue=true` 时,当前代码会继续处理下一项,真实多来源新增已验证这一点;`false` 则会阻止同库后续项,不能称为“所有失败都不会影响整批”。
## 二、阻塞与失败清单
| 标记 | 发生位置与触发条件 | 当前后果、影响范围 | 证据与处理方向 |
| --- | --- | --- | --- |
| **E01 已复现、未修复** | 释放集合包含 scope_confirmed=false 的其他任务进程;释放函数要求全部观察项 RELEASED;底层证明也把没有目标路径的进程作为可能占用 | 本工具 PCB 已退出,整库仍 PARTIAL;保留状态无法清除,同库后续任务继续等或被跳过 | R7 的 PCB 21856/21248 均退出;其他任务 viewdraw 29832 为 WAITING。必须区分观察项与本库目标,并用目标资源证明决定能否继续,不能直接结束其他任务 |
| **E02 已复现、未走通** | PCB 启动出现原生“确认无其他用户,以读写权限继续”提示 | 当前打开判为 DATABASE_SAFETY_STOP;普通校验未 READY,ICDB 检查无法确认,备份副本不安装。关闭成功时本项失败仍可安全继续 | 该正文不直接证明 ICDB 损坏。代码有受限的修复后授权分支,但不是普通打开时通用的用户确认入口 |
| **E03 已复现、未修复** | A/B 来源工程的原生 EDIF 导出器退出 0xC0000005 | 本项上传失败;退出及资源释放证明成功后下一项继续,不能跳过身份比对报告成功 | 相同批次 C 能新增成功。需进一步定位原生导出与输入兼容性 |
| **B01 可长期排队** | NativeQueue 没有排队总超时;等待 active=false 且本库 library_available=true | UI 线程保持运行,但普通校验、管理、刷新等任务可能一直显示等待;可取消排队。活动任务未返回时,即使不同库也不能使用同一个原生通道 | 属于后台任务等待,不等于界面卡死;不同库且条件满足的票据可以越过暂不可用票据。需要展示等待对象、阶段及下一步,而不是单一“忙” |
| **B02 失败传播到同库** | run_batch、run_management_batch、IcdbCheckTask 遇 safe_to_continue=false;未知异常也可能保守置 false | 同库后续项 SKIPPED;其他库不因这个集合被跳过;CANCELLED/QUEUE_STOP 或用户停止会停止余下队列 | 现有规则确实仍会让单项占用影响本库整批。后续需分辨仅此工程占用与共享库占用,不能盲目把 false 改 true |
| **B03 执行互斥与协调锁** | Windows 会话级 Local/CbbRefreshVerify795 被占用;库协调锁被持有;历史 blocked/pending 记录存在或身份不符 | 直接拒绝本次操作,或先复核旧记录;未确认时保留本库协调锁/记录 | 多个应用实例、独立上传工具、崩溃遗留均可能触发。历史记录本身不是仍在写库的证明 |
| **B04 地址、数据库、在途调用** | 存在 sAddress.adr;数据库/LMC/Layout 独占读失败;仍有本库原生写入或导出副本所有者 | 当前操作或释放证明失败;真实在途写入应继续保护。陈旧地址和不完整日志也可能导致无法确认 | 当前主要哈希排除地址文件,但占用判断仍会使用它们;不能用“哈希忽略了”推断“占用也已忽略” |
| **B05 原生调用未返回** | Add/Remove/COM 调用或原生进程超过监督时限 | 有些监督入口返回超时并保留真实 worker;真实写入继续观测;CleanWGLib 超时后仍等待其自然退出,不能把超时当释放 | 可能同时占着执行通道、库锁或保留状态。需要区分取消未开始项、请求原生取消、仍在写入、可以关闭的客户端 |
| **B06 原生版本窗口仍打开** | iCDB Project Backup 原生窗口尚未关闭,或关闭结果未确认 | 同库校验/恢复受到限制;同库 ICDB 后台检查会暂停,关闭并确认后恢复;不是自动修复失败 | 这是实际原生编辑会话的互斥。不能通过关闭应用或删除记录假装窗口已关闭 |
| **B07 格式、能力与来源校验** | 缺失/越界引用、不支持的版本或接口、目标分区不唯一、来源同名不匹配、未完成变更记录仍需恢复 | 本项拒绝;新增遇同名冲突明确失败;未完成写操作不会在重启后自动重放 | 这些多数属于输入/恢复边界;要给出具体原因和可纠正入口,不能混成 ICDB 问题 |
| **B08 来源/目标内容变化** | 暂存复制前后文件集合或主要哈希变化;基线后中心库更新;恢复前来源或目标变化 | 停止当前写入或恢复。更新已 Remove 但尚未 Add 成功时可能 RECOVERY_REQUIRED | 应保留阶段、原 Work 或人工备份路径;不能把部分成功视为整体成功 |
| **B09 权威状态与工程身份** | 保存/关闭失败;注册内容不符;中心库复读失败;校验后不是 GREEN/READY | 当前项不通过;是否影响后续取决于释放事实。上传成功可为 UPLOADED,但不等于 UPLOADED_VERIFIED | 不能仅以 PCB 窗口打开、COM 返回或文件目录存在判成功 |
| **B10 IO、路径与证据存储** | 网络盘不可见、路径映射失败、证据目录不可写、检查点变化、空间不足 | 读取/当前任务失败;关键写前检查点保存失败时不开始写入;某些辅助诊断写入失败只记录警告 | 网络/磁盘与原生数据库错误要分开报告;恢复需先复制验证库,因此有实际容量和耗时 |
| **B11 程序关闭等待** | 关闭时检查仍活动、当前任务仍忙、线程池或路径租约操作仍未结束 | 首次关闭可能只请求停止;进入关闭流程后等线程池/租约结束,代码没有统一关闭总超时 | R7 正常退出通过,不代表 COM 永久不返回场景也能退出;需要单独验收这一条件 |
| **F01 已修复复测** | 原生私有桌面 GetThreadDesktop 拒绝访问;重新 OpenDesktop 后 HWND 不可读 | 之前误报窗口归属变化,无法正常释放 | 已改为有界桌面枚举、映射窗口后再核对 PID,真实 PCB 正常取消退出通过 |
| **F02 已修复复测** | 状态刷新期间结果窗口的释放按钮仍可点击,函数因 busy 直接返回 | 之前按钮点击无窗口 | 已跟随 busy/排队目标更新,R7 先禁用后可用,点击能打开释放窗口;不等于 E01 已解决 |
另有 **P2 结果展示错误**:释放数量包含自然退出且未允许操作的观察项,因此出现“已释放 4 个,确认允许 2 个”。这是统计问题,不是解除占用的证明。
## 三、完整业务流程总图
下图按实际任务边界展开:所有菜单可以独立提交请求;排队串行的是 Mentor 原生操作。为保持图可读,把共享的 PCB 子流程和释放子流程放在后两张展开图中,节点 V、R 在各图中指向同一过程。
```mermaid
flowchart TD
START[启动桌面应用] --> INIT[配置日志、加载原生能力、异步发现未完成任务]
INIT --> LIB[选择中心库并建立路径映射 B10]
LIB --> READ[读取 CBB、工程文件及权威状态 B07 B09]
READ --> LIST[搜索、筛选、可见项勾选]
LIST --> OP{选择独立操作入口}
OP --> VERIFY[检验:只取可见非 READY 项]
OP --> CHECK[ICDB 批量检查:只取可见非 READY 项]
OP --> HISTORY[版本历史与备份:单个非 READY 项]
OP --> RECOVER[从完整工程备份恢复:非 READY 项]
OP --> MANAGE[中心库管理:READY 可更新或移除]
OP --> R[释放残留:进入释放子流程]
VERIFY --> CONFIRM[显示目标与确认;写操作提示人工备份]
CHECK --> CONFIRM
HISTORY --> ADMIT
RECOVER --> CONFIRM
MANAGE --> CONFIRM
CONFIRM --> ADMIT[原生队列准入 B01:可取消;按目标库保留状态判断]
ADMIT --> DISPATCH{任务类型}
DISPATCH -->|普通校验| V[共享 PCB 打开、弹窗、校验、关闭子流程 E02]
DISPATCH -->|检查| CITEM[每项重新判断 READY 和内容是否更新]
CITEM -->|应跳过| RESULT
CITEM -->|应检查| CV[调用 V;仅诊断打开,不保存校验、不 Repair]
CV --> CLASSIFY{本次错误正文含 ICDB 特征吗}
CLASSIFY -->|正常打开并关闭| CLEAN[CHECKED;不等于 READY]
CLASSIFY -->|含有特征| ICERR[报告 ICDB 问题;不执行自动修复]
CLASSIFY -->|其他弹窗或无法打开| UNCERTAIN[无法确认;保留原错误 E02]
CLEAN --> RESULT
ICERR --> RESULT
UNCERTAIN --> RESULT
DISPATCH -->|版本管理| HOPEN[绑定工程后打开原生备份窗口 B06]
HOPEN --> HUSER[用户查看、创建备份或选择版本回退]
HUSER --> HCLOSE[等待窗口正常关闭、释放结果及状态复读 B06 B09]
HCLOSE --> RESULT
DISPATCH -->|备份恢复| BVALID[来源身份、路径、文件、空间检查 B07 B10]
BVALID --> BCOPY[复制隔离验证库与备份工程 B08]
BCOPY --> BV[调用 V:在副本校验 E02]
BV --> BOK{PASS、GREEN 且安全释放}
BOK -->|否| BUNCHANGED[恢复失败;目标不安装]
BOK -->|是| BCOMPARE[复核来源和目标未变化 B08]
BCOMPARE --> INSTALL[旧 Work 改名保留,再安装副本 B08 B10]
INSTALL --> TV[调用 V:重新打开实际目标 B09]
TV --> RESULT
BUNCHANGED --> RESULT
DISPATCH -->|管理| MPRE[原生能力、来源、历史任务、库锁检查 B03 B07]
MPRE --> MCAT[原生目录复读并核对名称和分区 B09]
MCAT --> MBASE[记录内容基线;来源工程复制暂存 B08]
MBASE --> MOP{新增、更新或移除}
MOP -->|新增或更新| EXPORT[原生 ASCII、CSV、EDIF 身份导出 E03]
EXPORT --> MWRITE[新增 Add;更新 Remove 后 Add B05 B08]
MOP -->|移除| REMOVE[原生 Remove B05]
MWRITE --> MREAD[目录复读、内容身份及释放核对 B09]
REMOVE --> MREAD
MREAD --> AUTO{新增或更新启用自动校验吗}
AUTO -->|是| MV[调用 V 进行校验;上传成功与校验成功分别记录]
AUTO -->|否或移除| RESULT
MV --> RESULT
V --> RESULT[逐项记录结果、阶段、证据与释放事实]
RESULT --> SAFE{safe_to_continue}
SAFE -->|true| NEXT[继续下一项;ICDB 检查在每项之间让出原生队列]
SAFE -->|false| RETAIN[B02 保留本库会话状态;同库余项跳过]
RETAIN --> R
NEXT --> MORE{还有任务且未停止吗}
MORE -->|是| ADMIT
MORE -->|否| REFRESH[刷新受影响条目的权威状态 B09;生成报告 B10]
REFRESH --> LIST
R -->|证明成功| RESUME[清理本库保留状态;必要时用户继续未执行项]
R -->|未确认 E01| RETAIN
RESUME --> LIST
LIST -->|关闭应用| EXIT[停止当前任务并等待线程池、租约结束 B11]
EXIT --> END[程序退出]
classDef error fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef risk fill:#fff3cd,stroke:#d97706,color:#78350f
classDef good fill:#dcfce7,stroke:#16a34a,color:#14532d
class V,CV,UNCERTAIN,BV,EXPORT,R error
class LIB,READ,ADMIT,HOPEN,HCLOSE,BVALID,BCOPY,BCOMPARE,INSTALL,TV,MPRE,MCAT,MBASE,MWRITE,REMOVE,MREAD,RETAIN,REFRESH,EXIT risk
class CLEAN,RESUME good
```
图中的“回到队列”是下一次任务准入的概览:当前普通校验和管理批次在批次外围占用队列;ICDB 检查每完成一个 CBB 才释放并重新排队,不能理解为三种批次都已经逐项让出通道。读取/状态刷新也会使用原生队列,纯内存搜索与筛选不启动 Mentor。
## 四、共享 PCB 任务展开图 V
```mermaid
flowchart TD
V[开始:普通校验、检查或恢复副本校验] --> GATE[取得会话互斥、复核历史释放、取得库锁 B03 B04]
GATE --> PRE[检查 PRJ、PCB、依赖和证据目录 B07 B10]
PRE --> CONTENT{普通校验且配置了额外内容检查吗}
CONTENT -->|是| EXTRA[Importer 内容检查;失败结束本项]
CONTENT -->|否| LAUNCH
EXTRA -->|通过| LAUNCH[创建私有桌面与监督 worker;启动 PCB B05]
EXTRA -->|失败| FAILURE
LAUNCH --> OPEN{原生打开结果}
OPEN -->|读写确认提示| PERMISSION[E02 普通入口缺少通用授权交互;当前安全停止]
OPEN -->|可识别版本选择| VERSION[用户选最后手动保存、自动保存或取消;适用入口才提供]
OPEN -->|其他错误或未知弹窗| FAILURE[本项失败,记录实际文本或超时 B05]
OPEN -->|打开完成| MODE{仅诊断打开吗}
VERSION -->|可继续| OPEN
VERSION -->|取消| FAILURE
MODE -->|是| DIAG[证明目标已打开;请求关闭,不执行保存校验]
MODE -->|否| VERIFY[实际原生校验、保存、关闭 B05 B09]
VERIFY --> READY[中心库权威复读:必须 GREEN/READY B09]
PERMISSION --> CLOSE
FAILURE --> CLOSE
DIAG --> CLOSE[正常关闭、取消已知启动弹窗、释放 COM 和自动化助手]
READY --> CLOSE
CLOSE --> OWNERS[确认 worker、PCB、启动器和目标资源已释放 B04;桌面访问 F01 已修复]
OWNERS -->|成功| OUT[返回本项业务结果,safe_to_continue=true]
OWNERS -->|失败或无法确认| RETAIN[保留证据与会话,safe_to_continue=false,触发 B02]
classDef error fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef risk fill:#fff3cd,stroke:#d97706,color:#78350f
class PERMISSION error
class GATE,PRE,LAUNCH,FAILURE,VERIFY,READY,OWNERS,RETAIN risk
```
普通校验和检查都不默认启动自动 Repair。仓库中仍保留修复与修复后授权代码,但当前桌面批量检查路径明确关闭自动修复,不能把存在函数等同于产品入口已接通。
## 五、释放任务展开图 R
```mermaid
flowchart TD
R[主窗口或结果窗口点击释放] --> UI[校验当前目标与按钮可用状态 F02 已修复]
UI --> SCAN[异步枚举进程、线程桌面、窗口、历史会话]
SCAN --> GROUP{能证明属于本库吗}
GROUP -->|是| TARGET[可确认的目标客户端]
GROUP -->|否| OBSERVE[归属未知,只允许观察]
TARGET --> CONSENT[用户确认正常关闭;可查看原生提示]
CONSENT --> ACTION[重新核对 PID、创建时间、映像、窗口后正常关闭 F01 已修复]
ACTION --> PROMPT{还有原生提示吗}
PROMPT -->|保存提示| SAVE[用户保存、放弃或保留;真实分支尚未完整验收]
PROMPT -->|支持取消的活动窗口| CANCEL[确认后请求原生 Cancel;不当成取消已完成]
PROMPT -->|无| EXITCHECK
SAVE --> EXITCHECK[观察真实进程是否退出]
CANCEL --> EXITCHECK
EXITCHECK --> ALL{当前代码:所有观察项都 RELEASED 吗}
OBSERVE --> ALL
ALL -->|否| ERROR[E01 未归属本库的其他任务也会让整体 PARTIAL]
ALL -->|是| PROOF[持有证明句柄检查本库、共享库、地址、导出副本和在途调用 B04]
PROOF --> UNKNOWN[E01 底层仍可能把路径未知进程当候选占用]
UNKNOWN -->|不能证明| ERROR
UNKNOWN -->|证明成功| RECORD[归档匹配的历史记录,清理对应保留状态及映射]
RECORD --> RELEASED[RELEASE_CONFIRMED;允许重新尝试]
ERROR --> WAIT[B01 队列仍等或 B02 本库余项已跳过;显示残留原因]
WAIT -->|用户重新检查| SCAN
classDef error fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef risk fill:#fff3cd,stroke:#d97706,color:#78350f
classDef fixed fill:#dcfce7,stroke:#16a34a,color:#14532d
class ALL,ERROR,UNKNOWN error
class PROOF,WAIT,SAVE,CANCEL risk
class UI,ACTION,RELEASED fixed
```
强制结束是另一个需要确认的分支:只针对已确认归属、符合条件的客户端,不能结束数据库服务器或归属未知进程;本轮真实操作只验收了打开确认后取消,没有执行强制终止。它不会消除 E01,不能作为释放判断错误的替代方案。
## 六、代码位置与四层协调机制
| 机制 | 位置 | 控制范围 |
| --- | --- | --- |
| 原生队列 | `operation_queue.py:18`、`ui/main_window.py:844`、`ui/management_dialog.py:174` | 应用内一次执行一个原生任务;按库保留状态允许其他可运行票据越过等待项 |
| Windows 会话互斥 | `verify_runner.py:547`、`management.py:172`、`backup_recovery.py:145` | 同一 Windows 会话中的本工具原生调用;不是每工程独立互斥 |
| 库协调锁与历史阻止记录 | `library_lock.py:129`、`:443`、`:523` | 按中心库控制写入与释放;历史记录需复核,不能直接删除当成功 |
| 运行时保留状态 | `session_record.py:25`、`:236`、`:354`、`:443` | 原生队列准入、助手与客户端身份观测;日志阶段不等于真实进程状态 |
| 导出副本所有权 | `native_export_guard.py:10`、`native_engineering_identity.py:288` | 防止原生导出器仍持有分析副本时释放相关操作 |
关键传播代码:`verify_runner.py:1294`、`management.py:430`、`ui/icdb_check_task.py:55`。E01 的双重判定:`residual_sessions.py` 中 `_release_residual_sessions` 的全部行 RELEASED 条件,以及 `library_lock.py:443` 的 `_prove_library_released`。E02:`dialog_rules.py:222`、`verify_runner.py:895`。E03:`native_engineering_identity.py:288`。退出等待:`ui/main_window.py:1709`。
建议处理顺序:**E01 的本库释放判定 → B02 的工程/共享库影响范围 → E02 的明确用户确认路径 → B01/B05/B11 的等待及停止结果 → E03 输入兼容性与剩余条件按钮原生验收**。这些是后续工作建议,未在本次流程整理中实施。
@@ -0,0 +1,73 @@
# 误判复核与优化顺序
> 证据路径说明:本文的本机绝对路径、日志名、截图、测试 XML 和冻结包指向验收机器上的原始材料,未纳入 Git;仓库仅保留说明和验证摘要。
> 这是当天早期的复核与建议;后续实施结果见 [占用范围验证](2026-11-12-scoped-release-validation.md),不将早期未通过项追记为成功。
依据 `42d0ceb` 的六处修复记录、真实冻结程序验收,以及 13:44–13:46 的外部进程归属交叉核对。本轮只做分类和优化建议,没有修改业务代码。统计单位是已知问题根因,不能据此估算整个程序的缺陷率。
## 已修复的六处问题
| 问题 | 复核分类 | 依据 |
| --- | --- | --- |
| 导出器退出期间 OpenProcess 返回 5,立即认为释放失败 | 误判/过早得出失败结论 | 原生退出竞争;需要继续观察新快照与目标文件,而不是只看一次权限错误。已修复并有真实导入/更新复测 |
| 无工程参数的外部 viewdraw 阻止备份入口 | 跨工程占用误判 | 未证明目标被占用;恢复入口已改为结合路径、地址与目标文件实际探测 |
| 历史 sAddress_.adr 不一致导致报告工程内容不同 | 内容校验范围误判 | 地址元数据不等于工程内容;完整复制保留,但主要内容哈希排除 |
| 旧工程没有辅助 PCB/pcb.prj 被报告备份不完整 | 工程格式误判 | PCB 唯一关联主 PRJ 的旧格式本身可用;已复用同一身份检查并真实进入副本校验 |
| 私有桌面窗口不可读,不能正常取消 PCB | 真实 Windows 接入缺陷 | 正常进程查询权限不等于可读外部桌面 HWND;已修复并真实关闭客户端 |
| 释放按钮可点击但 busy 导致处理函数直接返回 | 真实 UI 状态缺陷 | R6 原包实际点击无窗口,R7 新包先禁用再可用,实际打开窗口 |
六处中四类属于误判/过严判断,两类属于真实功能缺陷。这里“误判”仍然是程序需要修复的缺陷,不表示可以撤销失败记录或补记验收成功。
## 当前剩余五类问题
| 类别 | 判定 | 是否仍需修改 |
| --- | --- | --- |
| 外部未知会话导致整库释放 PARTIAL | **已确认占用范围误判,1 个根因至少影响两道释放门禁** | 是,最高优先级;操作集合全退出判断与底层资源证明必须一起修正 |
| 显示释放 4 个,但确认允许操作只有 2 个 | **统计归因错误** | 是;区分本次请求关闭、实际退出、原已退出、外部只读观察,不混成主动释放数量 |
| PCB 读写确认挡住校验与备份恢复 | **原生提示真实发生,普通流程缺少相应确认路径;当前停止不等于检测错** | 是;明确用户授权、目标身份和实际占用核查;不能当 ICDB 损坏,也不能直接自动同意 |
| A/B 的原生 EDIF 导出崩溃 | **真实导出失败,输入/原生兼容性根因未定** | 是;保留错误码、输入及导出证据,独立复现,不绕过内容身份校验 |
| 条件按钮、现场失联副本、Win10 等未完成 | **验收缺口,不能记为已发生漏洞或误判** | 补真实覆盖;测试后再决定需要何种修改 |
此前“本程序遗留会话导致释放不了”的描述需细化:本程序在停止启动过程中确实留下过两个 PCB 客户端,属于真实清理问题;正常关闭后,继续挡住整库确认的是外部软件。不能用后半段的误判抹去前半段实际残留,也不能把两者当成同一种“锁”。
## 优化顺序与验收条件
### P1:统一占用归属和资源范围
当前备份入口与整库释放入口使用不同的判断强度;一处已经按目标资源探测,另一处仍能因未知进程直接停止。应复用统一的“来源、目标范围、活动阶段、资源证据”判断,避免每个入口再次发明一套锁规则。
- 来源记录:创建时保存 PID、创建时间、映像、任务号、私有桌面、目标工程/库和父子关系;重启后按身份核对,不能仅凭 PID。
- 范围判定:区分同工程、同库共享依赖、明确其他库、未知。由谁拉起与是否占用本库分别保存。
- 观察项不自动变成阻止项。明确属于其他库的进程不要求退出;未知项展示不确定原因,继续取本库在途调用、目标文件/数据库、地址、必要原生读取等证据。证据不足不能猜测安全。
- 不能只把 `scope is not False` 改成 `scope is True`,也不能只改“所有行退出”条件;否则可能放过真实打开同库的外部会话,或仍被底层第二道门禁挡住。
- 目标文件独占打开只是证据之一,不单独保证原生接口、共享依赖和检查期间的状态均安全。后续写入前还需重新核对。
验收至少包括:其他软件开其他库且持续运行时,本库能正常完成操作;其他软件确实持有本库数据库时,本库拒绝相关写入;外部进程来源不明但目标文件无占用时,不能单凭进程名永久阻止;PID 被复用时不得操作新进程。
### P1:把单项失败与批次停止分开
现有一个 `safe_to_continue` 同时承载多种情况:当前项失败、当前工程占用、共享库写入未结束、释放证据不足。因此某个工程的问题容易扩大为整库不可用。
逐项保留业务结果,再明确能否继续及影响范围:仅当前工程、整个共享库、原生执行通道、用户主动停止。安全释放的失败项继续下一项;仅当前工程问题是否可绕过,需要以共享资源证据决定;共享写入未返回则继续保护。不要全局放开 false 或直接删历史记录。
验收要使用同一批次“坏工程 → 好工程”以及“共享库真实占用 → 后续写入不得开始”两个方向。现有真实多来源新增已通过前一方向的一种安全失败场景,不代表所有占用场景都通过。
### P1/P2:接通原生读写提示与非阻塞操作
普通校验、检查、恢复副本按操作目的决定是否允许读写授权,不复用只适用于修复后的隐式授权。识别精确提示后展示目标和选项,用户可继续、跳过、取消;等待用户决定时保持 UI 可用,并明确后续任务是否仍需等当前原生会话。检查流程不能因用户点击而悄悄变成自动修复。
队列、原生执行和关闭分别展示等待对象与阶段。取消排队立即生效;已进入原生写入时说明是否正在等待返回或支持原生取消。普通校验/管理当前在批次外层持有队列,评估能否在完整单项事务结束后让出通道,不在 Remove→Add 中间插入另一写任务。
### P2:结果和性能
- UI 使用“检测结果、操作结果、释放状态”分别表达,避免将“待用户确认”写成工程损坏,或将“上传成功”写成 READY。
- 修正释放数字归因,报告观察项不增加本次主动释放数量。
- 来源、版本、依赖等便宜的输入检查先做;只复查本次受影响工程和实际依赖。避免每个按钮都全局扫描并读取无关窗口。
- 原生 EDIF 单独诊断;保存失败输入和退出码,让独立 CBB 继续,不能降低身份校验来消除报错。
### P2:真实并行与异常操作回归
保留其他软件测试作为并行验收条件,覆盖:外部独立工程持续打开、外部共享同库、检查中排队再取消、停止后立即释放、刷新时连续点击、版本窗口开关、断网、源文件变化、主程序关闭与重启后的 PID 复用。分别核查目标变更、真实进程退出、权威状态和剩余任务,而不是只看按钮恢复可用或 Python 测试通过。
当前最有价值的改动是修 E01 的作用范围与证据链,而不是继续增加更多全局拒绝条件。最终验收仍要求实际完整校验与恢复到 READY;本次分类没有补齐这一缺口。
@@ -0,0 +1,337 @@
{
"schema_version": 1,
"created": "2026-11-12T11:32:48",
"overall_acceptance": "NOT_PASSED",
"automatic_icdb_repair": false,
"merged": false,
"issue_closed": false,
"environment": {
"windows": [
"11",
"10.0.26200",
"SP0",
"Multiprocessor Free"
],
"python": "3.12.10",
"mentor": "EE7.9.5"
},
"baseline_commit": "b86e4e315a2ac7d8a3d05587389d0237b6576881",
"candidate": {
"executable": "F:\\CbbAccept-20261112\\candidate-release4\\dist\\CbbRefreshVerify-Background\\CbbRefreshVerify.exe",
"module_count": 62,
"source_and_frozen_code_equal": true,
"source_sha256_checked": true,
"packaged_assets_equal": true,
"exe_icon_images_equal": true,
"executable_sha256": "2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d"
},
"tests": {
"name": "pytest",
"errors": "0",
"failures": "0",
"skipped": "0",
"tests": "1851",
"time": "382.059",
"timestamp": "2026-11-12T11:20:58.800467+08:00",
"hostname": "Abs"
},
"compileall_passed": true,
"git_diff_check_passed": true,
"original_integrity": {
"time": "2026-11-12T11:29:23",
"results": [
{
"scope": "A",
"source": "F:\\Sync Tool Skyworth\\Work Maps\\Skyworth_CBB_Lib\\CBB\\1GPHY_RTL8211F",
"checked": 187,
"changes": []
},
{
"scope": "B",
"source": "F:\\Sync Tool Skyworth\\Work Maps\\Skyworth_CBB_Lib\\CBB\\1GPHY_RTL8211F_A",
"checked": 185,
"changes": []
},
{
"scope": "field-library-originals",
"source": "F:\\Sync Tool Skyworth\\Work Maps\\Skyworth_CBB_Lib\\Mentor_lib_EE7.9",
"checked": 26887,
"changes": []
}
],
"originals_unchanged": true
},
"native_crud": {
"same_name_update": {
"operation": "update",
"name": "1GPHY_8212",
"stage": "complete",
"status": "UPLOADED",
"safe_to_continue": true,
"detail": "上传已确认;本批次未启用自动校验。"
},
"remove": {
"operation": "remove",
"name": "1GPHY_8212",
"stage": "complete",
"status": "REMOVED",
"safe_to_continue": true,
"detail": "已由原生操作移除,重新读取目录确认不存在;应用未创建备份。"
},
"batch_first_safe_failure": {
"operation": "add",
"name": "1GPHY_RTL8211F",
"stage": "complete",
"status": "UPLOAD_FAILED",
"safe_to_continue": true,
"detail": "Native identity exporter failed or reported an error."
},
"batch_next_added": {
"operation": "add",
"name": "1GPHY_8212",
"stage": "complete",
"status": "UPLOADED",
"safe_to_continue": true,
"detail": "上传已确认;本批次未启用自动校验。"
}
},
"final_ui_observations": [
{
"time": "2026-11-12T11:26:17",
"event": "legacy-backup-recovery-result",
"bundle_sha256": "2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d",
"text": [
"目标 CBB",
"备份工程",
"恢复未通过:备份校验未通过,目标未更改。\nDATABASE_RECOVERY_REQUIRED: 是(&Y) | 否(&N) | If an XDS or ExpeditionPCB is running on this design, it's likely that\nyour file system and/or network system was too slow to determine\nwhich product the design is open in within the 15 second timeout\nperiod.\n\nOtherwise, the design may not have been closed properly due to\nthe XDS or ExpeditionPCB crashing in the last session.\n\nBefore continuing, please confirm that no other users have the\ndesign open.\n\nContinue to open the design with read/write access permission?\n记录:F:\\CbbAccept-20261112\\final-data\\evidence\\backup-restore-90b843115d07\\recovery-result.json"
],
"target_primary_unchanged": true
},
{
"time": "2026-11-12T11:27:59",
"event": "final-backup-queue-cancelled",
"bundle_sha256": "2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d",
"text": [
"目标 CBB",
"备份工程",
"恢复未通过:已取消排队,未启动原生操作。"
]
},
{
"time": "2026-11-12T11:28:27",
"event": "summary-release-initial-state",
"bundle_sha256": "2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d",
"enabled": false,
"text": [
"ICDB 检查结束:未发现异常 0,发现问题 0,占用 0,无法确认 0,取消 1,未执行 0",
"中心库",
"可见 1 / 1 · READY 0 · 异常/待确认 1",
"ICDB 检查结束:未发现异常 0,发现问题 0,占用 0,无法确认 0,取消 1,未执行 0",
"正在执行当前任务…"
]
},
{
"time": "2026-11-12T11:28:28",
"event": "summary-release-opened",
"bundle_sha256": "2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d",
"text": [
"正在检查当前库关联的会话…",
""
]
},
{
"time": "2026-11-12T11:28:34",
"event": "force-warning-cancel",
"bundle_sha256": "2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d",
"text": [
"仅强制结束以下客户端。客户端中其他已打开工程也会退出;未保存的更改会丢失,正在写入的工程可能需要恢复。\n数据库服务器和归属未知的进程不会被强制结束。\n\n1GPHY_8212 — ExpeditionPCB.exe (PID 21856)\n1GPHY_8212 — ExpeditionPCB.exe (PID 21248)\n\n仍要结束这些进程吗?"
]
},
{
"time": "2026-11-12T11:28:59",
"event": "r7-normal-exit",
"bundle_sha256": "2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d",
"exit_code": 0
}
],
"backup_recovery": {
"installed": false,
"status": "FAIL",
"detail": "备份校验未通过,目标未更改。\nDATABASE_RECOVERY_REQUIRED: 是(&Y) | 否(&N) | If an XDS or ExpeditionPCB is running on this design, it's likely that\nyour file system and/or network system was too slow to determine\nwhich product the design is open in within the 15 second timeout\nperiod.\n\nOtherwise, the design may not have been closed properly due to\nthe XDS or ExpeditionPCB crashing in the last session.\n\nBefore continuing, please confirm that no other users have the\ndesign open.\n\nContinue to open the design with read/write access permission?",
"target_primary_unchanged": true
},
"residual": {
"library": "F:\\CbbAccept-20261112\\library\\native-add\\fixture\\mentor_lib.lmc",
"status": "PARTIAL",
"confirmed_scope": [
{
"name": "ExpeditionPCB.exe",
"pid": 21856,
"release_status": "RELEASED",
"consent_allowed": true
},
{
"name": "ExpeditionPCB.exe",
"pid": 21248,
"release_status": "RELEASED",
"consent_allowed": true
}
],
"final_target_clients": 0,
"observed_unconfirmed": [
{
"name": "viewdraw.exe",
"pid": 29832,
"scope_confirmed": false
},
{
"name": "cscript.exe",
"pid": 8652,
"scope_confirmed": false
}
],
"foreign_task_processes_terminated": false,
"lock_or_address_files_deleted": false
},
"remaining": [
{
"priority": "P1",
"problem": "Unconfirmed processes from another task still prevent whole-library release proof"
},
{
"priority": "P2",
"problem": "Release count includes unconsented observation rows that exited independently"
},
{
"problem": "Native PCB read/write permission prompt prevents successful verify/READY and backup installation"
},
{
"problem": "Native EDIF exporter crashes for isolated A/B inputs, exit 0xC0000005"
},
{
"problem": "Some conditional native buttons, field lost-session recovery, Windows 10 remain unaccepted"
}
],
"evidence": [
{
"path": "F:\\CbbAccept-20261112\\candidate-release4\\bundle-verification.json",
"bytes": 261,
"sha256": "8dbefef3d8cbd65f3531a1919b11a8bea1b494f01fe63a65ac277e05b572b7de"
},
{
"path": "F:\\CbbAccept-20261112\\candidate-release4\\source-sha256.json",
"bytes": 8168,
"sha256": "35d9904b515297ab033e3290ae69785fa827e7f3440d1a670e665016c18b28f8"
},
{
"path": "F:\\CbbAccept-20261112\\full-suite-delivery.xml",
"bytes": 265893,
"sha256": "cb3298e2aa72c5f4899e1b4dc21c88b35b58af6343de5f3d148e6a5acfcba7de"
},
{
"path": "F:\\CbbAccept-20261112\\desktop-map-red.xml",
"bytes": 11144,
"sha256": "e209aa9aadefec21013ffaa1364c42cf210b3bfb738fb7cc817bd9f39f1aaa5f"
},
{
"path": "F:\\CbbAccept-20261112\\desktop-map-green.xml",
"bytes": 4929,
"sha256": "1a5b5814bc21d3f739573700f4c93da3b241161124f80ed44d2ee0bcf5f01c39"
},
{
"path": "F:\\CbbAccept-20261112\\legacy-backup-red.xml",
"bytes": 7828,
"sha256": "6c05be80efcd1430de99a905b9a32aaa29079aedb7cef606a673896bebf200dc"
},
{
"path": "F:\\CbbAccept-20261112\\legacy-backup-green.xml",
"bytes": 13877,
"sha256": "2a0fc3ddb5b743f2cb2db00a81dc1bc025f76a75a5c6099f667e3461a555d49b"
},
{
"path": "F:\\CbbAccept-20261112\\summary-release-red.xml",
"bytes": 3116,
"sha256": "3dcec893e4d3dca47d8d48bd8e83752f8a3860da09195c40429d1841bf6b9a6b"
},
{
"path": "F:\\CbbAccept-20261112\\summary-release-green.xml",
"bytes": 10321,
"sha256": "f8beefdea1b616d6459f4e12becdbdac633b4650f487332627d5e54c85518ce6"
},
{
"path": "F:\\CbbAccept-20261112\\originals-rechecked.json",
"bytes": 632,
"sha256": "693155ed50d18af7d9ae1bda41a696d25687b486541fc0e9df9956e7dbfe7653"
},
{
"path": "F:\\CbbAccept-20261112\\final-native-inspection.json",
"bytes": 22288,
"sha256": "038a635a8bd3e5d5de5eb4ad73125b12bbd1416d53a8f27ebe014e2a6bb84536"
},
{
"path": "F:\\CbbAccept-20261112\\r7-accept.log",
"bytes": 25203,
"sha256": "ceca1412c2df483f4290e7131c587af5de16d30874f23a588f53d32db432f9e7"
},
{
"path": "F:\\CbbAccept-20261112\\final-data\\management\\management-741e463dc75d4f35acd992ad42200fbf\\checkpoint.json",
"bytes": 3547,
"sha256": "7fe68525e01d8e35bacb2bc84cdc4fa1469bb599f40bd6a77dcad7a6725bce24"
},
{
"path": "F:\\CbbAccept-20261112\\final-data\\management\\management-d83e404f22864885ab57943783897ebe\\checkpoint.json",
"bytes": 11411,
"sha256": "6928ef7a8d9664da7ee209afeb280c61fd081f5d207ef8686ebf09ad57d8140a"
},
{
"path": "F:\\CbbAccept-20261112\\final-data\\management\\management-a900d2b62a544623b499ce55d099dfd2\\checkpoint.json",
"bytes": 1140,
"sha256": "dc0725ff0db339f81be5af021925396cba50f303cfea5c0aa2370a8deff18486"
},
{
"path": "F:\\CbbAccept-20261112\\final-data\\management\\management-c8a18e3bb8bc4aa19f7dbc982b3602d2\\checkpoint.json",
"bytes": 11652,
"sha256": "d09ad8d7b88e7ba607ddb34cac523ef8074f5d3f43fe2f033c35125629bc251c"
},
{
"path": "F:\\CbbAccept-20261112\\final-data\\evidence\\backup-restore-90b843115d07\\recovery-result.json",
"bytes": 3901,
"sha256": "df44ea3f2d01ace1189c2c5f93af8c67abc6c196cf2ba8e99318d222a582c58a"
},
{
"path": "F:\\CbbAccept-20261112\\final-data\\release-checks\\sessions-346da47efa8d\\result.json",
"bytes": 8947,
"sha256": "743fc764021ac8fc22d6f799f4f9663d704d0fd6c41aafd14409666e85747900"
},
{
"path": "F:\\CbbAccept-20261112\\step-restore_execute.py.log",
"bytes": 4134,
"sha256": "a6da200bd6a3895d60ae85eac419b440696a5b9b5503856990782ed04f1f9795"
},
{
"path": "F:\\CbbAccept-20261112\\r5-batch-add-result.png",
"bytes": 75306,
"sha256": "a812edf98f2a96ce4c1f5cd218c9ec0b045e94538af11dbd65c35db799e03e2d"
},
{
"path": "F:\\CbbAccept-20261112\\r5-release-result-1.png",
"bytes": 44151,
"sha256": "a916a2080504201902c5d873fc3d7913e47804b7c5e1aa410a8ef8f778e759b5"
},
{
"path": "F:\\CbbAccept-20261112\\r7-summary-release-initial-state.png",
"bytes": 11891,
"sha256": "d13236159a38adf8030d84a66f59db4269cba471f305e835918cf1e4f86b7397"
},
{
"path": "F:\\CbbAccept-20261112\\r7-summary-release-opened.png",
"bytes": 87863,
"sha256": "a77e0169e7dce2f25f5f3343afa73af75418837987bb7561c24dca18485e3627"
},
{
"path": "F:\\CbbAccept-20261112\\r7-final-release-result.png",
"bytes": 88350,
"sha256": "1b504c4b0c42c18cdbc73bc58b5aa716cde43cb0330106b07fc7cb5e40c7a514"
}
]
}
@@ -0,0 +1,74 @@
# 2026-11-12 冻结程序与 Mentor 原生验收
> 证据路径说明:本文的本机绝对路径、日志名、截图、测试 XML 和冻结包指向验收机器上的原始材料,未纳入 Git;仓库仅保留说明和验证摘要。
**结论:未通过整体验收,不合并发布、不关闭工单。**
本轮实际运行冻结 EXE、Mentor EE7.9.5、原生 COM/命令和私有桌面窗口;点击使用真实 UIA/Win32 控件,没有替换业务服务、伪造原生结果或抢占前台鼠标。此前 48 按钮 Qt 模拟结果不计为本次原生验收。
最终候选包:`F:\CbbAccept-20261112\candidate-release4\dist\CbbRefreshVerify-Background\CbbRefreshVerify.exe`。
SHA-256:`2ad132e434a8e1de0b61f271aa87215749b0f3174ea0682eb578bc31271e8a4d`。
冻结档案中的 62 个模块逐一与源代码编译结果相符;打包资产及 EXE 图标与当前源图标相符。
原始记录、截图、失败尝试和各轮候选包保存在 `F:\CbbAccept-20261112`,便于核对本报告中的具体测试轮次。
## 隔离范围与原件核对
- 原生创建独立空库 `library\native-add\fixture\mentor_lib.lmc`,随后实际新增、更新和移除测试 CBB。
- 另复制现场库的共享依赖及四个工程到 `field-lib`:26,887 个文件,815,607,385 字节。该库实际读取到四个 READY 项。
- 独立来源 A/B 的库引用原指向不可用的 S 盘,仅对隔离副本改为测试库;原工程未改。
- 验收结束重新核对原件:A 的 187 个主要文件、B 的 185 个主要文件、复制现场库所对应的 26,887 个原文件,大小及 SHA-256 均未改变。见 `originals-rechecked.json`。
- 完整旧 Work 已人工保留到 `manual-old-work`;应用管理操作继续采用手动备份提示,没有新增自动整库备份。
- 原生进程只使用正常关闭/取消。强制结束的确认窗口实际打开后选择了取消;没有强制结束其他工具的进程,也没有删除地址或锁文件。
## 实际发现并修改的六处问题
| 问题 | 修改 | 实际复测及边界 |
| --- | --- | --- |
| 导出器退出期间 OpenProcess 返回 5,立即被当成释放失败 | 5/87 均继续观测;只有新快照无目标、已取得句柄退出且数据库探测通过才放行 | R3 同名更新、R5 新增及同批失败续跑;真实活动进程和数据库占用仍拒绝放行 |
| 另一个工程无 PRJ 参数的 viewdraw 阻止备份入口 | 备份空闲检查结合目标路径、地址及实际独占读探测,不再单凭未知命令阻止 | R7 中其他 DxDesigner 仍运行,备份进入隔离库及原生校验;这不等于下面的整库释放问题已解决 |
| 原生导入不保留历史 `sAddress_.adr`,被误报内容不一致 | 将其与 `sAddress.adr` 一起排除在主要内容哈希之外,规则版本升为 2,完整复制仍保留 | R3 更新 `UPLOADED`,原理图 ASCII/CSV/EDIF、布局与注册内容一致;R5 再新增成功 |
| 外部私有桌面的 GetThreadDesktop 返回拒绝访问,重新 OpenDesktop 后 HWND 还不可读 | 对失败 PID 枚举当前窗口站的桌面;打开桌面后先枚举窗口,再核对 PID 并发送关闭/取消 | R5 原先残留的 PCB 启动器/客户端两个真实进程正常退出,获得 RELEASE_CONFIRMED;R6/R7 同类客户端也退出 |
| 恢复入口强制要求旧格式工程没有的辅助 `PCB/pcb.prj` | 复用既有工程身份检查;PCB 必须唯一关联所选主 PRJ,数据库与布局仍必需 | R5 原包拒绝;R7 新包进入隔离复制和真实 PCB 校验。原生读写确认仍导致校验失败,目标主要文件未改,未安装备份 |
| ICDB 结果窗口在前台任务忙时仍允许点击释放,处理函数却直接返回 | 结果按钮跟随执行状态;目标库因保留会话而排队时使用排队释放入口 | R6 实际点击无窗口;R7 同样操作时按钮先禁用,随后恢复,点击成功打开释放窗口。排队入口另有回归覆盖 |
## 实际按钮与流程结果
| 入口/动作 | 观察结果 | 验收判断 |
| --- | --- | --- |
| 选择库、读取、三个菜单、搜索/筛选、选择可见项/清空选择 | 空库、一个 PENDING、四个 READY 的真实数据可读取和操作;READY 不进入维护入口 | 已覆盖这些真实数据场景;381/3,000 项响应测试仍仅是此前模拟 |
| 高级设置及原生 Verify 开关 | 展开、收起、切换和还原成功 | 仅验证控件;Win10 原生 Verify 运行未验收 |
| 查看运行日志、打开日志目录 | 实际点击可用 | 已覆盖 |
| 已选校验、可见非 READY 校验 | 前者实际运行;后者确认后取消,没有执行写入 | 已选校验未通过,不能报告 READY |
| 检查中提交普通校验 | UI 可用、确认成功、显示排队;检查结束后实际启动普通 PCB 校验 | 排队行为通过;校验本身失败 |
| ICDB 批量检查(取消确认/完整执行/停止/再次使用) | 完整检查约 38 秒;读写确认不含 ICDB 错误,归类为无法确认;停止后可重新使用,可能留下客户端供确认释放 | 未执行自动 Repair;不能视为现场修复通过 |
| 版本历史与备份 | 从应用打开真实原生窗口,读取五个备份;创建 User 备份,再从原生 Restore 对话框恢复所选备份 | 原生输出 `Backup restored successfully.`;关闭后 CLOSED、safe=true,应用按钮恢复。证据为 R3 原生工具操作 |
| 从备份恢复(无效来源、取消确认、重复点击) | 无效输入拒绝;取消不启动;执行后按钮禁用,重复点击未重复启动 | 已覆盖 |
| 恢复排队、取消排队 | R6/R7 在检查期间提交,显示排队;取消后明确未启动原生操作 | 已覆盖 |
| 旧格式备份完整恢复 | R7 通过格式/复制检查,在隔离库打开 PCB 时被读写确认拦下 | **未完成恢复**;installed=false、目标主要文件不变,保留证据 |
| 用工程替换已选 CBB | R3 实际 Remove → 原生缺项复读 → Add → 内容比对 → 目录复读 | UPLOADED、safe=true;关闭自动校验,不等于 READY |
| 移除 | R5 原生 CleanWGLib 返回成功;独立目录读取为空,应用读取 0 项 | REMOVED、safe=true |
| 多来源新增 | 同批 A 的 EDIF 导出失败、safe=true;随后 C 实际新增成功;独立复读只有 C | 未因首项安全失败而停止整批 |
| 重复名称新增 | 实际拒绝;独立复读的条目、工程身份不变 | 已覆盖 |
| 管理执行确认取消、再次确认、连续点击执行 | 取消后可重新确认;运行时禁用执行,重复点击不创建第二项 | 新增、更新、移除均有真实操作记录 |
| 查看原生提示、重新检查、确认释放、关闭 | 窗口和提示可读;本工具两个 PCB 进程正常退出 | R5 完整释放通过;R6/R7 仍被下面的跨任务观察项阻止整库确认 |
| 强制结束客户端 | 确认名单只列两个本库 PCB,点击取消后继续正常释放 | 仅确认/取消路径通过,实际强制终止未执行 |
| 主程序退出 | R3/R4/R5/R6/R7 正常退出,末次退出码 0 | 不将退出应用造成的内存释放算作整库释放功能通过 |
**仍未实际触发的条件按钮**:处理 PCB 未保存更改的保存/放弃选择、活动原生备份的“请求原生取消”、管理批次“当前项结束后停止”、实际强制终止、ICDB 特征错误后的工程副本重导入、成功安装备份后的再次打开并 READY。它们的 Qt/回归测试不能替代原生验收;不宣称每一个按钮的所有原生分支都已通过。
## 未解决的验收卡点
1. **P1:未确认归属的其他任务仍能阻止整库释放。** R7 `sessions-346da47efa8d/result.json` 中,确认允许的 PCB PID 21856/21248 均 RELEASED,但另一个私有桌面上的 viewdraw PID 29832 为 scope_confirmed=false、consent_allowed=false、WAITING,整体仍 PARTIAL。末次检查还观察到其他工具的 cscript;没有本库确认所属的客户端残留。原因在于 `residual_sessions._release_residual_sessions` 要求全部观察项 RELEASED,随后 `library_lock._prove_library_released` 也把无法确定路径的进程当成候选占用。不能要求关闭其他任务来通过本库验收。后续需要将观察项与可操作目标分开,并用本库数据库/地址/独占句柄及在途调用证明决定能否继续;同时覆盖真实持有本库数据库时仍必须拒绝的场景。本轮未修改此判定。
2. **P2:释放数量混入自然退出的观察项。** R7 显示“已释放 4 个会话,确认允许 2 项”;另两个未允许项在操作期间自行退出,不能让用户误以为工具主动关闭了四项。
3. **原生 PCB 读写确认尚未走通。** `DATABASE_RECOVERY_REQUIRED` / `DATABASE_SAFETY_STOP` 的正文要求确认没有其他用户后以读写权限继续,未直接提供 ICDB 损坏证据。检查、普通校验和备份副本校验均未获得 READY;不能自动同意写入后宣称通过。
4. **输入兼容性:A/B 的原生 EDIF 导出崩溃。** 退出码 3221225477(0xC0000005),本机 WER 指向 MSVCR90.dll;相同环境下 C 的三种导出均成功。A/B 继续报告上传失败,不跳过身份校验伪造成功。
5. 现场服务器会话失联的一致故障副本完整入口、Windows 10、自动修复仍未验收。ICDB 自动 Repair 保持关闭。
## 复核依据
- 最终源代码:1,851 项 Python 测试通过,1 条 pywinauto COM 警告;`full-suite-delivery.xml`。编译检查及 `git diff --check` 通过。
- 回归保留修复前失败与修复后通过记录:`export-race-*`、`pathless-red.xml`、`address-manifest-*`、`desktop-map-*`、`legacy-backup-*`、`summary-release-*`。
- R3 同名更新:`final-data/management/management-741e463dc75d4f35acd992ad42200fbf/checkpoint.json`。
- R5 移除:`management-d83e404f22864885ab57943783897ebe`;同批失败:`management-a900d2b62a544623b499ce55d099dfd2`;同批继续新增:`management-c8a18e3bb8bc4aa19f7dbc982b3602d2`。
- R7 恢复:`final-data/evidence/backup-restore-90b843115d07/recovery-result.json`。R7 释放按钮状态、原生提示、取消强制结束、最终释放及退出见 `r7-accept.log` 和对应截图。
- 机器可读索引和指定证据摘要哈希见同目录 `2026-11-12-native-acceptance-validation.json`。大体积原始工程和运行时控制记录保留在本机,不纳入提交。
@@ -0,0 +1,41 @@
# 阻塞进程来源核查
> 证据路径说明:本文的本机绝对路径、日志名、截图、测试 XML 和冻结包指向验收机器上的原始材料,未纳入 Git;仓库仅保留说明和验证摘要。
> 本文保留当时的只读归属结论;后续代码修改及试验见 [占用范围验证](2026-11-12-scoped-release-validation.md)。
2026-11-12 13:44–13:46 进行了只读核查。结论:此前阻止整库释放的两个未知会话来自 `dxdesigner-part-replacement` 测试,不是本 CBB 程序拉起;其他软件并行测试暴露了本程序的归属和释放判定漏洞。本次没有修改业务代码或关闭进程。
| 历史进程 | 归属证据 | 结论 |
| --- | --- | --- |
| viewdraw.exe,PID 29832,父进程 5940 | 外部工具 lifecycle.jsonl 记录 worker_started PID 5940;其 private-desktop.json 记录 cad_pid 29832、创建时间 2026-11-12 03:17:21.099 UTC、桌面 dx-f2b2947f8ab144e19760e4599fda3249,均与 CBB 残留快照一致;窗口工程位于外部工具 outputs 目录 | 外部工具创建的 DxDesigner |
| cscript.exe,PID 8652,父进程 5940 | 命令行运行外部工具 QuickPartReplace.vbs;对应任务 project-checkpoint.json 的工程和 cad_pid 29832 与窗口匹配 | 同一外部测试批次的脚本 |
| ExpeditionPCB.exe,PID 21856 / 21248 | 命令行明确为 CBB 隔离库 1GPHY_8212 的 PCB;父子链 30552 → 21856 → 21248;CBB 验收释放记录确认两项均 RELEASED | 本程序的客户端,已正常退出 |
外部工程 CentralLibrary 指向 `F:/Sync Tool Skyworth/Work Maps/Skyworth_CBB_Lib/Mentor_lib_EE7.9/mentor_lib.lmc`。CBB 验收目标为 `F:/CbbAccept-20261112/library/native-add/fixture/mentor_lib.lmc`,二者不同。
13:44 的实时快照中,历史 PID 29832、8652 均已不存在,没有把新进程当成旧残留。当前另有真实父子链:DxPartReplace.exe 29436 → DxPartReplace.exe 16540 → cscript.exe 21364;父进程创建时间均早于子进程,映像和脚本均位于外部工具目录。此快照仅代表当时状态,PID 不能作为长期身份。
13:46 对本次隔离库的 LMC、icdb.dat、LayoutDB.lyt 共 12 个实际文件同时执行 GENERIC_READ、共享模式 0、OPEN_EXISTING 的只读独占打开,全部成功并关闭句柄;库内未发现 sAddress.adr。这证明当时这些目标文件没有阻止独占读的占用,不能倒推 11:28 的全部句柄状态。
## 逻辑漏洞所在
1. `library_lock._owner_matches_scope` 主要读取命令行中的 PRJ/PCB/LMC/数据库引用。裸 viewdraw.exe 和外部 QuickPartReplace.vbs 命令没有这些路径,均返回 None(UNKNOWN)。它没有在这里利用父进程批次记录、私有桌面或窗口工程身份进一步归属。
2. `residual_sessions.inspect_residual_sessions` 的 `scope is not False` 将这两项 UNKNOWN 加入当前库残留观察列表;`scope_confirmed=false` 正确阻止关闭它们。
3. `_release_residual_sessions` 又要求列表中全部行均为 RELEASED。这使“不能确认归属、不能操作的观察项”成为“当前库必须退出的对象”,结果一直 PARTIAL。
4. 即使绕过上一层,`library_lock._prove_library_released` 仍将范围为 UNKNOWN 的候选进程加入 owners,可能在目标文件独占打开之前直接拒绝证明。
以历史真实命令行回放当前归属函数,两项均得到 UNKNOWN,和真实残留列表一致。不是用户并行测试不合规,而是程序把“未知来源”升级成了“目标库占用”。
修复需要分别保存**进程来源**和**资源范围**:本程序创建的进程未必仍占目标;其他软件创建的进程也可能实际打开同一个库。因此不能只按进程名、父 PID 或软件目录粗暴排除外部进程,最终应结合创建时间绑定的身份、实际工程/库引用、本库在途调用、目标资源与地址探测决定是否阻止。外部归属只读展示,不自动结束;真实共享目标占用仍需保护。
## 证据
- 本机完整核查:`F:\CbbAccept-20261112\process-origin-audit.json`。
- 身份交叉核对、外部证据 SHA-256、分类回放及只读资源探测:`F:\CbbAccept-20261112\process-origin-confirmed.json`。
- 外部工具自身记录根目录:`F:\Sync Tool Skyworth\Work Maps\dxdesigner-part-replacement\outputs\frozen-random-final-20261112-r4`。
- 父 worker 记录:`data/batch-resources/28182d59cb9d4e0087fa312baf11d804/lifecycle.jsonl` 第 2 行。
- 原生进程创建身份:该批次 `generation-1/private-desktop.json`。
- 对应工程:`data/tasks/4f49b13e-3603-4578-b7f2-c9fe88bca864/quick-run/project-checkpoint.json`。
这里只完成核查和归因,没有声称跨软件阻塞已修复。
@@ -0,0 +1,19 @@
# PR #13 评论 391:合并前补充修复
> 证据路径说明:本文的本机绝对路径、日志、截图、测试 XML 和冻结包位于验收机器,未纳入 Git;仓库仅保留说明和验证摘要。
针对 [评论 391](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-391),以 `466f400` 为修改前基线。用户已明确授权补齐后依次合并 #10、#11、#12、#13;代码合并不等同于现场验收或发布。
- 导出进程证据缺失、损坏或不是 JSON 对象时,日志及占用错误保留 `exclusion_unavailable`、具体文件或目录、PID 和原因。仍拒绝把无法核实的活跃句柄认定为已释放。
- 批次结果在原生操作及报告完成后立即显示,权威状态刷新继续通过原生队列串行执行。刷新前不以 PASS 将清单改成 READY;等待/执行刷新有明确状态。刷新期间关闭结果窗口不重建窗口;取消排队刷新保留已完成结果,并将未复核清单状态记为 UNKNOWN。
- 11 月 12 日验收文档统一标明本机证据未入库,README/SOP 保留 EDIF 原生崩溃、SMB/跨机、Windows 10、现场失联副本及自动 Repair 的限制。
验证记录位于 `F:\CbbAccept-20261112`。新增用例先复现失败,再验证修复;私有桌面 `CbbReview391NativeUi` 下实际 Windows Qt 控件和进程句柄的 6 项回归通过。覆盖正常刷新、提前关闭结果、取消排队刷新,以及缺失/坏 JSON/错误结构的诊断与保守保护。独立合并前代码复核未发现新增阻断项。
最终完整回归 **1,886 passed**,1 条既有 pywinauto STA 警告,记录 `review391-final.xml`。编译及 diff-check 通过。未完成的早期全量运行已停止,不计作通过;坏 JSON、缺失证据、错误结构及结果延迟的失败复现记录分别保留为 `review391-red.xml`、`review391-ui-red.xml`、`review391-shape-red.xml`。
新冻结包为 `candidate-review391/dist/CbbRefreshVerify-Background/CbbRefreshVerify.exe`,SHA-256 为 `eb9200c06cf8b054dbbfe678fad14c5f5a16f634526e38d2487f5960e07760ab`。64 个冻结模块逐一与当前源码编译结果一致,资源及 PE 图标一致。私有桌面启动、三个实际菜单切换及正常退出通过,详见 `review391-frozen-smoke.json`;机器摘要见 [验证 JSON](2026-11-12-review391-validation.json)。
本轮没有在生产库执行操作,也没有重新验收现场 ICDB 故障;此前 Mentor 隔离库完整恢复至 READY 的证据见 [占用范围验证](2026-11-12-scoped-release-validation.md),该历史包与本轮新包分别记录,不混用源码与二进制证据。
依赖链合并时,#10 先进入 main,再将 #11、#12、#13 逐项改为以 main 为目标并合并,保留分支。逐项核对 head SHA,最后比较 main 与被测最终 head 的文件树;不把只合进中间分支当成全部进入 main。
@@ -0,0 +1,63 @@
{
"created": "2026-11-12T17:35:46.043003+08:00",
"base_commit": "466f400514acc8531a219db8e75641be35304a3f",
"review_comment": "https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-391",
"full_suite": {
"path": "F:\\CbbAccept-20261112\\review391-final.xml",
"tests": 1886,
"failures": 0,
"errors": 0,
"skipped": 0
},
"windows_private_desktop_suite": {
"path": "F:\\CbbAccept-20261112\\review391-native-ui.xml",
"tests": 6,
"failures": 0,
"errors": 0,
"skipped": 0
},
"bundle": {
"module_count": 64,
"source_and_frozen_code_equal": true,
"source_sha256_checked": true,
"packaged_assets_equal": true,
"exe_icon_images_equal": true,
"executable_sha256": "eb9200c06cf8b054dbbfe678fad14c5f5a16f634526e38d2487f5960e07760ab"
},
"frozen_smoke": {
"executable": "F:\\CbbAccept-20261112\\candidate-review391\\dist\\CbbRefreshVerify-Background\\CbbRefreshVerify.exe",
"sha256": "eb9200c06cf8b054dbbfe678fad14c5f5a16f634526e38d2487f5960e07760ab",
"tabs": [
"检验",
"ICDB 维护",
"中心库管理"
],
"exit_code": 0,
"private_desktop": "CbbReview391Frozen"
},
"source_sha256": {
"src/cbb_refresh_verify/native_export_guard.py": "c3eeadd557d2f89bfce855c0736c953043ebe97bc81aa74e40bd370780a54741",
"src/cbb_refresh_verify/ui/main_window.py": "af65fcd8e41f35f412e8c23f525821c92b2cfb78b9d0fd4f88c515249dbd24e1",
"tests/test_review391.py": "304d46d63af87ea4a9bca83834b77cc44c5c9addf7b0f3752431304ee612568c",
"tests/test_batch_item_yield.py": "ed4be6d1e854b18d054a75c92171cd46b6b64411c2f74e9a3caf31fba3c7366b"
},
"independent_code_review": "No actionable critical, important or minor issues; read-only review, no additional tests run.",
"merge_plan": {
"pull_requests": [
10,
11,
12,
13
],
"target": "main",
"retarget_stacked_pull_requests": true,
"preserve_branches": true,
"force_merge": false
},
"evidence_location": "Raw logs/XML/packages are local-only; repository contains this summary.",
"native_mentor_retested": false,
"known_limits": [
"Field ICDB loss-of-session recovery, Windows 10 and cross-machine SMB remain unverified.",
"Automatic ICDB Repair remains disabled; EDIF 0xC0000005 on A/B remains unresolved."
]
}
@@ -0,0 +1,61 @@
{
"schema_version": 1,
"time": "2026-11-12T16:00:50.172809+08:00",
"bundle": {
"module_count": 64,
"source_and_frozen_code_equal": true,
"source_sha256_checked": true,
"packaged_assets_equal": true,
"exe_icon_images_equal": true,
"executable_sha256": "85ec649c18fefcf50d8b4caf0a66005f108713e7d5f170d1aecc82e3c5fcfe33"
},
"tests": {
"passed": 1880,
"failures": 0,
"errors": 0,
"xml": "F:\\CbbAccept-20261112\\full-scoped-final10.xml"
},
"recovery": {
"path": "F:\\CbbAccept-20261112\\scoped10-data\\evidence\\backup-restore-5f9b134ab83c\\recovery-result.json",
"installed": true,
"source_status": "PASS",
"target_status": "PASS",
"library_flag": "GREEN",
"safe_to_continue": true,
"retained_work": "F:\\CbbAccept-20261112\\field-lib-recovery\\ReusableBlocksLP\\1GPHY_8212\\Work.before-restore-5f9b134ab83c"
},
"release": {
"path": "F:\\CbbAccept-20261112\\scoped10-data\\release-checks\\sessions-fc23a2a2024f\\result.json",
"status": "RELEASE_CONFIRMED"
},
"original_integrity": {
"time": "2026-11-12T16:00:19",
"results": [
{
"scope": "A",
"source": "F:\\Sync Tool Skyworth\\Work Maps\\Skyworth_CBB_Lib\\CBB\\1GPHY_RTL8211F",
"checked": 187,
"changes": []
},
{
"scope": "B",
"source": "F:\\Sync Tool Skyworth\\Work Maps\\Skyworth_CBB_Lib\\CBB\\1GPHY_RTL8211F_A",
"checked": 185,
"changes": []
},
{
"scope": "field-library-originals",
"source": "F:\\Sync Tool Skyworth\\Work Maps\\Skyworth_CBB_Lib\\Mentor_lib_EE7.9",
"checked": 26887,
"changes": []
}
],
"originals_unchanged": true
},
"interaction_log": "F:\\CbbAccept-20261112\\scoped10-accept.log",
"known_limits": [
"Native shared-symbol server sometimes cannot remove its own address file after STOP; not bypassed.",
"Actual field server-session-loss recovery and Windows 10 acceptance remain unverified.",
"Automatic ICDB Repair remains disabled. No merge, release or issue closure."
]
}
@@ -0,0 +1,54 @@
# 占用范围、单项队列及原生确认验证
> 证据路径说明:本文的本机绝对路径、日志名、截图、测试 XML 和冻结包指向验收机器上的原始材料,未纳入 Git;仓库仅保留说明和验证摘要。
本次基于 `42d0ceb`,沿用 `codex/runtime-lifecycle-safety`。当天较早的进程归属、误判分析和完整流程图是修改前快照;本记录描述后续实现及验收,不追溯改写先前失败。
## 修改
- 未确认归属的外部客户端只作观察,不要求其退出、不发送关闭,也不增加主动释放数量。释放仍检查本库在途调用、目标数据库地址和实际独占只读文件句柄;自身请求身份缺失、共享写入未返回时继续保护。
- 旧 NATIVE_CALL/CLOSING/UNCONFIRMED 日志结合进程创建身份核实;已退出或 PID 被复用不会仅因日志阶段被认定仍在写入,读取失败保留未确认。
- 单项失败后只对绑定任务取得新的释放证明;证明成功才允许后续项,原业务失败和原证据保留。校验和管理在完整单项事务结束后让出原生队列,不在移除与重新导入之间穿插其他任务。排队取消保留已完成项和汇总。
- 普通校验、上传后的校验、备份副本/目标校验接通精确 PCB 读写提示和历史版本选择。用户可以继续、跳过、取消;绑定本任务 PCB 的创建身份、启动链、工程和私有桌面,临近点击重新检查。ICDB 诊断检查不借此执行 Repair 或隐式取得写入授权。
- 实测新增修复:同名更新自动校验不再把自己当前的事务当成历史未释放事务。仅允许同线程、同 lease、同 PID、同目标及无待处理导出/检查点的嵌套调用。取消批次后不再把刷新排进已经取消的队列而丢失结果。
- 第二轮真实试验暴露导出器进程链误判:CSV 导出器 PID 16068 创建于 14:56:19,却收录了 12:57:45 已创建的 OneDrive 服务 PID 23804。运行时追踪改为排除原有进程、绑定原生进程句柄创建时间、拒绝早于父进程的子进程及 PID 复用后的新进程链。旧记录复核也排除出生时间证明不可能属于导出任务的条目;仍需原生范围及分析副本数据库的全套释放证明,未发送退出请求给 OneDrive。
- 失败释放复核包含在单项原生队列内部,完成后才让出通道,避免下一项开始时前一项又来争取管理互斥。新增两项回归先失败后通过,相关 46 项通过。
- 普通读写确认比较真实控件的句柄、ID、类和正文,允许 UIA 后续增加已识别的标题栏辅助节点、重排控件及省略按钮快捷键标记;替换真实按钮仍拒绝。实际快照显示 Win32 的“是(&Y)”变成 UIA 的“是(Y)”,进程及窗口/按钮句柄均未变化;不能据此认定工程或窗口被替换。来自恢复副本真实失败的回归先失败后通过,相关 52 项通过。
## 冻结包和真实试验
当前候选程序:`F:\CbbAccept-20261112\candidate-scoped10\dist\CbbRefreshVerify-Background\CbbRefreshVerify.exe`。
SHA-256:`85ec649c18fefcf50d8b4caf0a66005f108713e7d5f170d1aecc82e3c5fcfe33`。64 个冻结模块逐个与当前源码编译结果一致,资源及 PE 图标一致;检查记录 `candidate-scoped10/bundle-verification.json`。较早的 scoped5 为 `4cf682130923c4534d3193a8b967ffc83d0cc519e580f6739a4861daed4f36c3`,scoped7 为 `e37b2601bb3851e9170ab8d552800547004b1a5b9882211f1180693dde76957c`,scoped9 为 `a59488dcbad72bdd7159772aabdb33b6411dea972babec33e64412a3406f810f`;各次动作日志绑定实际运行包哈希,不能混为同一版本。
原生写操作仅在 `F:\CbbAccept-20261112` 隔离库及工具生成的 `C:\Users\ABS_Windows\.cbb-restore` 校验副本中进行,环境为 Windows 11 build 26200、Mentor EE7.9.5 及私有桌面。操作驱动使用真实程序按钮和后台窗口消息,没有前台鼠标抢占、强杀原生客户端或手删地址文件。
| 试验 | 事实与证据 |
| --- | --- |
| 外部脚本持续存在,目标真实句柄被占用 | `scoped3-accept.log`:持有 LMC 的 Windows 独占句柄时拒绝释放,错误 32;外部脚本仍存活 |
| 目标句柄关闭,外部脚本继续运行 | 同一日志:RELEASE_CONFIRMED,主动释放 0、授权 0;外部行为保持 OBSERVED,脚本最后自行退出 |
| 同名更新并自动校验 | `management-38fdf8365d834a13ba7dca67111861ff/checkpoint.json`:UPLOADED_VERIFIED、safe=true;真实选择继续打开和最后手动保存版本;校验 InSynch、Save/IsSaved/Close、PCB EXITED,IsVerifiedReuseBlock=1/READY。校验约 91.6 秒 |
| 重复更新发现地址残留 | `management-0cee6b12e93b45918caf18101c603dc5/checkpoint.json`:RECOVERY_REQUIRED;原生移除已发生,重新导入未开始,不能记为成功 |
| 地址残留的原生证据 | 共享符号库服务器 PID 17344 日志记录 Database closed、defragmentation completed、Could not remove server address file、S: STOP;之后没有该服务器进程。`address-native-probe/result.json`:原生目录可复读,地址仍在、端点不可达;未将不可达视作无占用证明 |
| 早期空白库试验 | 读写和手动版本选择成功,但原生 PartPkg 报缺 PartsDB 分区;不作为校验成功 |
| 早期自动校验试验 | `management-cb85cb2b564d4778912df7accf85c109` 上传完成,校验被自身事务锁拒绝;已补回归后由上述真实完整成功试验复核 |
| 导出器错误收录 OneDrive | `scoped6-data/management/management-498258fe1e1541e9a135ca4117cb7344/source-identity/csv-process.json`:CSV 日志已完成、分析副本无地址,但历史父 PID 关联扩大至外部进程;后来进程查询超时,本次无原生移除/新增,不计上传成功。`scoped6-active-handle-attribution.json` 为只读 Windows 句柄归属诊断;新增失败回归 `export-lineage-red.xml`、`export-history-red.xml`,修复后两组 73 项通过 |
| 旧误判记录解除及更新重试 | scoped7 真实点击释放:RELEASE_CONFIRMED、主动关闭 0;保留旧证据。随后 `scoped7-data/management/management-d4017aaae47041b08dae6445858a7419/checkpoint.json` 完成原生更新及工程身份复读,UPLOADED、safe=true,关闭了本批次自动校验 |
| 恢复确认窗口误判 | scoped7 的 `evidence/backup-restore-f52ee9adc188/recovery-result.json` 和 scoped9 的 `evidence/backup-restore-22512e81160b/recovery-result.json` 都在副本阶段失败,installed=false。先处理控件辅助节点后,第二次实际差分又明确了快捷键标记差异;未将两次失败记为通过 |
| 快捷键表示差异的原生定位 | `open-identity-real-diff.json` 捕获同一 PID/创建时间、HWND、真实按钮句柄下的 Win32/UIA 差异。修正后 `identity-debug/verify-f34d9f72d4aa/result.json` 实际 PASS、GREEN/READY=1、Save COMMITTED、Close CLOSED、PCB EXITED、资源 RELEASED。这是定位与复测,不能替代完整恢复按钮验收 |
| 立即停止后的残留 | scoped7 的 `evidence/icdb-check-73cdeda6d163/pcb-open/verify-bb3bdc393b0b/result.json`:CANCELLED、safe=false;本任务启动器 12408、PCB 344 在扫描时尚无可关闭窗口。未以队列取消成功冒充原生退出成功 |
| 残留后的再次释放 | 后续读取发现原生 Tip of the Day;在精确绑定的私有桌面正常关闭此帮助窗口后,PCB 完成打开。scoped9 实际“确认释放”正常关闭 3 项并 RELEASE_CONFIRMED,应用正常退出。`cleanup-scoped7-stop*/startup-close.json` 保留早期未确认记录;未强杀进程、未把帮助窗口关闭本身记成数据库释放 |
| 最终包验收 | 事实与证据 |
| --- | --- |
| 最终包完整恢复按钮 | scoped10 真实执行空来源校验、取消确认、重新确认、运行期间重复点击,随后完成副本校验、目标变更检查、保留旧 Work、安装、目标再次原生校验。`scoped10-data/evidence/backup-restore-5f9b134ab83c/recovery-result.json`:installed=true,source_validation 和 result 都为 PASS、GREEN/READY=1、safe=true,Save COMMITTED、Close CLOSED、PCB/助手 EXITED、资源 RELEASED |
| 最终状态及退出 | scoped10 原生状态刷新后可见 READY 1;READY 项检查及恢复入口禁用。最终释放为 RELEASE_CONFIRMED,主动关闭 0/允许 0,主程序正常退出 0;未修改旧失败记录 |
| 原始文件复核 | 16:00:19 对 A/B 来源及原始中心库共 27,259 个文件重新检查大小、SHA-256,无变化;`originals-rechecked.json`。先前失败校验副本归档到 F 盘以保留证据并腾出系统盘空间,映射见 `archived-validation-copies/map.json` |
最终源码全量测试 **1,880 passed**(1 条既有 pywinauto STA 警告),记录 `F:\CbbAccept-20261112\full-scoped-final10.xml`;compileall、diff-check 通过。冻结代码和图标一致性、完整恢复、释放及原始文件复核的机器摘要见同目录 [验证 JSON](2026-11-12-scoped-release-validation.json)。历史版本是按此前选择偏好使用最后手动保存版本,READY 不表示已经人工核对版本内容或无数据回退。
## 保留限制
自动 ICDB Repair 继续关闭。现场服务器会话失联的一致故障副本、Windows 10、跨机共享库掉线尚未验收;不会自动合并、发布或关闭工单。共享符号数据库地址若原生工具自身无法删除,不能通过本程序删除文件或仅凭无进程放行。此前 A/B 输入 EDIF 导出崩溃与空白依赖库有关与否仍需独立复现,不绕过工程身份校验。
立即停止时的晚到窗口仍需要正常处理:本次 Tip of the Day 是在精确绑定的私有桌面关闭后才由应用完成会话释放,不能将此试验写成自动退出无缺口。未知/损坏检查点、尚未返回的真实共享写入继续保留未确认状态。
@@ -0,0 +1,319 @@
{
"created": "2026-11-13T15:28:15.015734+08:00",
"base_main": "cbc57238496bc84f4228aa44929208a9516dff1b",
"branch": "codex/import-without-export-gate",
"full_suite": {
"tests": 1895,
"failures": 0,
"errors": 0,
"skipped": 0
},
"first_wrong_source_suite": {
"tests": 1893,
"failures": 15,
"errors": 0,
"skipped": 0
},
"first_wrong_source_reason": "Subprocesses used the editable original checkout; corrected by explicit PYTHONPATH to this worktree.",
"frozen": {
"module_count": 64,
"source_and_frozen_code_equal": true,
"source_sha256_checked": true,
"packaged_assets_equal": true,
"exe_icon_images_equal": true,
"executable_sha256": "98a642d8e81f42b708934bb4dc2d023c49c2acdae5851151a430f101c74c9615"
},
"native": [
{
"name": "1GPHY_RTL8211F_A",
"status": "UPLOADED_VERIFY_FAILED",
"safe_to_continue": true,
"detail": "原生注册、工程关联、顶层块和 Layout 已确认;未核验原理图语义。其他工程文件有差异,已记录供核对。\nProject Integration error: ERROR: There are no PartsDB partitions from which to extract parts | ERROR: Unable to create local PDB | ERROR: Problem Making Local Parts DataBase",
"checkpoint": "F:\\CbbI1113\\d3\\management\\management-9a5e12feb292441e8c5709270ffef18b\\checkpoint.json",
"native_add_success": true,
"registration_matches": true,
"top_level_block_mapping": {
"source": "1GPHY_RTL8211F",
"registered": "1GPHY_RTL8211F_A",
"allowed": [
"1GPHY_RTL8211F",
"1GPHY_RTL8211F_A"
]
},
"assets_match": false,
"asset_differences": {
"added": [
"PCB/1GPHY_RTL8211F_A.pcb",
"database/cdbback/2026-11-13 15.12.50-49956.zip"
],
"deleted": [
"PCB/1GPHY_RTL8211F.pcb"
],
"modified": [
"1GPHY_RTL8211F_A.prj"
]
},
"verification": [
{
"stage": "verified",
"time": "2026-11-13T07:18:34.641758+00:00",
"verification": {
"status": "FAIL",
"stderr": "Project Integration error: ERROR: There are no PartsDB partitions from which to extract parts | ERROR: Unable to create local PDB | ERROR: Problem Making Local Parts DataBase",
"stdout": "",
"evidence_path": "F:\\CbbI1113\\d3\\management\\management-9a5e12feb292441e8c5709270ffef18b\\verify\\verify-43d609b6535d\\result.json",
"safe_to_continue": true,
"library_flag": "UNKNOWN",
"library_flag_detail": "",
"report_path": null,
"content_check_exit_code": null,
"error_category": "MENTOR_PROJECT_INTEGRATION",
"error_stage": "forward_annotation",
"bridge_attempts": [],
"timings_seconds": {
"preflight": 0.031,
"worker_setup": 6.328,
"pcb_startup": 100.469,
"failure_diagnostics": 1.25,
"integration": 24.953,
"forward_annotation": 24.812,
"total": 133.406
},
"incomplete_timing_phases": [
"integration",
"forward_annotation"
],
"recovery_attempts": [],
"release_proof": null,
"write_outcome": {
"save_state": "UNKNOWN",
"close_state": "UNKNOWN",
"helper_state": "EXITED",
"resource_state": "RELEASED",
"interrupted": false,
"detail": "保存返回结果无法确认"
},
"session_record_path": "F:\\CbbI1113\\d3\\management\\management-9a5e12feb292441e8c5709270ffef18b\\verify\\verify-43d609b6535d\\session.json"
}
}
]
},
{
"name": "1GPHY_RTL8211F",
"status": "UPLOADED_VERIFY_FAILED",
"safe_to_continue": true,
"detail": "原生注册、工程关联、顶层块和 Layout 已确认;未核验原理图语义。其他工程文件有差异,已记录供核对。\nProject Integration error: ERROR: There are no PartsDB partitions from which to extract parts | ERROR: Unable to create local PDB | ERROR: Problem Making Local Parts DataBase",
"checkpoint": "F:\\CbbI1113\\d3\\management\\management-6be18dcb186846e78b3220b59631249e\\checkpoint.json",
"native_add_success": true,
"registration_matches": true,
"top_level_block_mapping": {
"source": "1GPHY_RTL8211F",
"registered": "1GPHY_RTL8211F",
"allowed": [
"1GPHY_RTL8211F",
"1GPHY_RTL8211F"
]
},
"assets_match": false,
"asset_differences": {
"added": [],
"deleted": [
"database/cdbsvr/events/events - Abs 的冲突副本 1 - 2026-09-16 07-16-58.dat",
"database/cdbsvr/events/events - Abs 的冲突副本 1 - 2026-09-16 07-16-58.idx"
],
"modified": [
"1GPHY_RTL8211F.prj"
]
},
"verification": [
{
"stage": "verified",
"time": "2026-11-13T07:23:45.773452+00:00",
"verification": {
"status": "FAIL",
"stderr": "Project Integration error: ERROR: There are no PartsDB partitions from which to extract parts | ERROR: Unable to create local PDB | ERROR: Problem Making Local Parts DataBase",
"stdout": "",
"evidence_path": "F:\\CbbI1113\\d3\\management\\management-6be18dcb186846e78b3220b59631249e\\verify\\verify-53e1561b73fa\\result.json",
"safe_to_continue": true,
"library_flag": "UNKNOWN",
"library_flag_detail": "",
"report_path": null,
"content_check_exit_code": null,
"error_category": "MENTOR_PROJECT_INTEGRATION",
"error_stage": "forward_annotation",
"bridge_attempts": [],
"timings_seconds": {
"preflight": 0.047,
"worker_setup": 3.766,
"pcb_startup": 80.469,
"failure_diagnostics": 1.39,
"integration": 22.359,
"forward_annotation": 22.297,
"total": 106.844
},
"incomplete_timing_phases": [
"integration",
"forward_annotation"
],
"recovery_attempts": [],
"release_proof": null,
"write_outcome": {
"save_state": "UNKNOWN",
"close_state": "UNKNOWN",
"helper_state": "EXITED",
"resource_state": "RELEASED",
"interrupted": false,
"detail": "保存返回结果无法确认"
},
"session_record_path": "F:\\CbbI1113\\d3\\management\\management-6be18dcb186846e78b3220b59631249e\\verify\\verify-53e1561b73fa\\session.json"
}
}
]
}
],
"duplicate_conflict": {
"passed": true,
"records": [
{
"operation": "add",
"library": "F:\\CbbI1113\\library3\\native-add\\fixture\\mentor_lib.lmc",
"name": "1GPHY_RTL8211F",
"partition": "Logical-Physical",
"source": "F:\\CbbI1113\\A\\1GPHY_RTL8211F.prj",
"auto_verify": false,
"stage": "complete",
"status": "UPLOAD_FAILED",
"safe_to_continue": true,
"detail": "同名 CBB 已存在;新增禁止覆盖,请使用明确的同名更新。",
"evidence_path": "F:\\CbbI1113\\d4\\management\\management-f43f218e0dcb41e8bfe09d5f2f69a0a8\\checkpoint.json",
"release_proof": null,
"change_report": null,
"history": [
{
"stage": "release_check",
"time": "2026-11-13T07:25:51.703695+00:00"
},
{
"stage": "catalog_before",
"time": "2026-11-13T07:26:22.388154+00:00"
}
],
"backup_policy": "manual"
}
],
"target_and_shared_content_unchanged": true,
"catalog": {
"library": "F:\\CbbI1113\\library3\\native-add\\fixture\\mentor_lib.lmc",
"flow": 1,
"entries": [
{
"name": "1GPHY_RTL8211F",
"partition": "Logical-Physical",
"engineering_identity": {
"top_level_block": "1GPHY_RTL8211F",
"schematic_sha256": "ed969340d9e89875b30c7c0ab175e82a92f965743f798cca297ad8de24a55f94",
"layout_sha256": "61c2107047afd2ce8778028bdc5527cb1e2ca14b13190625a2c9c5397077b4f8"
}
},
{
"name": "1GPHY_RTL8211F_A",
"partition": "Logical-Physical",
"engineering_identity": {
"top_level_block": "1GPHY_RTL8211F_A",
"schematic_sha256": "400183e788a0980f8e08a140e1eb7f96b845c48cf486e51c90cdb33900688e41",
"layout_sha256": "3b78437a66f3d9a510b7aed6130928629b1b15fa86a8029e1786006e900fb5d5"
}
}
],
"safe_to_continue": true
}
},
"source_hashes": {
"src/cbb_refresh_verify/application.py": "62b9b013563a216d020c8366cccb8f949b02afa72dc63c26940804441cc23057",
"src/cbb_refresh_verify/backup_recovery.py": "f07741fdeed73871eda1d4e72803bb516cc877b5b49973e3f7aa18972228baa2",
"src/cbb_refresh_verify/batch_status.py": "55a4007cf54491ca8e045a5bf86aa4353ac8437cca5a76cd79304962e3d3fa0a",
"src/cbb_refresh_verify/com_runtime.py": "f0f3802d16c791a8bf9dfef44a94917072bfbe8fb3a927d76be8ef0341c7ed35",
"src/cbb_refresh_verify/content_check.py": "8239c17b6e2452917ed573a7deb3e4c8583eaef91bf3630eff5f424d2e398aa9",
"src/cbb_refresh_verify/defaults.py": "a1c03192f4a61ad0924b24bb635705b1ee4811d35483a02864200f95edbbebe3",
"src/cbb_refresh_verify/desktop_worker.py": "27d751816552d215dd8ee9cd67941d824f7b4493120ead7c3f87e5eba5ec4a92",
"src/cbb_refresh_verify/diagnostic_open.py": "d6c49ffe5a9969d95edbbc896d47a7e100f248380a287f99ba7bb8b92dbb3072",
"src/cbb_refresh_verify/dialog_agent.py": "5acb6e5cf1350a7ca20a6fe480668435fac785835874f266881973010db6504b",
"src/cbb_refresh_verify/dialog_models.py": "f68cee01d927b48364276d3c1f79e63ce8af231878db0b907d292780cfbafb56",
"src/cbb_refresh_verify/dialog_probe.py": "d61f0c955c961980c9635940eefb9c7947c1fe90b4b6fd844720df41ddb0aa0e",
"src/cbb_refresh_verify/dialog_rules.py": "3189b476f7ff4678b59212ed7b4081164e038a7cf7662cd895f9019cb3c1edc5",
"src/cbb_refresh_verify/dialog_supervisor.py": "15c415c2d2e916f0b64ba04416164ff3b50996d70b22d3b4ac2226b5547ac247",
"src/cbb_refresh_verify/failed_session.py": "7e6f7fa5ebcf2d49f00c5efc5f5d26412704b68e9122e476ac1f672009a98c09",
"src/cbb_refresh_verify/icdb_maintenance.py": "e81d253d8b4d3e7c1000c45335a392c72b110748675c2c3324ebe524a7252e98",
"src/cbb_refresh_verify/icdb_ownership.py": "7bf2342c1efa34a2ebcbf27964a40a490220f7146fbb6ef957b8d8dd1e511f03",
"src/cbb_refresh_verify/icdb_recovery.py": "358c0e9a004f1e0b2127513286e1dffd94b0180a8b7314aa9655462f570b6360",
"src/cbb_refresh_verify/integration.py": "f188856af69ba25e265988c51db7a6d4263326440d972ca78378b733b891c1ed",
"src/cbb_refresh_verify/library_lock.py": "6836ec8ac21e788eb75326ff44cb31ad4bdfb5f381bd35cdf33e6b34c7fca89e",
"src/cbb_refresh_verify/library_manager_verify.py": "71e16a8581ad44b646be78b480f9812d596a6d162b3eec03d078bf4ea4503195",
"src/cbb_refresh_verify/library_reader.py": "d4007caa361edd467773e49f721e02671d5a9bcb30741769a57349850b12c438",
"src/cbb_refresh_verify/maintenance_entry.py": "3b93c25f69d7a961facd8004e20e155a84cc18f06d57b741a9055786ed058990",
"src/cbb_refresh_verify/management.py": "773f9405c39b3fdcea4647da84ca97e9113e03db386a45bfabd468a98ed1fb36",
"src/cbb_refresh_verify/management_transaction.py": "32c53caaead05d5db3a31d3e30721e65434e5837095dc0a7812f825603aa37a0",
"src/cbb_refresh_verify/mentor_adapter.py": "1fc8c98d5508120e03bf001a42dd3e0da7b165eb18c90f1aed83147d17db8638",
"src/cbb_refresh_verify/mentor_paths.py": "ba48c0003b3eacc88906497b2e43b299ca4536a9f7dae44bbacf6a6ec694c116",
"src/cbb_refresh_verify/models.py": "9e8209a8b006df923f1d07ccab64bbcfe5d674c4fc5f5426bfbc9b11da4ee105",
"src/cbb_refresh_verify/native_add_failures.py": "192202732423dc624c5548c75e80bb20973e5087c21d4798c9637f25b6de7e94",
"src/cbb_refresh_verify/native_backup.py": "7276fa3d9298e85550151cf0c7191d84bd08a18a72df5d854a3c38f1a88b001d",
"src/cbb_refresh_verify/native_engineering_identity.py": "e704e8f56c43629a1593d490776af328bb032208ee2f5ffd1d1be6c3114f5412",
"src/cbb_refresh_verify/native_export_guard.py": "c3eeadd557d2f89bfce855c0736c953043ebe97bc81aa74e40bd370780a54741",
"src/cbb_refresh_verify/native_management.py": "5eca3b40ef57ecd4a12a0d0c26afd1bb1afb448a0b7c5452bfe80591a3a74b77",
"src/cbb_refresh_verify/native_occupancy.py": "7d686079d12217382adace6361cd343d977b91075e3b157cf410ca92d07ffc49",
"src/cbb_refresh_verify/native_repair.py": "9f024dcb5e3a76369191033474fefd30787b6ae350c315f3cf38e92e5a1f3e98",
"src/cbb_refresh_verify/native_repair_ui.py": "3eb2af181befea94af8b3b3131edff09589f340bcba777abbe3b67fd31b80393",
"src/cbb_refresh_verify/network_path.py": "6b5b159502d42a46bf4ee26d5698fd2c6498b359088e2138eae46e9065b13c6f",
"src/cbb_refresh_verify/operation_lifecycle.py": "3838c5a501711d16f578c45ebbc6f960872b0c3ba6bbda9a597f994ef746cef6",
"src/cbb_refresh_verify/operation_queue.py": "a6932d8bc68ac436091f6d362557c66d274ec52d0f295a22f014a3396845c79f",
"src/cbb_refresh_verify/owner_probe.py": "8dcfd60246cb2979db34d02e0a2d605c334b6f7e2666f22daa2f50c0408bc903",
"src/cbb_refresh_verify/pcb_bridge.py": "2f6c2b09642100468814500569dbfc6695fc2a46b9a3b8333daa8e1530cdeef5",
"src/cbb_refresh_verify/pcb_open_consent.py": "7ad9c3a183f565b8b1f7a57b7c29ee9cbc3a79fe1ac0d778459edbdcb25b5664",
"src/cbb_refresh_verify/pcb_restore_prompt.py": "39e0b8623a838911eff61066f3e9c8ede4364dbf73efc5a8994197ec72a96488",
"src/cbb_refresh_verify/post_repair_consent.py": "3b1eaff1db58fd311a9dbc5fdcd850911b04cc5afd4e747f70a62b721b8fafa4",
"src/cbb_refresh_verify/post_verify_diagnostics.py": "2442de485bc0d6a34c4b2d9b10bc5f323ea38f9ff66674119a50f5c6043bac63",
"src/cbb_refresh_verify/reimport_recovery.py": "66b2ba8f8c2ec9ae8c386d6b1aa74a1fbb6bfb509c4df0a262f8d7a0ca48469e",
"src/cbb_refresh_verify/residual_sessions.py": "4ac500b33b209611d54eb496c6c30727ba159742d625431ceea84471a5fc3442",
"src/cbb_refresh_verify/runtime_logging.py": "44ac25430a89c5ffc9e48e88c227e88052f4c815365e8556f67918f3edaba39e",
"src/cbb_refresh_verify/runtime_timing.py": "c4ed4057b5000e0b86ccc7dd1fe2004d6e0dae29f397fec77b01ad41a81c6367",
"src/cbb_refresh_verify/scoped_manifest.py": "9318bf0f929d23c18466a25d83a4a9903822093c123aae10510061788c6d0ab7",
"src/cbb_refresh_verify/session_record.py": "2bc3cff365008864584138a4ff13538bb6b2f90d981e7d008a1300f9102c6e7e",
"src/cbb_refresh_verify/status_bridge.py": "05d627d02934a14f5de409472c291d37565a95b836f9c130111aae80612e9196",
"src/cbb_refresh_verify/verify_diagnostics.py": "041b77d7d49e4c86338ed5e5741d0d27a2c42bc358f4da54b3efe64af847e9b8",
"src/cbb_refresh_verify/verify_probe.py": "3ed743df49d195c74f5045985ab23491d103ee2c42c07b558c1e037176402ed2",
"src/cbb_refresh_verify/verify_runner.py": "3027ef7fc1ef6365ff36ae0c83389d869b92ffcd96985d10275bca4dc9483e3f",
"src/cbb_refresh_verify/__init__.py": "dd960394d88657820dba858792abf0de258e05efceb08ae2f0b39c6ad78bc469",
"src/cbb_refresh_verify/__main__.py": "dc4be034a0e43d4b659a9300137c29a6a6b7a32b7eaef02b6dff9a88c41305c0",
"src/cbb_refresh_verify/ui/backup_notice.py": "1a3fa5ac18a267907faf95f36d61b9f08bcbb939eef4d480dd06af1391a81599",
"src/cbb_refresh_verify/ui/backup_recovery_dialog.py": "65081eb8d9791f8ec1316023a80edb07a91b2658b9ed27cb4cf21addb0f26026",
"src/cbb_refresh_verify/ui/icdb_check_task.py": "ade3bf414aa29b42f4c1535c613b2cacb2735f6abc7900e6da25999390a5891d",
"src/cbb_refresh_verify/ui/main_window.py": "af65fcd8e41f35f412e8c23f525821c92b2cfb78b9d0fd4f88c515249dbd24e1",
"src/cbb_refresh_verify/ui/management_dialog.py": "4ae522e8509d9153af9d41d349f1611c80f73c0913f01f33cc5a122665cf56bf",
"src/cbb_refresh_verify/ui/pcb_open_dialog.py": "3cabdc15f1b2abaeb919a7f29f32d4b053186701fd514646d9bdd3ea32f364f6",
"src/cbb_refresh_verify/ui/pcb_restore_dialog.py": "b7228d828df235ac51502dc68760d28c4896af02c780e9806e11c32dba7f62da",
"src/cbb_refresh_verify/ui/residual_release_dialog.py": "1d2a26bfc7ee21b11d7edbc3074b4c525e8c9fb628bca45b08bd06fc672586c8",
"src/cbb_refresh_verify/ui/workers.py": "4cc9360a4820ded27a7d5ef709fc9f04b1d4804cb1e7a614f6c357ed547da888",
"src/cbb_refresh_verify/ui/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
"local_evidence_sha256": {
"F:\\CbbI1113\\full-suite.xml": "df15b248bb4eb21580800d43ce60a5ac4f4bae5a4d3c67580f45f0752472fcab",
"F:\\CbbI1113\\full-suite-final3.xml": "d0702c2a69dab5aef57c4fa7e7f9d633058b3c03dae5970665c393c979476ab6",
"F:\\CbbI1113\\accept.log": "39620df9b61514eed6b1c48edb19d6e1abbb71c1e4c7e7d31f0a7e1968442220",
"F:\\CbbI1113\\accept2.log": "b3d1509d1c6d65973ba4da666103785402aef576c1fe78936c559caaaa02a62d",
"F:\\CbbI1113\\accept2-resume.log": "6c5fb656f12c4e790ca1b3f01593283161bff7f8b253fd4e1444c53f0fb49d91",
"F:\\CbbI1113\\accept3.log": "0a69d374c5ae3652aac7e871578a45f090220cd3d04e8701390d95abd020a8d9",
"F:\\CbbI1113\\auto-verify-trial.json": "8729b9c6f4a48199f2e2515c59bae1891ce61b00a5572a9721dd25e003e196a0",
"F:\\CbbI1113\\accept4.log": "81af1d0a6146b33220dd85996ab7d4b28eee820fa6d8fb30314effea249cd568",
"F:\\CbbI1113\\duplicate-conflict-trial.json": "b7051b3e01102e51c551dde8aade9d358454a97ff91fb547702c8a4dbeb5928e",
"F:\\CbbI1113\\native-add-wait-chain.json": "f671192272d5edcd9ed3ea736b42ea7d330c86adaadc1a5cc434b6c55fb270c1"
},
"independent_review": "No actionable findings; static review only; three updates reviewed.",
"cloud_beta2_updated": false,
"schematic_semantic_equivalence_checked": false,
"known_limits": [
"Automatic ICDB Repair disabled; field lost-session recovery unverified.",
"Windows 10 and cross-machine SMB unverified.",
"Long native Add waits observed; root cause not determined; not claimed fixed."
]
}
@@ -0,0 +1,57 @@
# 2026-11-13:CBB 导入与附加核验解耦
分支:`codex/import-without-export-gate`;基线 main:`cbc57238496bc84f4228aa44929208a9516dff1b`。
原始工程、运行日志、截图、测试 XML 和冻结包保留在本机 `F:\CbbI1113`;仓库只保存说明和验证摘要。
## 原因与修改
此前导入会在原生 Add 之前和之后强制执行 ASCII、CSV、EDIF 内容导出;能力探测也依赖这些导出器。因此 EDIF 导出崩溃能让本来尚未执行 Add 的工程显示“上传失败”,取消上传后自动校验也不能避开它。
- 新增、同名替换和隔离管理适配器均不再调用或要求安装这些导出器。独立导出诊断代码保留,EDIF 崩溃根因没有被宣称解决。
- 保留完整来源暂存及复制核验、事务随机标识、检查点、库基线、精确进程和租约验证、原生成功回执以及重新读库。只在暂存副本中重定位库引用,来源旧库地址失效不会拒绝向明确选择的新库导入。
- 上传完成必须确认目标库、名称、分区、工程关联、顶层块和 Layout。顶层块允许保持来源名或被原生导入改成本次注册名;真实映射与实际目标身份保留在证据中,不能接受第三个名称。
- PRJ 路径规范化、默认标记、历史/其他工程文件的差异单独保存 `assets_match` 和增删改清单,并提示核对;不再以全文件相等判定上传失败。Layout 不一致、关联错误或结构缺失仍拒绝确认。
- 不比较原生重写后的 ICDB 原始字节,也不再声称证明了原理图语义等价。`identity_proof` 保存实际复读结果,没有伪造为来源内容。
- 上传后 Verify 保持独立可选;只有 PASS、权威 GREEN/READY 和释放确认才能记录 `UPLOADED_VERIFIED`。否则区分 `UPLOADED` 与 `UPLOADED_VERIFY_FAILED`。
- 来源或名称错误按行进入结果,其他有效条目继续。界面仍拒绝同批重复目标,避免对同一目标提交含糊的多次变更。单项失败先复核释放,只有未释放的相关库暂停后续写入;不绕过真实数据库占用。
## 回归与代码复核
新增用例先复现:导出器缺失导致能力禁用、导入调用附加导出、单行无效来源挡住批次、旧库地址失效、原生 PRJ 改写以及原生顶层块改名误报失败。保留陌生顶层块和 Layout 差异的拒绝用例,以及上传后 Verify 失败时安全继续下一项的用例。
最终源码全量回归 **1,895 passed**,1 条既有 pywinauto STA COM 警告;编译检查通过。冻结包的 64 个应用模块、资产和 EXE 图标与源码一致。独立只读代码复核没有发现待修正项;该复核没有执行原生操作。
第一轮全量运行有 15 项失败:子进程使用了机器 editable 安装的原始工作目录,而不是本隔离工作区。该轮不计为通过;显式设置 `PYTHONPATH` 到本工作区 `src` 后,全套通过。后续测试与原生试验均固定此路径,未更改用户 Python 安装。
## 实机中保留的失败
- 第一轮冻结包在全新隔离库实际成功新增 A/B,但 PRJ 自动规范化及历史事件冲突副本缺失被旧的全资产相等规则误报为 `RECOVERY_REQUIRED`。已增加差异证据及回归;该轮不算整体验收通过。
- 第二轮实际选择文件后移走一个测试文件、取消确认后重试并连点执行:失效行显示失败,A 随后 `UPLOADED`,B 的原生 Add 也成功。B 被后续“目标顶层块必须等于来源”检查误报为需恢复;已按本次原生命名变换修订。两项都确认释放,主程序最后正常退出 0。该轮同样不算全部通过。
- 原生 Add 曾长时间等待。窗口、进程与等待链证据保留;没有确定底层原因,不宣称已修复耗时,也不强制结束原生写入来得到成功结果。
## 最新冻结包的实际批量链路
候选程序:`F:\CbbI1113\candidate3\dist\CbbRefreshVerify-Background\CbbRefreshVerify.exe`。
SHA-256:`98a642d8e81f42b708934bb4dc2d023c49c2acdae5851151a430f101c74c9615`。
第三轮从应用真实按钮和文件选择器向全新空隔离库依次导入 B、A,开启上传后自动校验;没有替换原生适配器,没有前台鼠标接管,也没有强制结束进程或删除原生地址/锁文件。
| 步骤 | 实际结果 |
| --- | --- |
| B 的原生 Add 与复读 | 原生明确成功,库/名称/分区及工程关联确认;Layout 一致;顶层块从 `1GPHY_RTL8211F` 变为本次注册名 `1GPHY_RTL8211F_A`,映射保留,上传确认通过。 |
| B 的上传后 Verify | `MENTOR_PROJECT_INTEGRATION / forward_annotation`,原文 `There are no PartsDB partitions from which to extract parts`。空库没有 PartsDB,不能创建本地 PDB;记录 `UPLOADED_VERIFY_FAILED`、safe=true,不记为上传失败或 READY。 |
| B 失败后的同批 A | 实际继续执行 A 的原生 Add,注册及 Layout 复读通过;没有因为 B 的 Verify 失败停掉整批。 |
| A 的上传后 Verify | 同样因空库缺 PartsDB 返回 `UPLOADED_VERIFY_FAILED`、safe=true。没有把失败伪造成 READY。 |
| 独立目录读取 | 重新启动原生 Library Manager,确认两个正确名称均存在。 |
| 来源与退出 | 两份输入主要内容清单未变;原生会话释放,应用正常退出 0;整条试验控制器退出 0。 |
| 附加导出 | 本批未生成 ASCII/CSV/EDIF 导出进程记录;对应自动化回归也禁止普通导入调用这些导出边界。 |
第三轮原始证据:`accept3.log`、`auto-verify-trial.json`、`d3/management/*/checkpoint.json`、各项 `add/identity-comparison.json` 及 `verify/*/result.json`。此试验验证真实上传和“校验失败后释放并继续”的负向场景;**不是多个新增项在依赖完整的中心库中全部达到 READY 的验收**。
第四轮从同一最新冻结包重新打开该库,实际再次新增已有的 A:取消后重新确认、执行中连点均未重复提交;原生目录确认同名后返回 `UPLOAD_FAILED`、safe=true,检查点没有 `native_add` 阶段。目标及共享主要工程内容清单前后完全一致;独立原生目录仍只有 A/B,程序正常退出 0。证据为 `accept4.log`、`duplicate-conflict-trial.json` 和 `d4/management/*/checkpoint.json`。
机器可读摘要见同目录 `2026-11-13-import-decoupling-validation.json`。最初两轮发现问题的包及失败记录没有覆盖或改为成功。
## 范围
未更新云端既有 `v0.2.4-beta.2`,未合并 main 或关闭工单。自动 ICDB Repair 保持禁用。现场失联故障、Windows 10、跨机器共享库及任意工程内容的完整语义等价仍不在已验证结论中。
@@ -0,0 +1,430 @@
{
"schema_version": 1,
"created": "2026-11-13T17:31:37.910526+08:00",
"review": "https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-414",
"base_commit": "1572e2d8cab905c28f96f562851db00ef7ea8ad6",
"environment": {
"windows": [
"11",
"10.0.26200",
"SP0",
"Multiprocessor Free"
],
"python": "3.12.10",
"mentor": "EE7.9.5"
},
"commands": [
"python -X utf8 F:/CbbReview414/run_tests.py tests --junitxml=F:/CbbReview414/full-final.xml",
"python -X utf8 F:/CbbReview414/run_tests.py tests/test_review414_write_admission.py --junitxml=F:/CbbReview414/admission-extra.xml",
"python -X utf8 -m compileall -q src tests",
"git diff --check",
"python -X utf8 F:/CbbReview414/build.py",
"python -X utf8 F:/CbbReview414/verify_bundle.py",
"python -X utf8 F:/CbbReview414/create_library.py",
"python -X utf8 F:/CbbReview414/driver7.py"
],
"full_suite": {
"path": "F:\\CbbReview414\\full-final.xml",
"sha256": "075f7b76002b451a72af65d64428c0b6c65e5fa5c8776036a5fff55584a6dc54",
"tests": 1912,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 520.549
},
"additional_admission_suite": {
"path": "F:\\CbbReview414\\admission-extra.xml",
"sha256": "6aa78606fc7aa4af1b3e2f8865752a60a518d9d25b5f88924f2b1d88280b2ac0",
"tests": 14,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 5.299
},
"focused_serial_suite": {
"path": "F:\\CbbReview414\\focused-serial-final.xml",
"sha256": "8f68dc1ffd22d41f343299ff4382157c5fcb7ce68dc5198d2755a87dc1764337",
"tests": 19,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 5.036
},
"concurrent_test_failure": {
"result": {
"path": "F:\\CbbReview414\\focused-final.xml",
"sha256": "6246c57aee87142dae183aa48399ff2e3f8e8afbff0c4f6f3655d02b93b535fa",
"tests": 19,
"failures": 4,
"errors": 0,
"skipped": 0,
"seconds": 7.213
},
"reason": "Coordinator ran mutex-using tests during live native acceptance; four management/recovery tests were rejected by Local\\CbbRefreshVerify795. Rerun serially after native trial."
},
"count_note": "Full suite collected 1912 before two additional tests were appended. Additional 14-test run includes both new tests and 12 already in full suite; 1914 distinct tests passed.",
"compileall_passed": true,
"diff_check_passed": true,
"bundle": {
"module_count": 66,
"source_and_frozen_code_equal": true,
"source_sha256_checked": true,
"packaged_assets_equal": true,
"exe_icon_images_equal": true,
"executable_sha256": "818decc5f0778a27affe3b047da526595007608e234b89c05d3e1c375e1c4cf8"
},
"red_reproductions": [
{
"path": "F:\\CbbReview414\\open-red.xml",
"sha256": "b33502766075ece9777ceee3f6e7dde66dfb558eff08a5f860ccc0ebd63f9500"
},
{
"path": "F:\\CbbReview414\\queue-red.xml",
"sha256": "a5bbad8641c7851a5fa3a4bdd15b17784c9c90c92ee4f8c8fc7e51b62ae25f40"
},
{
"path": "F:\\CbbReview414\\write-red.xml",
"sha256": "4d0b0c6ebb0382955470ecb6072126b1d4f0708e6f77c49060c5be6b592220d7"
},
{
"path": "F:\\CbbReview414\\query-batch-red.xml",
"sha256": "6299777fd6d3c87849b0b7069afb0d238d4f4f20f84d7cdea59b81f4a479694f"
},
{
"path": "F:\\CbbReview414\\export-red.xml",
"sha256": "16724c8a015b5cb1c2d304abe6f5678716a4b4d40fd29880cb6f8a2ade451462"
},
{
"path": "F:\\CbbReview414\\restore-consent-red.xml",
"sha256": "e9e2edad0c3481bea26c00c14253c9fa9b2e2bbcb3679583e52489ac3072f571"
},
{
"path": "F:\\CbbReview414\\default-cancel-red.xml",
"sha256": "2e4b9b64d9a7fe8c719b08db407b78e6c866a647040761c1be36d566b86dca36"
}
],
"native_trial": {
"records": [
{
"operation": "add",
"name": "1GPHY_RTL8211F_A",
"status": "CANCELLED",
"safe_to_continue": true,
"detail": "已取消本批次,未提交后续写入。",
"evidence_path": "F:\\CbbReview414\\d7\\management\\management-00175f4d987f48da80bb7821017e7617\\checkpoint.json"
},
{
"operation": "add",
"name": "1GPHY_RTL8211F_A",
"status": "SKIPPED",
"safe_to_continue": true,
"detail": "用户跳过本项,未确认未知程序与目标库无关。",
"evidence_path": "F:\\CbbReview414\\d7\\management\\management-26da6781691c47c7a8172b5947db7191\\checkpoint.json"
},
{
"operation": "add",
"name": "1GPHY_RTL8211F",
"status": "UPLOADED",
"safe_to_continue": true,
"detail": "上传已确认;本批次未启用自动校验。\n原生注册、工程关联、顶层块和 Layout 已确认;未核验原理图语义。其他工程文件有差异,已记录供核对。",
"evidence_path": "F:\\CbbReview414\\d7\\management\\management-2a587eeb2919405d9b570df82ff75a2a\\checkpoint.json"
}
],
"choices": [
"cancel",
"skip",
"continue"
],
"catalog": {
"library": "F:\\CbbReview414\\library\\native-add\\fixture\\mentor_lib.lmc",
"flow": 1,
"safe_to_continue": true,
"names": [
"1GPHY_RTL8211F"
]
},
"sources_unchanged": true,
"parked_untouched_until_explicit_user_close": true,
"user_closed_owned_empty_client_before_continue": true,
"evidence": {
"path": "F:\\CbbReview414\\native-trial.json",
"sha256": "ecb21df8fd56755dd3bdc6374fa82b5623c523c396314a1c049c225fc82559df"
}
},
"native_action_log": {
"path": "F:\\CbbReview414\\actions7.jsonl",
"sha256": "4ee465d2750b826de428693f89fe0cd9d19f67e5ad08c0fb11451184a883faf2"
},
"superseded_drivers": {
"reason": "UIA traversal of disabled parent during modal prompt stalled the driver. Native windows were cancelled normally; no forced native termination.",
"logs": [
{
"path": "F:\\CbbReview414\\accept4.log",
"sha256": "f551539adec4e38072a58eff9e1a8c7589d926f2f120342a101f8476450b4b12"
},
{
"path": "F:\\CbbReview414\\accept5.log",
"sha256": "d2db6fa91df459d367900832a10c15459ba1ea8fb2a3773c29593c875597a03e"
}
]
},
"rejected_native_trial": {
"log": {
"path": "F:\\CbbReview414\\accept6.log",
"sha256": "73cf87c9328d2e4104077f36ecfbdc383ef67d5d5e54674f640d88d8e5a9de16"
},
"statuses": [
"CANCELLED",
"SKIPPED",
"UPLOAD_FAILED"
],
"reason": "Existing native _catalog_com refuses any preexisting LibraryManager even after write consent.",
"no_force_termination": true,
"foreign_client_untouched": true
},
"interaction_method": "Private desktop Win32 keyboard messages for modal owner decisions; UIA for idle dialogs only. Skip/Continue key routing separately verified against actual Qt dialog.",
"history_provenance": [
{
"tests": 1775,
"record_commit": "fdd07224aac99bee8d1f29e8e82d6a2c49964c87",
"record": "2026-11-09-full-review-followup-validation.json",
"manifest": null,
"recorded_manifest_checked_files": 27,
"manifest_mismatches": [],
"exact_historical_tree_available": false,
"collection_exit": 0,
"collection_summary": "1775 tests collected in 12.12s"
},
{
"tests": 1851,
"record_commit": "42d0cebc54191681b53dcecb120f53236c1963bb",
"record": "2026-11-12-native-acceptance-validation.json",
"manifest": "F:/CbbAccept-20261112/candidate-release4/source-sha256.json",
"recorded_manifest_checked_files": 70,
"manifest_mismatches": [],
"exact_historical_tree_available": false,
"collection_exit": 0,
"collection_summary": "1851 tests collected in 11.38s"
},
{
"tests": 1880,
"record_commit": "466f400514acc8531a219db8e75641be35304a3f",
"record": "2026-11-12-scoped-release-validation.json",
"manifest": "F:/CbbAccept-20261112/candidate-scoped10/source-sha256.json",
"recorded_manifest_checked_files": 72,
"manifest_mismatches": [],
"exact_historical_tree_available": false,
"collection_exit": 0,
"collection_summary": "1880 tests collected in 13.05s"
}
],
"independent_review": "Both findings fixed; final static review reported no additional actionable findings.",
"tested_files_sha256": {
"src/cbb_refresh_verify/application.py": "62b9b013563a216d020c8366cccb8f949b02afa72dc63c26940804441cc23057",
"src/cbb_refresh_verify/backup_recovery.py": "08ca467304f8ce34185212a92de0ebd0b83455302fe9351d09874b180222b523",
"src/cbb_refresh_verify/batch_status.py": "55a4007cf54491ca8e045a5bf86aa4353ac8437cca5a76cd79304962e3d3fa0a",
"src/cbb_refresh_verify/close_failed_block.vbs": "e5f0d9678e07a239e96e634b90cdc761de52fc136311fae31484fa38d6fd9781",
"src/cbb_refresh_verify/com_runtime.py": "f0f3802d16c791a8bf9dfef44a94917072bfbe8fb3a927d76be8ef0341c7ed35",
"src/cbb_refresh_verify/content_check.py": "8239c17b6e2452917ed573a7deb3e4c8583eaef91bf3630eff5f424d2e398aa9",
"src/cbb_refresh_verify/defaults.py": "a1c03192f4a61ad0924b24bb635705b1ee4811d35483a02864200f95edbbebe3",
"src/cbb_refresh_verify/desktop_worker.py": "27d751816552d215dd8ee9cd67941d824f7b4493120ead7c3f87e5eba5ec4a92",
"src/cbb_refresh_verify/diagnostic_open.py": "d6c49ffe5a9969d95edbbc896d47a7e100f248380a287f99ba7bb8b92dbb3072",
"src/cbb_refresh_verify/dialog_agent.py": "5acb6e5cf1350a7ca20a6fe480668435fac785835874f266881973010db6504b",
"src/cbb_refresh_verify/dialog_models.py": "f68cee01d927b48364276d3c1f79e63ce8af231878db0b907d292780cfbafb56",
"src/cbb_refresh_verify/dialog_probe.py": "d61f0c955c961980c9635940eefb9c7947c1fe90b4b6fd844720df41ddb0aa0e",
"src/cbb_refresh_verify/dialog_rules.py": "3189b476f7ff4678b59212ed7b4081164e038a7cf7662cd895f9019cb3c1edc5",
"src/cbb_refresh_verify/dialog_supervisor.py": "15c415c2d2e916f0b64ba04416164ff3b50996d70b22d3b4ac2226b5547ac247",
"src/cbb_refresh_verify/failed_session.py": "7e6f7fa5ebcf2d49f00c5efc5f5d26412704b68e9122e476ac1f672009a98c09",
"src/cbb_refresh_verify/icdb_maintenance.py": "e81d253d8b4d3e7c1000c45335a392c72b110748675c2c3324ebe524a7252e98",
"src/cbb_refresh_verify/icdb_ownership.py": "7bf2342c1efa34a2ebcbf27964a40a490220f7146fbb6ef957b8d8dd1e511f03",
"src/cbb_refresh_verify/icdb_recovery.py": "358c0e9a004f1e0b2127513286e1dffd94b0180a8b7314aa9655462f570b6360",
"src/cbb_refresh_verify/integration.py": "f188856af69ba25e265988c51db7a6d4263326440d972ca78378b733b891c1ed",
"src/cbb_refresh_verify/library_lock.py": "6836ec8ac21e788eb75326ff44cb31ad4bdfb5f381bd35cdf33e6b34c7fca89e",
"src/cbb_refresh_verify/library_manager_verify.py": "71e16a8581ad44b646be78b480f9812d596a6d162b3eec03d078bf4ea4503195",
"src/cbb_refresh_verify/library_reader.py": "d4007caa361edd467773e49f721e02671d5a9bcb30741769a57349850b12c438",
"src/cbb_refresh_verify/maintenance_entry.py": "3b93c25f69d7a961facd8004e20e155a84cc18f06d57b741a9055786ed058990",
"src/cbb_refresh_verify/management.py": "7ead9bfffeb44201e44f73d9f039590f091e9a456982f2110dca8ec3695f8803",
"src/cbb_refresh_verify/management_transaction.py": "32c53caaead05d5db3a31d3e30721e65434e5837095dc0a7812f825603aa37a0",
"src/cbb_refresh_verify/mentor_adapter.py": "1fc8c98d5508120e03bf001a42dd3e0da7b165eb18c90f1aed83147d17db8638",
"src/cbb_refresh_verify/mentor_paths.py": "ba48c0003b3eacc88906497b2e43b299ca4536a9f7dae44bbacf6a6ec694c116",
"src/cbb_refresh_verify/models.py": "9e8209a8b006df923f1d07ccab64bbcfe5d674c4fc5f5426bfbc9b11da4ee105",
"src/cbb_refresh_verify/native_add_failures.py": "192202732423dc624c5548c75e80bb20973e5087c21d4798c9637f25b6de7e94",
"src/cbb_refresh_verify/native_backup.py": "7276fa3d9298e85550151cf0c7191d84bd08a18a72df5d854a3c38f1a88b001d",
"src/cbb_refresh_verify/native_engineering_identity.py": "e704e8f56c43629a1593d490776af328bb032208ee2f5ffd1d1be6c3114f5412",
"src/cbb_refresh_verify/native_export_guard.py": "523cdf44db8e1665634feadba963ccf26777dc8942fb2eb604d2c30bbe92cbb6",
"src/cbb_refresh_verify/native_management.py": "1e8a298aac8c63aef68b1e799d1f06e43de7abdc165be5086e7089a61e643e88",
"src/cbb_refresh_verify/native_occupancy.py": "7d686079d12217382adace6361cd343d977b91075e3b157cf410ca92d07ffc49",
"src/cbb_refresh_verify/native_repair.py": "9f024dcb5e3a76369191033474fefd30787b6ae350c315f3cf38e92e5a1f3e98",
"src/cbb_refresh_verify/native_repair_ui.py": "3eb2af181befea94af8b3b3131edff09589f340bcba777abbe3b67fd31b80393",
"src/cbb_refresh_verify/network_path.py": "6b5b159502d42a46bf4ee26d5698fd2c6498b359088e2138eae46e9065b13c6f",
"src/cbb_refresh_verify/operation_lifecycle.py": "3838c5a501711d16f578c45ebbc6f960872b0c3ba6bbda9a597f994ef746cef6",
"src/cbb_refresh_verify/operation_queue.py": "a6932d8bc68ac436091f6d362557c66d274ec52d0f295a22f014a3396845c79f",
"src/cbb_refresh_verify/owner_probe.py": "8dcfd60246cb2979db34d02e0a2d605c334b6f7e2666f22daa2f50c0408bc903",
"src/cbb_refresh_verify/pcb_bridge.py": "2f6c2b09642100468814500569dbfc6695fc2a46b9a3b8333daa8e1530cdeef5",
"src/cbb_refresh_verify/pcb_open_consent.py": "2680930acc4daa314529c435337915333c05a8594ec28bc053c930054602590f",
"src/cbb_refresh_verify/pcb_restore_prompt.py": "39e0b8623a838911eff61066f3e9c8ede4364dbf73efc5a8994197ec72a96488",
"src/cbb_refresh_verify/post_repair_consent.py": "3b1eaff1db58fd311a9dbc5fdcd850911b04cc5afd4e747f70a62b721b8fafa4",
"src/cbb_refresh_verify/post_verify_diagnostics.py": "2442de485bc0d6a34c4b2d9b10bc5f323ea38f9ff66674119a50f5c6043bac63",
"src/cbb_refresh_verify/reimport_recovery.py": "ef148549751fa47518f5f2ca8f32ba25794ec5f22e0de545476ea33f89a3f0bf",
"src/cbb_refresh_verify/residual_sessions.py": "4ac500b33b209611d54eb496c6c30727ba159742d625431ceea84471a5fc3442",
"src/cbb_refresh_verify/runtime_logging.py": "44ac25430a89c5ffc9e48e88c227e88052f4c815365e8556f67918f3edaba39e",
"src/cbb_refresh_verify/runtime_timing.py": "c4ed4057b5000e0b86ccc7dd1fe2004d6e0dae29f397fec77b01ad41a81c6367",
"src/cbb_refresh_verify/save_verified_block.vbs": "926175562ef82bb2e732231dbc18d8a88059c7e6143c9f4e502cabfd0d170bcd",
"src/cbb_refresh_verify/scoped_manifest.py": "9318bf0f929d23c18466a25d83a4a9903822093c123aae10510061788c6d0ab7",
"src/cbb_refresh_verify/session_record.py": "2bc3cff365008864584138a4ff13538bb6b2f90d981e7d008a1300f9102c6e7e",
"src/cbb_refresh_verify/status_bridge.py": "05d627d02934a14f5de409472c291d37565a95b836f9c130111aae80612e9196",
"src/cbb_refresh_verify/verify_diagnostics.py": "041b77d7d49e4c86338ed5e5741d0d27a2c42bc358f4da54b3efe64af847e9b8",
"src/cbb_refresh_verify/verify_probe.py": "3ed743df49d195c74f5045985ab23491d103ee2c42c07b558c1e037176402ed2",
"src/cbb_refresh_verify/verify_runner.py": "3027ef7fc1ef6365ff36ae0c83389d869b92ffcd96985d10275bca4dc9483e3f",
"src/cbb_refresh_verify/write_admission.py": "e38b460370596f49499fbda3033b2962dda125aa62862fd2327bf6d376d192b9",
"src/cbb_refresh_verify/__init__.py": "dd960394d88657820dba858792abf0de258e05efceb08ae2f0b39c6ad78bc469",
"src/cbb_refresh_verify/__main__.py": "dc4be034a0e43d4b659a9300137c29a6a6b7a32b7eaef02b6dff9a88c41305c0",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.ico": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.png": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.svg": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328",
"src/cbb_refresh_verify/assets/dialog_rules.v1.json": "3911080fc799a819662e225a7ad73e883abd8dcc9936cc30ec1b2d6d51a03c6e",
"src/cbb_refresh_verify/ui/backup_notice.py": "1a3fa5ac18a267907faf95f36d61b9f08bcbb939eef4d480dd06af1391a81599",
"src/cbb_refresh_verify/ui/backup_recovery_dialog.py": "ba30b79cd652b74b6e8f438d6bd5f0fc0229594ff4be2358f81c6dd3cb82e77a",
"src/cbb_refresh_verify/ui/icdb_check_task.py": "ade3bf414aa29b42f4c1535c613b2cacb2735f6abc7900e6da25999390a5891d",
"src/cbb_refresh_verify/ui/main_window.py": "2c919badeeee0280e49387b88b058555a9fa6ace04835c094fccd782bf0af9c0",
"src/cbb_refresh_verify/ui/management_dialog.py": "8e2024957be874905685167c7eab440ecee9320170c1553340025b10fa1754d6",
"src/cbb_refresh_verify/ui/pcb_open_dialog.py": "3cabdc15f1b2abaeb919a7f29f32d4b053186701fd514646d9bdd3ea32f364f6",
"src/cbb_refresh_verify/ui/pcb_restore_dialog.py": "b7228d828df235ac51502dc68760d28c4896af02c780e9806e11c32dba7f62da",
"src/cbb_refresh_verify/ui/residual_release_dialog.py": "1d2a26bfc7ee21b11d7edbc3074b4c525e8c9fb628bca45b08bd06fc672586c8",
"src/cbb_refresh_verify/ui/workers.py": "4cc9360a4820ded27a7d5ef709fc9f04b1d4804cb1e7a614f6c357ed547da888",
"src/cbb_refresh_verify/ui/write_owner_dialog.py": "c77f4d57e683fa397a39a573171198922f6158e19a8a96ca3627af60b5a8963f",
"src/cbb_refresh_verify/ui/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"tests/button_simulation.py": "3278868565853001103557d5f7ada42b11b05c03feb9032deed0327b6609de2b",
"tests/CBBRefresh.Core.Tests.ps1": "e90774cde77189bc577ee374b50a8cc951740d2d3c36c786c73abbd128181a59",
"tests/ContentCheck.ExitCode.Tests.ps1": "efa0d1e8a77715932670ab8ac299984e023867d07ff57b09fc7da6d68c4d6fd9",
"tests/test_abnormal_shutdown.py": "0abdeaf51e2ffc3f771e09aefa9ec647a72b7f64757c9f3851926fbd392cbbcd",
"tests/test_all_buttons.py": "897ae449a15fe36fb6198a947575609346d5ce1a22c0a8c4d2950b9f00035d4f",
"tests/test_application.py": "bba12187fca6fee0f4f8862182bb40d939e2995016af2cdbb3fd756f6a99135d",
"tests/test_automation_license.py": "45e9c75d0d3e1a76f997f7da4cc87b5eb1b05a4ea2356408725742eac8a09ffb",
"tests/test_background_icdb.py": "df9bd9e8252e0dee4527dc6a740c0c33e76d1fb06a79b816cc15809d95716e44",
"tests/test_background_queue_regressions.py": "132866bfccc9a7ac5cb234f97aaf6a290e2e4ef949f31e2f70b0f3eafeb99046",
"tests/test_backup_recovery.py": "efd88c0c00440ac915b147c2e6dee8044ca805b03f90ab9f171cbde1db11cb9b",
"tests/test_backup_recovery_dialog.py": "b2f65864b861d95e99d5efb61ada915ae41973d2b49d08f2d536781997dd00cb",
"tests/test_batch_blockers.py": "4387293d3a5820fab630e3c5fe1b424f61ba6947773e5a61125d840433c5c62a",
"tests/test_batch_item_yield.py": "ed4be6d1e854b18d054a75c92171cd46b6b64411c2f74e9a3caf31fba3c7366b",
"tests/test_batch_status.py": "c1f9af0c7c6f3171b3726fb53346f480b13b8d9cd88111a9c12e2fae2392bbff",
"tests/test_batch_status_faults.py": "314e890c9aee439c8a75b4dfd605685240c74f6212da975fd50526bd70b4a0ff",
"tests/test_desktop_worker.py": "671d616f04a01d74508b328e3b6fc8f6c7191a91de0dcaa486aa98a3718353ff",
"tests/test_diagnostic_open.py": "b44f8f7b171602ad2691ea2e064ac9fe94f2fabb9fcc2eb6760cc1dd365b9423",
"tests/test_dialog_agent.py": "8c746e47d55637ca18d7cc998f324a0c2e0a5214dcfe8fcb6458c060619c211c",
"tests/test_dialog_models.py": "6902cf5c292458340fb48241b34875e111a0113d706cd82775934a7f72bab7b9",
"tests/test_dialog_probe.py": "55c98f6102957a27a96dcfd4f4bf3af499b5055225b77ef93b7b332dfd4ac472",
"tests/test_dialog_rules.py": "96bf36493da770679e9207e96b3088ef7f471aea22e17c254f33326ffef0d7f9",
"tests/test_dialog_startup_budget.py": "6f23c01836e4894ae82c3345a2383c4f8eb0517056c5b953c43100acd0fc3739",
"tests/test_dialog_supervisor.py": "4c1b00050127a65b0a8cf1c7a94fd673431ea3f04b76033a463804d0468ad2d9",
"tests/test_extended_safety.py": "7450816abba89aba1f4739f819f43631def82701fe07481279db2b3f3ed96cf6",
"tests/test_external_owner_release.py": "675ddbab4a97e86febac3003b9083c259295534941aa0463488a5a1206cfaf92",
"tests/test_failed_startup.py": "eca757ea46a4c0aa4fb0368ff53f26822af71612d251ecd87132686fe3c3794b",
"tests/test_failure_lifecycle.py": "dfeac56744a44e6f4c7898516749ca478f53d7c7f08b3843a05ef7f448c469a7",
"tests/test_icdb_address.py": "cbdc07e5043349c796a4ea1ce3d4989062094cd28929a9ef7d42c5ba75b77907",
"tests/test_icdb_batch_check.py": "e83982e0fd0b3744bdc62965b26970ded31aacfedea94283d9e321ef70a8232f",
"tests/test_icdb_open_check.py": "1f3750169755d0553bac3e0f8bec244038b84f9cd970e17c9f6eb67dee0e3dba",
"tests/test_icdb_recovery.py": "298ddac4b79b4400efc99ff27c58ca49fffea1f401a31071451b2fdaca59036e",
"tests/test_import_without_export_gate.py": "ae3dd0fb41c41773ce2d54aa9f9be83bbb56a0d09c59d600b10575fa8f0d2cd4",
"tests/test_incident_safety.py": "52f3ccb04db8971bf38628c2bd334d4fd79795e97de6538f6f66cb35f7123ece",
"tests/test_independent_operations.py": "4ba5798df3346bce74c3703c158f1dce1d1ba14df748606fcaf900c8568753e0",
"tests/test_integration.py": "9e9d30692607c889e1e3744a63c79c68e3af7d4c86804e0bcebe48e68765086c",
"tests/test_late_release_continuation.py": "34c62a628cbc08f4e8b9a1919c13f17772a2d26d1996fae34a35f814725b00e2",
"tests/test_library_lock.py": "3d65bd941faa441404045ce0140ea3ea5e58fb7d410b7b76bb9f03a9ea03d3af",
"tests/test_library_reader.py": "b39a1dc9d99c2463b744141e3c3489cd49ac4a637e7835559a9c3fe9cbafbb58",
"tests/test_lifecycle_supervision.py": "cfe29f1e73c6ef38d11e185e211b6e2fb60247f53a44e99dd1e2f8cf7a009faa",
"tests/test_maintenance_diagnosis.py": "0849aef555475a03b061eacf499f261fb75f2e727f35dba3cbceafac92e2a638",
"tests/test_maintenance_entry.py": "5ed3cda8e0c829fb2964e27f1bdc6fa8ee8dcde93ec63338959bf754b62d6a0b",
"tests/test_maintenance_owner_scope.py": "7cf64dc7f2b126684dcac6e619cbd87eca3d85ec2fc1f70f057154679dad6026",
"tests/test_maintenance_review.py": "ba807fd8c25c1b52cf2443d8bcf2f57539819715c0bc6c358d31d8542c2e7ce5",
"tests/test_maintenance_startup_gate.py": "4f69d33218483a658b51b2012ae8bfa83aff8a787152a38b19dadc4c0d3ffe36",
"tests/test_maintenance_ui.py": "2a640ba5e979a3fead81f0a38603b6105ffcb883dbb8484ccc42c99ee8c311db",
"tests/test_management.py": "cad0fb43eca9e7022a33a5e9ff0a408465b262fd304b146cdc85c28265f2e74f",
"tests/test_management_diagnostics.py": "671a9d7c112ededbee332db9b6fbab786fb37e9367d992f902f3ab2c9f60880b",
"tests/test_management_native_transaction.py": "7ca227aae6426c4d0d998edfd8620ec18905aaf212f0be20ceba97b1cde3a9a4",
"tests/test_management_probe_guards.py": "ae9be3dbd7c6a616478b7d4ea3498c428ff94a985089fe798463c5cab456f151",
"tests/test_management_retry_blockers.py": "124dbef291dbe331ba0c3e7de1665c910ea43e37b1563429b387f0f2233953ee",
"tests/test_management_source.py": "16e608ed9c8b0aa81cf08d49f165a33a1403c4ea7f2a5be44e8cfc8cb49850ad",
"tests/test_management_supervision.py": "2dcadd6551a94c52e5d4e74285959f10144a89c48af87e508abaea945652d1f6",
"tests/test_management_ui.py": "da3e2bc0b5c73926324a539edfa2f718ae1b585df96324a928a0c1a909e48083",
"tests/test_manual_backup_ui.py": "927e42ec4a1e0139c71a41b0cad1389ad47b0881381203c18b307cd2d137983a",
"tests/test_mentor_paths.py": "a05a91812a74b58e76f36d581216ee43969d2576b8a8e7d1cde3e301c52cf4c1",
"tests/test_native_add_failures.py": "ceedd60e030628b1af149d08d16216d5f7158a63686729bb357c148da86fb0ec",
"tests/test_native_backup.py": "43ec0c6b14b53864553feaf5d9fb498b37866f24edc486c0749160d3f803db5f",
"tests/test_native_engineering_identity.py": "a1adcf6883a9b55c2c37d9f491faf40dd4928f4d8db675419fd288dd31552c69",
"tests/test_native_export_guard.py": "f8ec4fa1058af55008e9628f79f2dc70b6e551f36815a812d10bfdf955cada51",
"tests/test_native_inspection_release_regressions.py": "8f7bb0b2b641d437872f1dd1d0c2547c2522c81e3c0351c31a7125f751d91927",
"tests/test_native_management.py": "badf33d4d00104c7e96e336777fb3e49690cc9db5ce1b071f98520aa5b6668f1",
"tests/test_native_management_fields.py": "9917ca0910e19bd809c86d0120c652145261528ace33c3b805f5663442c4a973",
"tests/test_native_occupancy.py": "56293dbe24bd3cd4f74cf8208e933faab7d737e5a5684a5d38838d063c3aef6d",
"tests/test_native_repair.py": "113185ced72d8f4f4eafca99054d97fe80a504d1c6cc91aaf86f55cea1b7e138",
"tests/test_navigation_tabs.py": "d7d5bbfc752f73c1b1d4615ffafc1266e772d96f3f3ba3d82c4b4baf678b292d",
"tests/test_network_path.py": "f52624391ae78e9b913dace2b1a9a2875a5855f86dc9e12c324ef493e6c7817b",
"tests/test_network_release_safety.py": "caef536d0a40b2eb848c1b8ab095ab374af247c03dd44acf8a70f0f500db6dac",
"tests/test_operation_lifecycle.py": "c0ce6c86b73021a8b162ae9e67a10aeec8a27a98e382fd82e1449a451a9a8c3c",
"tests/test_operation_queue.py": "8137528603f015695ed4d60a0c8fa8e7bf0a1c4659f8dc2a181291f5d500e6a1",
"tests/test_owner_probe.py": "deb757e022980f11ef48e57a2fd002ee3e90ec647a4666a0c4d4427313b6f725",
"tests/test_packaging.py": "87a6d04419775c0c5c806e0e569a48d7ef199a0bff8736b211443a1f471e7e8a",
"tests/test_packaging_status_bridge.py": "cbfaeac070a1494a1d8609fc25e9a779a63354c8914b4c6c57fdc7c31b70d472",
"tests/test_pcb_bridge.py": "527fb63147a203a2e9419da989aff600d3e461580989e39e8ede3a8cc57b901a",
"tests/test_pcb_open_consent.py": "5bf9ef6276d221b73ebe0dd14cff4fe5dc11bfec7b8be3266ae4a6b6a588d354",
"tests/test_pcb_restore_prompt.py": "a005691d0296587e520e20c4430e9e55227d767c8e910e950a9f2e93aeccb2c7",
"tests/test_pcb_version_choice.py": "0825c28333e4ed4f5a63847b6f5bb11143e922c7203d2770ce9c78fc8edec20f",
"tests/test_post_repair_consent.py": "bf417b378255386dc97ad8efdf5003b0691aa5d69da9d9256aa367dc16a2d4bb",
"tests/test_post_verify_diagnostics.py": "212857e56581998a3a3cd53635030b68a089fc4d630a8b0ee7ef3f137090dcc4",
"tests/test_private_desktop_discovery.py": "5361493313ae6864e252cdb9f2c72e71b39264a1c022beb4cf0c04c143cdd91e",
"tests/test_readonly_status_policy.py": "3ed40d7bdf2d3e6f70b38803b89a8b982336556444b45c6ba6b0a7c6df52a97f",
"tests/test_reimport_recovery.py": "875e5e2a0f6251ec5a251457848c7eac5dfd1674fcbb4745155f6d5d8bf4a4be",
"tests/test_residual_release_dialog.py": "10b23d009703d542e5ce8ecb35a4833e0135bb8852b4116e49eedc7010397a1e",
"tests/test_residual_sessions.py": "2c51ed1dc95a3afa7ebb24027963dfa9d13aba9c407e508e22ccc6e9f762dfeb",
"tests/test_review313_residual_isolation.py": "52a8024ed4e2a7fed219fe46cacdf76fa971166feedd557206716ef7f6d3c914",
"tests/test_review326_dispatch_and_receipts.py": "ce4d529246da1c4d53c3dec70ef49542165064404301dec3e32851df62492ecf",
"tests/test_review326_queue_guidance.py": "c2c97aceddd9713618afdd5f2a7be4764b56a1b62fc672282fb8c218b4969c74",
"tests/test_review345_ui_cli.py": "795e7e4f9bda8874c6a65a08863cab19f4adb3412287276ee2960588f0fd2fa8",
"tests/test_review348_release_comparison.py": "ceccdb3d6f7bc6cb65562c059f13aa2bc5d89d98c6f64b0f11d9b943ebbde165",
"tests/test_review381_queue_release.py": "e0d62424cbf70ec9573db78ede0a4c6534775399194eed4c6b28ba8d468307be",
"tests/test_review391.py": "304d46d63af87ea4a9bca83834b77cc44c5c9addf7b0f3752431304ee612568c",
"tests/test_review414_export_and_audit.py": "ec785c2656bed97de6c8467885f2ad0877b55ee872b02928744d399e8767d8a0",
"tests/test_review414_open_and_queue.py": "db065207dacaccd0bd80af52c1f1edaf36a278e7cf2dce7c9b44bc51dd0e1cec",
"tests/test_review414_write_admission.py": "604ee7429053d408943a1d74b18c6bbf2de817e9e0b76c82abe7a1faceafdf9f",
"tests/test_review_319.py": "831fd34d426abb4436b9132bfb7ed754994155a34ac60a59378dee0964b54d28",
"tests/test_review_backend_followup.py": "2f3f51a72ecd05fc33c6b5a8dddaecfd12d2b50df423c87b4c18d1e52b2609bd",
"tests/test_review_foreign_release_evidence.py": "cbf2af02418f6bd3ec720a7a7658cf97f06d1a6e12009fdff2a99f465711591e",
"tests/test_review_management_ui_followup.py": "746602a84c3ba9cb041c5dd354b39d344355b71a3666b27a47eb9aee231e171c",
"tests/test_review_release_followup.py": "ab375f67e63cf3f33fa67ce19058be442c2ec56f810d4fc58ef5484272cbda49",
"tests/test_runtime_timing.py": "7152cd8fedfe165e769dadc1238c347d9f4d3e93cd57f6ed991e14d959e720f7",
"tests/test_safety.py": "ccf5febaf0a974d5e5357398a6946d3f121e07a6247c2f0dc5b71d86b39cac52",
"tests/test_save_helper_identity.py": "178a68c4a9a8c618dad3d8393e816dd1d2a16aef8d1fb9984117fe9dc8d06add",
"tests/test_save_helper_runtime.py": "00b092ec799da4bca424e1ee63a83bee783c81dbcdc20b7526fda8b45bb4b72a",
"tests/test_scan_isolation.py": "cab02bfe55ed515f889d3fcba6e6880344f482cc3a78a072b543b7a871cf92ab",
"tests/test_scoped_manifest.py": "fe9b2047d2c43812e851dd89ff250a2e5907dda89b3f5d9ae0a4dc4c5f452eac",
"tests/test_session_record.py": "6b51b19adfb232275195da7ff1ba91a5ce5e296f9424a7a1a29fc67ecfdfb108",
"tests/test_status_bridge.py": "fe1c0632d4d5fd5a1caf221903d4cfe38eda62aaa4298e3438735e31b8459ab2",
"tests/test_status_bridge_server.py": "7d8cd72d69afae0f96ebbd9bb3be2ae3c222f01108e45ab51a09e54d4d8527cc",
"tests/test_ui.py": "306a66698296a050744869b0756ddd0eefee5019618ff90b684da136a9787854",
"tests/test_ui_batch_safety.py": "12a8d82d4aedbeee315a02a49ec0e9888547ad4abd63e181e7f392b2a39e26dc",
"tests/test_ui_filters.py": "155e8f72d18c5c76b353d4b99f3828339c80908a9910f01641ba5c32a3929c75",
"tests/test_ui_lease_lifecycle.py": "18ea8af868373fa795a4911754be55068fe75833ce35579c1212fd7f4713f149",
"tests/test_verify_diagnostics.py": "b6431194e9f4c86a42110cac0d5f712c27b063f43b4ce820327aded81602908c",
"tests/test_verify_probe.py": "aeb65b5bd2df14e8a8f3ba5501855b5946e6f8a22f0d26960c00ff1b0daea56b",
"tests/test_verify_runner.py": "e58619f55873302c39129ce50e50fb25173a96ab309d975aa4f47f0bd3459fbb",
"tests/test_verify_worker_stability.py": "eae03400c2e3c8a0bc339c8dc05d890403c6bfb4c6d70d0361bc1b882b47d618",
"tests/fixtures/icdb-repair-startup-windows-sanitized.json": "a7fe3a34d47fb36d7f98ca8c1df4bb9a50d5faa9aee5bf76db5dbc3f3d06d03d",
"tests/fixtures/issue2-lost-session-sanitized.json": "7ed4b567acabb38ff643ebd2c5b3d90b4fd9f33368f67ce3f436ba93ccf24519",
"tests/fixtures/pcb-version-choice-sanitized.json": "ce0cb6d9135970cb4fbfa31fa057271b174dc37e57d90a5d4ac9ecf3ebabddfd",
"tests/support/runtime_lifecycle_frozen_boundaries.py": "bf98533a1c06ccf4453d20b3804323779719e697141b8dc64fa679960a979cfd",
"tests/support/runtime_lifecycle_frozen_fixture.py": "b87761c06a300f0d93bce864d3d31e045f2135324b2a9a42f8682ccbff09ad22",
"tests/support/runtime_lifecycle_frozen_smoke.py": "b11e0aac71c1079625ac9832dc5c38197bc80110478c4d9e02c2a3bc58a2a2d0"
},
"automatic_icdb_repair": false,
"merged": false,
"published": false,
"limitations": [
"Real field lost-server-session recovery is not accepted.",
"Windows 10 and cross-machine SMB not tested.",
"PCB sharing-violation regression uses real Win32 handles with controlled callback; no claim of field popup repair acceptance.",
"Long native Add waits remain undiagnosed.",
"Preexisting LibraryManager still prevents native catalog activation; user must close it normally before continuing. Multi-client COM ownership is not verified.",
"Unknown-client consent is user attestation, not proof of future native ownership."
]
}
+64
View File
@@ -0,0 +1,64 @@
# PR #13 评论 414 修复与验证
审查基准为 main `cbc57238496bc84f4228aa44929208a9516dff1b`;本轮修改基于
`1572e2d`,保留正常导入与可选导出诊断解耦。审查链接:
https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-414
## 审查意见处理
| 意见 | 处理及验证 |
| --- | --- |
| P2-1 未知原生进程在写前被忽略 | 仅在中心库写入和备份替换时要求明确选择继续、跳过本项或取消批次。许可限定本批次、目标库、PID/创建时间/映像/用户/会话,先落盘后生效。实际目标进程、数据库句柄冲突和地址记录不能用此确认绕过。确认后重新查询进程及资源。 |
| P2-2 独占探测句柄跨越原生“读写打开”点击 | 退出 resource_guard、释放句柄并重核原生进程身份后才派发点击;保留实时窗口身份核对及单次回答。真实 Windows CreateFile 回归试验在原实现产生 sharing violation,修复后读写打开成功。 |
| 后台读 QWidget / 使用当前库 | 队列、批次结束刷新及备份会话读取使用请求绑定的库;后台缺少显式库参数直接拒绝,避免从控件推导。Qt 工作线程回归试验验证不再读取 lmc_edit.text。 |
| 导出预存进程豁免偏宽 | 需要最新快照的创建时间与完整映像匹配;当前绑定副本或归属未知的原生客户端不豁免。相同创建时间但映像冲突不能解释为原进程已退出。内存和磁盘释放路径均有测试。 |
| 非 checkpoint 租约不落盘 | 此描述不准确:已有 LibraryLock 会写入并 flush `.lock` 审计文本(机器/PID/时间/库),原生校验另有 session 记录。增加实测断言;审计不是占用证明,不增加新阻塞记录。 |
| 历史测试数字缺少复现信息 | 见下表及命令;区分记录提交和精确被测树,不用单个旧提交冒充混合工作树。 |
整批校验和 ICDB 检查仍独立。未知进程确认不会关闭这些进程。用户需要确认它们在本批次完成前不使用目标库;程序仍无法仅凭命令行证明另一个客户端未来不会打开此库。
独立复核另发现两个集成缺陷:确认记录创建恢复目录后,恢复再次以独占方式创建同名目录;以及调用方未传 Event 时“取消本批次”仍执行下一项。均先以回归测试复现,再修复;跳过继续、取消停止,新出现进程和记录写盘失败也有覆盖。
## 历史测试数字的来源与复现边界
| 数字 | 保存记录的提交 | 原始证据 |
| --- | --- | --- |
| 1775 | `fdd07224aac99bee8d1f29e8e82d6a2c49964c87` | `2026-11-09-full-review-followup-validation.json`:四个分支 head、27 个被测文件散列、XML 路径与散列。 |
| 1851 | `42d0cebc54191681b53dcecb120f53236c1963bb` | `2026-11-12-native-acceptance-validation.json`:baseline `b86e4e3`、XML 结果、candidate-release4/source-sha256.json。 |
| 1880 | `466f400514acc8531a219db8e75641be35304a3f` | `2026-11-12-scoped-release-validation.json`:full-scoped-final10.xml、冻结包散列。 |
本轮从以上三个提交分别导出干净快照,设置各自 PYTHONPATH 后运行
`python -X utf8 -m pytest --collect-only -q tests`,实际分别收集到
1775 / 1851 / 1880 项;对应记录的 27 / 70 / 72 个文件散列均与这些提交一致。
以上提交可作为复现入口,但本轮没有重跑三份历史全套测试,收集数量不等于重新验证通过。
历史记录未覆盖的测试文件及外部环境不能靠这项散列核对证明完全相同。
当前版本可从本修复提交干净检出后运行以下命令。必须显式设置 PYTHONPATH,避免可编辑安装及测试子进程加载到另一份工作区:
```powershell
$env:PYTHONPATH = (Resolve-Path ./src).Path
python -X utf8 -m pytest -q tests --junitxml=full-suite.xml
python -X utf8 -m pytest -q tests/test_review414_open_and_queue.py tests/test_review414_write_admission.py tests/test_review414_export_and_audit.py --junitxml=review414.xml
python -X utf8 -m compileall -q src tests
git diff --check
```
本轮实际命令、XML、源码散列、冻结包核对及隔离原生操作结果见相邻
`2026-11-13-review-414-validation.json`。
全量 1912 项通过后新增两个边界用例,追加的 14 项测试全部通过(其中 12 项与全量重合,合计 1914 个不同用例)。
冻结包 66 个模块与当前源码一致,图标及资源一致。隔离空库的实际按钮操作得到:
取消仅产生一个 CANCELLED;新批次第一项 SKIPPED、第二项 UPLOADED,独立读取只确认第二个工程。
两个来源目录的工程内容清单保持一致,程序与原生任务正常退出。
“继续”之前由测试用户正常关闭本任务创建的空 LibraryManager;没有强制终止外部软件。
两轮旧驱动卡在模态窗的 UIA 读取、一次保留 LibraryManager 导致原生拒绝,以及一次回归测试与原生试验并行造成互斥拒绝,均保留原记录,不计为通过。
## 验收边界
本轮不启用自动 ICDB Repair,不关闭现场工单。Windows 10、跨机器 SMB、现场服务器会话失联完整修复未验收。原生 Add 长等待的原因尚未定位;这轮不以缩短超时掩盖它。当前云端发布包保持不变。
冻结包实测额外确认一项既有边界:原生 `_catalog_com` 仍要求启动前没有其他
LibraryManager,避免将其他客户端错误登记为本次所有者。因此当未知客户端恰为
LibraryManager 时,选择继续仍可能得到“已有 Library Manager 运行”;确认不会绕过该原生入口限制。
并行 LibraryManager 的隔离接入需要单独验证 COM 返回对象与窗口/PID 的精确归属,
本轮没有直接删除检查。该失败试验及正常关闭测试会话后重试的结果分别保留。
@@ -0,0 +1,309 @@
{
"schema_version": 1,
"created": "2026-11-16T10:04:07.868924+08:00",
"review": "https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-430",
"base_commit": "fee4a67",
"code_commit": "fa5590468d62d7b4605f73e09fe961416020727c",
"environment": {
"windows": [
"11",
"10.0.26200",
"SP0",
"Multiprocessor Free"
],
"python": "3.12.10",
"mentor": "EE7.9.5"
},
"full_suite": {
"local_path": "F:\\CbbReview414\\review430-full.xml",
"sha256": "dda0f591d2652fc39622a62fb3767cfd4eba5420fa099dcfa7aa87b14733dee5",
"tests": 1924,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 316.455
},
"focused_suite": {
"local_path": "F:\\CbbReview414\\review430-focused.xml",
"sha256": "a09dac537ddf2adc8f014cfeea58454e3c05a1f0fe3ea8abd784f81b8843832e",
"tests": 89,
"failures": 0,
"errors": 0,
"skipped": 0,
"seconds": 32.99
},
"red_reproduction": {
"local_path": "F:\\CbbReview414\\review430-red.xml",
"sha256": "a0280295b7415e28974227b8a94bc62612b45d4903c1e0257ba269e37a149d7c",
"tests": 10,
"failures": 7,
"errors": 0,
"skipped": 0,
"seconds": 7.787
},
"commands": [
"PYTHONPATH=<checkout>/src python -X utf8 -m pytest -q tests --junitxml=full-suite.xml",
"python -X utf8 -m compileall -q src tests",
"git diff --check",
"python -X utf8 <local-evidence-root>/build.py",
"python -X utf8 <local-evidence-root>/verify_bundle.py",
"python -X utf8 <local-evidence-root>/driver.py"
],
"compileall_passed": true,
"diff_check_passed": true,
"bundle": {
"module_count": 66,
"source_and_frozen_code_equal": true,
"source_sha256_checked": true,
"packaged_assets_equal": true,
"exe_icon_images_equal": true,
"executable_sha256": "ab02971c5bd8e46881433b66922e927075ab0cea7c18fb7f79243089de97ce22"
},
"smoke": {
"backup_status": "SKIPPED",
"backup_target_unchanged": true,
"management": [
{
"name": "1GPHY_RTL8211F",
"status": "SKIPPED",
"safe_to_continue": true,
"evidence_path": "F:\\CbbReview430\\data\\management\\management-c1bb58f1e8f543f68453c03c138deba0\\checkpoint.json"
},
{
"name": "1GPHY_RTL8211F_A",
"status": "UPLOADED",
"safe_to_continue": true,
"evidence_path": "F:\\CbbReview430\\data\\management\\management-c6a380a4685a41669f5d2fc615de3756\\checkpoint.json"
}
],
"readback_names": [
"1GPHY_RTL8211F",
"1GPHY_RTL8211F_A"
],
"sources_unchanged": true,
"choices": [
"skip",
"skip",
"continue"
],
"client_normal_quit_before_continue": true,
"app_exit_code": 0
},
"smoke_evidence": {
"local_path": "F:\\CbbReview430\\smoke.json",
"sha256": "e3903cc6c2eb9e8cb4c7c3a4f83036703cd60622f0ced3211be8de8a9c52956c"
},
"actions": {
"local_path": "F:\\CbbReview430\\actions.jsonl",
"sha256": "2e442ac332fb56bf355f69254283361dab386634972fac6e1a6cc5b0649a9806"
},
"source_manifest": {
"local_path": "F:\\CbbReview430\\candidate\\source-sha256.json",
"sha256": "76cfa8ab47243c569ab9ee284b5c66df4b3f9eca7bfa0dae19a236a9c2ee1035"
},
"code_review": "Independent read-only review: no actionable findings; ready for PR after full suite.",
"warning": "Existing pywinauto Revert to STA COM threading mode warning.",
"evidence_note": "local_path values name local audit artifacts, not public download locations; redact before external sharing.",
"source_sha256": {
"src/cbb_refresh_verify/application.py": "62b9b013563a216d020c8366cccb8f949b02afa72dc63c26940804441cc23057",
"src/cbb_refresh_verify/backup_recovery.py": "1d7ef08ef53ca7a0971cdacb0908d9bb06d067b06dc2329fa58722ce9068921d",
"src/cbb_refresh_verify/batch_status.py": "55a4007cf54491ca8e045a5bf86aa4353ac8437cca5a76cd79304962e3d3fa0a",
"src/cbb_refresh_verify/close_failed_block.vbs": "e5f0d9678e07a239e96e634b90cdc761de52fc136311fae31484fa38d6fd9781",
"src/cbb_refresh_verify/com_runtime.py": "f0f3802d16c791a8bf9dfef44a94917072bfbe8fb3a927d76be8ef0341c7ed35",
"src/cbb_refresh_verify/content_check.py": "8239c17b6e2452917ed573a7deb3e4c8583eaef91bf3630eff5f424d2e398aa9",
"src/cbb_refresh_verify/defaults.py": "a1c03192f4a61ad0924b24bb635705b1ee4811d35483a02864200f95edbbebe3",
"src/cbb_refresh_verify/desktop_worker.py": "27d751816552d215dd8ee9cd67941d824f7b4493120ead7c3f87e5eba5ec4a92",
"src/cbb_refresh_verify/diagnostic_open.py": "d6c49ffe5a9969d95edbbc896d47a7e100f248380a287f99ba7bb8b92dbb3072",
"src/cbb_refresh_verify/dialog_agent.py": "5acb6e5cf1350a7ca20a6fe480668435fac785835874f266881973010db6504b",
"src/cbb_refresh_verify/dialog_models.py": "f68cee01d927b48364276d3c1f79e63ce8af231878db0b907d292780cfbafb56",
"src/cbb_refresh_verify/dialog_probe.py": "d61f0c955c961980c9635940eefb9c7947c1fe90b4b6fd844720df41ddb0aa0e",
"src/cbb_refresh_verify/dialog_rules.py": "3189b476f7ff4678b59212ed7b4081164e038a7cf7662cd895f9019cb3c1edc5",
"src/cbb_refresh_verify/dialog_supervisor.py": "15c415c2d2e916f0b64ba04416164ff3b50996d70b22d3b4ac2226b5547ac247",
"src/cbb_refresh_verify/failed_session.py": "7e6f7fa5ebcf2d49f00c5efc5f5d26412704b68e9122e476ac1f672009a98c09",
"src/cbb_refresh_verify/icdb_maintenance.py": "e81d253d8b4d3e7c1000c45335a392c72b110748675c2c3324ebe524a7252e98",
"src/cbb_refresh_verify/icdb_ownership.py": "7bf2342c1efa34a2ebcbf27964a40a490220f7146fbb6ef957b8d8dd1e511f03",
"src/cbb_refresh_verify/icdb_recovery.py": "358c0e9a004f1e0b2127513286e1dffd94b0180a8b7314aa9655462f570b6360",
"src/cbb_refresh_verify/integration.py": "f188856af69ba25e265988c51db7a6d4263326440d972ca78378b733b891c1ed",
"src/cbb_refresh_verify/library_lock.py": "6836ec8ac21e788eb75326ff44cb31ad4bdfb5f381bd35cdf33e6b34c7fca89e",
"src/cbb_refresh_verify/library_manager_verify.py": "71e16a8581ad44b646be78b480f9812d596a6d162b3eec03d078bf4ea4503195",
"src/cbb_refresh_verify/library_reader.py": "d4007caa361edd467773e49f721e02671d5a9bcb30741769a57349850b12c438",
"src/cbb_refresh_verify/maintenance_entry.py": "3b93c25f69d7a961facd8004e20e155a84cc18f06d57b741a9055786ed058990",
"src/cbb_refresh_verify/management.py": "7ead9bfffeb44201e44f73d9f039590f091e9a456982f2110dca8ec3695f8803",
"src/cbb_refresh_verify/management_transaction.py": "32c53caaead05d5db3a31d3e30721e65434e5837095dc0a7812f825603aa37a0",
"src/cbb_refresh_verify/mentor_adapter.py": "1fc8c98d5508120e03bf001a42dd3e0da7b165eb18c90f1aed83147d17db8638",
"src/cbb_refresh_verify/mentor_paths.py": "ba48c0003b3eacc88906497b2e43b299ca4536a9f7dae44bbacf6a6ec694c116",
"src/cbb_refresh_verify/models.py": "9e8209a8b006df923f1d07ccab64bbcfe5d674c4fc5f5426bfbc9b11da4ee105",
"src/cbb_refresh_verify/native_add_failures.py": "192202732423dc624c5548c75e80bb20973e5087c21d4798c9637f25b6de7e94",
"src/cbb_refresh_verify/native_backup.py": "7276fa3d9298e85550151cf0c7191d84bd08a18a72df5d854a3c38f1a88b001d",
"src/cbb_refresh_verify/native_engineering_identity.py": "8c0fc144707d68a9b85f6da50ef950f1f6e7fee248acbf34d19b707d51212be0",
"src/cbb_refresh_verify/native_export_guard.py": "523cdf44db8e1665634feadba963ccf26777dc8942fb2eb604d2c30bbe92cbb6",
"src/cbb_refresh_verify/native_management.py": "eb2ec311489eaf5deb06893a54a02469c9b2bb9baccbdd6563bae295aafcf363",
"src/cbb_refresh_verify/native_occupancy.py": "7d686079d12217382adace6361cd343d977b91075e3b157cf410ca92d07ffc49",
"src/cbb_refresh_verify/native_repair.py": "9f024dcb5e3a76369191033474fefd30787b6ae350c315f3cf38e92e5a1f3e98",
"src/cbb_refresh_verify/native_repair_ui.py": "3eb2af181befea94af8b3b3131edff09589f340bcba777abbe3b67fd31b80393",
"src/cbb_refresh_verify/network_path.py": "6b5b159502d42a46bf4ee26d5698fd2c6498b359088e2138eae46e9065b13c6f",
"src/cbb_refresh_verify/operation_lifecycle.py": "3838c5a501711d16f578c45ebbc6f960872b0c3ba6bbda9a597f994ef746cef6",
"src/cbb_refresh_verify/operation_queue.py": "a6932d8bc68ac436091f6d362557c66d274ec52d0f295a22f014a3396845c79f",
"src/cbb_refresh_verify/owner_probe.py": "8dcfd60246cb2979db34d02e0a2d605c334b6f7e2666f22daa2f50c0408bc903",
"src/cbb_refresh_verify/pcb_bridge.py": "2f6c2b09642100468814500569dbfc6695fc2a46b9a3b8333daa8e1530cdeef5",
"src/cbb_refresh_verify/pcb_open_consent.py": "59b6998afab074a98a1bf7eb0d05f2347ccb642b3b217e399ea856a5a8b1c56b",
"src/cbb_refresh_verify/pcb_restore_prompt.py": "39e0b8623a838911eff61066f3e9c8ede4364dbf73efc5a8994197ec72a96488",
"src/cbb_refresh_verify/post_repair_consent.py": "3b1eaff1db58fd311a9dbc5fdcd850911b04cc5afd4e747f70a62b721b8fafa4",
"src/cbb_refresh_verify/post_verify_diagnostics.py": "2442de485bc0d6a34c4b2d9b10bc5f323ea38f9ff66674119a50f5c6043bac63",
"src/cbb_refresh_verify/reimport_recovery.py": "ef148549751fa47518f5f2ca8f32ba25794ec5f22e0de545476ea33f89a3f0bf",
"src/cbb_refresh_verify/residual_sessions.py": "4ac500b33b209611d54eb496c6c30727ba159742d625431ceea84471a5fc3442",
"src/cbb_refresh_verify/runtime_logging.py": "44ac25430a89c5ffc9e48e88c227e88052f4c815365e8556f67918f3edaba39e",
"src/cbb_refresh_verify/runtime_timing.py": "c4ed4057b5000e0b86ccc7dd1fe2004d6e0dae29f397fec77b01ad41a81c6367",
"src/cbb_refresh_verify/save_verified_block.vbs": "926175562ef82bb2e732231dbc18d8a88059c7e6143c9f4e502cabfd0d170bcd",
"src/cbb_refresh_verify/scoped_manifest.py": "9318bf0f929d23c18466a25d83a4a9903822093c123aae10510061788c6d0ab7",
"src/cbb_refresh_verify/session_record.py": "2bc3cff365008864584138a4ff13538bb6b2f90d981e7d008a1300f9102c6e7e",
"src/cbb_refresh_verify/status_bridge.py": "05d627d02934a14f5de409472c291d37565a95b836f9c130111aae80612e9196",
"src/cbb_refresh_verify/verify_diagnostics.py": "041b77d7d49e4c86338ed5e5741d0d27a2c42bc358f4da54b3efe64af847e9b8",
"src/cbb_refresh_verify/verify_probe.py": "3ed743df49d195c74f5045985ab23491d103ee2c42c07b558c1e037176402ed2",
"src/cbb_refresh_verify/verify_runner.py": "3027ef7fc1ef6365ff36ae0c83389d869b92ffcd96985d10275bca4dc9483e3f",
"src/cbb_refresh_verify/write_admission.py": "0f8280912ec5c7af07a5f08b62a6b2cf7c95f93c745b443d0c7812d752558ce3",
"src/cbb_refresh_verify/__init__.py": "dd960394d88657820dba858792abf0de258e05efceb08ae2f0b39c6ad78bc469",
"src/cbb_refresh_verify/__main__.py": "dc4be034a0e43d4b659a9300137c29a6a6b7a32b7eaef02b6dff9a88c41305c0",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.ico": "62d4472ebaa94f9b39aebae06459685d3322041d0e1a7ada9f368cfd816ba1d6",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.png": "840f657fd7c622d9afd78625a64ed8ad04c90a895dd3c9fd37eebae543cdebe8",
"src/cbb_refresh_verify/assets/cbb_refresh_verify.svg": "cbba5b3f339cbeb5eb43012709237359442ef67c69fc5b6679a8ee4c0a1b7328",
"src/cbb_refresh_verify/assets/dialog_rules.v1.json": "3911080fc799a819662e225a7ad73e883abd8dcc9936cc30ec1b2d6d51a03c6e",
"src/cbb_refresh_verify/ui/backup_notice.py": "1a3fa5ac18a267907faf95f36d61b9f08bcbb939eef4d480dd06af1391a81599",
"src/cbb_refresh_verify/ui/backup_recovery_dialog.py": "be4796d664b8bc812244ced70f4cb616e433cef698813787f68d74408cd5cbbd",
"src/cbb_refresh_verify/ui/icdb_check_task.py": "ade3bf414aa29b42f4c1535c613b2cacb2735f6abc7900e6da25999390a5891d",
"src/cbb_refresh_verify/ui/main_window.py": "2c919badeeee0280e49387b88b058555a9fa6ace04835c094fccd782bf0af9c0",
"src/cbb_refresh_verify/ui/management_dialog.py": "8e2024957be874905685167c7eab440ecee9320170c1553340025b10fa1754d6",
"src/cbb_refresh_verify/ui/pcb_open_dialog.py": "3cabdc15f1b2abaeb919a7f29f32d4b053186701fd514646d9bdd3ea32f364f6",
"src/cbb_refresh_verify/ui/pcb_restore_dialog.py": "b7228d828df235ac51502dc68760d28c4896af02c780e9806e11c32dba7f62da",
"src/cbb_refresh_verify/ui/residual_release_dialog.py": "1d2a26bfc7ee21b11d7edbc3074b4c525e8c9fb628bca45b08bd06fc672586c8",
"src/cbb_refresh_verify/ui/workers.py": "4cc9360a4820ded27a7d5ef709fc9f04b1d4804cb1e7a614f6c357ed547da888",
"src/cbb_refresh_verify/ui/write_owner_dialog.py": "00c6091cc7d6109e41cdc3f9433b55c24725be444e440b894af21cbf751537c3",
"src/cbb_refresh_verify/ui/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
"tests_sha256": {
"tests/button_simulation.py": "3278868565853001103557d5f7ada42b11b05c03feb9032deed0327b6609de2b",
"tests/test_abnormal_shutdown.py": "0abdeaf51e2ffc3f771e09aefa9ec647a72b7f64757c9f3851926fbd392cbbcd",
"tests/test_all_buttons.py": "897ae449a15fe36fb6198a947575609346d5ce1a22c0a8c4d2950b9f00035d4f",
"tests/test_application.py": "bba12187fca6fee0f4f8862182bb40d939e2995016af2cdbb3fd756f6a99135d",
"tests/test_automation_license.py": "45e9c75d0d3e1a76f997f7da4cc87b5eb1b05a4ea2356408725742eac8a09ffb",
"tests/test_background_icdb.py": "df9bd9e8252e0dee4527dc6a740c0c33e76d1fb06a79b816cc15809d95716e44",
"tests/test_background_queue_regressions.py": "132866bfccc9a7ac5cb234f97aaf6a290e2e4ef949f31e2f70b0f3eafeb99046",
"tests/test_backup_recovery.py": "efd88c0c00440ac915b147c2e6dee8044ca805b03f90ab9f171cbde1db11cb9b",
"tests/test_backup_recovery_dialog.py": "b2f65864b861d95e99d5efb61ada915ae41973d2b49d08f2d536781997dd00cb",
"tests/test_batch_blockers.py": "4387293d3a5820fab630e3c5fe1b424f61ba6947773e5a61125d840433c5c62a",
"tests/test_batch_item_yield.py": "ed4be6d1e854b18d054a75c92171cd46b6b64411c2f74e9a3caf31fba3c7366b",
"tests/test_batch_status.py": "c1f9af0c7c6f3171b3726fb53346f480b13b8d9cd88111a9c12e2fae2392bbff",
"tests/test_batch_status_faults.py": "314e890c9aee439c8a75b4dfd605685240c74f6212da975fd50526bd70b4a0ff",
"tests/test_desktop_worker.py": "671d616f04a01d74508b328e3b6fc8f6c7191a91de0dcaa486aa98a3718353ff",
"tests/test_diagnostic_open.py": "b44f8f7b171602ad2691ea2e064ac9fe94f2fabb9fcc2eb6760cc1dd365b9423",
"tests/test_dialog_agent.py": "8c746e47d55637ca18d7cc998f324a0c2e0a5214dcfe8fcb6458c060619c211c",
"tests/test_dialog_models.py": "6902cf5c292458340fb48241b34875e111a0113d706cd82775934a7f72bab7b9",
"tests/test_dialog_probe.py": "55c98f6102957a27a96dcfd4f4bf3af499b5055225b77ef93b7b332dfd4ac472",
"tests/test_dialog_rules.py": "96bf36493da770679e9207e96b3088ef7f471aea22e17c254f33326ffef0d7f9",
"tests/test_dialog_startup_budget.py": "6f23c01836e4894ae82c3345a2383c4f8eb0517056c5b953c43100acd0fc3739",
"tests/test_dialog_supervisor.py": "4c1b00050127a65b0a8cf1c7a94fd673431ea3f04b76033a463804d0468ad2d9",
"tests/test_extended_safety.py": "7450816abba89aba1f4739f819f43631def82701fe07481279db2b3f3ed96cf6",
"tests/test_external_owner_release.py": "675ddbab4a97e86febac3003b9083c259295534941aa0463488a5a1206cfaf92",
"tests/test_failed_startup.py": "eca757ea46a4c0aa4fb0368ff53f26822af71612d251ecd87132686fe3c3794b",
"tests/test_failure_lifecycle.py": "dfeac56744a44e6f4c7898516749ca478f53d7c7f08b3843a05ef7f448c469a7",
"tests/test_icdb_address.py": "cbdc07e5043349c796a4ea1ce3d4989062094cd28929a9ef7d42c5ba75b77907",
"tests/test_icdb_batch_check.py": "e83982e0fd0b3744bdc62965b26970ded31aacfedea94283d9e321ef70a8232f",
"tests/test_icdb_open_check.py": "1f3750169755d0553bac3e0f8bec244038b84f9cd970e17c9f6eb67dee0e3dba",
"tests/test_icdb_recovery.py": "298ddac4b79b4400efc99ff27c58ca49fffea1f401a31071451b2fdaca59036e",
"tests/test_import_without_export_gate.py": "ae3dd0fb41c41773ce2d54aa9f9be83bbb56a0d09c59d600b10575fa8f0d2cd4",
"tests/test_incident_safety.py": "52f3ccb04db8971bf38628c2bd334d4fd79795e97de6538f6f66cb35f7123ece",
"tests/test_independent_operations.py": "4ba5798df3346bce74c3703c158f1dce1d1ba14df748606fcaf900c8568753e0",
"tests/test_integration.py": "9e9d30692607c889e1e3744a63c79c68e3af7d4c86804e0bcebe48e68765086c",
"tests/test_late_release_continuation.py": "34c62a628cbc08f4e8b9a1919c13f17772a2d26d1996fae34a35f814725b00e2",
"tests/test_library_lock.py": "3d65bd941faa441404045ce0140ea3ea5e58fb7d410b7b76bb9f03a9ea03d3af",
"tests/test_library_reader.py": "b39a1dc9d99c2463b744141e3c3489cd49ac4a637e7835559a9c3fe9cbafbb58",
"tests/test_lifecycle_supervision.py": "cfe29f1e73c6ef38d11e185e211b6e2fb60247f53a44e99dd1e2f8cf7a009faa",
"tests/test_maintenance_diagnosis.py": "0849aef555475a03b061eacf499f261fb75f2e727f35dba3cbceafac92e2a638",
"tests/test_maintenance_entry.py": "5ed3cda8e0c829fb2964e27f1bdc6fa8ee8dcde93ec63338959bf754b62d6a0b",
"tests/test_maintenance_owner_scope.py": "7cf64dc7f2b126684dcac6e619cbd87eca3d85ec2fc1f70f057154679dad6026",
"tests/test_maintenance_review.py": "ba807fd8c25c1b52cf2443d8bcf2f57539819715c0bc6c358d31d8542c2e7ce5",
"tests/test_maintenance_startup_gate.py": "4f69d33218483a658b51b2012ae8bfa83aff8a787152a38b19dadc4c0d3ffe36",
"tests/test_maintenance_ui.py": "2a640ba5e979a3fead81f0a38603b6105ffcb883dbb8484ccc42c99ee8c311db",
"tests/test_management.py": "cad0fb43eca9e7022a33a5e9ff0a408465b262fd304b146cdc85c28265f2e74f",
"tests/test_management_diagnostics.py": "671a9d7c112ededbee332db9b6fbab786fb37e9367d992f902f3ab2c9f60880b",
"tests/test_management_native_transaction.py": "7ca227aae6426c4d0d998edfd8620ec18905aaf212f0be20ceba97b1cde3a9a4",
"tests/test_management_probe_guards.py": "ae9be3dbd7c6a616478b7d4ea3498c428ff94a985089fe798463c5cab456f151",
"tests/test_management_retry_blockers.py": "124dbef291dbe331ba0c3e7de1665c910ea43e37b1563429b387f0f2233953ee",
"tests/test_management_source.py": "16e608ed9c8b0aa81cf08d49f165a33a1403c4ea7f2a5be44e8cfc8cb49850ad",
"tests/test_management_supervision.py": "2dcadd6551a94c52e5d4e74285959f10144a89c48af87e508abaea945652d1f6",
"tests/test_management_ui.py": "da3e2bc0b5c73926324a539edfa2f718ae1b585df96324a928a0c1a909e48083",
"tests/test_manual_backup_ui.py": "927e42ec4a1e0139c71a41b0cad1389ad47b0881381203c18b307cd2d137983a",
"tests/test_mentor_paths.py": "a05a91812a74b58e76f36d581216ee43969d2576b8a8e7d1cde3e301c52cf4c1",
"tests/test_native_add_failures.py": "ceedd60e030628b1af149d08d16216d5f7158a63686729bb357c148da86fb0ec",
"tests/test_native_backup.py": "43ec0c6b14b53864553feaf5d9fb498b37866f24edc486c0749160d3f803db5f",
"tests/test_native_engineering_identity.py": "a1adcf6883a9b55c2c37d9f491faf40dd4928f4d8db675419fd288dd31552c69",
"tests/test_native_export_guard.py": "f8ec4fa1058af55008e9628f79f2dc70b6e551f36815a812d10bfdf955cada51",
"tests/test_native_inspection_release_regressions.py": "8f7bb0b2b641d437872f1dd1d0c2547c2522c81e3c0351c31a7125f751d91927",
"tests/test_native_management.py": "badf33d4d00104c7e96e336777fb3e49690cc9db5ce1b071f98520aa5b6668f1",
"tests/test_native_management_fields.py": "9917ca0910e19bd809c86d0120c652145261528ace33c3b805f5663442c4a973",
"tests/test_native_occupancy.py": "56293dbe24bd3cd4f74cf8208e933faab7d737e5a5684a5d38838d063c3aef6d",
"tests/test_native_repair.py": "113185ced72d8f4f4eafca99054d97fe80a504d1c6cc91aaf86f55cea1b7e138",
"tests/test_navigation_tabs.py": "d7d5bbfc752f73c1b1d4615ffafc1266e772d96f3f3ba3d82c4b4baf678b292d",
"tests/test_network_path.py": "f52624391ae78e9b913dace2b1a9a2875a5855f86dc9e12c324ef493e6c7817b",
"tests/test_network_release_safety.py": "caef536d0a40b2eb848c1b8ab095ab374af247c03dd44acf8a70f0f500db6dac",
"tests/test_operation_lifecycle.py": "c0ce6c86b73021a8b162ae9e67a10aeec8a27a98e382fd82e1449a451a9a8c3c",
"tests/test_operation_queue.py": "8137528603f015695ed4d60a0c8fa8e7bf0a1c4659f8dc2a181291f5d500e6a1",
"tests/test_owner_probe.py": "deb757e022980f11ef48e57a2fd002ee3e90ec647a4666a0c4d4427313b6f725",
"tests/test_packaging.py": "87a6d04419775c0c5c806e0e569a48d7ef199a0bff8736b211443a1f471e7e8a",
"tests/test_packaging_status_bridge.py": "cbfaeac070a1494a1d8609fc25e9a779a63354c8914b4c6c57fdc7c31b70d472",
"tests/test_pcb_bridge.py": "527fb63147a203a2e9419da989aff600d3e461580989e39e8ede3a8cc57b901a",
"tests/test_pcb_open_consent.py": "5bf9ef6276d221b73ebe0dd14cff4fe5dc11bfec7b8be3266ae4a6b6a588d354",
"tests/test_pcb_restore_prompt.py": "a005691d0296587e520e20c4430e9e55227d767c8e910e950a9f2e93aeccb2c7",
"tests/test_pcb_version_choice.py": "0825c28333e4ed4f5a63847b6f5bb11143e922c7203d2770ce9c78fc8edec20f",
"tests/test_post_repair_consent.py": "bf417b378255386dc97ad8efdf5003b0691aa5d69da9d9256aa367dc16a2d4bb",
"tests/test_post_verify_diagnostics.py": "212857e56581998a3a3cd53635030b68a089fc4d630a8b0ee7ef3f137090dcc4",
"tests/test_private_desktop_discovery.py": "5361493313ae6864e252cdb9f2c72e71b39264a1c022beb4cf0c04c143cdd91e",
"tests/test_readonly_status_policy.py": "3ed40d7bdf2d3e6f70b38803b89a8b982336556444b45c6ba6b0a7c6df52a97f",
"tests/test_reimport_recovery.py": "875e5e2a0f6251ec5a251457848c7eac5dfd1674fcbb4745155f6d5d8bf4a4be",
"tests/test_residual_release_dialog.py": "10b23d009703d542e5ce8ecb35a4833e0135bb8852b4116e49eedc7010397a1e",
"tests/test_residual_sessions.py": "2c51ed1dc95a3afa7ebb24027963dfa9d13aba9c407e508e22ccc6e9f762dfeb",
"tests/test_review313_residual_isolation.py": "52a8024ed4e2a7fed219fe46cacdf76fa971166feedd557206716ef7f6d3c914",
"tests/test_review326_dispatch_and_receipts.py": "ce4d529246da1c4d53c3dec70ef49542165064404301dec3e32851df62492ecf",
"tests/test_review326_queue_guidance.py": "c2c97aceddd9713618afdd5f2a7be4764b56a1b62fc672282fb8c218b4969c74",
"tests/test_review345_ui_cli.py": "795e7e4f9bda8874c6a65a08863cab19f4adb3412287276ee2960588f0fd2fa8",
"tests/test_review348_release_comparison.py": "ceccdb3d6f7bc6cb65562c059f13aa2bc5d89d98c6f64b0f11d9b943ebbde165",
"tests/test_review381_queue_release.py": "e0d62424cbf70ec9573db78ede0a4c6534775399194eed4c6b28ba8d468307be",
"tests/test_review391.py": "304d46d63af87ea4a9bca83834b77cc44c5c9addf7b0f3752431304ee612568c",
"tests/test_review414_export_and_audit.py": "ec785c2656bed97de6c8467885f2ad0877b55ee872b02928744d399e8767d8a0",
"tests/test_review414_open_and_queue.py": "db065207dacaccd0bd80af52c1f1edaf36a278e7cf2dce7c9b44bc51dd0e1cec",
"tests/test_review414_write_admission.py": "b1b18fc69eeb9110baf3a7bb214938d5b8f681d7ad234991c92550210c8bf171",
"tests/test_review430.py": "7350f3883ddb9be48cc66fa7b0f612e1b45acf2298c80a7faa3da1f05d6d4c83",
"tests/test_review_319.py": "831fd34d426abb4436b9132bfb7ed754994155a34ac60a59378dee0964b54d28",
"tests/test_review_backend_followup.py": "2f3f51a72ecd05fc33c6b5a8dddaecfd12d2b50df423c87b4c18d1e52b2609bd",
"tests/test_review_foreign_release_evidence.py": "cbf2af02418f6bd3ec720a7a7658cf97f06d1a6e12009fdff2a99f465711591e",
"tests/test_review_management_ui_followup.py": "746602a84c3ba9cb041c5dd354b39d344355b71a3666b27a47eb9aee231e171c",
"tests/test_review_release_followup.py": "ab375f67e63cf3f33fa67ce19058be442c2ec56f810d4fc58ef5484272cbda49",
"tests/test_runtime_timing.py": "7152cd8fedfe165e769dadc1238c347d9f4d3e93cd57f6ed991e14d959e720f7",
"tests/test_safety.py": "ccf5febaf0a974d5e5357398a6946d3f121e07a6247c2f0dc5b71d86b39cac52",
"tests/test_save_helper_identity.py": "178a68c4a9a8c618dad3d8393e816dd1d2a16aef8d1fb9984117fe9dc8d06add",
"tests/test_save_helper_runtime.py": "00b092ec799da4bca424e1ee63a83bee783c81dbcdc20b7526fda8b45bb4b72a",
"tests/test_scan_isolation.py": "cab02bfe55ed515f889d3fcba6e6880344f482cc3a78a072b543b7a871cf92ab",
"tests/test_scoped_manifest.py": "fe9b2047d2c43812e851dd89ff250a2e5907dda89b3f5d9ae0a4dc4c5f452eac",
"tests/test_session_record.py": "6b51b19adfb232275195da7ff1ba91a5ce5e296f9424a7a1a29fc67ecfdfb108",
"tests/test_status_bridge.py": "fe1c0632d4d5fd5a1caf221903d4cfe38eda62aaa4298e3438735e31b8459ab2",
"tests/test_status_bridge_server.py": "7d8cd72d69afae0f96ebbd9bb3be2ae3c222f01108e45ab51a09e54d4d8527cc",
"tests/test_ui.py": "306a66698296a050744869b0756ddd0eefee5019618ff90b684da136a9787854",
"tests/test_ui_batch_safety.py": "12a8d82d4aedbeee315a02a49ec0e9888547ad4abd63e181e7f392b2a39e26dc",
"tests/test_ui_filters.py": "155e8f72d18c5c76b353d4b99f3828339c80908a9910f01641ba5c32a3929c75",
"tests/test_ui_lease_lifecycle.py": "18ea8af868373fa795a4911754be55068fe75833ce35579c1212fd7f4713f149",
"tests/test_verify_diagnostics.py": "b6431194e9f4c86a42110cac0d5f712c27b063f43b4ce820327aded81602908c",
"tests/test_verify_probe.py": "aeb65b5bd2df14e8a8f3ba5501855b5946e6f8a22f0d26960c00ff1b0daea56b",
"tests/test_verify_runner.py": "e58619f55873302c39129ce50e50fb25173a96ab309d975aa4f47f0bd3459fbb",
"tests/test_verify_worker_stability.py": "eae03400c2e3c8a0bc339c8dc05d890403c6bfb4c6d70d0361bc1b882b47d618"
},
"semantic_decision": "File-only identity failure remains RECOVERY_REQUIRED; native exit/resource proof governs independent continuation, and same-target replay remains prohibited.",
"merged": false,
"published": false,
"automatic_icdb_repair": false,
"limits": [
"Schematic semantic equivalence is not proven by import; UPLOADED is distinct from READY.",
"Other LibraryManager must be closed normally before native catalog activation; concurrent COM ownership remains unverified.",
"Windows 10, cross-machine SMB and field lost-server-session recovery remain unverified.",
"EDIF crash root cause remains undiagnosed; ordinary import does not invoke export."
]
}
+63
View File
@@ -0,0 +1,63 @@
# PR #13 后续评论 430
对应审查:https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-430
基准为本地 `fee4a67`。新 PR 同时包含 main `cbc5723` 后尚未推送的导入解耦和评论 414 修复。
本次为代码候选版,不更新云端 `v0.2.4-beta.2`,不启用自动 ICDB Repair。
## 三项语义处理
1. **文件身份不等于原生释放证明。** `capture_registration_identity` 只读文件,不创建原生进程。
原生注册及目录重新打开后,必须先确认其会话已退出,才进行文件核对。
文件核对异常仍返回该项 `RECOVERY_REQUIRED`,不能改报上传成功、READY,也不能自动重放该目标。
后续独立 CBB 可在自身写前检查通过后继续;不把文件读取异常伪装成“原生会话未释放”。
代码保留最后一次原生目录读取的退出证明,不再用文件采集对象的同名字段覆盖它。
原生释放未确认则拒绝文件采集,后续仍按已有释放证明流程处理。
2. **未执行与失败分开。** 无界面无法完成占用确认时返回 `SKIPPED`,保留原因码及“需通过界面确认”的说明。
备份替换在安装前跳过或取消,分别返回 `SKIPPED` / `CANCELLED`,界面显示“恢复已跳过” / “恢复已取消”。
安装后的失败仍按失败记录,不能被重新解释成未执行。真实占用、身份变化、检查失败仍拒绝操作。
3. **避免无等待时的重复探测。** 无未知原生客户端时只做一轮进程查询和资源探测。
只要进入未知客户端确认路径,返回后仍重新查询进程并探测资源;不会持有独占句柄等待用户选择。
整理了新增的确认模块及相关修改的空格、分行,并在 PCB 点击处写明已知取舍:
为避免 Mentor 自身的 sharing violation,先关闭独占探测句柄,再复核身份和点击。
两者之间仍有短暂竞态窗口,不能当作跨机器资源锁。
## 验证与复现
先复现错误再修改:新增 10 项用例中 7 项在旧代码上失败,3 项确认原有边界。
针对性 89 项、全量 1924 项通过。冻结包 66 个模块、资源及 PE 图标与源码一致。
私有桌面中实际恢复跳过后显示“恢复已跳过”,目标工程内容未变;
批量新增第一项 SKIPPED、第二项 UPLOADED,独立目录重新读取确认新增条目存在。
两个来源工程保持一致,程序退出码为 0。本轮未启用上传后自动 Verify,因此不声称 READY。
完整结果见相邻
`2026-11-16-review-430-validation.json`。
在 Windows Python 3.12、已安装项目依赖的干净工作树执行:
```powershell
$env:PYTHONPATH = (Resolve-Path ./src).Path
python -X utf8 -m pytest -q tests --junitxml=full-suite.xml
python -X utf8 -m pytest -q tests/test_review430.py tests/test_review414_write_admission.py tests/test_import_without_export_gate.py tests/test_management_native_transaction.py tests/test_backup_recovery.py tests/test_backup_recovery_dialog.py
python -X utf8 -m compileall -q src tests
git diff --check
```
包含全局任务互斥的测试与实际 Mentor 试验串行执行。
验证 JSON 中列出的本机证据路径仅供本次审计,不作为其他机器可直接访问的下载路径。
未入库的 XML、进程记录、截图及冻结程序按文件散列关联;外发前需处理本机路径和工程名称。
## 产品与验收边界
正常导入确认原生注册、名称/分区、工程引用、允许的顶层块和 Layout;原生重写后的 ICDB 字节不作原理图语义等价证明。
`schematic_semantics_checked=False` 保持明确;上传成功不等于 READY,完整 Verify 为独立、可选步骤。
单项输入或可选 Verify 失败不阻止已释放的独立 CBB 继续,这与本轮用户确认的行为一致。
原生 COM 入口仍拒绝已有其他 LibraryManager 的情况,未冒险将其他客户端登记为本任务所有者;
用户可正常关闭相关会话再继续。EDIF 崩溃根因、Windows 10、跨机器 SMB 和现场服务器会话失联修复仍未验收。
本次实际按钮试验只操作隔离库及本任务创建的空会话,不关闭用户的其他程序。
## 回滚
通过 revert 新 PR 合入的提交回滚程序代码;云端旧发布包不受该 PR 自动影响。
程序回滚不会撤销用户已完成的库写入:根据逐项检查点与人工备份恢复,不自动重放管理任务。
+27
View File
@@ -0,0 +1,27 @@
# CBB Verify v0.2.3-beta.1
**Beta 预发布,供隔离副本和小范围现场验收使用。**
版本标识:`0.2.3b1`;Git 标签:`v0.2.3-beta.1`。
## 本版内容
- 增加“全库 ICDB 检查与修复”维护入口,包含 Ready 项、串行进度、结果统计和维护报告。
- 增加“从备份恢复 CBB…”弹窗:选择同名 CBB 的完整工程 `.prj` 备份,先在独立短路径副本中验证,再保留原 Work、恢复目标并重新打开校验。
- 恢复只有在原生打开、集成、保存关闭、进程释放和权威 `READY / raw=1` 全部满足时才报告成功;失败保留回退副本并清除旧绿色状态。
- 加强 ICDB 会话所有权、原生修复备份恢复状态、目录链接/外部路径检查和异常 worker 的安全处理。
- 补充真实损坏工程恢复记录、无历史备份边界说明、手动原生修复文档和自动化验证脚本。
## 验证记录
- `python -m pytest -q`:471 passed,1 条既有 pywinauto STA 提示。
- `tests/CBBRefresh.Core.Tests.ps1`:通过。
- `tests/ContentCheck.ExitCode.Tests.ps1`:通过。
- EE7.9.5 隔离实测:破坏 ICDB 文件头后实际打开失败;通过恢复弹窗恢复同名完整备份;同一目标重新打开达到 `PASS / GREEN / READY (raw=1)`。
- PyInstaller 构建和冻结程序 smoke 检查通过。
## 范围限制
恢复功能支持已有同名 CBB 的完整工程备份,不自动删除旧库条目,不实现跨库重导入或共享符号数据库重建。共享库损坏、外部路径引用、不完整备份和未释放原生会话会停止操作。恢复采用用户选择的备份版本,发布前请在隔离副本和现场版本上复核。
详细实机记录:[2026-10-28-cbb-backup-dialog-validation.md](2026-10-28-cbb-backup-dialog-validation.md)。
+39
View File
@@ -0,0 +1,39 @@
# v0.2.4-beta.1(0.2.4b1)开发候选说明
状态:待评审、待现场验收。不是自动发布指令,工单保持开放。
## 用户可见变化
- 检验、ICDB 维护、中心库管理为独立入口。ICDB 检查在后台逐项运行,其他原生任务可排队,搜索/筛选保持可用。
- 检查以当前 PCB 打开情况和本次原生错误为依据,只有明确 ICDB 错误才标记问题;不自动 Repair、Restore 或选择版本,CHECKED 不等于 READY。
- 停止队列同时停止后续后台检查;执行前再次排除 READY,校验排队不隐藏检查进度;释放失败显示实际原因。
- 原生新增、同名替换、移除和备份恢复继续要求确认及人工备份,失败结果和未完成任务逐项保留。
- 默认残留释放为正常关闭。单独确认的强制结束仅允许属于当前 Windows 用户和会话、已确认作用域和精确身份的受支持文档客户端;服务器、后台导入器和未知进程不可强制结束。
## 强制客户端操作的契约
支持 Expedition PCB、Library Manager、viewdraw 和 iCDB Project Backup。操作员须知晓客户端中其他工程可能一并退出、未保存更改可能丢失、写入中的工程可能需要恢复。确认名单先持久记录为库外 `consent.json`,失败则不执行;派发处复核身份和预览范围,句柄处复核创建时间、完整映像、用户 SID、Windows 会话与原生活动;变化时拒绝。
数据库服务器可能服务同库其他用户,命令行归属不构成独占授权。本工具不会强制结束任何 ICDB 服务器;它仍活跃或库状态未知时保留 PARTIAL,不能通过结束客户端伪造释放或修复成功。
## 安全状态和回退
单项失败且本任务确已释放时可继续独立项;未释放时保留现场、检查点、映射和证据。客户端强制结束不可撤销,恢复使用人工一致备份或原生历史版本;不会自动重新导入、回退共享库或重放未完成写操作。
程序回退:先关闭正在使用的客户端,再使用此前候选包;程序回退不恢复原生事务或丢失更改。工程恢复:保留故障现场、选择确认过的备份,在隔离副本验证后恢复并重新校验。
## 验证与限制
PR #3 comment 249 的修复通过服务器排除、确认记录失败、PID 复用、客户端/服务器混合名单等 fake 边界回归;没有为了验证本功能终止真实 Mentor 客户端或服务器。
此前 r10 的原生隔离检查与界面排队证据只证明该候选包已记录的打开/释放行为,不能当成新强制客户端功能的现场验收。现场服务器失联恢复、ICDB 自动修复、Windows 10 和共享库跨机器并发仍未验收。
规范:[SOP](../../SOP.md)、[ICDB 手动修复手册](../ICDB-MANUAL-REPAIR-AND-UPDATE.md)。依赖和拆分顺序见 PR #3 的独立审查链。
## 2026-11-06 审查修正
- 校验和管理统一复核历史占用,释放经过先留证;PASS 不再重复计入无法确认。
- 管理增加目标工程及共享依赖的写后差分,明确不覆盖其他 CBB 内容;报告失败不制造未完成原生事务。
- 释放逐项持久保存,快照异常保留已完成/未执行项;报告保存失败与独立释放证明分别展示。
- 预览与强制执行前读取原生活动,正在 Backup/Restore/Repair 或无法确认的备份客户端不可强制结束;显示后台提示、映像路径与桌面,并对唯一已识别的 Cancel/取消按钮提供确认请求。取消后的实际状态仍需复核。
- 本轮自动测试不包含真实 Mentor 的强制结束或原生取消验收;ICDB 自动修复继续暂停。
+13
View File
@@ -0,0 +1,13 @@
# 独立审查 1:只读进程探测与原生任务准入队列
基于 main `a56fd17`,不叠加 PR #3 的历史提交。
**行为变化:** 增加有界、版本化、只读 owner-probe helper 和可取消的 FIFO 原生任务队列。应用仅新增隐藏的只读 helper 分派;现有 UI、验证和原生写操作保持原来的入口。
**失败安全:** 查询超时或协议/身份异常返回未确认;暂停或取消的队列票据不会运行其动作,也不阻止后面的可执行任务。不启动或终止 Mentor 进程。
**回滚方式:** 尚未合入下游时撤销本提交即可;下游接入后须按依赖从上层向下回退。
完整回归:491 passed,1 条既有 pywinauto STA 提示。编译和 diff 检查通过。
与原评论建议的差别:`management_transaction` 直接导入管理模型和库锁;`scoped_manifest` 的协调记录与独占快照依赖库锁协议。这两者在后端审查中一起交付,避免构造导入不完整的“纯工具”基线。
+20
View File
@@ -0,0 +1,20 @@
# Native backend review unit
Base: codex/review-infrastructure. This unit integrates ICDB open diagnostics, scoped content manifests, native CBB transactions and the library-release protocol; it does not expose the new UI or residual termination action. Verification and ICDB checks remain separate, READY items are excluded from maintenance, and a released single-item failure can continue independent targets.
Failure safety: no automatic Repair/version choice, no server termination, no direct LMC edits or native lock-file deletion. Native writes are serialized, uncertain ownership retains evidence and mappings, and unfinished writes are shown without replay.
Dependency rationale: library release imports native engineering identity and retained management workers; engineering identity imports management source models and scoped manifests. Separating these into nominally independent utilities would leave runtime imports unresolved. This PR therefore keeps the backend dependency closure together; UI and user-confirmed termination remain separate later PRs.
Rollback: before dependents are merged, revert this commit. After merging dependents, revert in reverse order or use the previous candidate package after closing the current app. Code rollback does not undo a native transaction; use a consistent manual backup or explicitly selected native history on an isolated copy.
Validation: full Python suite 1,376 passed (one existing pywinauto COM-threading warning); compileall and git diff --check passed. Native field recovery, Windows 10 and cross-machine shared-library acceptance remain pending.
Review comment 344 follow-up (2026-11-09):
- Production status scans continue to query fresh bridge results. The low-level session now also defaults to fresh scans; explicit checkpoint reuse is documented as a controlled read-only option with no production resume promise.
- `library-changes.json` declares `rule_version`, the selected `scope`, excluded directory categories and suffixes, positional runtime rules, runtime filenames/prefixes, and recognized coordination checkpoints. Names, suffixes, prefixes and native database locations come from the same constants used by semantic classification. These are differences in participating engineering files; excluded content is not proven unchanged, and unrelated CBB content is not checked.
- Removed the tests-only `pcb_bridge.execution_outcome` helper. Production release safety continues to come from observed release state and remaining clients.
- Unlocked primary snapshots hash the copy stream, then independently hash the final source and destination. Source reads decrease from three to two. Rejected the suggestion to remove/threshold the final source hash: size and mtime cannot detect same-size, same-timestamp source edits. Locked LMC/icdb streams and owned lock snapshots retain their existing behavior; no source-rehash skip flag is added.
Validation for this follow-up: 287 targeted cases passed through the isolated mutex/PYTHONPATH wrapper (`test_batch_status`, `test_batch_status_faults`, `test_review_backend_followup`, `test_scoped_manifest`, `test_pcb_bridge`, `test_management_retry_blockers`, `test_backup_recovery`, `test_library_lock`, `test_management`). AST parsing, `git diff --check`, and original newline-style checks passed. No real Mentor, COM automation, shared library or process control was exercised; no full-suite run was requested.
@@ -0,0 +1,9 @@
# Residual release contract review unit
Base: codex/review-ui-integration. Behavior: expose the residual-session preview and cooperative close entry, plus a separately confirmed force action limited to recognized document clients of the current Windows user and session. Database servers, importers, unknown scope and unverified identities cannot be force ended. Version becomes 0.2.4b1, with README, SOP, manual and rollback notes aligned.
Failure safety: persist the exact allowed/excluded confirmation list before any native action, recheck scope/creation/executable/user/session at dispatch and the held handle, and require independent library-release proof after exit. Unreadable owner metadata disables force only. A terminated client is not a repaired/READY project; partial release retains evidence and mappings.
Rollback: reverse the dependent commits before reverting the backend, or close the current app and use the earlier candidate. Process termination cannot be undone, and code rollback does not restore native transactions or unsaved data. Use a consistent manual backup or an explicitly chosen native history version on a copy.
Validation: 1,601 passed for this final stack, 1,601 passed for the umbrella, and 43 focused release tests passed after the final UI wording change. Compileall, diff checks and byte-level final implementation equality passed. Detailed XML counts/hashes and content digest are recorded in ../releases/2026-11-05-pr249-review-validation.json. No real Mentor client/server was terminated for these checks. Field recovery, Windows 10, shared-library concurrency and the new frozen package remain unverified.
@@ -0,0 +1,9 @@
# Application integration review unit
Base: codex/review-native-backend. Behavior: verification, ICDB batch checking and CBB management have separate tabs; background checks yield between items, keep browsing responsive and let other native tasks queue. READY targets are excluded at execution, status refresh is scoped, and manual version/copy decisions remain explicit.
Failure safety: a released item failure can continue independent targets; uncertain native ownership retains evidence and mappings. There is no residual-session release backend in this review stage: its button and result actions are hidden, and its callback is inert. The next PR restores the complete release entry together with its tested backend, rather than exposing a button with a missing import. No automatic Repair or native version selection is added.
Rollback: revert this UI commit before its dependent release PR; after dependents, revert in reverse order or close the current program and use the prior candidate. This does not roll back library writes.
Validation: 1,545 passed (one existing pywinauto COM-threading warning), compileall and diff checks passed. Release-specific tests are introduced in the dependent PR, never discarded from the final tree. Windows 10, real shared-library concurrency and field ICDB recovery remain pending.
@@ -0,0 +1,9 @@
# 评论 275:占用复核与变更报告
校验和管理共用历史释放记录复核:旧 JSON/内存租约触发实际进程、地址、独占文件和导出副本证明,不直接视为真实占用,不结束进程或执行 Repair。确认释放后归档旧记录并继续;失败且本项尚未启动时保留原记录,结果不会把本项标成未释放。校验结果兼容新增 release_proof,管理首次原生调用前保存释放经过;进程释放不等于历史数据已恢复。
写后仅对原先的目标 Work/Cert、中心库配置和共享依赖范围生成 SHA-256 差分,报告新增、删除、修改路径,并保存写后清单。范围沿用原有 ManifestScope.library,不增加整库备份或其他 CBB 内容哈希,不声称已证明所有其他 CBB 未被波及。已释放的部分失败也保留差分;仍有原生所有者时不为报告读取数据库。报告失败单独标为 UNCONFIRMED 并返回原因,不伪造未完成事务、不制造永久占用。
PASS 不再重复计入 unconfirmed。未改变实际原生写操作、人工备份政策或服务器保护,也没有恢复自动修复。
回归覆盖历史记录无占用/真实地址占用、首次原生调用前留证、目标及共享依赖差分、失败后差分、报告保存失败后可继续。完整回归和限制以最终验证记录及 PR 描述为准;真实 Mentor、Win10、跨机器共享库尚未因此取得新验收结论。
@@ -0,0 +1,11 @@
# 评论 286:释放留证与原生活动
释放前持久保存 NOT_STARTED 检查点,动作前保存 REQUESTING,动作后逐项保存实际状态,快照超时/中途异常也保留已执行和未执行项。保存失败停止继续发出动作;最终保存失败明确标为 PARTIAL/evidence_error,但独立且匹配当前库的释放证明仍被界面接受,不伪造占用。确认意图 consent_allowed 与实际 release_status 分别记录。
强制结束预览及精确句柄处重新读取原生窗口、进度和 Output;备份客户端进行中或状态无法确认时拒绝强制结束。普通客户端的保存模态窗口不直接等同于正在写库。服务器、导入器和未知身份仍排除。
窗口快照记录桌面,预览展示完整映像路径并提供原生提示/输出查看,支持原有保存选择。仅在当前用户/会话、精确进程身份匹配,且当前备份窗口唯一存在启用的 Cancel/取消(标准 IDCANCEL=2)控件时,提供单独确认的取消请求;执行前再次匹配标题、桌面、窗口和按钮并校验 PID。该请求复用串行准入和库外留证,不能当作已取消/已释放/已修复,也没有未知菜单或前台鼠标回退。没有可识别控件时入口禁用,保留状态供重新检查。
回归覆盖初次/末次快照超时、逐项记录、报告落盘失败、活动状态变化、原生取消按钮变化、确认与取消选择、已释放事实不被报告错误覆盖。测试使用临时文件和 fake 原生边界,没有终止或取消真实 Mentor 事务。原生取消在具体 Mentor 版本/现场窗口上的效果仍待隔离实机验收;ICDB 自动修复继续暂停。
回退代码不恢复已结束进程或原生事务;工程数据恢复仍需一致人工备份或明确选择的原生历史,不自动重放写操作。
+7
View File
@@ -0,0 +1,7 @@
# 评论 275/283:结果口径接入
管理进度显示历史占用复核;结果分别呈现已确认的原生动作、变更清单完整性和历史会话释放事实。单项 RECOVERY_REQUIRED 但 safe_to_continue=True 时,不再声称整个队列停止;记录失败不伪装成原生上传/移除失败。
独立操作回归更新为实际历史记录归档流程:先证明当前占用已释放、保留归档字节,再进行普通验证;不自动 Repair,失败后不遗留新的占用锁。
本阶段相关 UI/独立操作/后端回归 29 passed。后端完整回归与最终集成回归另见验证记录。没有执行真实 Mentor 写操作;回退按依赖逆序,不代表恢复原生事务。
@@ -1,5 +1,7 @@
# CBB Batch Status Bridge Implementation Plan
Current behavior (2026-11-09): production status scans always query the bridge fresh and overwrite checkpoint evidence. `BatchStatusSession.scan` defaults to `resume=False`; `resume=True` remains an explicit low-level option for controlled read-only scans, not an exposed production resume feature. Its lightweight fingerprint cannot detect every native payload/database write, so saved READY/PENDING rows must not authorize production actions.
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Read 180 to 3000 CBB Verify states through one resilient x86 Mentor bridge session with checkpoint recovery and authoritative `READY/PENDING` results.
@@ -0,0 +1,42 @@
# iCDB failure lifecycle and recovery implementation plan
**Goal:** Prevent failed verification from aborting iCDB owners, close owned idle failed documents normally, and attempt native recovery only against a validated idle target with a complete backup.
**Context:** User confirmed the incident used r4 or earlier. r4 enables `JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE`, calls `TerminateJobObject` and `taskkill /T /F` on failures and native owners. a11eb3c removed those PCB paths, but content-check timeout still kills a process tree. Failed worker exceptions currently release COM references without requesting normal document closure.
**Architecture:** Keep native transactions alive through timeouts. Signal cooperative cancellation to the worker; let blocking native calls return before closing a document. A separate recovery module owns target checks, backup and the official GUI repair transaction; failed or ambiguous repair remains failed. Work and central-library database ownership are checked separately.
**Tech stack:** Python 3.12, Windows process handles/private desktops, x86 cscript and Mentor EE7.9.5 native tools. Continue on `codex/icdb-lost-session-diagnostics`.
## Task 1 — Retain native owners on content timeout
- [x] Add a regression that starts a harmless importer with a harmless child, times out, and checks both survive until normal exit or test cleanup.
- [x] Add a content-timeout batch regression proving the second item does not start.
- [x] Remove tree/client termination from `_run_process` timeout; retain/drain the process in a background observer, record PID/command/release in evidence, and return TIMEOUT with `safe_to_continue=False`.
- [x] Verify targeted tests and the existing content-check tests.
## Task 2 — Normal close of failed owned sessions
- [x] Add x86 cscript harness tests for failed Save and close-only operation, checking `Close(False)`, reference release and Quit, with failure status preserved and mismatched identity untouched.
- [x] Implement an identity-checked close helper and call it only after the worker has returned from its native call and released Python references. Retain busy helpers instead of terminating them.
- [x] Add cooperative cancellation at Python/VBS native-operation boundaries; a supervisor timeout/crash must not terminate a pending native Save.
- [x] Add targeted tests for cancel before Save, cancel after a pending call returns, supervisor loss and blocked native-call retention.
- [x] Check shared `SymbolLibs/__ReusableBlocksSymb` ownership as well as Work/PCB database ownership before writing and before declaring release.
- [x] Give the status reader an EOF shutdown grace period before any fallback termination.
## Task 3 — Attempt official native recovery
- [x] Probe native UI on new isolated copies only; record accepted project/database identity, exact command, backup creation and completion signals. Do not invent CLI Repair flags or manipulate native ownership metadata.
- [x] Add recovery-policy tests: reject foreign/unresolved targets, active clients, inconsistent backups and repeat repair; preserve the original error; at most one recovery attempt.
- [x] Implement the supported native repair route with a complete backup and exact target checks. If the installed native tool cannot accept a shared symbol database, retain that explicit blocked result instead of repairing an unrelated Work project.
- [x] Retry opening/verifying only after native success and confirmed release; authoritative READY remains the success criterion.
## Validation and delivery
- [x] Run full Python and PowerShell regressions, compilation and whitespace checks, plus independent code review.
- [x] Verify a successful native run and a controlled failed integration/close on an isolated library, and source fingerprints afterward.
- [x] Record precisely which recovery target types were actually exercised and any remaining field-only limitations; commit changes on the current branch.
## Execution evidence
Completed on 2026-10-27. See `docs/releases/2026-10-27-icdb-failure-lifecycle-and-recovery.md` for 448 passing Python regressions, PowerShell and x86 harness checks, real failed-session close, real native Repair, the synthetic-error/real-repair/real-retry chain, frozen EXE Repair validation, and trial-package scope. Shared symbol databases without a supported PRJ entry remain explicitly unsupported; no field database was repaired.
@@ -0,0 +1,55 @@
# 从健康 CBB 来源恢复的增量设计
状态:同名 CBB 完整工程备份恢复弹窗已实现,并通过真实损坏打开失败 → 弹窗恢复 → 同一目标重新打开 PASS/READY 的闭环验证。471 项回归通过;原生跨库重新导入替换闭环仍未验证。
实机记录:`docs/releases/2026-10-28-cbb-backup-dialog-validation.md`。
## 本轮确定的实现范围
采用简单弹窗:目标 CBB、完整备份工程 PRJ、“恢复并校验”和“关闭”。选择的工程名和顶层块必须与目标一致,必须保留完整 Work 数据,不能仅选择单个数据库文件。
后台先保存完整目标库快照及 SHA256 清单,复制来源工程,在另一份目标库副本中恢复来源并通过原生 PCB 打开、集成、保存、关闭及权威 Ready 检查。通过后再次检查来源/目标内容及会话释放状态,保留原 Work 为同级 `Work.before-restore-*`,安装已验证的工程副本,再实际打开目标校验。只有 PASS、GREEN 和已释放的结果视为成功。失败保留回退库、来源快照、旧 Work 和原生日志,不自动覆盖共享数据库回退。
验证副本放在用户目录 `.cbb-restore/<编号>`,记录其实际路径。避开深层日志目录及 MSIX 对 AppData 的长路径重定向;本机短路径原生复核已通过 Ready 检查。目标原生操作保留映射盘/别名,文件快照和 Work 替换使用实际路径。原本已指向目标库的等价相对引用不重写,保留工程字节和日期。
该功能恢复现有条目的工程数据;不删除库条目,不宣称已完成原生跨库重新导入或共享符号库重建。原生导入探测已在新建的隔离库通过“Reusable Blocks / New Reusable Block”从 PRJ 创建 IP101GR,但替换损坏条目和依赖完整性尚未形成完整验证闭环,因此本轮不开放自动先删后导入。
真实验证脚本:`tools/validate_backup_recovery_dialog.py`,分 setup、open-before、restore、compare 四阶段。测试目标移除历史备份并破坏数据库文件头,使用独立健康来源;restore 阶段点击实际主窗口按钮及弹窗“恢复并校验”,使用生产后端。
目标:原生 Repair 无法恢复时,允许选择其他目录或库中的健康 CBB 作为恢复来源,重建目标 CBB 的可用状态,并保留完整回退材料。
## 已确认的原生行为
安装自带 `SDD_HOME/lm/win32/lib/upc_utils.tcl` 提供以下依据:
- `runReuseBlockLoader` 使用 DMS 的 `com.mentor.dms.rbloader.jar` 执行 `copyout`,下载/恢复 CBB。
- `processReuseBlockChunk` 在下载 CBB 和相关 Cell 后调用 `runReuseBlockImporter ... move`,同步 CBB 在共享 iCDB 中的符号。
- `removeReuseBlocks` 经 CleanWGLib 处理 CBB 移除;注释明确说明 Cell 和 iCDB 符号也由原生清理处理。
- `ReuseBlockImporter` 因此不能仅凭名字被当成通用完整 CBB 备份导入程序。任意本地目录/压缩包的完整原生导入方式仍需验证。
## 两种故障分开处理
1. 单个 CBB 的 Work 数据库损坏、目标中心库及共享符号库可用:可验证恢复该 CBB,并通过原生流程重新建立元数据、Cell 和符号关联。
2. `SymbolLibs/__ReusableBlocksSymb` 等共享数据库损坏:在同一损坏目标中删除或导入 CBB 都可能因无法访问共享库失败。应先恢复共享库,或评估建立健康新库并迁移 CBB 及依赖;该迁移路线尚未实测。
不将删除日志、地址文件、锁文件或修改私有数据库会话字段作为恢复方法。
## 建议操作流程
1. 选择健康来源:完整工程/可导入的 CBB 包、来源库或受支持的 DMS 版本。核对 CBB 类型、名称、分区、软件版本、来源时间及符号/Cell/零件依赖;名称相同不证明内容等价。
2. 在来源副本上验证可以打开,保留原始来源不被校验保存修改。
3. 在隔离目标副本中验证原生导入/恢复路径。目标中心库必须可访问,错误类别和数据库路径必须明确。
4. 通过原生流程替换/移除旧条目并恢复健康 CBB,确认 .lmc 元数据、CBB 工程、Cell 和共享符号关联一致。先验证是否支持原生替换;不盲目采用先删后导入,也不假定导入具备原子回退。
5. 实际打开恢复的工程,完成集成、保存、关闭和权威 Verify 状态确认。失败保留原始工程、恢复来源、原生日志和完整备份;不将失败结果改为绿色。
## 对现有按钮的建议升级
维护入口展示原生修复结果;受阻项目可选择“从健康 CBB 恢复”。启动前显示来源与目标、覆盖范围和版本差异;结果区分别报告“原位修复”“从备份恢复”“重新导入恢复”“共享库阻断”和“未确认”。
程序可以负责来源核对、隔离验证、备份、原生操作编排和复核。若本机版本只能使用 GUI 导入,先提供原生窗口及操作指引;没有可靠的原生命令/界面路径之前,不声称支持自动重新导入。
## 后续验证门槛
- 确定一个完整、可打开的来源 CBB,并在独立副本上复现目标报错。
- 记录本机原生本地导入/跨库复制/受支持 DMS 恢复的确切入口、替换策略、冲突提示和日志。
- 对照恢复前后的实际工程打开结果与依赖完整性,包含导入失败、来源版本不匹配、目标共享库不可用的停止行为。
@@ -0,0 +1,24 @@
# ICDB Global Check and Repair Implementation Plan
**Goal:** Provide a separate full-library action that checks each available CBB and invokes the existing evidence-bound iCDB recovery when appropriate.
**Architecture:** Reuse the serial verification queue, including Ready rows, and the existing backup, ownership, native repair and retry safeguards. Confirm the full-library write scope before starting; stop on unconfirmed ownership and retain existing reports and evidence. Shared symbol database repair remains unsupported.
**Tech Stack:** Python 3.12, PySide6, pytest, Windows native Mentor tools.
1. Add UI tests for confirmation, Ready-row inclusion, skipped projects, busy state and cancellation.
2. Add the button and route the full set of eligible rows through the existing queue without changing ordinary Verify behavior.
3. Run focused and full regression tests. On a new isolated project copy, attempt a reproducible native session failure and run the repair; retain evidence and explicitly report whether actual corruption and recovery were demonstrated.
## Button design and acceptance (2026-10-28)
- [x] Put the action in a separate database maintenance panel with the supported scope beside it.
- [x] Confirmation displays the exact library, eligible count, Ready count and missing-project count, and explains that verification saves projects.
- [x] Show item progress and separate checking, backup and native repair phases; allow stopping after the current item.
- [x] Report verified items, native repairs, restored backups requiring review, unconfirmed repairs and unexecuted items separately. Save a JSON maintenance report with original error and repair evidence.
- [x] Detect native restoration from an existing backup without treating it as an automatic repair success or retrying verification. Close only after restoration/diagnostics complete, the native main window is idle and the database address has been released.
- [x] Exercise the actual Qt button on a fresh local library copy using the production reader and verifier, capture screenshots and check source fingerprints afterwards.
- [x] Repeat the real header-corruption/native-repair probe with a 180-second native deadline and verify the restoration-review result and normal process exit.
- [x] Run the full regression suite and record the supported scope and practical limits in a release validation note.
Results: `docs/releases/2026-10-28-icdb-maintenance-button-validation.md`. Actual button run PASS/READY raw=1 on IP101GR; all 21,029 source file hashes unchanged. Real header corruption led to native restoration of an older backup and RESTORED_REVIEW_REQUIRED, without automatic retry. Full regression: 455 passed. Final Windows EXE smoke: clean exit 0.
@@ -0,0 +1,104 @@
# Issue #2 implementation plan
Approved by user on 2026-11-02. Continue branch codex/temp-issue-2-icdb-recovery,
baseline ec78dd7 (491 tests). Do not merge, publish or close the issue. Preserve
untracked review.diff. Python 3.12, PySide6, Mentor EE7.9.5, private desktop by
default. No force termination of native database owners, deleting locks,
guessing native write interfaces, or editing LMC binary contents.
Each task uses regression tests, focused validation and a separate commit.
Real field lost-session reproduction and Windows 10 validation must be reported
as unverified when unavailable; header corruption is not a substitute.
## Task 1: ICDB failure lifecycle and repair outcomes
Extend the existing owned-empty-PCB close path to wait for its launcher as well.
Cover COM connected without a document, delayed dialogs/addresses/process exit.
Native Repair must report missing healthy backup, native repair failure, database
busy, unknown dialogs and timeout/unreleased distinctly using this run's native
logs and Output. Safely close an idle, conclusively failed native repair tool;
never act on unrecognized prompts or active native operations.
Preserve original error, original evidence and all repair evidence. Record release
state. Repair success in summaries means original native repair succeeded AND
same-project reopening, verification and authoritative GREEN succeeded. Historical
backup restoration remains RESTORED_REVIEW_REQUIRED. A conclusively failed repair
may continue independent CBB items only if all relevant processes and addresses
are released and scope is project-local; shared-library/unknown ownership stops.
Add sanitized replay of issue2 lost-session/open-failure events with asserted target,
stage and invocation order; one automatic repair maximum, no repeated PCB loop.
Maintain VerifyRequest/VerifyResult compatibility. Files primarily failed_session,
pcb_bridge, mentor_adapter, native_repair[_ui], verify_runner, icdb_maintenance and
their tests. Update release evidence. No native live operations without coordinator
agreement (only one native operation at a time). Coordinator builds candidate and
runs frozen tests after review. Field fault sample is not in the attachment (logs
only); do not claim field recovery.
## Task 2: Search, filtering, selection and non-READY maintenance
Implement local name/partition keyword search and filters: all, READY, non-READY,
PENDING, unknown/read errors, missing project. Non-READY includes unconfirmed states
without calling them corrupt. Show visible/READY/error counts; no Mentor rereads on
filtering. Management selection permits READY; verify/maintenance/default backup
recovery exclude READY. Operations target current visible checked rows; hiding a row
clears its checkbox. Provide select visible/clear selection. Maintenance entry,
confirmation, progress and report agree on non-READY target set. Existing verify-all
means visible eligible rows, maintenance defaults visible eligible rows with checked
subset if any. Refresh affected authoritative statuses after operations, retain search
and filter. No premature integration of CRUD; expose selected records for Task4.
Maintain CbbRecord compatibility and explicit status separate from action result.
Tests include mixed READY/PENDING/errors/missing, filtering after state transitions,
selection scope and 381/3000 row responsiveness. Files UI main_window, small focused
filter helper if useful, backup dialog and maintenance report + tests. Avoid unrelated
UI overhaul. Commit and report focused tests plus full suite once.
## Task 3: Scoped primary-file hashes and verified backups
Copy and retain complete backup trees. Restrict SHA256 and semantic before/after
comparison to primary project/design/database/constraint files and required library
dependencies: PRJ/PCB/DXP, icdb.dat, Layout, schematic/logic/symbol assets, CES/config,
target LMC and shared database dependencies. Explicitly exclude runtime logs/temp/
locks/address records, historical backups, PDF/generated output from content hashes;
address files still participate in idle checks. Treat unclassified engineering data
conservatively as primary rather than accidentally excluding it. For central-library
manifest, only target CBB Work/Cert plus active library configuration/shared library
dependency trees; do not hash unrelated CBB projects.
During copy validate tree membership and file size/mtime before/after; primary files
also source/destination SHA256, including locked database stream bytes. Logs changing
after successful snapshot must not invalidate subsequent semantic comparison, while
primary changes/additions/deletions must block install. Manifest is versioned and
contains relative paths, size, hash and scope; progress gives hashed files/bytes/stage.
Keep existing validate-copy -> target conflict check -> retain Work -> install ->
reopen verification. Preserve old backups and evidence on failure. Add tests for logs
only, all primary categories, changed/deleted sources, target concurrency, copied byte
corruption and preserved recovery copies. Files backup_recovery and new focused
manifest helper + tests. Reuse helper in management Task4 without changing old public
Verify contracts. Document explicit rules/compatibility, commit after tests.
## Task 4: Native CBB management and delivery
Integrate add, same-name update, remove in current application. Input complete PRJ/PCB
projects, no Packager/PDF/part replacement/rename/partition move. Add conflicts never
overwrite. Update matches existing name/partition and backs up complete old project
and library recovery snapshot. Remove backs up then uses verified Mentor native
operation; reread confirms absence. Never fake removal by deleting directories.
Add/update reread identity, default auto-verify optional per batch, distinguish upload
failed, uploaded-but-verification-failed, uploaded-and-verified. Preserve source files.
Use isolated native adapter: capability detection by installed version/interface plus
isolated validation. Prefer proven COM/command; verified private desktop controls only
fallback, never foreground input. Unsupported operations disabled with exact reason.
Use cbb-upload-795 as research only, no external runtime dependency. Native API research
comes from coordinator. No fabricated operation parameters. Snapshot/readback result
must correspond to actual library entry and source engineering identity.
Requests/results contain operation, library, CBB, partition, source, auto_verify,
stage/status, safe_to_continue and evidence path. Serialize all writes with existing
verification mutex and a library-level lock compatible with original uploader; apply
coordination to verify/recovery too. Stop when native release uncertain. Persist item
checkpoints and show unfinished tasks on restart, never replay automatically.
Provide safe preview/confirmation for destructive operations; backups outside target.
Test isolated add/conflict/update/remove/reimport, cancellation, timeout/network errors,
partial successes, no-op/lying native response, busy library, restart checkpoints.
Implement capabilities conservatively: if actual native operation cannot be proven,
its UI remains disabled with actionable explanation and validation gap is explicit.
Full Python/compile/diff checks, candidate frozen smoke, Windows11 native scenario;
Windows10 and real field sample explicitly unverified if inaccessible. Coordinator
provides final review and source/frozen deliverables without merging/publishing.
@@ -0,0 +1,12 @@
# 无地址 ICDB 维护与 PCB 版本选择
用户要求按已确认的入口分析修复,并明确允许需要时弹窗让用户选择。沿用临时分支,不恢复应用自动备份,不改原库。
- [x] 无地址记录的明确维护也进入原生 Repair;仅允许唯一数据库与 PCB/PRJ 反向引用绑定,保留全库独占检查。新增回归先失败,集中 250 项通过,独立审查通过。
- [x] 实际应用按钮在无地址 IP101GR 副本完成原生 Repair,随后需要 PCB 版本选择;沿用用户此前确认的手动保存版本,诊断续接已保存关闭并读取 READY。人工续接不算完整自动链路验收。
- [x] 在主应用显示候选时间和手动保存/自动保存/取消按钮。没有 UI 选择入口的调用保持待选择,不自动选版本;每个原生窗口只问一次,等待期间继续观察会话。
- [x] 原生动作仍由私有桌面代理执行,核对修复证明、进程、窗口和候选版本;先选择单选项并复读,再确认 OK;取消或窗口变化不确认恢复。
- [x] 用户选择后沿原校验链路继续,原生保存提示仍由已有监督器处理。最终 READY 保持原有门槛;使用历史 PCB 版本记录“已恢复,版本待核对”,不标记无损修复。
- [x] 测试 UI 取消、手动/自动选择、选择失效、重复弹窗、错 PID/桌面、原生失败和 READY 区分;独立审查、全量回归、冻结实际按钮验证并交付候选。1135 项通过;de952a6 冻结实际按钮达到 PASS/GREEN/READY,历史版本仍标记待核对。
采用独立版本选择控制器与 Qt 对话框,复用原生代理及现有进度信号;不引入前台鼠标或自动重导入。界面只要求选择已有候选版本,不替用户推断应采用哪个版本。
@@ -0,0 +1,36 @@
# Manual Backup Implementation Plan
**Goal:** 按用户最新要求取消应用操作前的自动备份,改为提示手动备份,减少整库复制和重复哈希耗时。
**Architecture:** 管理操作使用只读内容基线、暂存来源、原生身份核对和现有库锁。备份责任转为用户;应用不验证或声称手动备份已存在。恢复操作只创建用于隔离校验的库副本,不再额外复制完整回退库。原生 Repair 自身备份保持原生行为。
**Tech Stack:** Python 3.12 / PySide6 / Mentor EE7.9.5。
用户已明确指定取消自动备份并提示手动备份,本计划直接执行。沿用临时分支,不合并发布、不修改原用户库。保留既有 `review.diff`。
## 范围与检查结果
| 操作 | 旧行为 | 新行为 |
| --- | --- | --- |
| 新增、替换、移除 | 每项完整中心库备份 | 手动备份提示;只读基线、检查点及来源暂存 |
| 普通校验 | 本地 CBB 辅助备份,网络跳过 | 所有路径统一取消应用辅助备份 |
| ICDB Repair | 应用完整工程备份,加原生自身备份 | 取消应用复制,保留独占读取/身份检查及原生自身行为 |
| 从备份恢复 | 整库回退备份再复制验证库;额外来源副本 | 直接复制一次隔离验证库,来源直接暂存到验证工程 |
| 读取/搜索/筛选 | 无备份 | 保持只读 |
验证工程副本和来源暂存是任务输入,不能删除后直接改原始来源。恢复安装中的旧 Work 改名保留是目录交换保护,不复制数据,继续保留。历史证据与备份不清理。独立研究工具的显式备份不属于桌面自动操作。
## Tasks
- [ ] 管理:先增加不复制整库及基线变化阻止写入的回归;移除事务授权对备份目录的依赖,绑定基线清单,保留身份、监督进程、活跃库锁和检查点验证;更新对应测试。
- [ ] 校验/Repair/恢复:先写不调用自动备份、保持独占检查及单一验证库副本的回归;改调用路径和进度说明,测试取消/占用/来源及目标变化继续阻止操作。
- [ ] 界面:将手动备份提示加入管理、校验、维护、恢复执行确认;取消不启动任务,每批一次,不伪称备份已完成。移除自动备份承诺。
- [ ] 验证:集中测试、全量 Python 测试、编译与 diff 检查、独立代码审查;隔离原生移除验证不创建整库备份;新冻结包验证提示和取消反馈。更新验证记录,提交并构建候选。
## Review Focus
- 没有备份目录仍能通过真实管理事务校验;错库、过期锁、来源变化、基线记录篡改仍拒绝。
- 替换移除成功但新增失败必须保留部分失败检查点,明确使用用户手动备份恢复。
- 删除备份调用不能同时删掉数据库独占和取消检查。
- 恢复仍隔离验证,并保留来源/目标变更检查与失败安装回退。
- UI 取消确认无写入;逐项自动校验不重复弹窗;没有目标时不弹无意义提示。
@@ -0,0 +1,32 @@
# 原生 CBB 管理接入续作
沿用用户已批准的工单 #2 管理范围与临时分支。此次用户要求找到并尝试接入库的增删改查原生接口。
不直接修改 LMC 二进制,不采用前台鼠标,不强制结束持有数据库的原生进程;原用户库不参与写入试验。
## 已确认接口
- 查询:LibraryManager.Application.OpenLibrary → Partitions(7) → 名称、分区,核对库身份并正常退出。
- 新增:OnReusableBlocksEditor → 原生 Logical-Physical 页签 → New → 源 PRJ、名称、顶层块,提交原生对话框。字段使用有时限的窗口消息复读,提交后确认成功消息,再关闭重开目录。
- 移除:安装脚本确认的 CleanWGLib/F4/REUSE_BLOCK,必须完整备份且重新读库确认缺失。
- 同名替换:复用经过验证的移除与新增;它不是原子更新,删除后导入失败时保留恢复检查点并停止队列。与仅替换 Work 的“从备份恢复”明确区分。
## 接入步骤
1. 共享原生新增适配层,保留私有桌面、二进制版本、同库租约、监督进程、来源暂存及完整备份的验证。生产能力未通过时只有带隔离库所有权证据的研究入口可写。
2. 原生 ICDB 导入会重写存储。用安装版本锁定的 ASCII、CSV 和 EDIF 原理图导出建立内容指纹,并保留布局及其他工程资产的字节哈希。不能把注册成功或名称相同等同于工程内容一致。
3. 导出仅使用新建的完整工程副本。严格确认退出、有效输出与原生完成标记;仅规范化已经实际证明会变化的报告时间/路径字段。布局、坐标、连接、属性及未知工程文件变化一律阻止接受。
4. 新增后原生程序可能未正确重定位 PCB 配置的 CentralLibrary。仅在本任务注册成功、原生释放和租约持有时修正该已导入工程的库引用,再重新打开核对目录与内容。原始输入工程不改动。
5. 在实际新建隔离库运行新增、同名冲突、不同版本同名替换、备份后移除、从备份重新导入;逐项保存证据,验证源文件未变。随后才提升对应生产能力。
6. 运行相关回归、独立审查、全量测试与冻结包实际管理入口验证。缺少原生证据的能力继续禁用并准确说明原因。
## 已完成的内容指纹取证
`diagnostics/issue2-native-crud-20261103/` 保存真实导出对照:
- ASCII:层次与展开连接、组件、端口和属性,3,531 行;只差生成时间和数据库目录三行报告元数据。
- CSV:14 个表格文件;只差信息表的 System_Date 字段。
- EDIF `-schematic`:约 580 KB,包含坐标、图形、连线、旋转、文本位置及属性;只差根级 status/written/timestamp。
- 139 个主要工程资产一致;其余变化为 ICDB 数据文件、其运行时记录及两处 PCB CentralLibrary 引用。
以上为已验证格式的内容身份合同,不声称任意未知版本、任意外部工具私有元数据都可无差别转换。
导出格式、安装版本、必需文件或引用不符合时拒绝操作。
@@ -0,0 +1,56 @@
# PR #3 comment 249 implementation plan
**Goal:** Make the force-release contract explicit and keep shared native servers out of forced termination; replace the large PR as the merge entry with smaller, ordered review branches.
**Authorization:** The user requested implementation of comment 249. Earlier user decisions retain explicit user-confirmed residual release, manual backups and no release/issue closure before field acceptance. These decisions take precedence over changing Draft status merely to make a merge button available.
**Architecture:** Keep automatic verification and checking cooperative. A separate explicit force action can end supported document clients only after scope, exact process identity, current user SID and Windows session are checked. Native database servers and unknown processes remain observable and cannot be force terminated. Every force request must persist consent intent before any termination and still obtain independent library-release proof afterward.
**Review split:** Preserve #3 as an unmerged umbrella. Create a dependent review chain: (1) read-only owner probing and cooperative queue; (2) native backend, manifests, library coordination and transactions; (3) background checks and application UI integration; (4) residual-session release, its explicit contract, version and documentation. `management_transaction` imports management and lock APIs, and semantic manifests depend on recognized coordination checkpoints; they belong with the backend rather than pretending to be standalone read-only utilities. The existing #5 remains a prerequisite document review, not an automatically merged change.
## Global constraints
- Python/PySide6, Windows and Mentor EE7.9.5 remain the supported implementation stack.
- Never kill native servers or operate production libraries in this development task.
- No automatic Repair, Restore, version choice, issue closure, publishing or PR merge.
- Each split PR states visible behavior, failure safety and rollback.
- Preserve the current user test workspace; work in the PR worktree.
## Task 1: Force-release boundary
Files: `residual_sessions.py`, `ui/residual_release_dialog.py`, `tests/test_residual_sessions.py`, `tests/test_residual_release_dialog.py`.
- [x] Add failing tests: a scoped iCDB server cannot reach `_force_close`; direct force requests against server/unsupported names never obtain a terminate-capable handle; missing consent evidence causes zero termination calls; mixed client/server previews list only supported clients in the confirmation; rejected/reused process identities remain unchanged.
- [x] Define one shared force-eligibility function allowing only recognized document clients with confirmed scope and matching captured executable identity. Enforce it again at dispatch and at the exact handle boundary.
- [x] Persist `consent.json` with target library, exact preview identities and allowed/excluded targets before processing a force request. A write failure returns before native actions.
- [x] Keep excluded servers in the release result and require the existing independent release proof; process exit never means repaired/READY.
- [x] Run focused regressions and the complete suite with an isolated test mutex.
## Task 2: Version and operating contract
Files: `pyproject.toml`, `README.md`, `SOP.md`, `docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md`, `docs/releases/v0.2.4-beta.1.md`.
- [x] Identify the actual tracked SOP before editing; update README, SOP and manual together.
- [x] Set `0.2.4b1` and document the user-confirmed client-only exception to the automatic no-force contract. Explain server handling, evidence, failure states, manual recovery and rollback.
- [x] Keep field ICDB recovery, Win10 and multiuser shared-library acceptance explicitly unverified.
## Task 3: Review branches
- [x] Inventory final files against main and assign each file to the smallest dependency-closed review stage. Keep UI/release hooks unavailable until their backend exists; do not publish branches with broken normal operation.
- [x] Create ordered branches with one concrete feature commit per review unit, no rewriting the existing umbrella history.
- [x] Test each review stage using appropriate unit/full checks; preserve all final regressions and verify the final source tree against the umbrella snapshot.
- [x] Push branches without force and create draft PRs with explicit base dependencies. Link them from #3 and record the splitting rationale.
## Task 4: Delivery
- [x] Commit and push the safety fixes and validation record to #3.
- [x] Verify remote heads, PR descriptions and clean review worktrees. Keep #3 and issues open and do not merge #5.
- [x] Prepare the final user report with PR links, passing tests and remaining field-acceptance limits.
## Delivery evidence
- Review chain: [#9](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/9) → [#10](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/10) → [#11](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/11) → [#12](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/12). Each base/head was read back from the API and matched local branches; all remain Draft and open.
- #3 is the unmerged umbrella with the review chain linked. #5 was not merged; issues #2/#4 remain open.
- Complete suites: 491 / 1,376 / 1,545 / 1,601 passed for the four review stages; umbrella 1,601; focused release tests 43. Validation hashes and limits: `docs/releases/2026-11-05-pr249-review-validation.json`.
- Final implementation files match byte for byte; compile and diff checks pass. Only review worktrees were committed; the original running r10 test workspace was preserved.
- No new frozen package or field ICDB recovery acceptance is claimed. No actual Mentor client/server termination or production-library operation was performed.
@@ -0,0 +1,370 @@
# CBB 原生操作生命周期与只读边界 Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. 本计划默认在当前会话逐项执行,不隐含授权创建额外代理。
**Goal:** 消除保存阶段的自动强杀、管理工作进程失联后的无监督写入,以及 legacy 状态读取的隐式弹窗操作,同时保持工具可用和独立任务可继续。
**Architecture:** 复用现有 NativeQueue、LibraryLock、私有桌面和库外证据体系,补充一个保存事实解析模块与一个会话记录模块。先实现保存/停止策略,再补管理监督与跨重启观察,最后收紧读取路径并联调 GUI/CLI;不重写调度框架。
**Tech Stack:** Python 3.12、PySide6、pywin32、Windows、Mentor EE7.9.5、现有 32 位 cscript/VBS 与状态桥;不增加运行时依赖。
**Spec:** [2026-11-06-runtime-lifecycle-safety-design.md](../specs/2026-11-06-runtime-lifecycle-safety-design.md)
**Status:** 用户已于 2026-11-06 授权按本计划实施,正在独立分支执行。基线为 `5eb4b2d7ed09947f19310ba80ba3b9a2a09b6f7d`;本文件没有修改生产行为。
## Global Constraints
- 技术栈保持 Python 3.12、PySide6、pywin32、Mentor EE7.9.5,不增加运行时依赖。
- 检验、ICDB 批量检查、中心库管理保持独立;ICDB 自动 Repair 继续关闭。
- READY 条目继续排除维护;状态读取失败不伪造 READY,也不直接判定 ICDB 损坏。
- 自动停止、超时、失败清理、监督器失联都不得强杀可能正在原生写入的进程或 COM 保存 helper。
- UI、搜索、筛选、日志查看和只读浏览保持可用;一个未释放写入不得占着全局执行票据等待无限长时间。
- 同库仍在进行的写入不可并发启动;已释放的单项失败不得阻止独立项,其他独立库可排队获得执行机会。
- 历史 JSON 只触发身份及实际资源复核,不直接构成真实占用;报告错误不得伪造占用或永久禁用入口。
- 不自动选择历史版本、重新导入、恢复备份、删除原生锁/地址文件或修改 LMC 伪造状态。
- 不新增全库自动备份或全库内容哈希;此前确认的人工备份策略不变。
- 确认结束客户端与正常停止分开;本轮不增加“放弃正在进行的保存”按钮,不自动放宽服务器保护。
- 原生动作、证据读取、路径解析、进程查询和重启核对都放在非 GUI 线程;GUI 只更新视图和提交用户意图。
- 保留 VerifyRequest / VerifyResult 的现有参数及 safe_to_continue 兼容性,只追加有默认值的事实字段。
- 保持原有文件行尾,不进行与功能无关的整文件规范化。
- 开发验证只使用临时数据、模拟原生边界或隔离副本;不在生产库制造保存中断。
## 实施起点与三个交付单元
执行前重新读取 PR #10/#11/#12、main 和本地工作树,不将旧评论当成新实现的批准。另开 `codex/runtime-lifecycle-safety` 临时分支,使用独立工作树;保留用户原始脏工作区与已运行程序,不 force-push。
- **A:保存与停止闭环。** Task 1–4 作为一个功能单元验收;前面的模型和 primitive 可以独立提交,接线未完成时不交付候选程序。
- **B:管理失联与重启核对。** Task 5–6,在 A 的协议上扩展管理;不增加自动清除锁文件。
- **C:只读边界与交付验证。** Task 7–9;最终创建仅含本轮差分的草稿 PR,按 A/B/C 给出审查顺序。
### Task 1:建立保存事实解析与停止判据
**Files:**
- Create: `src/cbb_refresh_verify/operation_lifecycle.py`
- Create: `tests/test_operation_lifecycle.py`
**Interfaces:**
- Consumes: 本轮 helper 的标记序列与独立进程/资源观察结果;不读取文件或调用 COM。
- Produces: `classify_save_state(markers: Sequence[str], *, helper_exited: bool | None, native_released: bool | None, forced: bool = False) -> dict[str, str | bool]`。
- Produces: `stop_disposition(*, call_started: bool | None, call_returned: bool | None, identity_confirmed: bool) -> str`,返回 CANCEL_BEFORE_CALL / WAIT_FOR_RETURN / CLEANUP_RETURNED / OBSERVE_UNCONFIRMED。
- 返回字段固定为 save_state、close_state、helper_state、resource_state、interrupted、detail,取值见设计第 4 节;其他任务不得另造不兼容枚举。
- [x] **Step 1: 写失败测试,证明 Save/Close/释放不能互相替代。**
```python
from cbb_refresh_verify.operation_lifecycle import classify_save_state, stop_disposition
def test_saved_but_not_closed_is_not_unsaved_or_fully_released():
facts = classify_save_state(["SAVE_START", "SAVE_OK", "CLOSE_START"],
helper_exited=False, native_released=False)
assert facts["save_state"] == "COMMITTED"
assert facts["close_state"] == "UNKNOWN"
assert facts["resource_state"] == "RETAINED"
def test_process_exit_without_save_result_is_unknown():
facts = classify_save_state(["SAVE_START"], helper_exited=True, native_released=True)
assert facts["save_state"] == "UNKNOWN"
assert facts["resource_state"] == "RELEASED"
def test_an_unreturned_call_requires_waiting():
assert stop_disposition(call_started=True, call_returned=False,
identity_confirmed=True) == "WAIT_FOR_RETURN"
```
- [x] **Step 2: 运行并确认 RED。** `python -m pytest -q tests/test_operation_lifecycle.py`;预期缺少新模块/函数。再加取消前、SAVE_REJECTED、CLOSE_FAILED、日志截断/矛盾、forced=True 的行为断言,不把进程退出断言成保存完成。
- [x] **Step 3: 实现纯判据。** 核心映射从明确证据出发:
```python
save_state = ("COMMITTED" if "SAVE_OK" in markers else
"REJECTED" if "SAVE_REJECTED" in markers else
"NOT_STARTED" if "CANCELLED_BEFORE_SAVE" in markers else "UNKNOWN")
resource_state = ("RELEASED" if native_released is True and helper_exited is True else
"RETAINED" if native_released is False or helper_exited is False else "UNKNOWN")
```
不把 UNKNOWN 当 False;矛盾标记降为 UNKNOWN 并记录原因。`forced=True` 不能把 UNKNOWN 的保存状态升级为成功。
- [x] **Step 4: 运行该文件及 `tests/test_runtime_timing.py`,确认已有标记消费保持兼容。**
- [x] **Step 5: 提交。** `git commit -m "feat: distinguish save close and resource release facts"`。
### Task 2:保存 helper 的启动门和完整返回事实
**Files:**
- Modify: `src/cbb_refresh_verify/save_verified_block.vbs`
- Modify: `src/cbb_refresh_verify/desktop_worker.py:17`(launch_save_helper)
- Modify: `src/cbb_refresh_verify/mentor_adapter.py:818`(保存启动和等待)
- Modify: `tests/test_save_helper_runtime.py`
- Modify: `tests/test_failure_lifecycle.py`
- Create: `tests/test_save_helper_identity.py`(基线没有此文件,用于 helper 启动门和精确身份测试)
**Interfaces:**
- Consumes: Task 1 的 `classify_save_state`。
- Produces: VBS 标记 CANCELLED_BEFORE_SAVE / SAVE_START / SAVE_OK / SAVE_REJECTED / POST_SAVE_FAILED / CLOSE_START / CLOSE_OK / CLOSE_FAILED,以及既有 LICENSE_OK / IS_SAVED / QUIT_OK。
- `launch_save_helper(command, **kwargs)` 保持原调用兼容;生产调用附加第 4 个 VBS 参数 `start_gate`,helper 未放行时不进入 COM;已有三参数 harness 保留兼容覆盖。
- helper 启动门在 30 秒内未放行或取消时,以明确的启动前取消结果退出。门放行前记录精确 helper 身份,不靠事后按父 PID 猜测。
- [x] **Step 1: 扩展真实 cscript harness,先复现保存中取消和保存后关闭失败。** 继续使用 `tests/test_save_helper_runtime.py` 中实际 VBS 源码,仅替换 COM 创建。FakeDoc.Save 内创建取消文件后返回 True;FakeDoc.Close 返回 False 或延迟返回。断言:
```python
assert "SAVE_OK" in completed.stdout
assert "SAVE_REJECTED" not in completed.stdout
assert "CLOSE_FAILED" in completed.stdout
assert completed.returncode != 0
```
另写门未打开的 harness,在 FakeDoc.Save 中写 `save-called.txt`;取消/门超时后该文件必须不存在。
- [x] **Step 2: 运行 `python -m pytest -q tests/test_save_helper_runtime.py tests/test_failure_lifecycle.py -k "save or helper"`,确认新行为失败。** 不运行真实 Mentor 保存。
- [x] **Step 3: 按调用边界写标记,取消只阻止尚未开始的写入。** 局部错误检查示例:
```vb
CheckCancellationBeforeSave
WScript.Echo "SAVE_START"
On Error Resume Next
operationOK = doc.Save()
saveError = Err.Number
saveDescription = Err.Description
Err.Clear
On Error GoTo 0
If saveError <> 0 Then
WScript.Echo "SAVE_RESULT_UNKNOWN|" & CStr(saveError) & "|" & saveDescription
WScript.Quit 11
End If
If Not operationOK Then
WScript.Echo "SAVE_REJECTED"
WScript.Quit 4
End If
WScript.Echo "SAVE_OK"
```
把 `saveError/saveDescription` 加入 Option Explicit 的 Dim。IsSaved/后置同步/Close 使用同样局部检查并写各自原因,不抹掉 SAVE_OK;取消后只在精确文档、已保存且没有未知模态提示时做既有正常关闭,不再次 Save、不自动放弃脏文档。
- [x] **Step 4: 保存等待不再因取消文件出现就直接抛错丢弃监督。** 本任务先提供可观察的调用返回事实;Task 4 再统一所有生产停止入口,不能保留“保存脚本启动后随便 terminate”的中间交付。
- [x] **Step 5: 重跑真实 cscript harness、身份核对和 runtime_timing 回归,通过后提交。** `git commit -m "fix: preserve native save results across cancellation"`。
### Task 3:受控会话记录和后台观察交接
**Files:**
- Create: `src/cbb_refresh_verify/session_record.py`
- Create: `tests/test_session_record.py`
- Modify: `src/cbb_refresh_verify/desktop_worker.py`
- Modify: `src/cbb_refresh_verify/library_lock.py`
- Modify: `src/cbb_refresh_verify/network_path.py`
- Test: `tests/test_network_release_safety.py`
**Interfaces:**
- Produces: `write_session_record(path: Path, record: Mapping[str, object]) -> None`,原子 pending→replace,flush/fsync。
- Produces: `read_session_record(path: Path, *, evidence_root: Path) -> dict`,协议 `cbb-runtime-session`、version=1,最大 64 KiB,拒绝重解析点/越界路径。
- Produces: `reconcile_session_record(path: Path, *, evidence_root: Path) -> dict`,仅后台核对,返回 ACTIVE / RELEASED / IDENTITY_CHANGED / UNCONFIRMED、原因、匹配库及独立 release_proof;不终止进程、不执行写操作。
- Produces: `observe_retained_session(path: Path, *, evidence_root: Path, stop=None, progress=None) -> dict`,1 秒为观察间隔,单次进程查询有界;退出观察不表示原生进程退出。
- immutable `session.json`、单写者 `worker-state.json`、watchdog 的 `supervisor-lost.json`、观察者的 `observation-<observer_id>.json` 分开,不互相覆盖。
- 等待循环只使用精确句柄的零等待观察,不持有 `_guard`/全局原生互斥,不循环扫描全库。退出后才尝试独立释放证明;通道忙只延后该观察,不把其他库也设为不可用。
- [x] **Step 1: 写协议/重启身份测试。** 使用临时 JSON 和本测试创建的 sleep 子进程;在记录上替换 created 或 executable,确保返回 IDENTITY_CHANGED 而不是结束新进程。损坏 JSON、超过 64 KiB 和越界目录返回 UNCONFIRMED。
```python
def test_record_outside_controlled_root_is_observation_only(tmp_path):
from cbb_refresh_verify.session_record import reconcile_session_record
owned = tmp_path / "owned"
owned.mkdir()
external = tmp_path / "external-session.json"
external.write_text("{}", encoding="utf-8")
outcome = reconcile_session_record(external, evidence_root=owned)
assert outcome["status"] == "UNCONFIRMED"
assert outcome["release_proof"] is None
```
PID 复用测试在本测试创建的进程身份记录上替换 created/image,再走同一个 reconcile 入口;只模拟外部进程观察边界,不用实现返回值代替被测流程。
- [x] **Step 2: 运行 `python -m pytest -q tests/test_session_record.py`,确认 RED。**
- [x] **Step 3: 实现精确身份、记录路径约束与独立释放证明。** 核对 supervisor/worker/helper/native 的创建时间、映像和当前用户/Windows 会话。PID 不在快照中不能直接生成 RELEASED;复用现有 `release_retained_library` 证明,不删 `.lock`/sAddress.adr。
- [x] **Step 4: 增加后台交接测试。** A 库 helper 保持活跃,转观察后释放 NativeQueue action;同库写请求仍等待,B 库请求可运行。映射直到匹配库独立释放证明成立才归还;调用 `process.close()` 不得丢失观察所需的精确句柄。
- [x] **Step 5: 验证报告写失败不终止活跃调用、不把记录存在本身当占用。** 内存观察保留,下一次可重新核对。通过后提交 `git commit -m "feat: persist and reconcile owned native sessions"`。
### Task 4:统一用户停止、超时、finally、kill 和 watchdog
**Files:**
- Modify: `src/cbb_refresh_verify/verify_runner.py:231`、`:951`、`:1067`、`:1090`、`:1128`
- Modify: `src/cbb_refresh_verify/desktop_worker.py:25`、`:174`、`:182`、`:191`、`:224`
- Modify: `src/cbb_refresh_verify/mentor_adapter.py:830`、`:888`、`:1005`
- Modify: `src/cbb_refresh_verify/verify_runner.py`(VerifyResult 默认字段与兼容 auto_repair 停止传播)
- Modify: `src/cbb_refresh_verify/defaults.py`(NATIVE_WRITE_STOP_WAIT_SECONDS)
- Modify: `src/cbb_refresh_verify/native_repair.py:127`(增加 stop=None 并向现有 run_native_repair 传播;默认 auto_repair 不变)
- Test: `tests/test_failure_lifecycle.py`
- Test: `tests/test_abnormal_shutdown.py`
- Test: `tests/test_verify_worker_stability.py`
- Test: `tests/test_incident_safety.py`
**Interfaces:**
- Consumes: Task 1–3 的事实解析、停止判据与后台观察。
- `_stop_worker(process, *, timeout=5)` 保持 bool 返回兼容,但不再对未知/活跃写调用自动 kill;返回 False 表示尚未确认 worker 退出,调用方转受控观察。
- `VerifyResult.write_outcome: dict | None = None`、`session_record_path: Path | None = None` 追加在现有默认字段之后。
- `attempt_recovery(request, diagnosis, evidence_root, *, progress=None, stop=None)` 只补取消传播,不使其默认启用。
- 保存等待转后台的默认界限为 120 秒,放在 `defaults.py` 的 `NATIVE_WRITE_STOP_WAIT_SECONDS`;普通合作式停止等待保持 5 秒。
- [x] **Step 1: 替换冲突的旧期望并增加跨组件失败测试。** `test_stop_cancels_then_stops_automation_client_after_deadline` 不能再锁定保存中会 kill 的行为。用本测试创建的 helper 进程触发 `_stop_worker`,使 `kill` 和 `stop_automation_clients` 在活跃 Save 时被调用即失败:
```python
class SavingWorker:
def request_stop(self): self.requested = True
def wait(self, timeout): raise TimeoutError("native Save pending")
def poll(self): return None
def kill(self): raise AssertionError("pending Save was killed")
def stop_automation_clients(self): raise AssertionError("save helper was killed")
def test_cancel_preserves_pending_save():
worker = SavingWorker()
assert _stop_worker(worker, timeout=0) is False
assert worker.requested
```
这个 fake 只用于停止分派边界;另用实际 sleep/helper 与真实 VBS harness 验证生命周期,不只断言 mock 被调用。
- [x] **Step 2: 覆盖五个触发入口。** 用户停止、活动超时、对话框错误、finally 收尾、父进程退出分别触发;verify 生产配置 `stop_clients=True` 必须在测试中出现,不只测默认参数 False。
- [x] **Step 3: 接入同一阶段判据。** 原生调用可能进行中时只写取消意图;短等待后不关闭观察句柄,120 秒后交 Task 3 观察。只有已证明未进入写入的辅助进程允许终止。`DesktopWorker.kill` 及 watchdog 不能绕开此判据;保存 helper 的注册/启动门与 supervisor 失联竞争必须被覆盖。
- [x] **Step 4: 清理前采样并保留中断事实。** 更新 session-release/outcome/result/recovery-required 的生成逻辑。后续发现进程退出可以更新 resource_state,但不能把未知保存重写成成功;正常关闭失败保留 COMMITTED。`safe_to_continue=True` 不删除 write_outcome 中的失败。
- [x] **Step 5: 跑 `tests/test_operation_lifecycle.py tests/test_session_record.py tests/test_failure_lifecycle.py tests/test_abnormal_shutdown.py tests/test_verify_worker_stability.py tests/test_incident_safety.py`,通过后执行交付单元 A 的完整回归并提交。** `git commit -m "fix: honor native write boundaries on every stop path"`。
### Task 5:管理 worker 的监督器失联与事务边界取消
**Files:**
- Modify: `src/cbb_refresh_verify/native_management.py:132`、`:209`、`:694`、`:1131`
- Modify: `src/cbb_refresh_verify/management.py`(run_management / run_management_batch)
- Modify: `src/cbb_refresh_verify/management_transaction.py`(沿用原 nonce/lease 身份,不放宽验证)
- Create: `tests/test_management_supervision.py`
- Test: `tests/test_management_native_transaction.py`
- Test: `tests/test_management_retry_blockers.py`
**Interfaces:**
- Consumes: Task 3 的会话记录,Task 4 的阶段停止规则。
- 管理 job 新增 `cancel_signal`、`session_record_path`、`start_gate` 与 supervisor 创建身份;原 desktop/supervisor_pid/timeout_seconds 保持兼容。
- 新增私有 `_require_management_continuation(job, root)`:每次新原生调用前校验当前取消/监督器身份;被取消时抛已有管理错误并明确 native_started,而不是启动下一动作。
- 现有 `_require_add_supervisor(job, root)` 调用共享判据并保留 add deadline 检查,不移除已有安全检查。
- [x] **Step 1: 写无监督器和双阶段 update 测试。** 在 catalog 前使 supervisor 退出,确保不创建 LM;remove 调用内部模拟父进程退出但保留 native owner,返回后确保 add 不调用。断言部分完成与资源释放分别记录:
```python
assert result.status == "RECOVERY_REQUIRED" # remove 已发生,add 未发出
assert adapter.calls == ["remove"]
assert result.safe_to_continue is True # 本例原生 owner 已独立证明释放
assert not any(call[0] == "add" for call in adapter.calls if isinstance(call, tuple))
```
- [x] **Step 2: 对 catalog/add/remove 三条 worker 路由分别触发取消和父进程退出。** 正在 native wait/COM 调用时 helper/worker 存活,返回后不进入下一写动作;同目标不得自动重试。
- [x] **Step 3: 启动前持久登记并使用 gate,worker 在身份检查后 armed watchdog。** watchdog 只写自己的失联文件和取消信号,不异步退出正在做原生调用的工作进程。调用返回后执行正常自有会话收尾;未知弹窗记录并交已有提示入口。
- [x] **Step 4: 将仅依赖 `_pending_workers/_retained_workers` 的判据补为内存+可核对记录。** 内存列表继续用于同一进程的快速收尾,但不是唯一恢复入口;读不到 result.json 不能永久推断 owner 活着。
- [x] **Step 5: 跑管理三个测试文件与 `tests/test_native_management.py tests/test_native_export_guard.py`,通过后提交。** `git commit -m "fix: supervise management workers across cancellation and parent loss"`。
### Task 6:重启核对和相关库范围的可操作入口
**Files:**
- Modify: `src/cbb_refresh_verify/session_record.py`
- Modify: `src/cbb_refresh_verify/residual_sessions.py`
- Modify: `src/cbb_refresh_verify/ui/residual_release_dialog.py`
- Modify: `src/cbb_refresh_verify/ui/main_window.py`
- Test: `tests/test_session_record.py`
- Test: `tests/test_review_release_followup.py`
- Test: `tests/test_ui_lease_lifecycle.py`
- Test: `tests/test_background_queue_regressions.py`
**Interfaces:**
- Consumes: A/B 单元生成的 session.json/worker-state/observation 记录,保留已存在的 release_proof / released Signal 兼容。
- GUI 后台核对只显示状态,不自动点击原生提示、不重放新增/更新/移除、不仅按 Cbb 桌面前缀结束进程。
- NativeQueue 使用已有 ready 回调查询已缓存的相关库可执行性;ready 自身不做 WMI、文件读取或 SMB 路径解析。
- [x] **Step 1: 写“重启时 active、exited、PID reused、记录损坏”四个场景。** 检查行为结果而不是只检查某函数调用次数:active 可看原生阶段,exited 需独立证明,reused 没有 native 消息,损坏记录不禁用全部 UI。
- [x] **Step 2: 写 A 库等待、B 库可执行的队列测试。** 暂停保存的 A 保留关联租约,不占队列 active;B 可完成,A 同库新写操作不会进入。用户取消批次不会在恢复后自动重放。
- [x] **Step 3: 接入启动时的后台发现与已有“查看原生提示/处理保存/请求原生取消/重新检查”。** 未知窗口只展示真实原因;记录 helper 正在 Save/Close 时不向普通强制结束路径放行。不为“能释放”而新增任意杀进程按钮。
- [x] **Step 4: 证明成立后只解除匹配会话的历史记录和映射。** 关闭自有 desktop 句柄,不能宣称已删除仍有原生引用的桌面。报告保存失败单独展示,不把有效释放反转成真实占用。
- [x] **Step 5: 跑上述四个文件与 `tests/test_residual_sessions.py tests/test_residual_release_dialog.py`,再跑 A+B 完整回归后提交。** `git commit -m "fix: reconcile retained sessions without blocking independent libraries"`。
### Task 7:关闭 legacy 读取的隐式启动和肯定按钮回退
**Files:**
- Modify: `src/cbb_refresh_verify/library_reader.py:249`、`:340`
- Modify: `src/cbb_refresh_verify/mentor_adapter.py:1453`、`:1532`、`:1629`
- Modify: `src/cbb_refresh_verify/ui/main_window.py:114`
- Create: `tests/test_readonly_status_policy.py`
- Test: `tests/test_library_reader.py`
- Test: `tests/test_batch_status_faults.py`
- Modify: `tests/test_desktop_worker.py`(旧 reader 必启动私有桌面的测试改为可达新边界)
**Interfaces:**
- 默认 authoritative_status_map 入口不变;桥返回失败仍使用 UNKNOWN / UNAVAILABLE,不能升级为 PENDING/READY。
- `read_library_flag(library, name, *, timeout_seconds=90, log_path=None)` 与 `read_library_tree_image_map(library, names, *, timeout_seconds=45, log_path=None)` 保留调用签名和返回形状,但只观察已存在、匹配库身份的 LM;不自动启动新的 LM。
- 无匹配 LM 返回原有 FLAG_UNKNOWN 或 `{name: None}`,并附可读原因,不要求每次搜索/过滤都人工开 LM。
- `handle_known_dialogs` 留给需要的已验证写路径;状态读取不调用它,不修改其他流程的弹窗规则。
- [x] **Step 1: 写未知提示和无 LM 的回归。** 把 CreateDesktop/CreateProcess/PostMessage 与 affirmative handler 设为触发即失败,调用两个兼容 reader 和 `scan_open_library_status`:
```python
def test_status_read_does_not_launch_or_answer_when_lm_is_absent(monkeypatch):
import win32process
from cbb_refresh_verify import mentor_adapter
monkeypatch.setattr(win32process, "CreateProcess",
lambda *a, **kw: (_ for _ in ()).throw(AssertionError("implicit LM launch")))
# 该测试文件的 FakeDesktop.windows() 返回 [],不连接实际 LM。
assert mentor_adapter.read_library_tree_image_map("C:/Fixture/lib.lmc", ["A"]) == {"A": None}
```
再对“修复/覆盖/保存/未知许可提示”的窗口快照参数化,要求没有任何消息发送。
- [x] **Step 2: 运行 `python -m pytest -q tests/test_readonly_status_policy.py`,确认 RED。**
- [x] **Step 3: 去掉读取路径的自动创建和通用肯定应答。** 抽取最小既有 LM 树观察函数,使用 exact library identity,只读树项,不关闭用户打开的窗口;窗口不可读就返回未知。若发现其他调用方仍依赖隐式启动,迁到明确的原生工具打开入口或保留未知,不隐藏恢复原行为。
- [x] **Step 4: 跑 reader/bridge/UI 状态回归,并用混合 READY/PENDING/UNAVAILABLE 清单检查数量和筛选。** 默认桥成功时不改变结果;legacy 无 LM 不弹每项确认、不启动 Mentor、不伪造损坏。
- [x] **Step 5: 提交。** `git commit -m "fix: keep legacy status reads observational"`。
### Task 8:GUI/CLI 停止传播和结果展示联调
**Files:**
- Modify: `src/cbb_refresh_verify/verify_runner.py:1251`(run_batch 默认 verifier 转发 stop)
- Modify: `src/cbb_refresh_verify/ui/main_window.py:1504`
- Modify: `src/cbb_refresh_verify/ui/icdb_check_task.py`
- Modify: `src/cbb_refresh_verify/ui/management_dialog.py`
- Modify: `src/cbb_refresh_verify/application.py`(CLI 信号进入本批次 stop)
- Test: `tests/test_operation_queue.py`
- Test: `tests/test_ui_batch_safety.py`
- Test: `tests/test_background_queue_regressions.py`
- Test: `tests/test_application.py`
**Interfaces:**
- `run_batch(..., stop=event)` 的默认调用必须实际传 `run_verify(..., stop=event)`;外部注入 verifier 的原一参数签名保持不变。
- UI 接受 write_outcome 和 session_record_path,但不直接读取/resolve 这些路径;通过现有 ServiceWorker 接收事实。
- 文案分别为“已请求停止,等待当前保存返回”“保存已返回,关闭待确认”“已转后台观察,可查看状态”“当前状态无法确认”,只在对应事实成立时显示。
- [x] **Step 1: 写 CLI 默认 verifier 的 stop 传播测试与 GUI 延迟保存测试。** GUI 点击停止后 200ms 定时器仍可触发、搜索仍可编辑;新原生动作没有发出,进度不假称已保存或已释放。
- [x] **Step 2: 写 action 抛异常、队列取消和按库 ready 的回归。** 保留已存在的 Event 轮询取消语义;不用无通知无限 wait;一项异常释放队列票据,后续可执行独立项不被遗留票据挡住。
- [x] **Step 3: 接入停止来源与事实投影。** `auto_repair=False` 保持默认;兼容修复/复验的 stop 转发使用 Task 4 新签名。Save/Close 尚未确认时不启用本目标自动重试,也不禁用所有只读操作。
- [x] **Step 4: 跑队列、后台、界面和 CLI 测试,检查退出/重启后未完成状态仍可见。** GUI 线程中将 Path.resolve、WMI、文件读取替换为失败哨兵,确认事实展示不触发它们。
- [x] **Step 5: 提交。** `git commit -m "fix: propagate stop intent and display independent lifecycle facts"`。
### Task 9:完整回归、冻结包和隔离验收
**Files:**
- Modify: `README.md`
- Modify: `SOP.md`
- Modify: `docs/ICDB-MANUAL-REPAIR-AND-UPDATE.md`
- Create: `docs/releases/2026-11-06-runtime-lifecycle-validation.json`
- Create: `docs/releases/2026-11-06-runtime-lifecycle-candidate.md`
- Modify: `pyproject.toml`、`src/cbb_refresh_verify/__init__.py`(只在实际生成新候选包时递增为 0.2.4b2)
- Test: `tests/test_packaging.py`、`tests/test_packaging_status_bridge.py`
**Interfaces:**
- 验证记录必须关联最终 source tree SHA、测试 XML 哈希、实际版本、候选包 SHA-256、平台/Mentor 版本;缺少真实包或环境的项使用 not_run/unverified,不能写 passed。
- 旧 `0.2.4b1` / `5eb4b2d` 的 1,631 完整回归和 63 项专项为历史基线,不是本轮验收结果。
- [x] **Step 1: 在独立测试互斥/临时恢复目录下串行跑最终完整套件。** `python -m pytest -q` 必须来自新工作树 src,子进程 PYTHONPATH 同步。不要同时在同一 runner 跑另一个使用真实产品互斥或固定恢复根的全量任务。
- [x] **Step 2: 跑 `python -m compileall -q src tests` 和 `git diff --check`。** 保持源文件原行尾;记录预期 pywinauto COM 提示,新的警告另查。
- [x] **Step 3: 生成候选包前更新为 0.2.4b2,按现有 spec 打包并运行 frozen 入口冒烟。** 验证 verify-worker、management-worker、owner-probe、dialog-agent 的模块/脚本可加载;运行“冻结程序 + fake 保存/管理 native 边界”的父进程退出与停止测试。构建环境缺外部依赖时记录具体缺项,不宣称已产生候选包。
- [ ] **Step 4: 通过应用实际按钮运行隔离副本。** 单独记录 Save 前停止、Save 中停止、Close 延迟、管理父进程退出、legacy 未打开 LM、未知原生提示、独立库继续。缺实机场景保留未验收;不为验收在生产库保存中杀进程。
- [x] **Step 5: 更新文档与审查描述。** 写清默认停止规则、后台观察范围、只读未知状态、真实 COM 无法取消的限制、程序回退与数据恢复的区别。测试用例数量不得替代场景证据。
- [x] **Step 6: 提交候选记录,推送本轮差分草稿 PR。** `git commit -m "docs: record runtime lifecycle validation and candidate limits"`;按 A/B/C 提供审查顺序,不自动发布或关闭 ICDB 工单。若 main 已变化,重新整合并验证实际候选树。
## 验收映射与自查
| 审查问题 | 计划任务 | 必须看到的证据 |
| --- | --- | --- |
| P1-1 Save/Close 中自动强杀及误记安全 | 1、2、3、4、8 | 实际 helper 存活、无 terminate、保存/关闭/释放独立结果、跨入口停止一致 |
| P1-2 管理失联后无监督操作 | 3、5、6 | 启动门、精确持久身份、失联取消、调用返回后无后续写入、重启可核对 |
| P1-3 legacy 读取隐式启动/肯定应答 | 7、8 | 读取路径无 CreateProcess/点击/用户窗口关闭,未知状态可见 |
| 直接相关停止传播和保存状态记录 | 1、2、4、8 | CLI/GUI 同一 stop,兼容修复链不吞 stop;COMMITTED 与关闭失败并存 |
| 防止修复又导致整批/全工具卡死 | 3、6、8 | 有界等待后转观察;B 库执行,A 库活跃写入不并发;UI 始终可响应 |
| 源码、冻结包和现场验收口径 | 9 | 三层分别记录,缺哪层明确保留,不能互相代替 |
本轮排除项见设计第 13 节。源文件行号以基线供定位,实施时先用 rg 重新定位所有调用方,不直接按旧行号打补丁。
实施记录:用户已授权执行。实施在当前会话逐项完成;独立只读审查按 requesting-code-review 技能执行,没有并行修改源码。保存启动门依赖会话协议,故先提交协议 primitive(97a3de2);mentor_adapter 的停止与只读修改共用文件,在 8d3eab1 合并提交 A/C 基础接线。管理接线为 6278091,界面及按库交接为 cb11624,独立审查修正为 d9a79b6、051498b。三单元联通后统一验证、生成候选,未提前交付不完整的 A 单元。真实环境未验收项见候选记录。
@@ -0,0 +1,25 @@
# Latest reviews for PR #10/#11/#12
Scope: user selected only the 2026-11-09 comments #309/#310/#313. Earlier deep-review backlog stays out of scope. Preserve ICDB automatic Repair OFF, serial writes, current icon and independent-library admission. No merge to main, issue closure or release.
## PR #10
- [x] Reproduce BlockA releasing historical BlockB checkpoints and retained owners without naming BlockB in proof.
- [x] Record requested block, actual proof scope, checkpoint identities and foreign names in existing release proof. Preserve original checkpoint bytes and data_recovery_confirmed=False; no new blocking gate.
- [x] Run backend/lease regressions, compile/diff checks, commit on codex/review-native-backend.
## PR #11/#12
- [x] Forward-merge backend into UI, then UI into residual branch; no history rewriting.
- [x] Test one unreadable process/thread not affecting another, without fabricated modal windows; cover preview and action-time rechecks.
- [x] Enumerate only target-process threads/windows, store incomplete-read metadata per PID. Keep unknown/active writers protected rather than adding a blind force override.
- [x] Persist window identities and at most a 4 KiB output excerpt, preserve full preview in memory, stop duplicating activity output.
- [x] Carry exact preview block scope into native Cancel and recheck identity/scope before clicking.
- [x] Run residual/UI regressions, compile/diff checks, commit on residual branch.
## Chain tip
- [x] Merge residual fixes into PR #13, preserving ca39fb3 and icon.
- [x] Address #11's line-ending note once at the tip: application.py to LF; pin it and main_window.py with targeted .gitattributes exceptions. Preserve all other file endings and the global * -text rule; EditorConfig is unnecessary.
- [x] Independent review, integrated full suite, compile/diff checks, validation records and fast-forward pushes to existing PR branches.
- [x] Update PR descriptions with precise results and no new package/native acceptance. Leave #3 as historical umbrella, without merging or closing it.
@@ -0,0 +1,32 @@
# PR #13 comment 319: residual lifecycle fixes
**Goal:** Fix the P2 and three P3 findings against head `96e179b` without interrupting an in-flight native writer.
**Scope:** https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-319
**Constraints:** Python 3.12/PySide6/pywin32, no new dependencies; existing isolated worktree and icon retained; no automatic ICDB Repair, native process termination, merge, release or issue closure. Real Mentor and shared-network acceptance remains outstanding.
## 1. Release proof and queue state
- [x] Reproduce an ended UNCONFIRMED observer leaving its library unavailable after explicit successful release.
- [x] Snapshot retained entries before proof; acknowledge only those entries, for the matching library, while proof handles are still held. Failed proof and newer handoffs remain blocked. Test independent libraries and queue resumption.
- [x] Retain final observer states for the existing residual panel, including unreadable journals; expose fresh recheck through that panel.
## 2. Passive discovery
- [x] Test that discovery of an exited session never calls release proof or modifies library checkpoints.
- [x] Separate process observation from explicit reconciliation; startup observation stays read-only, reports ACTIVE/UNCONFIRMED and cannot claim RELEASED without proof.
- [x] Refresh journal/status information from the running residual dialog, keeping all I/O off the Qt thread.
## 3. Supervisor loss
- [x] Use harmless real subprocesses to test PRECALL/POSTCALL exit, NATIVE_CALL/CLOSING retention, missing/unreadable journals and failed cancellation/journal writes.
- [x] Synchronize phase transitions and helper registration with watchdog shutdown. Only matching durable and in-memory non-pending state allows worker-only exit; preserve active helpers and unknown states. Prevent subsequent calls after supervisor loss.
- [x] Recheck after retained calls return; do not kill a native child or interpret worker exit as release proof.
## 4. Dead code and validation
- [x] Delete unused `_terminate_pid`; replace obsolete test hooks with assertions at actual process termination boundaries.
- [x] Run focused regressions, full Python suite, compileall and diff checks. Record results and field-validation limits, then commit scoped changes. Do not rebuild or publish a candidate without documenting its source and validation.
Execution: implement inline in the existing isolated worktree; red/green tests per task. The user has authorized these fixes, so no further plan confirmation is needed.
@@ -0,0 +1,13 @@
# 占用范围、释放及原生确认实施计划
按用户已确认的误判复核方案执行,沿用隔离分支 codex/runtime-lifecycle-safety;原工作区和其他软件会话不改动。
1. 先以真实外部命令回放补充失败测试:未知外部观察项不接收关闭请求,目标独占资源证明成功后不阻止本库释放;真实本库进程、在途助手、数据库句柄或地址仍阻止。统一库证明与维护入口的进程候选判断,保留观测证据。
2. 修正释放结果:观察项与可操作目标分开,未允许且自然退出不计主动释放;对绑定身份已退出的旧 UNCONFIRMED 日志不再认定调用仍在执行。覆盖 PID 复用和读取失败。
3. 单项失败后,先尝试本库/本工程新鲜释放证明;证明完成才解除相应保留状态并继续,无法证明的共享占用仍停止相关写入。普通校验/管理在完整单项事务结束后让出队列,支持等待及取消。
4. 普通 PCB 打开接通精确读写提示的用户确认;复用现有异步选择模型,绑定 PID、工程、私有桌面、当前提示,取消/跳过不自动写入。自动 Repair 保持关闭;恢复副本也传递用户选择。识别未知提示不猜测点击。
5. 每项先红后绿;全量回归、编译、冻结代码/图标一致性;其他软件独立工程持续运行、真实目标句柄占用、停止后重试、提示确认/取消、真实校验与备份恢复。EDIF 崩溃单独保留原生失败证据,不跳过身份校验。尚未达到 READY 不宣称验收通过。
主要代码:library_lock.py、residual_sessions.py、session_record.py、verify_runner.py、management.py、ui/icdb_check_task.py、ui/management_dialog.py、ui/main_window.py、ui/residual_release_dialog.py、backup_recovery.py;原生确认按现有 pcb_restore_prompt 和 dialog_agent 模式实现。
验证记录写入 docs/releases,原始运行证据放 F 盘独立验收目录。开发与原生验收串行执行,所有原生操作局限隔离副本。
@@ -1,5 +1,7 @@
# CBB 批量状态桥设计
Current behavior (2026-11-09): production status scans always query the bridge fresh and overwrite checkpoint evidence. `BatchStatusSession.scan` defaults to `resume=False`; `resume=True` remains an explicit low-level option for controlled read-only scans, not an exposed production resume feature. Its lightweight fingerprint cannot detect every native payload/database write, so saved READY/PENDING rows must not authorize production actions.
## 目标
支持对 180 到 3000 个 CBB 进行 Mentor authoritative Verify 状态读取,要求单条失败隔离、过程可恢复、结果可审计,并避免现有“一条 CBB 启动一个桥进程”的启动开销。
Loaded 100 of 278 files, more files were not shown because too many files have changed in this diff. Show more