投产包管家（技术预览）

面向嘉立创 EDA 专业版的本地生产资料发布助手。它从当前 PCB 生成带清单和检查报告的制造资料包，帮助个人开发者、学生和创客减少漏文件、错版本和命名混乱。

MVP 能力

• 两种发布模式：
  • 仅制板：Gerber ZIP（包含 EDA 生成的钻孔资料）。
  • PCB + SMT：Gerber ZIP、BOM CSV、Pick and Place CSV。
• 可选导出 STEP 装配体。
• 导出前保存当前 PCB，并执行官方 PCB DRC。
• 检查空位号、重复位号、BOM 排除器件和缺失 3D 模型。
• 每个阶段核对当前 PCB UUID，避免切换文档后混合不同设计。
• 生成 manifest.json、check-report.txt 和 README.txt。
• 使用本地离线依赖 fflate 生成外层 ZIP；打包失败时降级为分别保存成功文件。
• 默认不访问网络、不上传设计文件、不创建订单。

重要边界

本扩展不是完整 DFM 系统：

• Gerber、BOM、贴片坐标、3D 和 DRC 等关键官方 API 当前为 BETA。
• DRC 和本扩展的完整性检查不等同于板厂 DFM。
• 本扩展不能保证资料一定可生产或一定被下单系统接受。
• saveFile() 完成不代表扩展能够确认用户最终选择的物理保存路径。
• 下单时通常应上传外层资料包中的 Gerber ZIP，而不是直接上传整个归档包。

生成后请使用 Gerber 查看器或嘉立创 DFM 做人工复核。

使用方法

1. 在嘉立创 EDA 专业版中打开 PCB，在顶部菜单选择“投产包管家 → 生成投产包...”。
2. 选择“PCB + SMT”或“仅制板”。前者包含 Gerber、BOM 和贴片坐标；后者只要求 Gerber。
3. 输入本次资料包的版本号，例如 1.0、A 或 EVT1。版本号只用于本次本地资料包，不会上传网络。
4. 选择“包含 STEP”或“不包含 STEP”，然后根据检查结果确认是否继续。
5. 保存生成的资料包，并在下单前使用 Gerber 查看器或嘉立创 DFM 人工复核。

界面演示

1. 选择投产包类型

2. 输入版本号

3. 选择 STEP 导出

环境

• Node.js >= 20.17.0
• 嘉立创 EDA 专业版 ^3.2.0
• 官方 SDK：easyeda/pro-api-sdk

开发

npm install
npm run check
npm run build

构建成功后，扩展包位于：

build/dist/manufacturing-release-pack_v0.1.0.eext

在嘉立创 EDA 专业版中打开“高级 → 扩展管理器”，导入该 .eext 文件。在 PCB 编辑器顶部菜单选择“投产包管家 → 生成投产包...”。

实机兼容性验证

发布前至少在桌面版和网页版分别验证：

1. 当前 PCB 获取与保存。
2. Gerber、BOM、贴片坐标、STEP 四个导出 API。
3. Gerber ZIP 中的板框、铜层和 PTH/NPTH 钻孔文件。
4. BOM/PnP CSV 的编码、列名和位号集合。
5. DRC 返回结果。
6. 大型 STEP 和 Gerber 的内存表现。
7. saveFile() 的下载/保存体验。
8. 外层 ZIP 能用 7-Zip 正常打开，且内层 Gerber ZIP字节未被修改。

隐私

• 不发起网络请求。
• 不采集遥测。
• 不存储账号或订单信息。
• 不记录 BOM 行、坐标正文、绝对路径或完整工程 UUID。
• 所有文件只在当前扩展运行内存中处理，并由用户保存到本地。

官方参考

• AI 插件初始化指南
• 接口稳定性说明
• Gerber 导出 API
• BOM 导出 API
• 贴片坐标 API
• 3D 导出 API
• 文件保存 API
• PCB DRC API

许可证

Apache-2.0。构建工具基于嘉立创 EDA 官方 pro-api-sdk。