Files
dxdesigner-part-replacement/docs/reviews/2026-10-15-code-pruning.md

4.9 KiB

1.1.2 代码精简与启动/BOM 审查

审查起点:136d7ff。本轮不打包、不发布,不启动 CAD;原始工程、BOM 与既有实测证据不参与写入。

结论与已处理项

代码确实有历史包袱,但不能按文件大小直接删除。审查起点 Python 生产源码 86 个文件、22,564 行,其中旧 part_replace 为 7,503 行;测试目录约 30,337 行,不属于生产包源码。通过检查 GUI、CLI、VBS 动态调用和打包入口,本轮确认并处理以下内容。

  1. 删除 ui/project_table.py 的孤立工程列表控件(122 行)。当前窗口使用单工程摘要与位号计划;生产代码、工具、菜单和打包配置均未引用旧控件。
  2. 删除 TargetTable.item() / _CellAdapter。它们只为测试模拟旧 QTableWidget 接口;相关用例现直接通过真实 QTableView model 修改、勾选与读取,排序后的 UID 绑定覆盖继续保留。
  3. 删除未使用的私有导入,保留真实使用的批量备份、协议和包导出。
  4. 合并 BOM 普通预览与报告校验引擎。preview_batch 保留严格调用接口,以同一份 inspect_batch 结果返回预览或报错,不再独立维护采集、路由、匹配和编辑保留逻辑。
  5. BomMatcher 对一个工程的位号清单只建立一次索引,逐行仅返回实际命中的目标。每行校验与最终合并校验均保留,继续拒绝重复目标、歧义位号、替换链和循环;未导入位号的原编辑保留。
  6. 修复损坏 Excel 在普通预览中被误报为未处理异常的问题;按 BOM 导入错误报告。
  7. 修复读表过程中取消被 ValueError 捕获并转成 BOM 错误的问题。TaskCenterError 是 ValueError 子类,需先传播操作异常;inspect/strict 两入口均验证保留 operation_cancelled,没有采集或部分保存。
  8. 启动恢复统一由 runner 完成,删除 application 提前恢复。旧顺序会先修改数据库,使 runner 来不及记录恢复前/后事件。迁移恢复、确认迁移记录和旧运行任务协调均保留。
  9. 通过按中断状态过滤的一次 SQL 查询替代逐任务读取工程;30 个空闲任务场景不再产生 30 次逐任务工程读取。
  10. Windows 启动诊断改用 sys.getwindowsversion(),避免仅为了记录 OS 信息就启动 WMI 查询。审查期间真实遇到 platform._wmi_query 的 0x8007000e 异常;这项修正与 CAD COM 绑定问题分别处理。

生产源码相对起点净减少 186 行,减少 1 个模块。新增的索引类替代重复构建和扫描,不是简单把大文件挪到另一个文件。

保留依据

范围 仍存在的调用
旧 part_replace CLI pyproject 公开入口、python -m dx_productivity、Start-PartReplacement.ps1 的 discover/status/create/operator-step
人工 runner / comparison / evidence 旧服务入口、历史任务恢复、迁移事件与证据校验;GUI 的规则检查仍跨包复用 inputs
SceneOS application 的 --sceneos-cli 分派仍存在
菜单和 VBS 桥 MenuRuntime 的 ExecuteGlobal 动态加载,不能仅依靠 Python import 搜索判死
QuickPartReplace / native_helper 当前原生替换、私有桌面子进程仍使用,打包配置显式包含 VBS

quick_run.py、service.py、store.py 仍然偏大。进一步分职责需要检查协议和兼容入口;本轮未引入另一套执行架构或删除仍被调用的功能。

验证

  • 位号编辑、排序和单工程 UI:11 passed。
  • BOM、库存扩展、事务、任务上下文、UI 草稿和重复轮次选定回归:99 passed,31.19 秒。
  • 启动、旧人工流程和应用引导:37 passed,21.39 秒,包括历史迁移恢复和恢复前/后事件。
  • 审查末尾读表取消与启动恢复检查:12 passed,23.55 秒。上述检查有重叠,不相加为总用例数。
  • 另运行真实 Qt 的 offscreen 应用启动/关闭 smoke;数据目录位于 build/code-pruning-startup-smoke-20261015。
  • 只读复核代理确认原生保存/恢复事务、目标身份、NC 与 Value 处理边界未削弱;其指出的读表取消错误已修复。

BOM 模拟规模测量

使用 1000 个模拟位号、真实 XLSX 的 200 条替换行,包含工程匹配、逐行校验和预览构建,不启动 CAD。

版本 结果
精简前 探针进程运行 285.36 秒仍未完成,主动停止;该值包含建库和生成模板,不能视为完整匹配耗时
精简后 校验阶段 5.920 秒,200 行通过、0 行失败,1000 个位号中恰好启用 200 个

临时探针位于 build/probe-bom-scale-audit.py,前后结果分别保留在 build/bom-scale-before-20261015/metrics.json 和 build/bom-scale-after-20261015/metrics.json。未将一次性探针加入生产代码。

此结果不能换算成完整 CAD 替换速度。上一轮千步执行测试未达到 30 秒目标、CAD COM 启动偶发阻塞,仍是独立的未解决项。