10 KiB
批量执行闭环验收
本轮对应 docs/superpowers/plans/2026-11-17-batch-execution-closure.md。位号优先定位;工程内先暂存,工程统一保存回读后提交;不确定工程隔离,确认全部自有写进程退出后继续独立工程。工程执行、网表验收、资源告警分开记录。
flowchart TD
A[导入 BOM 并保存待执行计划] --> B[原生读取当前工程所需位号与网表]
B --> C{工程/页/位号能否明确定位}
C -- 否 --> D[记录明确的匹配错误]
C -- 是 --> E[逐项原生替换和内存核验]
E --> F[写 pending_save / 暂存回执]
F --> G{工程还有项且未暂停}
G -- 是 --> E
G -- 否 --> H[统一保存页 / 关闭工程 / 重开回读 / 最终关闭]
H --> I{全部前缀核验通过}
I -- 是 --> J[原子提交已保存回执和任务进度]
J --> K{人工暂停}
K -- 是 --> L[结束整批 / 保留未执行项]
K -- 否 --> M[继续下一独立工程]
E -- 未知写入或异常 --> N[保留 uncertain / 工程待核验]
I -- 否 --> N
N --> O[回收该工程自有写进程]
O --> P{写进程退出和自有句柄关闭已证实}
P -- 否 --> Q[停止整批 / 等待资源核验]
P -- 是 --> R[隔离工程及共享写入源]
R --> S{旧桌面是否仍存在}
S -- 是 --> T[保留隔离告警 / desktop_released=false]
S -- 否 --> M
T --> M
J --> U[独立原生网表验收 / 单独显示结果]
R --> V[共享源后续任务未派发即阻塞]
V --> W[原依赖恢复后显式核验重新准入]
20 类验收场景
下面是自动化验收矩阵,不代表 20 次真实 Mentor 替换。Python 测试替代 COM 边界;VBS 测试执行生产脚本函数并使用假 COM 对象。真实 Windows 桌面测试另列。
| # | 场景 | 需要确认的结果 | 自动化覆盖 |
|---|---|---|---|
| 1 | 器件 UID 缺失或格式异常 | 位号明确时可定位,原始 UID 留证 | test_refdes_identity_closure inventory cases |
| 2 | 不同位号共享 UID | 不误绑定,不阻断无关器件 | 同模块 duplicate UID / unselected collision cases |
| 3 | 替换或重开后 UID 变化 | 快照、回读、网表仍关联原位号,旧操作编号不变 | 同模块 snapshot/readback/netlist cases |
| 4 | 原 UID 被另一位号复用 | 不把错误位号当成替换成功 | 同模块 reused UID mismatch cases |
| 5 | 不同页或层级同位号 | 依据工程、页和层级定位,真实歧义拒绝 | 同模块 sheet/hierarchy cases |
| 6 | 同一物理器件多个合法单元 | 全单元快照及回读,物理引脚连接仍严格比较 | 同模块 multiunit cases |
| 7 | 工程中多项暂存 | 游标推进,但 saved/completed 不提前增加 | test_project_commit_progress |
| 8 | 工程末统一保存 | 每个已修改页保存一次,工程关闭重开回读一次 | test_project_commit_vbs save/reopen case |
| 9 | 暂存前缀后人工暂停 | 提交已修改前缀,未执行项不产生写入/不确定状态 | test_project_commit_end_to_end pause cases |
| 10 | 写入前暂停 | 保留 SafeStop 来源,当前项保持 pending | test_project_commit_vbs / test_resource_isolation_prewrite_pause |
| 11 | 回读失败或提交清单不完整 | 不提前提交任何暂存项 | test_project_commit_journal / test_project_commit_proof |
| 12 | 保存成功后程序崩溃 | 从不可变提交证据幂等恢复,不重放替换 | test_project_commit_journal / test_project_commit_public_recovery |
| 13 | 工程保存回读持续有进度且超过原等待时间 | 不因固定 60 秒误判收尾失败 | test_project_commit_session progressing commit case |
| 14 | 自有进程退出但旧桌面仍被外部句柄持有 | 保留 desktop_released=false,隔离告警,新批次可进入 | test_resource_isolation;真实 Windows 探针 |
| 15 | 仍有写进程或进程身份未知 | 不允许隔离放行 | test_resource_isolation active/unknown cases |
| 16 | 隔离后重启,随后外部句柄消失 | 重验退出证明;被动确认释放,不重复 Quit | 同模块 restart/passive disappearance cases |
| 17 | 工程结果未知,资源已收尾 | 保留 blocked 和 uncertain,继续独立工程,恢复队列不重放 | test_project_isolation_queue / test_workspace_execution |
| 18 | 本地回收与人工停止 | 本地回收不污染下一工程;人工暂停/强制结束仍生效 | test_project_isolation_queue / workspace control cases |
| 19 | 后续工程共享 iCDB 写入源 | 未派发即阻塞,原依赖核验完成后才重新准入 | test_lifecycle_integration_fix dependency cases |
| 20 | 任务完成、失败、恢复及资源告警 | 实时分类;已保存结果与网表/资源结果分别展示;诊断含最后成功项和未返回调用 | test_live_task_completion / test_failed_native_recovery_guard / test_diagnostics_closure |
证据位置
- 本轮回归日志:
build/batch-execution-closure/。 - Windows 桌面实际持有、重启复核及新桌面准入:
build/batch-execution-closure/resource-isolation/run-4ace6aa7a36b4204a7bed568b5ce7505/evidence.json。 - 工单原始日志保留在
outputs/issues-20261117/issue29/,不修改用户上传证据。
自动化验证结果
主程序/UI 全量运行 2335 项,最初 2320 项通过、15 项失败。14 项仍断言“未知结果必须整批暂停”,已按已批准的工程隔离策略更新,同时保留同工程后项不派发、不重放和独立工程可继续的断言;另一项修复测试对尚未创建完成的原生弹窗按钮的读取竞态。随后对全部失败项和本轮新增/修改的调用链定点复验。
最终 JUnit 合并记录为 2438 个唯一用例通过,0 个未解决失败,证据见 build/batch-execution-closure/verified-test-summary.json。这是全量运行加定点复验的合并结果,不是另一次全部用例在最后源码上的全量运行。定点记录为 root delta 143 项、lifecycle delta 97 项、project recovery 29 项、identity delta 47 项、deleted guard 1 项,均通过;这些记录存在重叠,不应直接相加。
独立审查已复核位号/多单元、工程暂存及暂停、资源隔离、共享源恢复及公开工程提交恢复。工程已保存但数据库回执未完成时,公开恢复入口验证原生关闭检查点、保存源、回读文件及原尝试身份后恢复回执,不启动 CAD 或重复替换;源变化、其他未知写入、证据损坏及不匹配的中断记录继续保持待核验。
实机边界
工程级批量保存、UID 异常和多单元替换需要使用副本进行真实 Mentor 验收。自动化协议验证、真实桌面句柄探针和真实 CAD 写入必须分别报告;不得用前两者声称已完成原 100 工程队列。原工程、中心库、Excel 和历史 uncertain 记录不作为试验修改对象。
首轮真实 Mentor 探针 build/batch-execution-closure/mentor-live/ 在 RL02 原生替换和内存回读后失败:新暂存入口未暂时清除内存 restored_ok,导致生产命令读取器认定没有待处理命令。该问题已有真实读取器回归;复测使用 mentor-live-fixed/ 全新副本。失败副本及 uncertain 保留,不重放。首轮 Mentor 正常退出、桌面释放,无强制终止;原备份 34 个文件前后哈希一致。
第二轮 mentor-live-fixed/ 发现未选中非 PCB 图形的空位号被写成相同别名,导致后续全页原生回读重复 UID;已对空位号跳过引用别名并保留其独立原始 UID。第三轮 mentor-live-final/ 通过该位置并写出 pending_save,随后全页语义采集缺少逐器件进度,触发无进度停止;补充实际完成计数后使用 mentor-live-progress/ 新副本复测。前三轮异常资源均确认释放,备份源文件前后哈希一致;不计为工程保存成功验收。
第四轮真实 Mentor 验收通过,证据为 build/batch-execution-closure/mentor-live-progress/closure-live-summary.json。RL02、RL05 两项替换先暂存,最后统一提交;日志确认一个 worker、一次保存、两次打开工程(首次打开及保存后重开)。两项 SQL 操作均为 verified/generation=1,工程提交 verified,任务 completed。独立原生清单读取复核 13 个位号:两项目标料号正确,其余 11 项保留原料号。Mentor 和桌面确认释放,无强制终止;备份源 34 个文件哈希未变化。
本机计时及限制
| 实际边界 | 秒 |
|---|---|
| 第一项开始至暂存回执 | 472.664 |
| 第二项派发至暂存回执,含前一项检查点核验 | 539.298 |
| 工程收尾,含完整状态检查、统一保存、关闭重开和回读 | 431.863 |
| 其中两次原生替换提交调用 | 0.631 / 0.424 |
| Mentor 退出 | 5.093 |
| 桌面释放 | 0.009 |
| 整个队列 | 1450.341 |
| 队列结束后的独立原生清单复核 | 1.505 |
“其中”调用嵌套于上层步骤,不能再次相加。本轮同时存在构建和回归负载,不能作为独占性能基准,也没有同条件旧版对照。全页状态反复采集仍是明显耗时项;本次证明阻塞闭环、保存次数与结果提交正确,没有证明速度提升。真实 CAD 仅验证一个副本工程、两次替换;多单元、UID 异常和 20 类异常场景主要依靠自动化协议/COM 边界测试,不能当成 20 个真实工程已通过。
候选包仅供本地测试,不自动覆盖旧 Release。
本地候选程序
入口:D:\CodexValidation\batch-closure-20261117\candidate\dist\DxPartReplace\DxPartReplace.exe。这是包含完整 Harness/Node/Qt 运行时的目录包,运行时文件须与程序一起保留。应用版本资源仍为 1.3.1,本轮候选代码通过冻结模块核对区分,不代表远端已经发布了新版本。
冻结包内 162 个应用模块与最终源码编译结果一致,两份 VBS 与源码逐字节一致。EXE SHA256:4b19948b6a008912851f3ab674afa361bf4a28de4b74f20d3d04b80719200cc1。打包程序本身已通过启动、冻结监督进程、进程身份读取、资源释放及正常退出验证。报告位于候选目录上级的 source-verification.json 与 packaged-runtime-verification.json。
实施决定:沿用已有功能分支保留先前授权修复;互不重叠的模块并行处理后统一审查;本地直接交付完整目录包。前两项若判断错误需集成返工,目录包如需转移到其他机器可另行归档。本轮未合并、推送或发布远端版本。