Files
mentor-export/docs/validation-2026-11-09-parallel.md

3.3 KiB
Raw Permalink Blame History

0.1.2 并发导出验收

2026-11-09。本机 Windows x64、Mentor EE7.9.5。默认每工程 3 个导出任务并发,工程顺序处理,同库缓存继续共享。--jobs 1 保留串行入口,最大并发 8。

自动测试及审查

python -X utf8 -m pytest -q:64 passed in 34.73s。

新增回归先失败后通过,覆盖独立副本上的真实调度重叠、并发上限、稳定输出顺序、快照与正文导出重叠、库件在 ASCII 就绪后提前运行、并发取消后收尾、CLI 参数传递、无效并发数、进程退出通知唤醒,以及强制收尾产物不能作为已验证结果复用。

独立审查确认协调线程独占工程记录写入,worker 使用独立状态与副本,同库分区缓存仍为单写入者。审查发现的强制结束后误入成功缓存已修正,普通导出和原生库读取都保留产物但标为提示;末轮针对进程等待与库缓存复查无待处理发现。

同输入实测

从之前已验收的两个真实工程复制固定输入,分别使用不可修改的 v0.1.1 发行包和最终 v0.1.2 发行包。每次是独立新进程和新批次,未用 --retry 代替首次导出。

项目 v0.1.1 串行 v0.1.2 默认 3 并发
两工程完整导出 156.015 秒 74.594 秒
取得的导出项 22 22
带提示项 0 0
批次退出码 0 0

本机样例耗时降低 52.2%,约为原速度的 2.09 倍。不同工程、磁盘负载及许可环境下不保证同一比例。

两工程逐一解析 EDIF 网表与 KYN:器件、字符串属性、物理引脚、网络及连接集合与串行结果完全一致。关联库件原生记录逐项完全一致。14 个工程输入文件摘要未变,工程内源数据库和源库检查均为 source_unchanged=true。

最终包复制到中文及空格目录,从 C:\Windows\Temp 通过真实 CMD 无参数问答启动,PATH 仅保留 System32,PYTHONHOME/PYTHONPATH 为无效目录。自动发现环境并使用预置 Python 成功。

随后使用 --retry --jobs 1 --yes 验证串行入口及重复使用:13.609 秒,退出 0,22 项成功产物校验后复用。664 个发行文件与 manifest、ZIP 内容均核对一致。

等待策略

固定 50 ms 轮询睡眠改为进程句柄等待,工具退出即唤醒;仍以最多 50 ms 检查用户取消和超时。正常后台进程保留最多 2 秒自然退出宽限期,等待与其他任务重叠。

曾以 0.25 秒宽限期测试,出现 14 项强制收尾提示,串行重试需重新导出并耗时 68.188 秒。最终保留 2 秒正常宽限期,解决重复运行退化;不靠过早终止后台进程制造加速。

证据

  • 串行基线及初轮对照:build/parallel-benchmark-20261109-141823/benchmark.json。
  • 最终实际问答、串行重试及逐项比较:build/parallel-release-acceptance-20261109-143025/acceptance.json。
  • 原始逐工具记录新增 started_at、tool_seconds、cleanup_seconds;工程记录新增 execution.jobs 与 execution.seconds。
  • 最终 ZIP SHA256:28616ced54ea893058d6dcde00025a9a72122814ae4f0021ee790ff9ed7bf22c。

本次未增加跨工程并发或原生库分区并发;主要加速来自独立导出任务并行、库件提前开始、快照探测重叠、进程退出通知及减少重复记录写入。