CBB 导入解耦与写入确认:补齐 PR #13 后续审查修复 #14

Merged
abaishu0730 merged 4 commits from codex/import-without-export-gate into main 2026-11-16 11:07:04 +08:00
Owner

正常 CBB 导入此前依赖 ASCII/CSV/EDIF 导出,导出异常及单项输入、校验失败可能妨碍后续独立条目。本 PR 将可选导出诊断移出普通导入路径,并补齐写入确认、PCB 打开句柄和任务绑定边界。

承接已合并 PR #13 的 评论 414 和 评论 430,包含此前仅在本地的 1572e2d、fee4a67 及本轮修复。

行为变化

  • 导入确认原生注册、名称/分区、工程关联、允许的顶层块和 Layout。单项输入或可选 Verify 失败后,在会话已释放且下一项检查通过时继续;上传与 READY 分开报告。
  • 未知原生客户端只在写入或备份替换时需要用户选择继续、跳过或取消;许可绑定本批次、库及进程身份。真实占用和身份变化不能用确认绕过。
  • PCB 读写打开前先释放独占探测句柄,再复核进程及窗口身份;后台队列和状态刷新使用请求绑定的库。
  • 文件身份采集失败保留 RECOVERY_REQUIRED、阻止自动重放该目标。后续资格依据独立的原生退出及资源证据,文件采集结果不会覆盖原生释放状态。
  • 无界面无法确认及恢复安装前跳过均报告 SKIPPED,取消报告 CANCELLED;恢复界面区分跳过、取消和失败。
  • 无未知客户端时省去第二轮重复探测;经过确认后仍重新检查进程、地址和文件资源。导出进程豁免要求最新身份及作用域证据。

验证

  • Windows 11 / Python 3.12:全量 1924 passed;本轮针对性 89 passed。编译和 git diff --check 通过。
  • 先复现后修复:评论 430 新增 10 项用例,旧代码出现 7 项预期失败;另 3 项确认原有边界。
  • 冻结包从本轮代码提交重新生成,核对打包模块、源码散列、资源及 PE 图标;实际私有桌面操作结果见验证记录。
  • 实际按钮试验:恢复选择跳过,显示“恢复已跳过”且目标内容不变;批量新增第一项 SKIPPED、第二项 UPLOADED,独立目录回读确认新增条目,来源不变,程序退出码 0。此轮未启用上传后自动 Verify,不宣称 READY。
  • 验证记录:docs/releases/2026-11-13-import-decoupling-validation.json、2026-11-13-review-414-validation.json、2026-11-16-review-430-validation.json。其中本机证据路径仅用于审计,非可公开下载地址。

明确边界

原理图语义未作等价证明(schematic_semantics_checked=False),完整 Verify 为独立可选步骤;“已上传”不代表 READY。该范围按本轮用户确认执行。

原生入口仍拒绝已有其他 LibraryManager 的情况,需正常关闭相关会话后继续。EDIF 崩溃根因、Windows 10、跨机器 SMB 和现场服务器会话失联修复未验收;自动 ICDB Repair 保持关闭。本 PR 不更新云端 v0.2.4-beta.2,代码合并不代表现场验收通过。

本次冻结程序为候选测试包。将来发布时仍须从合入后的 main 重建并做冒烟,不直接把本地候选包当作云端新版本。

回滚

通过 revert 本 PR 合入的提交回滚代码。程序回滚不撤销已经完成的中心库操作,应依据逐项检查点和人工备份恢复;不自动重放写入。

正常 CBB 导入此前依赖 ASCII/CSV/EDIF 导出,导出异常及单项输入、校验失败可能妨碍后续独立条目。本 PR 将可选导出诊断移出普通导入路径,并补齐写入确认、PCB 打开句柄和任务绑定边界。 承接已合并 PR #13 的 [评论 414](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-414) 和 [评论 430](https://git.simgreek.com/Skyworth_Digital_Hardware/cbb-refresh-verify-795/pulls/13#issuecomment-430),包含此前仅在本地的 `1572e2d`、`fee4a67` 及本轮修复。 ### 行为变化 - 导入确认原生注册、名称/分区、工程关联、允许的顶层块和 Layout。单项输入或可选 Verify 失败后,在会话已释放且下一项检查通过时继续;上传与 READY 分开报告。 - 未知原生客户端只在写入或备份替换时需要用户选择继续、跳过或取消;许可绑定本批次、库及进程身份。真实占用和身份变化不能用确认绕过。 - PCB 读写打开前先释放独占探测句柄,再复核进程及窗口身份;后台队列和状态刷新使用请求绑定的库。 - 文件身份采集失败保留 `RECOVERY_REQUIRED`、阻止自动重放该目标。后续资格依据独立的原生退出及资源证据,文件采集结果不会覆盖原生释放状态。 - 无界面无法确认及恢复安装前跳过均报告 `SKIPPED`,取消报告 `CANCELLED`;恢复界面区分跳过、取消和失败。 - 无未知客户端时省去第二轮重复探测;经过确认后仍重新检查进程、地址和文件资源。导出进程豁免要求最新身份及作用域证据。 ### 验证 - Windows 11 / Python 3.12:全量 **1924 passed**;本轮针对性 **89 passed**。编译和 `git diff --check` 通过。 - 先复现后修复:评论 430 新增 10 项用例,旧代码出现 7 项预期失败;另 3 项确认原有边界。 - 冻结包从本轮代码提交重新生成,核对打包模块、源码散列、资源及 PE 图标;实际私有桌面操作结果见验证记录。 - 实际按钮试验:恢复选择跳过,显示“恢复已跳过”且目标内容不变;批量新增第一项 SKIPPED、第二项 UPLOADED,独立目录回读确认新增条目,来源不变,程序退出码 0。此轮未启用上传后自动 Verify,不宣称 READY。 - 验证记录:`docs/releases/2026-11-13-import-decoupling-validation.json`、`2026-11-13-review-414-validation.json`、`2026-11-16-review-430-validation.json`。其中本机证据路径仅用于审计,非可公开下载地址。 ### 明确边界 原理图语义未作等价证明(`schematic_semantics_checked=False`),完整 Verify 为独立可选步骤;“已上传”不代表 READY。该范围按本轮用户确认执行。 原生入口仍拒绝已有其他 LibraryManager 的情况,需正常关闭相关会话后继续。EDIF 崩溃根因、Windows 10、跨机器 SMB 和现场服务器会话失联修复未验收;自动 ICDB Repair 保持关闭。本 PR 不更新云端 `v0.2.4-beta.2`,代码合并不代表现场验收通过。 本次冻结程序为候选测试包。将来发布时仍须从合入后的 main 重建并做冒烟,不直接把本地候选包当作云端新版本。 ### 回滚 通过 revert 本 PR 合入的提交回滚代码。程序回滚不撤销已经完成的中心库操作,应依据逐项检查点和人工备份恢复;不自动重放写入。
abaishu0730 added 4 commits 2026-11-16 10:04:35 +08:00
Author
Owner

审查:评论 430 三项修复复核(fa55904、ec9f8a3)

范围:PR head ec9f8a3,在上一轮 fee4a67 之上新增两个提交;相对 main(cbc5723)共 4 个提交、31 文件、+2156/−130,可 fast-forward,main 未前移。

结论:通过,可以合并。 上轮评论 430 的 3 项语义问题均已按要求处理,有红测和新增用例覆盖,未发现新的阻断项。

三项修复复核

  1. 文件身份 ≠ 原生释放证明:_add_transaction 不再用 capture_registration_identity() 的 safe_to_continue 覆盖重开目录后的原生退出证明(native_management.py:405-408);文件采集失败仍为 RECOVERY_REQUIRED,同目标不自动重放,独立条目可在自身写前检查通过后继续。test_file_proof_does_not_override_confirmed_native_release 与 test_unreleased_native_owner_never_reaches_file_proof 覆盖两个方向。
  2. 未执行 ≠ 失败:无界面/无提示时 WriteAdmission.confirm() 与 _idle_check() 返回 WriteAdmissionDeclined('skip') → 管理状态 SKIPPED;恢复在安装前跳过/取消返回 SKIPPED/CANCELLED,界面显示“恢复已跳过/已取消”。SKIPPED 不标记库 unsafe,也不触发目录重载(main_window.py:757 的白名单不含它)。
  3. 空闲时只探测一轮:_idle_check() 无未知客户端时一次进程查询 + 一次资源探测即返回;进入确认路径才重新查询并探测,且不持独占句柄等待用户(backup_recovery.py:61-73)。test_confirmation_rechecks_a_database_that_became_occupied 证明确认后新占用被拒绝。

独立验证

  • 收集 1924 项(1914 + 新增 10),与 2026-11-16-review-430-validation.json 一致。
  • 相关用例 462 项全部通过:232 项(review430/review414/导入解耦/导出释放/备份恢复/管理批处理/原生管理/后台队列)+ 230 项(reimport、operation lifecycle、管理重试/探针、原生身份、PCB 打开/版本选择等)。
  • 红测复核:将 tests/test_review430.py 放回 fee4a67 树运行,结果 7 failed / 3 passed,与文档完全一致。
  • compileall 通过;git diff --check(按本仓库本地配置 core.whitespace=cr-at-eol)通过;全量 diff 无敏感信息。
  • 全量 1924 无法在当前沙箱独立跑完:私有桌面/进程限制导致部分环境性失败与 GUI 挂起,与上轮 main 基线一致;validation JSON 的 full/focused/red(1924/0、89/0、10/7)内部自洽。
  • 未验证:真实私有桌面冒烟、冻结包 66 模块与 PE 图标一致性(依赖本地证据)。

遗留观察(不阻断)

  • git diff --check 依赖本地 core.whitespace=cr-at-eol;.gitattributes 明确 * -text 保留 CRLF,干净克隆默认配置会把新增 CRLF JSON 报为 trailing whitespace。建议把检查命令写进 REPOSITORY-NOTES.md。
  • native_export_guard._preexisting_export_pids() 仍较密集,未传 snapshot 时会额外调用 _process_snapshot();建议后续复用快照。
  • README/SOP 尚未提到管理/恢复的 SKIPPED/CANCELLED 状态语义(当前只有 UI 标签和 release 文档),建议补一句。
  • 两个新提交仍无正文;PR 描述已覆盖。
  • 产品/验收边界未变:schematic_semantics_checked=False,UPLOADED ≠ READY;EDIF 根因、Windows 10、跨机 SMB、现场失联修复未验收;自动 ICDB Repair 关闭。

合并建议

fast-forward 合并 PR #14;合并后按 validation JSON 的 bundle 清单重建冻结包并做一次冒烟(ec9f8a3 仅文档,包对应代码提交 fa55904)。合并不等于现场验收/发布,云端 v0.2.4-beta.2 不受影响。

### 审查:评论 430 三项修复复核(`fa55904`、`ec9f8a3`) 范围:PR head `ec9f8a3`,在上一轮 `fee4a67` 之上新增两个提交;相对 `main`(`cbc5723`)共 4 个提交、31 文件、+2156/−130,可 fast-forward,main 未前移。 **结论:通过,可以合并。** 上轮评论 430 的 3 项语义问题均已按要求处理,有红测和新增用例覆盖,未发现新的阻断项。 #### 三项修复复核 1. **文件身份 ≠ 原生释放证明**:`_add_transaction` 不再用 `capture_registration_identity()` 的 `safe_to_continue` 覆盖重开目录后的原生退出证明(`native_management.py:405-408`);文件采集失败仍为 `RECOVERY_REQUIRED`,同目标不自动重放,独立条目可在自身写前检查通过后继续。`test_file_proof_does_not_override_confirmed_native_release` 与 `test_unreleased_native_owner_never_reaches_file_proof` 覆盖两个方向。 2. **未执行 ≠ 失败**:无界面/无提示时 `WriteAdmission.confirm()` 与 `_idle_check()` 返回 `WriteAdmissionDeclined('skip')` → 管理状态 `SKIPPED`;恢复在安装前跳过/取消返回 `SKIPPED`/`CANCELLED`,界面显示“恢复已跳过/已取消”。`SKIPPED` 不标记库 unsafe,也不触发目录重载(`main_window.py:757` 的白名单不含它)。 3. **空闲时只探测一轮**:`_idle_check()` 无未知客户端时一次进程查询 + 一次资源探测即返回;进入确认路径才重新查询并探测,且不持独占句柄等待用户(`backup_recovery.py:61-73`)。`test_confirmation_rechecks_a_database_that_became_occupied` 证明确认后新占用被拒绝。 #### 独立验证 - 收集 **1924 项**(1914 + 新增 10),与 `2026-11-16-review-430-validation.json` 一致。 - 相关用例 **462 项全部通过**:232 项(review430/review414/导入解耦/导出释放/备份恢复/管理批处理/原生管理/后台队列)+ 230 项(reimport、operation lifecycle、管理重试/探针、原生身份、PCB 打开/版本选择等)。 - 红测复核:将 `tests/test_review430.py` 放回 `fee4a67` 树运行,结果 **7 failed / 3 passed**,与文档完全一致。 - `compileall` 通过;`git diff --check`(按本仓库本地配置 `core.whitespace=cr-at-eol`)通过;全量 diff 无敏感信息。 - 全量 1924 无法在当前沙箱独立跑完:私有桌面/进程限制导致部分环境性失败与 GUI 挂起,与上轮 main 基线一致;validation JSON 的 full/focused/red(1924/0、89/0、10/7)内部自洽。 - 未验证:真实私有桌面冒烟、冻结包 66 模块与 PE 图标一致性(依赖本地证据)。 #### 遗留观察(不阻断) - `git diff --check` 依赖本地 `core.whitespace=cr-at-eol`;`.gitattributes` 明确 `* -text` 保留 CRLF,干净克隆默认配置会把新增 CRLF JSON 报为 trailing whitespace。建议把检查命令写进 `REPOSITORY-NOTES.md`。 - `native_export_guard._preexisting_export_pids()` 仍较密集,未传 snapshot 时会额外调用 `_process_snapshot()`;建议后续复用快照。 - README/SOP 尚未提到管理/恢复的 `SKIPPED`/`CANCELLED` 状态语义(当前只有 UI 标签和 release 文档),建议补一句。 - 两个新提交仍无正文;PR 描述已覆盖。 - 产品/验收边界未变:`schematic_semantics_checked=False`,`UPLOADED` ≠ `READY`;EDIF 根因、Windows 10、跨机 SMB、现场失联修复未验收;自动 ICDB Repair 关闭。 #### 合并建议 fast-forward 合并 PR #14;合并后按 validation JSON 的 bundle 清单重建冻结包并做一次冒烟(`ec9f8a3` 仅文档,包对应代码提交 `fa55904`)。合并不等于现场验收/发布,云端 `v0.2.4-beta.2` 不受影响。
abaishu0730 merged commit ec9f8a3e40 into main 2026-11-16 11:07:04 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Skyworth_Digital_Hardware/cbb-refresh-verify-795#14