docs: add fixed-layout IPC routing lessons for v1.3.0
This commit is contained in:
1 parent
fcbde2e9cf
commit
7ec66f26a4
4 files changed
+89
-6
No files matched your search
@@ -2,6 +2,8 @@
|
||||
|
||||
用户指定 PCB 设计过程中使用这两个工具。本文件规定分工和工程交接;路由参数的完整说明按需读取本机 [kicad-routing-tools 技能](D:/AI软件/codex-skills/kicad-routing-tools/SKILL.md)。路径或版本变更时核实实际安装,不从旧记录推断能力。
|
||||
|
||||
遵守当前会话及适用 AGENTS.md 的工具执行约定:整个工作流无界面运行。只调用不会启动、附着或聚焦 KiCad GUI 的 MCP 方法;不能确认无界面时,改走 KiCad CLI、文件接口、脚本或 API。不得启动 GUI 来确认当前打开的工程、预览结果或执行检查;没有无界面替代方案时报告限制。
|
||||
|
||||
## 分工与入口
|
||||
|
||||
| 工具 | 用途 | 本机入口 |
|
||||
@@ -12,19 +14,20 @@
|
||||
|
||||
2026-09-14 实测 MCP 3.34.3、KiCad CLI/IPC 10.0.3,服务当时为只读模式;这是环境快照,不能作为以后写操作已启用的依据。调用 `kicad_get_version`、必要时 `kicad_get_server_info` 核查能力/模式;用 `kicad_set_project` 绑定已确认的 PCB/原理图路径,再取工程信息及 `project_get_next_action`。工具建议不能覆盖用户限定的阶段。发现的工具元数据、调用参数和运行时能力优先于静态工具清单。
|
||||
|
||||
KiCadRoutingTools 本机版本 0.22.0,根目录 `D:\AI软件\KiCadRoutingTools-0.22.0`,Python 为 `D:\AI软件\kicad-routing-env\Scripts\python.exe`。通过 `krt.ps1` 使用 KiCad Python 3.11 和正确路径;不要混用 MCP 的 Python 3.13 环境。命令使用绝对路径并对路径、网络通配符加引号;先读相应命令帮助。
|
||||
2026-10-08 工程实测 KiCadRoutingTools 0.22.1,根目录 `D:\AI软件\KiCadRoutingTools-0.22.1`,专用 Python 为 `D:\AI软件\kicad-routing-env\Scripts\pythonw.exe`。这是本机快照,执行时仍检查实际路径、版本和 CLI 帮助;Windows 使用已验证的无窗口启动器及无窗口子进程配置,不只凭脚本名判断。运行时采用 KiCad Python 3.11 和正确路径,不混用不能加载 pcbnew 的 MCP Python 环境。命令使用绝对路径并对路径、网络通配符加引号;先读相应命令帮助。
|
||||
|
||||
## 同一工程的交接
|
||||
|
||||
1. 对齐 MCP 活动工程、GUI 实际打开的 PCB、磁盘输入和同名 `.kicad_pro`/`.kicad_dru`。已打开一块板不证明它就是请求对象;识别未保存状态,不覆盖用户编辑。
|
||||
1. 对齐 MCP 绑定工程、磁盘 PCB 输入和同名 `.kicad_pro`/`.kicad_dru`;仅以明确确认的磁盘路径为准,不依赖或检查 GUI 当前打开的工程状态。
|
||||
2. 用 `copy_board.py` 成套复制到独立候选路径,并确认自定义规则和库依赖齐全。修改限定于授权对象;固定布局任务禁止调用布局优化器移动器件。
|
||||
3. 对同一工程可能写入的 GUI/MCP、CLI 布线、填铜、DRC 和保存串行执行。外部文件更新后重新加载/绑定并读回确认,再做下一次编辑;禁止用 GUI 旧内存板覆盖磁盘新结果。
|
||||
3. 对同一工程可能写入的 headless MCP、CLI 布线、填铜、DRC 和保存串行执行。外部文件更新后通过文件接口重新加载/绑定并读回确认,再做下一次编辑;禁止用进程内旧内存板覆盖磁盘新结果。
|
||||
4. 原生工具缺少某类操作时,可在独立副本用版本匹配的 API 或经验证的文件变换完成必要几何工作。保留两工具的工程核查和独立验收,不以自编脚本全面替代它们。
|
||||
5. 某工具或能力不可用时报告具体原因和未执行项,继续无依赖且获授权的工作;不能假称调用成功,也不能将缺失验收记为通过。
|
||||
|
||||
## 路由约束与最终验证
|
||||
|
||||
- 指定线宽、线距、过孔时使用适当的 `--escalation off`。不采用默认降级来获得表面连通,不擅自启用 `--clearance-ceiling` 或 `--relax-drc-severities`。即使用 `--no-fix-drc-settings`,仍比较前后工程规则,0.22.0 可能写入输出工程下限。
|
||||
- 使用 KRT 不等于获得自动布线授权。项目禁止自动布线时,只使用获准的检查、复制、文字整理或明确路径局部编辑;不调用自动路由入口。丝印工具也应先确认只改变文字/图形,核对封装位姿和铜几何没有被移动。
|
||||
- 指定线宽、线距、过孔时使用适当的 `--escalation off`。不采用默认降级来获得表面连通,不擅自启用 `--clearance-ceiling` 或 `--relax-drc-severities`。即使用 `--no-fix-drc-settings`,仍比较前后工程规则,部分版本可能写入输出工程下限。
|
||||
- 路由结束核查失败、开路、多端网络和实际铜连接,不以 routed 数量表示成功。
|
||||
- 对最终保存版本执行 KiCadRoutingTools `check_connected.py`、按实际项目规则配置的 `check_drc.py`,以及原生 KiCad 填铜后的 DRC。检查独立工具默认跳过的项目,例如焊盘到板边;由原生或其它适用检查覆盖并披露范围。
|
||||
- MCP 重新绑定最终结果,核对工程、叠层、规则和适用的原理图/PCB 一致性检查。MCP 若调用同一原生 CLI DRC,不算额外一次独立算法验证;不为凑次数重复同一检查。
|
||||
|
||||
Reference in new issue
Block a user