6.1 KiB
批次私有桌面实机验收,2026-10-21
本机单组对照通过:两个工程的 BOM 导入及一次顺序替换合计从 170.860 秒降至 151.859 秒,减少 19.001 秒,约 11.12%。业务流程的私有桌面数从 6 个降至 2 个,CAD 启动数从 2 次降至 1 次。该时间不包含独立核验器额外启动 CAD 的开销,属于本次对照的实测值。
输入与隔离范围
- 基线:原仓库
e15ee25;候选:.worktrees/batch-runtime的批次运行时实现。 - 原始 fixture:原仓库
build/cbb-bom-import-live-20261015/projects/Audio_D2128与Audio_T605A。 - 两版本分别复制到全新目录,使用相同源文件及输入;源工程全文件 SHA-256 在结束后保持一致。
- 中心库:
F:/Sync Tool Skyworth/Work Maps/Skyworth_CBB_Lib/Mentor_lib_EE7.9/mentor_lib.lmc,只读使用,.lmcSHA-256 不变。 - 两工程均只替换
RV05,由4100-CA0000-T7替换为4100-CA0000-T0。sync_nc=True,copy_part_number_to_value=False,队列策略为preserve。 - 证据根:工作树
build/batch-runtime-live-20261021-144210,实际基线结果在baseline2,候选在candidate。comparison.json汇总跨版本对照。
preserve 保持原生目标库器件的 Value,而非恢复旧器件文字。此目标的原生 Value 属性缺失,最终期望为 Part Number=4100-CA0000-T0、Part Label=0R、Value 属性不存在。该语义来自 docs/superpowers/specs/2026-10-14-v1.1.0-project-tasks-design.md,与 QPRestoreComponent、QPVerifyValuePolicy 的存在性及内容核验一致。两版本的最终实际状态均符合该期望。
测量结果
| 指标 | 基线 | 候选 |
|---|---|---|
| BOM 导入两工程 | 2.250 s | 3.187 s |
| 两工程顺序替换、保存、回读和流程收尾 | 168.610 s | 148.672 s |
| 上述业务流程合计 | 170.860 s | 151.859 s |
| BOM 阶段私有桌面 | 2 | 1 |
| 执行阶段私有桌面 | 4 | 1 |
| 执行阶段 CAD 启动 | 2 | 1 |
基线执行阶段含两个只读 native CLI 桌面和两个 CAD 桌面;候选在该阶段共用一个私有桌面和同一个 CAD PID 9192,generation 为 1。独立核验器使用的额外 CAD 会话单独记录在 desktop_starts、cad_starts 的 independent_before、independent_after 阶段,不计入表中的业务资源数量。
保存结果与释放核验
每份工程均通过独立 Python COM 读取器,从空 CAD 开始重新打开磁盘工程,直接读取图页组件、全部属性和引脚网络。读取器不调用生产恢复/替换代码。
- 两版本替换前的完整独立读取 JSON 完全相等;替换后的完整 JSON 也完全相等,包含目标器件的所有属性。
- 每份工程保持 57 个组件身份、103 个引脚连接;56 个非目标器件的全部属性、位置、变换和引脚状态完全不变。
RV05的 UID、Refdes、位置、方向、比例和网络连接保持一致,目标引脚编号非空;Part Number/Part Label/Value 符合上述策略。- 候选两份写前记录具有相同 batch session/generation、不同 attempt ID,并均为
mutation_possible。两个逻辑工程分别记录标记。 - 候选 BOM 和任务队列资源记录均为
released,无自动重试、恢复或已成功步骤的重放。 - 观察器确认所有拥有的 CAD 退出、私有桌面消失,输入桌面未切换,拥有的 CAD 未出现在用户桌面或成为前台窗口。
- 候选源代码/VBS 清单的 SHA-256 在实机执行期间保持一致。两个工程源副本及中心库
.lmc的 SHA-256 均不变。
关键证据:
comparison.jsoncandidate/report.jsoncandidate/desktop-observation.jsoncandidate/source-under-test-manifest.jsoncandidate/data/batch-resources/*/session.jsoncandidate/data/tasks/*/quick-run/batch-attempts/*/*.jsonbaseline2/read-only-verification/saved-verification.jsonbaseline2/{before,after}-Audio_D2128.json、baseline2/{before,after}-Audio_T605A.json及 candidate 对应文件
初次探针在 baseline 目录因属性 COM 对象未强制转为 IVdAttr 而停止,尚未执行替换。修复读取器后使用全新 baseline2 副本执行。baseline2 两次替换均已完成,随后旧核验断言误把默认关闭复制选项视为 Part Label 复制;保留原错误报告,依据既有 Value 策略修正独立预期,再仅补充缺少的磁盘读取。该补充过程没有调用队列、恢复或替换。原始错误记录和历史输出均保留。
复现
tools/probe_batch_runtime_live.py 使用服务层 BOM 导入和任务队列入口,自动创建全新工程副本,无恢复/重放选项。--repo 指向被测版本,工具本身保持相同。
$batchProbeRepo = 'F:/Sync Tool Skyworth/Work Maps/dxdesigner-part-replacement'
$batchProbeWorktree = "$batchProbeRepo/.worktrees/batch-runtime"
$batchProbeSources = "$batchProbeRepo/build/cbb-bom-import-live-20261015/projects"
$batchProbeLibrary = 'F:/Sync Tool Skyworth/Work Maps/Skyworth_CBB_Lib/Mentor_lib_EE7.9/mentor_lib.lmc'
$batchProbeOutput = "$batchProbeWorktree/build/batch-runtime-live-NEW-TIMESTAMP"
$batchProbeBaseline = "$batchProbeWorktree/build/baseline-e15ee25"
git -C $batchProbeRepo worktree add --detach $batchProbeBaseline e15ee25
python "$batchProbeWorktree/tools/probe_batch_runtime_live.py" --repo $batchProbeBaseline --source-root $batchProbeSources --library $batchProbeLibrary --output "$batchProbeOutput/baseline" --run-native
python "$batchProbeWorktree/tools/probe_batch_runtime_live.py" --repo $batchProbeWorktree --source-root $batchProbeSources --library $batchProbeLibrary --output "$batchProbeOutput/candidate" --run-native
基线须固定到 e15ee25 的独立目录;合入后原仓库已经是新实现,不能继续把原仓库当前 HEAD 当作旧基线。上述输出及基线目录均应使用尚不存在的新路径。
仅在两个任务均已完成而独立核验需补读时,可使用 --verify-existing <已有输出目录>。该分支只读已保存工程,不执行任务队列;核验结果写入独立的 read-only-verification 目录,且拒绝覆盖已有核验目录。