关于 kicad-panelize
kicad-panelize 是帮助 Agent 使用 KiKit 制作 KiCad PCB 拼板的技能,涵盖板框检查、参数配置、生成和结果验证,并要求保留源板文件。
主要功能
- 01检查板框与边缘器件
- 02配置阵列、连接桥、框架和工艺孔
- 03生成版本化拼板且不覆盖源文件
- 04检查拼板文件与渲染图
适用场景
- 01为单板 KiCad 设计制作拼板
- 02为边缘连接器或邮票孔设置连接桥
- 03安排工艺孔和基准点
- 04检查生成的拼板几何
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ backplaneworks/ kistack --skill kicad-panelize安装后在 Claude Code 中输入/kicad-panelize确认已加载。
详细介绍
PCB 拼板技能
设置
确保已安装 KiKit,并运行 kikit --version 检查
添加参数前,请检查此安装中的 resources/panelizePresets/default.json 和 panelize_ui_sections.py;它们就是准则、真理与指引。
用法
- 查找用户要求处理的源文件 .kicad_pcb
- 检查其实际板文件、Edge.Cuts、铜层、焊盘,以及可能与板边相交的元件,以识别半孔、板边连接器、天线、镀边等项目。
- 确定网格尺寸、间距、旋转、连接桥、分离方式、框架和制造商限制。
- 根据拼板轮廓定位工艺孔和基准点。
- 编写严格的 JSON。
- 在 "build" 子目录中生成带版本标记的拼板文件,不要覆盖源文件。
- 通知用户前检查生成的拼板,确保从板文件层面和渲染效果来看都符合要求。
首选起始值
- 板边铣削间隙:2mm
- 连接桥宽度:3mm
- 鼠咬孔钻孔直径:0.5mm
- 鼠咬孔间距:0.8mm
- 鼠咬孔偏移:0mm
- 完整框架宽度:5mm
- 框架到阵列的间隙:2mm
- 框架断开切口:无
- 外侧框架圆角:2mm
- 内侧铣削圆角:0.25mm
- 工艺孔:三个 1.5mm 孔
- 启用工艺孔模板开口
- 基准点:三个,1mm 铜层,开口为 1mm
- 禁用基准点锡膏开口
KiKit 行为
-
对于普通的单板文件,source.type: "auto" 是合适的。
-
tabs.type: "spacing" 会对称放置连接桥,且无法排除特定的一侧。
-
使用固定连接桥时:
- hcount 控制从左/右边伸出的连接桥数量。
- vcount 控制从上/下边伸出的连接桥数量。
- 数量设为零会取消对应方向的连接桥。
-
只有在必须排除选定线段或某一侧时,才使用标注连接桥。
-
必须根据每块板的几何形状和旋转角度推导需要保护的连接桥方向。切勿将“底部”或“右侧”硬编码为通用规则。
-
全局鼠咬孔切割方法会处理所有生成的切割路径,包括 framing.cuts。
-
因此,使用鼠咬孔时,framing.cuts: "both" 会在框架横梁上钻出断开孔列。
-
要使用连续框架,请将 framing.cuts: "none"。
-
工艺孔和基准点的偏移量是从拼板外边缘向内测量的。
-
要使特征位于 5mm 框架的正中间,请使用 2.5mm 的垂直偏移量。
-
数量和偏移量相同的工艺孔与基准点会重叠。请沿框架将它们错开。
-
paste: true 表示会在模板的锡膏层上为该特征生成开口。它不会控制钻孔是否可见。
-
framing.fillet 用于圆化拼板外角。
-
post.millradius 用于圆化内凹的铣削转角。
-
post.reconstructarcs: true 会生成真实的 Edge.Cuts 圆弧,而不是由密集线段近似而成的圆弧。
实用命令
python3 -m json.tool panelize.json kikit panelize -p panelize.json input.kicad_pcb output-panel.kicad_pcb
使用以下命令转储合并后的完整 KiKit 配置:
kikit panelize -p panelize.json -d resolved.json input.kicad_pcb output-panel.kicad_pcb
渲染并打开:
kicad-cli pcb render
--output panel-top.png
--width 1600
--height 1200
--side top
--background opaque
--quality high
panel.kicad_pcb
kicad-cli pcb render
--output panel-iso.png
--width 1600
--height 1200
--perspective
--rotate 325,0,35
panel.kicad_pcb