Files
cbb-refresh-verify-795/docs/diagnostics/2026-11-04-native-backup-entry.md

4.0 KiB
Raw Permalink Blame History

原生版本历史、备份与回退入口

用户操作

在“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 保持开放。