Files
mentor-pdf-exporter/docs/testing/2026-10-10-v031-ui-fix.md
T

4.2 KiB
Raw Blame History

0.3.1 执行中队列浏览与源变化诊断(2026-10-10)

用户问题与根因

  1. 右上角“已找到 Mentor 原生引擎”不需要展示:移除 badge,仍保留引擎路径输入及导出前环境验证。
  2. 执行中队列无法上下浏览:旧 _set_busy 把整个 QTableWidget 禁用,滚动条和视图事件一并失效。
  3. “源工程在任务期间发生变化”是文件内容指纹不同,不等于用户手动修改图纸。只读分析用户已有运行记录 20261010-093135 至 20261010-093217:六个工程均出现 database/icdb.dat 的内容变化,并伴有事件/日志变化;部分工程新增数据库升级记录。Audio_D2128_SURGE_ESD 的原生升级日志明确记录约束定义升级、保存 DxD/Board1 等快照。该次 pdf-check.json 显示已生成 1 页原生 PDF,但最后源指纹不同,未正式发布。

这些证据说明不能把全部变化当作无害日志或缓存;尚未对设计语义/电路进行前后比较。本轮没有再次调用原生导出,没有改写/恢复用户工程,也没有删除原生引擎自身生成的 cdbback 升级备份。

修复范围

  • 表格保持启用,执行或扫描时仅锁定勾选项的 ItemIsUserCheckable 和配置/全选/清除/重试按钮。队列状态、结果、路径和滚动条可浏览;结束后恢复勾选。
  • 新扫描行也根据 busy 状态锁定,防止 scan found 与 finished 之间可以修改队列。
  • 清除日志占位、执行状态、单工程状态中的过时副本文案;仍不创建工程副本。
  • 源不一致时保留 uncertain、不发布、不覆盖旧 PDF,且写 source-diff.json,分 modified/added/removed;结果及日志列出部分路径,完整列表保存在运行证据中。不擅自忽略主数据库或其他变化。
  • 独立发布 0.3.1,保留先前发行版,启动脚本指向新版。

TDD 与自动验证

先运行新增测试:7 项失败,分别复现 badge 仍存在、scan/batch 全表禁用、真实等待 worker 时表格禁用、源变化没有具体文件信息、尚无 compare_fingerprints。

修复后新增测试 7 项通过,覆盖:

  • badge 移除但引擎输入保留。
  • 45 行队列在 scan/batch busy 中,滚动条实际键盘 End/Home 事件可以上下浏览;鼠标点击和空格键不改变已锁定勾选,结束后空格可正常改选。
  • 30 行队列真实 BatchWorker 运行(测试 runner 阻塞,不调用 Mentor)期间可浏览,停止后正常恢复,执行文案为直接模式。
  • 原生返回 0 或 9 且源文件发生修改/新增/删除时,结果仍 uncertain、旧 PDF 字节不变,source-diff.json 精确列出文件。
  • fingerprint 差异比较正确区分三类变化并排序,未修改的哈希不误报。

全量命令:.venv/Scripts/python.exe -m pytest -q --junitxml=artifacts/pytest-v031-ui-fix.xml。

结果:158 passed,73.03 秒,退出码 0。证据:artifacts/pytest-v031-ui-fix.log、artifacts/pytest-v031-ui-fix.xml。

已有原生记录只读分析:artifacts/v031-native-existing-run-analysis.json。

未解决边界

源变化的精确诊断已改进,但主数据库升级/更新问题没有通过关闭检查来“解决”。当前直接模式仍可能由原生引擎写回工程,指纹保护只能阻止发布,不能撤销这些源写入;不能把本次 UI 修复认定为原工程只读/无损导出验收。

便携修复版验证

  • 使用全新 workpath 构建 0.3.1,构建退出码 0。
  • EXE 内 14 个运行模块逐一与当前源码比较,全部一致。
  • ZIP 255 个文件、57300568 字节,CRC 和解压后 EXE 哈希检查通过。
  • 清理 Python/Qt 环境路径后,解压版环境自检及 UI-only 扫描均返回 0;扫描两个已有测试工程,没有请求原生导出、没有导出结果。
  • 已查看 artifacts/ui-v031-bundle.png:右上角无引擎 badge,界面中文可读,无明显控件遮挡。
  • 保留 0.3.0 等既有发行目录。新版路径 release/MentorPDFExporter-0.3.1;启动脚本 Start-MentorPDF.cmd 指向新版。
  • 本轮独立只读代码审查未发现阻塞问题。
  • 证据:artifacts/build-v031-ui-fix.log、artifacts/v031-bundle-source-check.json、artifacts/v031-package-report.json、artifacts/v031-zip-check-report.json、artifacts/v031-bundle-ui-report.json。