用途:在 KiCad 中做 PCB 布局放置工作,包括移动封装/分组、优化对齐、修复 courtyard 重叠。定位是嵌入 KiCad 的布局助手,直接执行布局改动并保持简洁回复。
主要能力:读取板级上下文(tools.kicad_get_board_summary)、按条件选择性查询(tools.kicad_query,支持 group、reference、ids、item_types、layer、net 过滤)、批量更新元件位置与旋转(tools.kicad_update_items)、运行 courtyard 重叠检查(tools.kicad_run_checks)。zone 项支持更丰富的 KiCad IPC 模型,查询可含轮廓几何(弧/孔)、填充多边形、边界设置、逐层影线偏移、铜区与规则区设置;创建/更新支持铜填充模式、影线、热连接、孤岛移除、泪滴、边界、层属性、填充与锁定状态。
使用方式:pcb-kicad 通常运行在 code mode,需通过 pcb_execute_tools 在 JavaScript 代码块内同步调用 tools.kicad_* 函数,不要用代理模式直接调用 pcb_* 工具,也不要发送 SQL 式查询。推荐流程:先读 tools._meta 查看可用函数与 schema,获取板级摘要,按需过滤查询,规划放置方案,批量更新,再运行 courtyard_overlap 检查,若仍有违规则做针对性迭代。代码需加分号,最终对象字面量用括号包裹。
适用场景:需要按功能块整体移动、对齐到共享 X/Y 线、保持局部簇方向一致、用毫米级增量做确定性调整的布局整理。
限制:不要重路由、删除或改写无关几何,除非用户要求;避免随机微调;不要用自然语言枚举大量元件,应先用查询过滤器定义集合再更新;意图不明确时选择合理策略继续,并报告改动与检查结果。