# Mentor PDF 批量导出 **v1.0.0 正式版 · Windows x64** 扫描 Mentor / DxDesigner 原理图工程,调用本机原生 `sch2pdf.exe` 串行导出 PDF。提供工程队列、参考配色、中文字体处理、失败重试和运行记录。 ## 下载与启动 从组织仓库的 **Releases / 发行版** 下载 `MentorPDFExporter-1.0.0-win64.zip`,解压整个文件夹,双击 `MentorPDFExporter.exe`。不能单独复制 EXE,必须保留 `_internal` 文件夹。 - 用户无需安装 Python。 - 本机必须安装 Mentor、拥有有效许可证,工程引用的中心库 / 依赖库必须可访问。 - 已验收环境:Windows 11 x64、Mentor EE 7.9.5。其他系统或 Mentor 版本需要另行验证。 - 源码目录中的 `Start-MentorPDF.cmd` 优先启动 v1.0.0 便携版,否则启动本项目开发环境。 ## 使用 1. 选择工程目录,点击 **扫描工程**。工具会递归识别原理图工程并排除 PCB、备份、输出和运行目录。 2. 选择位于源工程之外的 PDF 输出目录。 3. 确认自动发现的导出引擎;必要时手动选择本机 `sch2pdf.exe`。 4. 勾选工程并确认配色、字体和导出范围,点击 **开始批量导出**。 5. 完成后打开输出目录;失败项目可选中重试。运行中队列仍可滚动查看。 PDF 与原 `.prj` 文件同名,不加随机 / 摘要后缀。同名不同版本放入自然子目录,例如 `Work/PON.pdf` 和 `Cert/PON.pdf`。子集重试保留扫描时规划的目录。 依赖库沿用各原工程现有配置,不需要在本工具另选。中心库不是待导出的工程集合;库路径失效时,应先在 Mentor 中修复原工程配置。 ## 默认出图设置 - 工程参考配色,白底彩色,保留显式文字属性颜色与原有线宽。 - Arial 字体映射及中文宋体回退,修复 CP936 / GBK 旧工程文字。 - 整工程导出;也可指定真实原理图 / Block 名称。 - 不覆盖已有 PDF;只有主动勾选允许覆盖才会替换旧文件。 - 原生高级参数折叠显示,界面只保留操作控件与简短状态。 **普通 WinAnsi 工程请关闭 GBK 修复。** 不能将编码修复用于所有项目,也不能只凭“成功”状态代替最终 PDF 检查。安全可识别的英文笔画隐藏检索层会保留;无法安全处理的字体仍会明确失败。 ## 源工程与覆盖策略 工具直接读取原工程,**不创建工程工作副本、不备份旧 PDF**,不改工程字体 INI、全局 Mentor 配色、Windows 字体或父进程环境。独立打印配色只在本次导出子进程生效。 **直接导出不是只读保证。** Mentor 原生引擎可能更新数据库、运行记录,旧工程可能触发原生升级并产生引擎自身的升级备份。工具不擅自删除或回滚这些更新。 默认将已分类的数据库 / 运行记录更新记录为提示,不仅因此阻止有效 PDF 发布;图纸、配置、未知文件等变化仍会阻止发布。严格源检查会阻止任何受保护源变化后的发布,但不能撤销引擎已经写回的数据。路径分类也不能证明所有设计语义完全不变。 成功覆盖后工具不提供旧 PDF 恢复。停止任务不能回滚已发生的原生写回;成功出图后会等待原生后台写回完成,不强杀后台数据库服务。 ## 运行记录 默认保存在 `%LOCALAPPDATA%\MentorPDFExporter\runs`。界面显示简短进度、结果与错误;完整命令、引擎输出、PDF 检查和源变化记录可通过 **打开运行记录** 查看。日志可能包含工程路径或敏感文字,请按所在组织的要求保存,不要随源码上传。 ## 正式版交付 - 窗口、任务栏和 EXE 使用统一的原创 PDF 导出图标;不使用 Mentor / Adobe 商标图标。 - Windows 文件属性包含正式产品名称与 1.0.0 版本信息。 - 发布包附带使用说明、发布说明、第三方声明和 SHA-256 校验文件。 - 不分发 Mentor 二进制、许可证、工程、中心库、参考 PDF 或 Windows 字体文件。 - 验证范围和变更说明见 `CHANGELOG.md` 与 `docs/releases/1.0.0.md`。 ## 源码开发与构建 使用 Python 3.12 x64: ```powershell python -m venv .venv .\.venv\Scripts\python.exe -m pip install -r packaging/requirements-release.txt .\.venv\Scripts\python.exe -m pip install -e ".[dev]" .\.venv\Scripts\python.exe -m pytest -q .\.venv\Scripts\python.exe packaging/build_release.py ``` 构建结果位于 `release/MentorPDFExporter-1.0.0` 和 `release/MentorPDFExporter-1.0.0-win64.zip`。开发命令行支持 `python -m mentor_pdf_export --help`。 ### 发布维护 构建后运行 `python packaging/verify_release.py` 验收 EXE 与最终 ZIP。`packaging/publish_release.py` 默认只检查 `git.simgreek.com` 登录和组织可达性;加 `--publish` 后才会创建私有仓库、推送源码及正式标签、上传已验收的 ZIP 和校验文件。发布前需要完整回归记录、干净源码提交与匹配的版本标签。凭据只从现有 Git 凭据管理器读取,不写入源码、远端 URL 或发行包。