From 5ad0c667325e4ae4e196bb472234e855213bc2ad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E7=99=BD=E5=8F=94?= <11794527+absfan@user.noreply.gitee.com> Date: Mon, 19 Oct 2026 13:48:37 +0800 Subject: [PATCH] docs: record native progress and library redraw live regression --- ...0-19-native-progress-and-library-redraw.md | 59 ++++++ ...19-native-progress-and-library-redraw.json | 196 ++++++++++++++++++ 2 files changed, 255 insertions(+) create mode 100644 docs/reviews/2026-10-19-native-progress-and-library-redraw.md create mode 100644 docs/testing/evidence/2026-10-19-native-progress-and-library-redraw.json diff --git a/docs/reviews/2026-10-19-native-progress-and-library-redraw.md b/docs/reviews/2026-10-19-native-progress-and-library-redraw.md new file mode 100644 index 0000000..0b17d75 --- /dev/null +++ b/docs/reviews/2026-10-19-native-progress-and-library-redraw.md @@ -0,0 +1,59 @@ +# 原生采集进度与库列表刷新修复 + +本轮处理两项执行稳定性问题,并继续只读核对封装映射。没有合并保存事务,没有减少采集、保存前或重开后的完整检查,未打包发布。 + +## 采集仍在工作时的超时误判 + +原生脚本在 CAD 内执行,外部调用在返回前无法取得它的 stdout。上一版本只有调用前后两次进度,采集超过 150 秒时,即使 CAD 仍在逐件读取,监控也可能请求停止。 + +原生宿主现在通过本次 attempt 专用的 ASCII 侧文件发布真实进度,常规更新按约一秒节流,并在阶段完成时发布。它在完成器件或引脚读取等原有进度边界产生,不使用独立定时器伪造活跃;卡住的 COM 调用仍会触发原超时保护。 + +监控只在 native_snapshot_read 阶段接收,逐项验证本次 token、初始监控 job、当前 job、父 stdout 序号、独立递增的原生序号、安全标记及计数。它只更新活跃时间和显示计数,不能推进 stdout 序号、把不安全阶段变成安全阶段,也不能形成任何保存成功证明。跨调用、跨 job、旧令牌、重复或不完整帧均不能延长等待。 + +取消文件仍先在原有安全边界检查,然后才尝试发布进度。侧文件暂时不能读写时,监控继续按原超时预算处理;可选进度 I/O 错误不覆盖真实读取错误,原生完整结果仍必须经过原有严格校验。监控主进度文件的非共享类 I/O 错误继续向上传递。 + +界面增加该阶段的中文说明“采集并核验器件完整状态”。新增 native_progress_frames 仅用来记录实际接收数量,切换 job 后归零,不参与成功判定。 + +## DxDataBook 刷新时的失效 UIA 行 + +首次新副本实机回归中,第一项在获取库行时失败:pywinauto 的 UIA wrapper 对已失效行读取到 control_type=None,查找包装类抛出 KeyError(None)。原始 traceback 位于 build/native-progress-formal-bom-20261019/ 的 native JSON。该项停在提交原生替换之前,关闭工程未保存;第二项继续正常保存。这一轮为 1 成功 / 1 失败,报告保留 verified=false,源工程哈希不变,两个自有 CAD 与私有桌面释放通过,不计作成功验收。 + +wait_for_library_rows 现在只对这个明确的 KeyError(None) 重新读取列表,清空之前的稳定期并重新等待稳定,沿用原 30 秒总期限。持续失效会超时;其他 KeyError 或运行错误直接抛出。没有重试替换、点击提交或任何 CAD 写入。回归反例先复现 2 failed / 7 passed,修复后相关组 49 passed。 + +## 封装映射诊断 + +使用另一个私有 CAD 会话,在成功工程的新副本上只读获取属性层,确认: + +| 位号 | 保存料号 | Part Name | Cell Name 的 Value / InstanceValue | +| --- | --- | --- | --- | +| RV05(已替换) | 4100-CA0000-T0 | RESC1608N | 空 / RESC1005N_0402 | +| RV14(已替换) | 4100-CA0000-T0 | RESC1608N | 空 / RESC1005N_0402 | +| RV11(未替换) | 4100-CA0000-T7 | RESC1005N | 空 / RESC1005N_0402 | + +旧 Cell Name 作为实例属性保留,不能仅以 Part Name 更新认定 PCB 封装同步成功。当前恢复代码只恢复 Comment/Notes/User_ 等实例值,其余属性只恢复显示样式;该 Cell Name 不是本轮显示恢复把旧值写回的结果。但本次没有取得替换提交后、恢复前的独立采样,不能进一步声称已经证明原生替换内部如何处理了该实例。 + +目标料号的权威 Cell 映射及多候选选择规则仍未确认。本轮没有按名字推断封装、清空实例值或直接覆写。下一步应先取得目标库允许的 Cell 集合,再验证替换后的有效 Cell 和保存重开结果,遇到歧义时停止。独立属性层证据留在 build/cell-instance-read-20261019/report.json,来源哈希及自有会话释放通过。 + +安装中还发现 pdbext.exe / pdbquery.exe,隔离桌面下的 -h 探针均未在十秒内给出命令行帮助,已由自有 Job 清理;没有把它们接入生产,也不将它们称作可用替换 CLI。 + +## 定向回归与审查 + +- 原生采集、运行时组合、监控、阶段计时、执行反馈、会话、安全及恢复:110 passed,59.13 秒。 +- 追加跨 job 和失效监控 job 边界:13 passed,0.67 秒;其中 11 项已在上述套件,不将两组直接相加。 +- 库目标就绪、自动替换及安全:49 passed,8.88 秒;安全文件与上述套件有重叠,不把数量相加作为独立用例总数。 +- 实际子进程仅用侧文件、没有 stdout 心跳,运行超过设置的 idle 限制仍正常完成;旧版相同反例会误超时。持续重放、旧调用、旧 job、错误计数、安全标记改变及不完整行不能延长等待。生成器覆盖不能写进度文件、会话初始/当前 job 不同以及不安全阶段保留取消请求的路径。 +- 独立只读审查未发现 Critical/Important 问题,覆盖进度与完整证明的隔离、取消、计数重置和 UIA 只读重试。生产提交为 `911afdf`。 + +超大页仍缺真实规模认证;短 idle 的子进程反例不能代替所有复杂工程实测。180 秒样例目标、千步队列性能和 Cell 映射等既有发布缺口没有因本轮测试通过而自动关闭。 + +## 修复后完整 BOM 实机回归 + +另建 build/native-progress-formal-bom-20261019-v2/ 副本,重新走创建任务、导出默认模板、数值料号失败提示、修正文本、导入预览确认、正式替换、逐项保存重开、独立库存和 ASCII 导出。RV05/RV14 两项保存成功、零失败,料号为 4100-CA0000-T0,Value 分别为 0R 和 0R/NC,原 UID 保留。 + +完整队列耗时 **188.937 秒**,上一轮为 189.250 秒,基本持平;本轮不声称取得新的吞吐量提升。最后一项记录实际接收到 **8 条**原生进度,未触发 stop_requested。两项共 6 次完整原生采集;首项快照排除 M 行后仍为 120 行,与上一轮内容多重集完全一致。 + +独立层级、扁平导出均确认 57 个器件、103 个引脚、22 个网络;55 个未选中器件、全部引脚连接和网络关系不变,完整最终图与上一轮结果完全相等。来源工程哈希未变,自有 CAD 和私有桌面释放,未抢主桌面前台。启动时记录四个执行模块的哈希,完成后与当前源码核对一致。 + +这一轮没有额外重跑故障恢复实机;恢复代码经过定向回归,上一轮完整只读恢复的证据继续按其版本边界保留。UIA 瞬时失效的重试由反例测试证明,新实机成功本身不证明该瞬时错误在本次再次发生过。 + +机器证据:[JSON](../testing/evidence/2026-10-19-native-progress-and-library-redraw.json)。没有以首次失败回归的部分成功覆盖最终结论,两个原始报告均保留。 diff --git a/docs/testing/evidence/2026-10-19-native-progress-and-library-redraw.json b/docs/testing/evidence/2026-10-19-native-progress-and-library-redraw.json new file mode 100644 index 0000000..b5cca96 --- /dev/null +++ b/docs/testing/evidence/2026-10-19-native-progress-and-library-redraw.json @@ -0,0 +1,196 @@ +{ + "date": "2026-10-19", + "production_commit": "911afdf", + "code_hashes": { + "integration/dxdesigner795/QuickPartReplace.vbs": "102be388b4878156c72d40eb0c6bf7bdd2e51295b80560635b482e1e6816babb", + "src/dx_productivity/trial_task_center/native_helper.py": "099760ad648b47f92993aed62d039c05a584dae41e2e14a2b59fb50df8fcf527", + "integration/dxdesigner795/NativeSnapshotReader.vbs": "9ad8c7e297bea649e938af02dc3187a636c26e384a1763ebdaad09f0063d5ad0", + "src/dx_productivity/trial_task_center/worker_monitor.py": "8d15942a29e14555f09d771949ec5788243d545f140de87e3a06fb9ac702b460" + }, + "regressions": { + "native-progress-final-20261019": { + "tests": "110", + "failures": "0", + "errors": "0", + "time": "58.810" + }, + "native-progress-job-guards-20261019": { + "tests": "13", + "failures": "0", + "errors": "0", + "time": "0.514" + }, + "native-library-redraw-final-20261019": { + "tests": "49", + "failures": "0", + "errors": "0", + "time": "8.744" + } + }, + "overlap_note": "Suites overlap; do not sum their counts. Two of the 13 job guards were added after the 110-case run.", + "formal_bom": { + "verified": true, + "seconds": 188.93699999997625, + "previous_seconds": 189.25, + "timing_note": "Essentially unchanged; this revision improves liveness and transient read handling, not demonstrated throughput.", + "saved_items": 2, + "failed_items": 0, + "native_full_reads": 6, + "accepted_native_progress_frames_last_job": 8, + "source_hashes_unchanged": true, + "snapshot_rows_equal_excluding_M": 120, + "graph_summary": { + "hier": { + "component_count": 57, + "pin_count": 103, + "net_count": 22, + "unchanged_components": 55, + "all_pin_connections_unchanged": true, + "net_graph_unchanged": true + }, + "flat": { + "component_count": 57, + "pin_count": 103, + "net_count": 22, + "unchanged_components": 55, + "all_pin_connections_unchanged": true, + "net_graph_unchanged": true + } + }, + "previous_result_graph_equivalence": { + "hier": { + "equal": true, + "components": 57, + "pins": 103, + "nets": 22, + "sha256": "32b36adbef100db505ea3d98ca628d50a94c91826d7289d90e473b3f9c864a31" + }, + "flat": { + "equal": true, + "components": 57, + "pins": 103, + "nets": 22, + "sha256": "acbb89d93ebd3dc35f7d4b794df943c2ef5d164a0fb0c1626c432d2a0aa5b033" + } + } + }, + "isolation": { + "cad_exit_confirmed": true, + "desktops_released": true, + "input_desktop_unchanged": true, + "owned_cad_became_foreground": false, + "owned_cad_on_input_desktop": false, + "observer_errors": [] + }, + "first_failed_live_run": { + "verified": false, + "saved_items": 1, + "failed_items": 1, + "cause": "UIA row wrapper observed control_type=None during DxDataBook redraw; KeyError(None) before replacement submission.", + "first_item_closed_without_save": true, + "source_hashes_unchanged": true, + "preserved_root": "build/native-progress-formal-bom-20261019" + }, + "cell_instance_probe": { + "source_hashes_unchanged": true, + "owned_session_released": true, + "components": [ + { + "uid": "$2I2022", + "refdes": "RV11", + "effective_attributes": { + "Part Number": "4100-CA0000-T7", + "Value": "0R", + "Part Name": "RESC1005N", + "Part Label": "0R", + "Cell Name": "RESC1005N_0402" + }, + "attribute_layers": { + "Part Number": { + "base": "4100-CA0000-T7", + "instance": "" + }, + "Part Name": { + "base": "", + "instance": "RESC1005N" + }, + "Cell Name": { + "base": "", + "instance": "RESC1005N_0402" + } + } + }, + { + "uid": "$2I1766", + "refdes": "RV14", + "effective_attributes": { + "Part Number": "4100-CA0000-T0", + "Value": "0R/NC", + "Part Name": "RESC1608N", + "Part Label": "0R", + "Cell Name": "RESC1005N_0402" + }, + "attribute_layers": { + "Part Number": { + "base": "4100-CA0000-T0", + "instance": "" + }, + "Part Name": { + "base": "RESC1608N", + "instance": "" + }, + "Cell Name": { + "base": "", + "instance": "RESC1005N_0402" + } + } + }, + { + "uid": "$2I2014", + "refdes": "RV05", + "effective_attributes": { + "Part Number": "4100-CA0000-T0", + "Value": "0R", + "Part Name": "RESC1608N", + "Part Label": "0R", + "Cell Name": "RESC1005N_0402" + }, + "attribute_layers": { + "Part Number": { + "base": "4100-CA0000-T0", + "instance": "" + }, + "Part Name": { + "base": "RESC1608N", + "instance": "RESC1608N" + }, + "Cell Name": { + "base": "", + "instance": "RESC1005N_0402" + } + } + } + ], + "conclusion": "Old Cell Name persists as instance override. Target-library authoritative Cell mapping remains unproven; no Cell mutation implemented." + }, + "review": { + "critical": 0, + "important": 0, + "read_only": true + }, + "limitations": [ + "Actual very large pages, complex hierarchy and multi-gate cases remain uncertified.", + "Sidecar progress does not prove saved correctness; original full snapshots/save/reopen remain required.", + "No new speedup claim: same-source 188.937s versus previous 189.250s are single runs.", + "PCB Cell mapping remains a release gap; no inferred or forced Cell values.", + "Existing 1000-step simulated performance threshold remains unresolved and was not rerun.", + "No package or release performed." + ], + "raw_evidence_roots": [ + "build/native-progress-formal-bom-20261019", + "build/native-progress-formal-bom-20261019-v2", + "build/native-progress-ascii-result-20261019", + "build/cell-instance-read-20261019", + "build/pdb-cli-help-20261019" + ] +}