用途
kicad-export 面向 KiCad 工程的自动化导出流程,借助 kicad-cli 生成确定性的检查报告与制造、装配、文档、3D 等输出。核心目标是让每次导出可重复、可脚本化,便于按项目维护命令顺序。
主要能力
- 生成 ERC(电气规则检查)与 DRC(设计规则检查)报告,支持 mm 单位、warning/error 严重级别、退出码标记违规。
- 导出原理图 PDF、BOM、网表(kicadxml / kicadsexpr)、元件表。
- 导出 Gerber、钻孔文件(Excellon)、位置文件、PCB 布局 PDF(黑白、多页)、STEP 3D 模型。
- 渲染 PCB 顶层与底层 PNG 图(可设尺寸、透明背景、灯光参数等)。
- 针对 JLCPCB 与 NextPCB 生成专用 BOM。
使用方式
通过 kicad-cli 执行一系列命令,例如 sch erc、pcb drc、sch export pdf / bom / netlist、pcb export gerbers / drill / pos / pdf / step、pcb render 等。为保证确定性,建议将命令顺序写入 Python 或 bash 脚本并按项目修改。文档说明位于该技能的 references/ 目录下。
JLCPCB 与 NextPCB 的位置文件需要特定 CSV 格式:Designator、Mid X、Mid Y、Layer(T 或 B)、rotation 共 5 列。KiCad 不支持直接输出该格式,需使用 scripts/convert_position.py 转换。如果用户未安装 Python,需在修改其电脑前告知用户,除非用户已指定使用虚拟环境,或项目根目录下已存在虚拟环境。
JLCPCB BOM 还需要 LCSC 料号,需确保 JLCPCB BOM 预设可用,否则应告知用户需要添加。
适用场景
- 需要在 CI 或脚本中稳定导出 KiCad 工程检查与制造文件。
- 面向 JLCPCB、NextPCB 等制造商准备 BOM 与位置文件。
- 需要原理图、PCB 布局、3D 模型或渲染图等文档输出。
限制
- 依赖 kicad-cli 与 KiCad 项目文件(.kicad_sch、.kicad_pcb)。
- 位置文件格式转换依赖 Python 脚本 scripts/convert_position.py。
- JLCPCB BOM 依赖 LCSC 料号与 JLCPCB BOM 预设。
- 除非用户另有指定,DRC 与 ERC 错误会导致导出 FAILURE;出现 FAILURE 时可提示用户输入 OVERRIDE 以重新继续导出。
- 具体命令行参数、层级列表、预设内容等细节以参考资料为准;本文未提供的细节暂未提供。