Files

77 lines
5.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 或发行包。