SuperAPI AI 工具集

kicad-export

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

kicad-export 是一个面向 KiCad 项目的导出技能,核心工具是 kicad-cli。它的目标是为 ERC、DRC、制造、装配、文档和 3D 导出生成确定性的输出,做法是把命令顺序保存到 Python 或 bash 脚本中,并按项目进行修改,从而保证每次导出结果可复现。

用途方面,该技能覆盖从设计规则检查到生产文件生成的完整流程。它先解析相关文档,使用必要项生成 ERC/DRC 报告,然后根据用户指定的制造商创建 GERBER、钻孔文件、位置文件和 BOM 文件。

主要能力包括:

  • 生成 ERC 报告(kicad-cli sch erc),支持指定输出路径、报告格式、单位、严重级别和违规退出码。
  • 生成 DRC 报告(kicad-cli pcb drc),支持重新填充铺铜、原理图一致性检查等选项。
  • 导出原理图 PDF、BOM、网表(kicadxml 和 kicadsexpr 格式)以及自定义字段的组件 CSV。
  • 导出 GERBER、钻孔文件、位置文件、PCB 布局 PDF、STEP 3D 模型以及顶/底面渲染图。

使用方式上,技能提供了参考文档目录(references/)用于确定需要使用的 PCB 和原理图输出命令。示例命令集包括 kicad-cli version、sch erc、pcb drc、sch export pdf、sch export bom、sch export netlist、pcb export gerbers、pcb export drill、pcb export pos、pcb export pdf、pcb export step 和 pcb render 等。

针对制造商适配:JLCPCB 和 NextPCB 要求位置文件为特定格式,即包含 5 列的 .csv 文件:Designator、Mid X、Mid Y、Layer(T 或 B)和 rotation。KiCad 本身不支持该格式,因此需要使用 scripts/convert_position.py 脚本进行转换。如果用户未安装 Python,在修改其计算机之前需要先告知用户,除非用户已指定使用虚拟环境,或在该技能被调用的项目根目录下能看到虚拟环境。JLCPCB 的 BOM 还需要 LCSC 料号,需确保 JLCPCB BOM 预设可用,否则应告知用户需要添加。

适用场景:需要为 KiCad 项目生成可复现的制造与装配输出,尤其是面向 JLCPCB、NextPCB 等制造商准备生产文件时。

限制与注意事项:除非用户另有说明,DRC 和 ERC 错误会导致导出失败(FAILURE)。出现失败时,可以提示用户:“Should we proceed with export? Please reply with OVERRIDE to restart.” 用户回复 OVERRIDE 后可继续。位置文件转换依赖 Python 环境;JLCPCB BOM 依赖 LCSC 料号和预设。