Files
cbb-refresh-verify-795/docs/diagnostics/2026-11-05-blocking-lock-audit.md

22 KiB
Raw Permalink Blame History

全链路阻塞与锁审计(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;完整原生移除与重新读目录验证通过。历史记录本身不再被直接当作活跃会话,管理入口允许重新复核;生产库工程未改动。