Files
dxdesigner-part-replacement/docs/testing/2026-10-19-release-preparation.md

79 lines
9.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 可选封装与候选发布验收
## 本轮要求
用户确认三项:目标封装可选;排查并清理回归失败项;从最终冻结候选 ZIP 解压后验收 BOM、替换保存、旧数据升级及后台资源释放。本轮不创建远端 Release、不覆盖 V1.1.2 附件,不修改原工程或中央库,不改未跟踪 feedback。
未指定封装时,工具不读封装目录、不主动覆写 Cell Name,可后续与中心库同步;原生 Replace Part 本身可能更新库关联属性,不承诺封装始终保持旧值。明确选择封装时继续核验完整库证据、写入并保存重开检查。
## 回归失败归因与处理
| 原失败 | 原因及处理 | 证据 |
| --- | --- | --- |
| 构建检查 3 项 VBS 保护失败 | 抽取生产函数的测试夹具漏载新增 QPTargetCell,出现 VBScript 类型不匹配;补载真实函数,保留全部原断言 | release-candidate-gate-initial-20261019.xml;release-safety-fixes-20261019.xml |
| 旧彻底删除租约检查 | 旧测试要求执行期间绕过互斥,现有安全规则禁止修改;改为锁内拒绝、关系不变、释放后正常删除 | release-delete-final-20261019.xml:8 passed;包含 3 项未决队列证据保留 |
| 旧队列功能检查 | 重新运行,无当前失败,不因历史报告改动生产队列 | release-legacy-quick-run-initial-20261019.xml:34 passed;批处理功能初跑 59 passed,另有租约及性能失败 |
| 旧 UI 导入错误和 42 项失败 | 引用了已移除导出、QTableWidget 工程链表、扫描/手动跳过/单次无备份按钮、内嵌日志、同步读取、重叠 mutation worker;迁移到当前单工程任务、QTableView、目录创建弹窗、可回收日志窗口与串行 mutation 语义 | release-legacy-ui-initial-20261019.xml;release-ui-migrated-final-20261019.xml:23 passed |
| 销毁窗口后后台回调 | 补回销毁测试后发现真实缺陷:success/failed/finished 闭包访问已删除控件;增加 QObject 有效性检查,结束时仍移除 worker,禁止触碰已删除控件 | release-ui-destruction-20261019.xml 为失败记录;release-ui-lifecycle-final-20261019.xml:54 passed,含成功/失败两个销毁场景 |
| 初次构建无法收集 XLSX 测试 | 仓库 .venv 缺 openpyxl,构建安全停止;后续明确使用依赖齐全的安装版 Python 3.12,不跳过构建检查 | release-candidate-build-20261019.log 保留失败;后续构建另存日志 |
以上检查范围有重叠,不相加当独立总数。旧 UI 的 47 个用例没有被称为全部修复后逐项通过:已移除界面不再保留对应布局断言,仍有效的功能和安全意图迁移到当前 UI;新的 tests/ui 共 25 项(23 项加两个销毁分支)。没有 skip、xfail、放宽性能阈值或删掉有效证据保留检查来制造通过。
## UI 迁移覆盖对照
| 原意图 | 当前检查位置 |
| --- | --- |
| 读取/选择工程与位号、BOM 原地编辑 | tests/v1_1/test_project_task_ui.py;test_ui_workspace.py |
| 搜索、排序、回收站和确认删除 | tests/v1_1/test_ui_remediation.py;tests/ui/test_permanent_delete_ui.py |
| 确认前不执行、未命中完成、Value 策略变化停止旧确认 | tests/ui/test_trial_task_center_workflow.py |
| 规则勾选持久化、任务 Value 独立 | tests/ui/test_trial_task_center_workflow.py;test_value_options_layout.py |
| 已完成任务状态、重试、重复执行新轮次 | tests/v1_1/test_ui_batch_retry.py;test_new_round.py |
| 任务切换丢弃旧查询、执行期间只读浏览、归属不丢失 | tests/v1_1/test_ui_responsiveness.py |
| 常规 mutation 禁止重入,退出等待安全收尾,强制销毁回调 | tests/ui/test_trial_task_center_workflow.py;tests/v1_1/test_ui_remediation.py |
| 错误编号及日志格式、按需创建/关闭/重新打开日志 | tests/ui/test_ui_execution_feedback.py;tests/v1_1/test_lazy_components.py;test_execution_results_view.py |
| 小窗口和布局持久化 | tests/ui/test_value_options_layout.py;tests/v1_1/test_ui_workspace.py |
## 验收进度
源码修复与相关回归已完成。最终构建检查 692 passed;UI 生命周期相关 54 passed;队列与恢复相关 122 passed(千步性能单独执行)。这些检查范围存在重叠,不合并计数。
冻结候选 e2f76c3 的 BOM 实际操作已通过:两工程导出原 11 列模板,错误清单报告通过 2 / 失败 1,修正后报告通过 2 / 失败 0;确认保存后只有 RV05 启用,RV11 保留。两工程原生 CLI 采集与私有桌面清理有独立记录。真实 1.1.1 数据升级保留 2 个任务、1 条规则,未选封装迁移为空,原数据库哈希不变。
首次冻结替换在 DxDataBook 读取目标行时超时,两份副本均关闭未保存,未提交原生替换。后续只读 MTA/STA 探针未发现 UIA 异常,原生列表计数确为 0。检查发现验收夹具仍引用不存在的 S:\\mentor_lib.lmc,属于副本准备漏重绑定;不能据此认定冻结 UIA 接口失效。保留首次失败及诊断证据,另建 v2 副本并复制独立中央库后重验。STA 诊断脚本还出现大输出阻塞管道而超时,最终 Job 与桌面已释放;此记录不计为产品验收通过。
验收工具同步补齐:BOM 检查所有 CLI 尝试的资源清理,不能被后续成功记录掩盖;执行阶段读取本次新队列检查点,遇 failed/blocked/skipped 立即失败,不能只等待可能保留 RUNNING 的任务状态。相关反例先失败、修复后 10 passed;未修改产品任务状态语义。
修正夹具后的 v2 冻结验收通过:两工程(路径 370 / 143 字符)均完成替换及保存重开核验,执行总耗时 278.312 秒。独立新 CAD 回读证实 RV05 改为新料号、Part Label 与 Value 为 0R,RV11 料号与 Value 未变。层次与展开网络均比对 57 个器件、103 个引脚、22 个网络,除目标属性外其余 56 个器件、引脚与网络连接不变。日志窗口和新一轮检查通过;1221 次执行观察中主桌面未切换、文件均可读,自有 CAD 未出现在主桌面,进程及私有桌面已释放。原工程与中央库跟踪的 1033 个文件哈希均未变。完整证据在 build/packaged-optional-acceptance-20261019-v2。
独立千步模拟初测 40.90267 秒,未通过小于 30 秒的原门槛。审查确认并移除重复工作:同次队列准备对重复工程路径先去重;日志轮转正常分支合并 exists/stat,异常分支保留 pathlib 平台语义;已有日志目录先检查,避免重复失败的 mkdir。没有改 fsync、原子提交、逐步事件、实时身份戳或门槛。优化后独立模拟 22.52262 秒、峰值 2210321 字节,通过原门槛;这不是实际 CAD 替换速度。长路径、事件缓存、轮转与日志异常语义共 24 项通过。
上述 v2 冻结实机证据对应 e2f76c3 的产品代码,作为历史验收保留。以下为包含文件操作优化的最终冻结结果。
## 最终冻结结果
最终产品源提交为 e6ec267a26efedbab796207b8044533d02222350,构建检查 700 passed、1 条 pywinauto COM 模式提示。最终 EXE 的 8 个关键模块编译码与源码逐一核对一致,两个 VBS 与源码哈希一致。实际使用 ZIP 解压后的 EXE,未通过源码 GUI 代替最终包验收。
| 检查 | 最终结果 |
| --- | --- |
| BOM 模板与导入 | 保持 11 列;错误清单通过 2 / 失败 1,用时 6.203 秒;修正后通过 2 / 失败 0,用时 3.438 秒;保存前不写入计划 |
| 两工程顺序执行 | 路径 362 / 135 字符;两工程只替换 RV05,封装均留空;原生事务不含 target_cell 或 cell_catalog;保存重开核验成功,共 167 秒 |
| 独立属性回读 | 全新私有 CAD 分别读取磁盘工程,RV05 为新料号且 Part Label / Value 均为 0R,RV11 旧料号、Value 与 UID 不变 |
| 独立网络比对 | 每工程层次及展开网表各核对 57 个器件、103 个引脚、22 个网络;其余 56 个器件及全部连接不变,仅允许目标属性及已知引脚号显式化 |
| 完成后操作 | 替换结果与日志可打开、关闭后再打开;开始新一轮归档两份旧计划,任务恢复草稿,旧证据保留 |
| 1.1.1 升级 | 复用由真实旧 EXE 创建的旧夹具副本,由最终冻结 EXE 执行迁移;保留 2 个任务、1 条规则及原字段,封装迁移为空,旧数据库不变 |
| 后台资源与主桌面 | 执行期间 777 次观察均能读文件,主桌面保持 Default;自有 CAD 未进入主桌面或前台;执行及独立读取的 CAD、Job 和私有桌面确认释放,主 GUI 正常退出 |
| 原始数据 | 跟踪的 1033 个原工程及中央库文件哈希均未变;测试仅修改 build 副本 |
| 千步最终门槛 | 1000 步模拟、91 步模拟保存,含 tracemalloc,21.091375 秒,峰值低于 128 MB,通过原 <30 秒门槛 |
167 秒是这两工程的实测执行时间;千步模拟只测队列开销。两者不能混用,也不把历史候选与最终候选的时差全部归因于上述优化。控制器耗时包含工作进程阶段,CSV 的两层记录不能直接相加。
最终驱动曾因网络检查脚本移到新目录后无法导入 build/compare_speed_graphs.py 而停止。原 graph.log、退出码 1 及全部已完成阶段仍保留;修正脚本所在目录后只读续验通过,没有重复导入或替换。该历史失败及续验说明保存在紧凑证据中,未改成首次全绿。
本机最终冻结候选验收通过;未创建公开 Release、未覆盖 V1.1.2 附件。未声称覆盖所有机器或所有器件组合。
- [紧凑验收证据](evidence/2026-10-19-optional-cell-candidate.json)
- [各阶段耗时 CSV](evidence/2026-10-19-optional-cell-timings.csv)
- 本地完整证据及候选包:build/packaged-optional-final-20261019
- EXE SHA256:de21d56084d9adde155311c5679fd4ea2bca7b981e42cc1748fc72dbaba32c45
- ZIP SHA256:aee87aa879b61164731cab9914ea5c84b22f645ef016d55c915fa256db447d7b