Mentor 工程批量导出 PDF 测试工具
独立 Windows 简易界面,扫描 DxDesigner 原理图工程,通过本机原生 sch2pdf.exe 串行导出 PDF。每个任务在独立工程副本中执行,不保存或改写源工程,不修改源工程的 dxpdf.ini。这是 v0.1.0 测试版,不是无需 Mentor 的独立转换器。
使用便携版
解压整个发行目录,双击 MentorPDFExporter.exe。不能只复制 exe,必须保留 _internal 文件夹。用户不需要安装 Python,但本机必须安装 Mentor、拥有有效许可证,工程引用的库必须可访问。
- 选择包含一个或多个工程的目录,点击“扫描工程”。排除 PCB、备份、输出、运行目录;会完整递归而不是根目录发现工程后提前结束。
- 选择源工程外部的 PDF 输出目录。工程名相同的项目通过路径摘要区分,不会互相覆盖。
- 检查自动发现的
sch2pdf.exe,必要时手动选择。 - 网络中心库不可达时,显式选择对应本地
.lmc。工具只修改工作副本的CentralLibrary,不改源工程;不会自动选择可能不匹配的库。 - 勾选工程,确认配置,然后开始导出。默认不覆盖已有 PDF。失败项可通过“选中失败项重试”重新执行。
- 可以停止当前任务及后续队列;仅结束工具启动的引擎进程树,不关闭用户的 DxDesigner。
配置与安全
- 默认白底彩色并保留彩色文字(
-c 4)、器件弹出菜单开启、可见超链接关闭、URL-valued 清空、ICT 转原理图开启、线宽 1。 Use exclusion info按截图保持勾选,它不等于“去掉文字掩盖”。不要为了掩盖问题直接关闭排除信息。- 整工程范围可能包含非顶层 Block;如只需要截图中的 Block 范围,选择“指定原理图 / Block”并填真实名称,例如
PON,不是Board1。 - 现有字体映射保留;笔画字体提供对照方式。不同工程的中文、特殊字符和背景掩盖效果仍须查看样张。PDF 结构成功不代表排版、中文及图页范围全部验收完成。
- 源数据库必须在工程内部,含外部数据库路径或链接的工程不执行,以免副本反而写回原数据库。
- 工作副本中排除 PCB、CES、ICXPro、Integration、备份与历史日志;不依赖这些目录的标准原理图工程已做验证,特殊外部依赖需要人工检查。
- 已有输出只有显式勾选覆盖后才替换。引擎正常退出且 PDF 解析成功、至少一页、源内容指纹一致后,才发布新文件。
日志
默认保存到 %LOCALAPPDATA%\MentorPDFExporter\runs。每次记录源工程指纹、实际命令、副本配置、stdout/stderr、PDF 页数/摘要以及结果 JSON,失败输出不会成为正式 PDF。发布前以原子写入并刷盘方式持久化提交预记录;覆盖前保留旧 PDF 备份。若提交后结果记录写入失败,会返回“待核验”并保留真实输出路径,不能当作完整成功。工作副本包含工程数据,请按公司要求保存;测试版不自动删除运行记录。
已确认的真实测试
本机 EE 7.9.5;PON 示例工程原引用 192.168.0.252 的网络中心库,首次默认路径导出超时且只产生空 PDF;在副本中显式使用本地对应库后正常导出 24 页。源工程参与复制的文件内容指纹一致。样张外部 URL 数为零。
默认样张部分中文批注存在乱码、浅色原理图对象对白底对比度较低,因此该版本只标为测试版,不把 PDF 结构验证当作最终出图质量验收。
额外安全保护
- 队列开始前统一检查全部源工程,防止 A 的输出目录误选到 B 的数据库中。
- CLI 报告仅允许
.json,拒绝写入源工程/运行证据目录或覆盖非本工具的 JSON;自动测试截图也不能写入源目录。 - 最后一次源内容核验在发布之前完成,不在覆盖旧 PDF 后才否决结果。
- 批量队列预记录写入失败时不启动引擎;末尾记录更新失败仍保留计数、内存结果和逐工程提交预记录。
- 打包排除构建机 PATH 中误发现的第三方 ICU DLL,使用与本机 Qt 轮子配套的 Windows 系统依赖。
- 当前真实验收环境为 Windows 11;尚未对其他 Windows 版本做兼容性验收。
开发
Python 3.12。安装依赖后:
$env:PYTHONPATH = "$(Get-Location)\src"
.\.venv\Scripts\python.exe -m mentor_pdf_export
.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\python.exe -m PyInstaller packaging\MentorPDFExporter.spec --distpath release --workpath build\pyinstaller --noconfirm
CLI:--self-check --report FILE;批量命令行:--export A.prj B.prj --output DIR --library LOCAL.lmc --report FILE;UI 自动测试:--project-root DIR --output DIR --library LOCAL.lmc --ui-smoke SCREENSHOT.png --ui-export-smoke --report FILE。
源码、测试和说明纳入 Git。原始文档、Mentor 工程、PDF、运行数据和发行产物不入 Git。无自动上传、联网更新或用户环境变量修改。