KiCad 电路设计 LuYanFCP/dsh-kicad

dsh-kicad

为 DeepSeek Harness（dsh）提供 KiCad 支持的原生插件 bundle：让 agent 读取、修改并检查 KiCad 原理图，而设计是否正确由 KiCad 自己（kicad-cli）判定。

开发者预览版。基于 dsh 0.2.1-rc.2 与 KiCad 10.0.7 构建和测试。dsh 插件 API 尚未稳定，所有包都在 engines.dsh 中锁定 >=0.2.1-rc.2 <0.3.0-0。

功能

| 能力 | 说明 |
| 工具（kicad_） | doctor（检查本机是否就绪：kicad-cli 与 KiCad 8+、库、Python，附修复方法和安装命令）、read_schematic、list_components、get_symbol_pins、list_nets（KiCad 网表）、search_symbols（已安装符号库）、erc、drc、render（SVG；模型支持图片时附带 PNG 图片；电路板可从任意方向和角度渲染 KiCad 的 3D 视图）、export（网表/BOM）、simulate（用 ngspice 做 SPICE 验证：工作点、瞬态与交流分析，需求以断言形式由工具依据数值判定，见仿真验证）、sim_model（列出模型文件或目录中的 SPICE 模型及其引脚）、datasheet（读取器件 datasheet PDF：章节索引、搜索、整页）、check_design（以 datasheet 原文为依据的原理图单元测试，见datasheet 检查）、check_mcu（静态检查微控制器的接线，见MCU 接线检查）、simulate_firmware（让 ATtiny 或 ESP32 固件在板子上运行，见固件与电路板联合仿真）、export_fab（Gerber/钻孔/坐标/BOM 压缩包及 3D 预览，KiCad 判定电路板就绪前拒绝导出，见制板输出）、fab_preset（JLCPCB/PCBWay 设计规则）、create_schematic，以及原子批量编辑 edit_schematic（增删移动元件、设置值/封装/属性、导线、标签、电源符号、结点、不连接标记、绕开元件和其他网络自动布线的引脚到引脚导线、引脚到网络的连接，以及按功能分区布局：带标题的功能块框、连同导线一起移动元件或整个功能块、图纸尺寸与标题栏）；电路板有 read_pcb（外框、层、设计规则与网络类、带 courtyard 和焊盘网络的封装、覆铜区、DRC 给出的未布线数）和原子批量编辑 edit_pcb（板框与安装孔、移动/翻面/锁定封装、写入 .kicad_pro 的设计规则与网络类、以焊盘为端点的走线、过孔、覆铜区、禁布区、丝印文字与位号、按 uuid 删除）；以及 update_pcb——无界面地完成 KiCad 的“从原理图更新 PCB”：新板使用 KiCad 的空板、默认叠层和占位板框；已有电路板上已放置的封装保持原位，新封装放在板框旁等待布局，网络、值和字段随原理图更新；无法上板时拒绝执行并列出需修正的 REF:PIN，结果由 KiCad 的原理图一致性检查判定；以及 autoroute——用 Freerouting 自动布线，保留手工布好（锁定）的和已有的走线，重新填充覆铜，以 KiCad 的 DRC 结论为准（见布线）。未修改的文件文本逐字节保持不变。 |
| 策略 | 设计修改走 dsh 审批（ask）；写操作被单调 guard 限制在会话工作目录内；每次成功修改后自动运行 KiCad ERC（原理图）或 DRC（电路板修改或应用板厂预设后，先重新填充覆铜；update_pcb 之后另报原理图一致性问题数）并把结论附加到工具结果，原理图修改后未通过的设计检查也会附加上去；系统提示中注入稳定的 KiCad 工作规范，以及动态的“当前目录中的 KiCad 工程 + 最近一次 ERC/DRC”上下文。 |
| 技能 | kicad-agent-workflow、kicad-design-brief、kicad-erc-triage、kicad-drc-triage、kicad-schematic-design、kicad-datasheet-checks（阅读每个器件的 datasheet，把要求保存为检查）、kicad-pcb-layout（从同步后的原理图到生产文件：设计规则、布局、关键网络、GND 铺铜、自动布线、DRC、生产文件，每一步由 KiCad 判定）、kicad-simulate、kicad-mcu-check。 |
| 命令 | /erc、/drc、/bom、/simulate、/design-checks、/mcu-check、/mcu-sim（不经过模型，作用于工程根设计）、/kicad-fab（制板压缩包）、/kicad-render、/kicad-doctor（环境检查）、/kicad-install（安装 KiCad、Freerouting 自动布线器或用于 ESP32 固件仿真的 Espressif QEMU，见下文）。 |
| Agent 预设 | eda：与 standard 类似的工具集 + 电子设计人设。KiCad 工具为全局注册，任何预设都可使用。 |
| Web 界面 | 右侧边栏 .kicad_sch / .kicad_pcb 查看器，两种模式：交互——内嵌 KiCanvas（层次图纸、查看元件/封装/网络、图层开关、KiCad 或 Witch Hazel 主题、文件变化时自动刷新）；SVG——kicad-cli 渲染（平移缩放、多图纸、渲染按钮，PCB 文件变化时自动重新渲染，也是交互模式失败时的自动回退）；电路板还有仿照 KiCad 3D 查看器的 3D 模式（见 3D 视图）；对话卡片：ERC/DRC、原理图与电路板修改（附自动 ERC/DRC 结果）、从原理图更新 PCB（改动、待布局的元件、KiCad 的一致性检查数）、自动布线（Freerouting 新增的走线、KiCad 统计的未布通数和 DRC 错误）、生产文件（导出闸门、文件列表、下载 zip、3D 预览）以及环境检查；开启 跟随 agent 时，agent 同步、修改或布线电路板时会在侧边栏打开它，和原理图一样；设置页：sidecar（kicad-cli、Python、Java、Freerouting、ngspice 和 QEMU 的路径，以及 KiCad 环境检查和 安装 KiCad）与策略（审批、自动 ERC、自动 DRC、自动渲染）。KiCad 缺失或版本过低时，查看器和失败的工具卡片会显示带 安装 KiCad 按钮的提示。 |
| 独立 MCP server | Python sidecar 通过 stdio 说 MCP 协议，Claude Code 或 RL 环境可以不经 dsh 直接复用同一套工具。 |
| KiCad 端（可选） | IPC 插件，工具栏按钮 “Open in DSH”。 |

架构

dsh-kicad-bundle (cordis.patch.yml：全局行 + presets/eda.patch.yml)
├─ dsh-kicad-bridge Host ctx.kicad 服务；通过 ctx.subprocess 管理 Python sidecar，以 MCP 通信 │ └─ sidecar/ Python ≥3.10，核心仅用标准库：无损 .kicad_sch S 表达式编辑、符号库、引脚几何、 │ kicad-cli（ERC/DRC/网表/BOM/SVG）、制板输出；可选 extra：png（cairosvg）、ipc（kicad-python） ├─ dsh-tool-kicad Host kicad_ 工具（defineTool），路径相对会话工作目录解析 ├─ dsh-kicad-policy Host tools.guard + tools/pre-execute（ask/deny）+ tools/post-execute（自动 ERC/DRC）+ 提示词 section/context ├─ dsh-kicad-skills Host 技能 provider + /erc /drc /bom /kicad-fab /kicad-render └─ dsh-client-ui-kicad Client sidebarRightTabs 类型 + tool.call.toolview 行 + plugins.row.config 设置页 kicad-plugin/ KiCad IPC 插件（"Open in DSH"） market/ 插件市场索引示例

设计取舍：

- 文件优先、可 headless。 以文件方式编辑 .kicad_sch（S 表达式），用 kicad-cli 判定，不依赖 KiCad GUI。IPC API（kipy）只是可选的实时通道（ipc_status），因为它需要 GUI 运行且同一时间只允许一个客户端。
- Python sidecar 而非 Node 直连 IPC：KiCad IPC 是 NNG + protobuf，官方绑定只有 Python。
- 由 KiCad 判定。 ERC/DRC 结论来自 kicad-cli，不让模型自判。
- 与 dsh 的耦合集中。 每个包只通过一个适配模块（src/dsh.ts、src/client/dsh.ts）接触 dsh API；前端只用公开接缝（sidebarRightTabs、keyed slots、remote.workspaceFiles、remote.commands、配置表单），不 import 任何 dsh Client 包——这也是 dsh 对第三方 UI 插件的要求。

环境要求

- dsh >=0.2.1-rc.2 <0.3（npm i -g @deepseek-ai/dsh），Node >=22.19，pnpm 11（源码构建时）
- PATH 上的 Python >=3.10（python3；Windows 为 python），核心无需任何 Python 包
- KiCad 8+ 与 kicad-cli（已在 10.0.7 测试）。查找顺序：设置项、$KICAD_CLI、PATH、macOS/Windows 安装目录、Flatpak org.kicad.KiCad
- 可选：rsvg-convert、ImageMagick 或 png extra（PNG 渲染）；ipc extra（IPC 通道）；ngspice（PATH 上的 ngspice，或 $NGSPICE，或 KiCad bridge 的 ngspice 设置），供 kicad_simulate 使用；poppler 的 pdftotext（poppler-utils，或 $PDFTOTEXT），供 kicad_datasheet 使用

检查环境与安装 KiCad

Plugins → KiCad → KiCad bridge 页面显示环境检查：每一项（kicad-cli、KiCad 版本 ≥ 8、符号库与封装库、Python ≥ 3.10、可选的 KiCad 3D 模型库、PNG 光栅化工具和 kicad-python）都有状态和修复方法。对话里用 /kicad-doctor 查看同样的结果，模型可调用 kicad_doctor；因缺少 KiCad 而失败的工具会在错误信息里给出安装命令。

KiCad 缺失或版本过低时，该页面（以及查看器里的提示）会列出本机可用的安装方式：

| 平台 | 方式 | 能否由 dsh 执行 |
| Fedora | sudo dnf install -y kicad | 否：需要 root，提供 复制命令 |
| Ubuntu 及衍生版 | KiCad PPA：sudo add-apt-repository -y ppa:kicad/kicad-10.0-releases && sudo apt-get update && sudo apt-get install -y kicad | 否（root） |
| Debian | sudo apt-get install -y kicad | 否（root） |
| Arch | sudo pacman -S --needed kicad kicad-library | 否（root） |
| openSUSE | sudo zypper install kicad | 否（root） |
| 装有 flatpak 的任意 Linux | flatpak remote-add --user … flathub + flatpak install --user flathub org.kicad.KiCad | 可以，按用户安装、无需 root（约 1.5 GB） |
| macOS | brew install --cask kicad | 可以（需已安装 Homebrew） |
| Windows | winget install --id KiCad.KiCad -e | 可以（需有 winget，Windows 可能弹出授权） |
| 所有平台 | kicad.org 安装包 | 链接 |

点击 安装… 并确认显示的完整命令之前，不会执行任何操作。dsh 从不执行 sudo：需要 root 的方式只展示命令，请在终端中自行执行后点 重新检查。安装过程显示日志、可随时停止；结束后 bridge 会重启 sidecar 并重新检查，新的 kicad-cli（包括通过 flatpak run --command=kicad-cli org.kicad.KiCad 运行的 Flatpak 版）无需重启 dsh 即可使用。对话中：/kicad-install 列出安装方式，/kicad-install flatpak --yes 执行其中一种，/kicad-install status 查看进度。

设置页本身没有会话，检查会借用你最近的会话执行，因此请先打开或新建一个会话。

安装

从源码（当前可用）

git clone https://github.com/LuYanFCP/dsh-kicad && cd dsh-kicad
pnpm install && pnpm run build
dsh plugin --profile web add "$PWD/packages/kicad-bundle"
dsh web

dsh plugin … add <目录> 会以 link 方式安装；子包通过本仓库的 node_modules 解析，@deepseek-ai/ 的 import 由 dsh 映射到正在运行的安装。修改代码后需重新构建并重启 dsh。也可以在 Web 界面 Plugins → Install 中填入同一绝对路径。

直接粘贴仓库地址（最简单）

在 dsh 里 Plugins → Add plugin，填 https://github.com/LuYanFCP/dsh-kicad 后安装（或运行 dsh plugin --profile web add https://github.com/LuYanFCP/dsh-kicad）。仓库根目录本身就是 dsh-kicad bundle，会加载预构建好的 dist/dsh-kicad。在地址后加 #<tag 或 commit> 可以固定版本。

通过插件市场（在 dsh 里搜索安装）

dsh 通过插件市场检索插件：添加一次市场索引（JSON）即可搜索。本仓库发布了一个索引。

1. Plugins → Experimental plugins → More → Custom plugin markets 打开，出现 Discover 标签。
2. Discover → Add index source 填入：https://raw.githubusercontent.com/LuYanFCP/dsh-kicad/main/market/index.json
3. 搜索 kicad、原理图、电路板、circuit board 等，点 Install → Enable now，无需重启。

市场条目从固定的 Git commit 安装 dist/dsh-kicad：由 pnpm run dist（scripts/pack-dist.mjs）生成的单个自包含包。也可以直接安装：

dsh plugin --profile web add "git+https://github.com/LuYanFCP/dsh-kicad.git#<commit>&path:/dist/dsh-kicad"

发布新版本：pnpm run dist 并提交，然后在 market/index.json 中用该 commit 增加一个版本，并用 node market/validate.mjs <dsh>/node_modules/@deepseek-ai/dsh-plugin-market-index 校验。

使用

1. 打开工作区包含 KiCad 工程的会话（侧栏 Add workspace），可选择 EDA agent 预设。
2. 例如提问：“在 U1 旁边的 +3V3 与 GND 之间加一个 100 nF 去耦电容，并让 ERC 通过。”* agent 会先读取设计，再发送一次 kicad_edit_schematic 批量修改（由你审批），并读取策略自动附加的 ERC 结论。
3. 从 Workspace files 打开 .kicad_sch：KiCad 标签页显示渲染结果，agent 每次修改后自动刷新；Render 按需重新渲染。
4. /erc、/drc、/bom 不经过模型直接运行。
5. 设置位于 Plugins → KiCad → KiCad bridge / KiCad policy。

按功能块画原理图

新设计像参考设计那样按功能块逐块绘制。agent 先规划各功能块（标题、元件、在图纸上的区域），然后每次 kicad_edit_schematic 调用画完一个功能块，并用 add_block 框起来。每个块是一个虚线框，标题写明它的功能和主要器件（如 3V3 LDO — AMS1117-3.3、MCU — ATtiny85），需要解释的设计选择在块内加简短注释。功能块之间只通过网络标签和电源符号连接。每次放置或移动元件后，编辑结果都会列出不在任何功能块里的元件；只要还有这样的元件，agent 就不算画完。kicad_read_schematic 的 outside_blocks 列出的是同一批元件。已有的原理图保持原来的组织方式，除非你要求重新整理。下面的电路板布局也按这些功能块进行。

datasheet 检查

器件的极限值和它需要的外围器件来自 datasheet，而不是模型的记忆。kicad_datasheet {path, reference | lib_id | url | pdf, query?, pages?} 读取 datasheet，来源可以是符号自带的链接、agent 用 web_search 找到的 URL，或工作区里的 PDF。它把 PDF 下载一次存进 .dsh-kicad/datasheets/，用 pdftotext 按页提取文字，然后返回常见章节所在的页（绝对最大额定值、工作条件、电气特性、应用信息、布局）、与查询匹配的行，或整页内容。链接指向网页或压缩包时会拒绝，并说明该怎么做。

kicad_check_design 把这些页面变成原理图的单元测试。每条检查写明一项要求，并引用它所依据的原文。检查保存在原理图旁的 design-checks.json 里，由工具根据 KiCad 网表和元件取值判定。规则：

- max_voltage、voltage_range；
- voltage_difference（稳压器的压差余量）；
- capacitance（两个网络之间所有电容之和）；
- resistance（上拉、下拉、串联电阻）；
- same_net；
- led_current（由电源电压、Vf 和串联电阻算出）。

只有依据成立的检查才算数：引用必须真的出现在 datasheet 文字里（用户自己定的数值可以引用工作区文件，如 design-brief.md），而且引用里要写着检查用到的数字。否则检查结果是 CANNOT VERIFY，绝不算通过。每次修改原理图后，检查会重新运行，未通过的附加在结果里；/design-checks 不经过模型直接运行它们。

AMS1117-3.3 的 datasheet 写着 “The addition of 22µF solid tantalum on the output will ensure stability for all operating conditions”。按惯例用 10 µF 的设计在这条检查上失败（capacitance +3V3 → GND = 10.1 µF < 22 µF），换成 22 µF 后通过。kicad-datasheet-checks 技能说明了每类器件要从 datasheet 中提取哪些要求。

电路板布局

kicad_update_pcb 生成电路板后，一个 kicad_edit_pcb 操作 auto_place 即可按原理图的功能块（add_block 画的框；没有功能块时按图纸页，再不然按网络连接）完成布局：同一功能块的元件放在一起，连接器放在板边并朝外（封装上的 "PCB Edge" 标记落在板边），去耦电容紧靠其 IC 的电源引脚，晶振紧靠其 IC，功率器件周围留出空间，板框按元件大小确定（已画好的板框则保留，元件放在其中）。place_block 把单个功能块放到指定位置或矩形内。之后 kicad_read_pcb 报告 courtyard 重叠、板框外的封装和飞线总长，kicad_render 加 view: "3d" 可查看效果。在 usb-attiny85 电路板上：无 courtyard 重叠，所有封装都在板框内，USB-C 位于板边，飞线总长 214 mm，随机摆放为 345 mm（详情）。

布线

kicad_autoroute {pcb, nets?, exclude_nets?, passes?, timeout?} 把电路板写成 Specctra 设计文件，无界面运行 Freerouting，只把新增的走线和过孔加回电路板，从不移动封装。板上已有的走线和过孔都作为固定布线保留，因此 agent 先手工布关键网络（电源、USB 或差分对、晶振：kicad_edit_pcb 的 add_track / add_via，加 locked: true），其余交给布线器完成。之后由 kicad-cli pcb drc --refill-zones --save-board 重新填充并保存覆铜（例如双面 GND 铺铜），其结论（未布通数、DRC 错误、原理图一致性）就是结果。可以在 dsh 中取消，到达 timeout（默认 300 秒）时停止并保留已布好的线；设计文件、会话文件和日志保存在 <工程>/.dsh-kicad/autoroute/。仍有未布通的连接时，结果会建议手工补线，或者对用 auto_place 布局的电路板先清除走线（remove_tracks）、再以更大间距（gap: 2, group_gap: 4）重新布局：usb-attiny85 示例这样即可全部布通。

Freerouting（GPL-3.0）是独立的 Java 程序，不随插件分发。/kicad-doctor 检查 Java 与 Freerouting；/kicad-install freerouting --yes 把固定版本的发布 jar（2.5.0，约 65 MB，校验 SHA-256）下载到你的数据目录（Linux 上为 ~/.local/share/dsh-kicad/freerouting），从不使用 sudo。Freerouting 2.5.0 需要 Java 25+：doctor 会列出包管理器命令或 Temurin JRE。bridge 的 java 与 freerouting 设置可以指向已有的 Java 或 jar。

仿真验证

kicad_simulate {path, analyses?, assertions?, probes?, timeout?} 验证原理图“做什么”，而不只是“怎么连”。KiCad 导出 SPICE 网表（kicad-cli sch export netlist --format spice，读取元件的 Sim. 属性，所以这里仿真过的设计在 KiCad 自带的 Simulator 里也能仿真），ngspice 无界面运行，每条需求写成断言，由工具依据数值判定，就像 ERC/DRC 由 KiCad 判定一样：模型不做裁决。

- 分析：op（直流工作点，默认）、tran {stop, step?}、ac {start, stop, points?}；每次调用每种至多一个。
- 探针：V(net)、V(a,b)、I(R1|C1|L1|D1|V1)。断言：{probe, min?, max?, equals? + tol | tol_pct, abs?, measure?, at?, from?, to?, ref?}，数值用 SPICE 写法（10k、100n、3.3、20m）。测量项：final、initial、max、min、mean、rms、pp、at（瞬态）；gain_db、phase_deg、peak_gain_db、lowpass_cutoff_hz、highpass_cutoff_hz（交流，ref 用于相对输入的增益）。
- 示例：3.3 V 电源轨 {probe: "V(3V3)", min: 3.2, max: 3.4}，LED {probe: "I(D1)", min: "5m", max: "15m", abs: true}，低通滤波器 {probe: "V(OUT)", analysis: "ac", measure: "lowpass_cutoff_hz", equals: 1000, tol_pct: 5}。
- 电路需要接地网络、来自 Simulation_SPICE 的信号源（VDC、VSIN、VPULSE、IDC），以及每个关键元件的模型：R、C、L 按其值仿真；二极管和 LED 需要 set_sim_model {reference, device: "D", params}（即隐藏属性 Sim.Device）（否则工具拒绝运行，因为缺少它时 KiCad 会把二极管接反）；IC、稳压器和三极管需要厂商模型（见下）。没有模型的元件会被排除在电路之外，并列在结果里。
- 厂商模型。 kicad_sim_model {path, name?} 列出模型文件（或目录下所有模型文件）中的 .subckt（带引脚名和上方的注释）与 .model。kicad_edit_schematic 的 set_sim_model {reference, library, name, pins?} 把其中一个绑定到元件：写入隐藏属性 Sim.Library（相对工程路径）、Sim.Name、Sim.Device 和 Sim.Pins，按名称匹配符号引脚与模型引脚；匹配不了时拒绝并给出两边的引脚列表（请传 pins: {"1": "GND", "2": "OUT", "3": "IN"}），因为 KiCad 会照单全收错误的 Sim.Pins 并仿真出错误的电路。{reference, device: "D", params} 不需要文件，直接设置内置器件。模型来自你提供的文件，插件不内置任何模型，也要求 agent 不得编造。子电路内部节点不会出现在结果里。
- 容差分析。 monte_carlo: {runs?, seed?, tolerances?, distribution?, min_pass_rate?} 在 R、C、L 的值（默认 ±5 %、±10 %、±10 %；tolerances: {R: 1, C1: "20%", V1: 2}，百分比，按元件字母或位号；V、I 源按直流电平）随机取值的情况下重复仿真，均匀分布在容差内，或高斯分布（3σ 等于容差），并按断言报告成立的次数、最小/平均/最大值和第一次失败的取值。有随机种子，可重复；min_pass_rate（默认每次都要成立）可接受低于 100 % 的比例。只有普通的 R、C、L 值和电源电平会变化，厂商模型内部的参数不变。
- 需求跟着工程走。 save_spec: true 把本次调用的分析、断言和 monte_carlo 写入 <原理图名>.sim.json（普通 JSON：analyses、assertions、probes、monte_carlo、timeout；spec 可指定别的文件）。之后的 kicad_simulate 调用和 /simulate 在该文件存在时直接使用它，改动后无需重新输入就能按所有已保存的需求重新验证；调用中明确给出的参数会替换文件里的同名键。
- ngspice 需要另行安装：/kicad-doctor 会检查并列出本机的安装命令（sudo dnf install ngspice、sudo apt-get install ngspice、brew install ngspice 等）。网表、仿真文件、rawfile 和日志保存在 <工程>/.dsh-kicad/sim/<名称>/。/simulate 不经过模型，按工程已保存的需求仿真（没有保存时做一次工作点仿真）；kicad-simulate 技能指导 agent 把需求写成断言并迭代修改。
- 它无法回答的：固件行为、没有 SPICE 模型的元件、信号完整性、EMC 和热。

MCU 接线检查

kicad_check_mcu {path, reference?, requirements?} 依据 KiCad 网表和每个系列的引脚表（MCU provider）检查微控制器的接线，并由工具自己判定。这是静态检查，不是固件仿真：它不知道固件会怎样使用某个引脚。

- 检查项（error / warning / info，带引脚、网络和修复建议）。以经典 ESP32 为例：strapping 引脚在复位时电平错误（GPIO0 直接接地；GPIO12 接高或被强上拉，会选择 1.8 V flash 导致无法启动；GPIO2 被上拉）、占用了保留的 flash/PSRAM 引脚（GPIO6-11，以及 PICO、WROVER、-R2 模块上的 16/17）、输入专用 GPIO（34-39）没有任何东西能驱动它，或接按键却悬空、EN 未连接或没有上拉、电源滤波不足 10 µF。ATtiny85：RESET 未连接或只靠较弱的内部上拉、VCC 滤波不足 100 nF；它的外设在固定引脚上，所以 i2c_sda、i2c_scl、spi_、pwm、adc 等需求会按固定引脚判定（SDA 接在 PB4 上就会失败）。ATmega48/88/168/328（Arduino UNO/Nano 用的芯片；引脚按端口命名，PB0-PD7）：RESET 没有上拉、VCC 和 AVCC 的去耦、AVCC 没有接到 VCC（数据手册要求即使不用 ADC 也要连接；经 LC 滤波连接也算）、AREF 直接接在电源轨上（选择 AVCC 或内部 1.1 V 基准时会与它短接）或缺少电容、XTAL1/XTAL2 上的晶振缺少负载电容、PB6/PB7 被当作 GPIO 使用（只有使用内部振荡器时才行）、ADC6/ADC7（只能做模拟输入，没有上拉）接按键；需求可用 pwm（OC0A/B、OC1A/B、OC2A/B）、adc、i2c_（PC4/PC5）、spi_、uart_tx/uart_rx（PD1/PD0）、int0/int1。Arduino Nano 和 UNO 模块符号（引脚 D0-D13、A0-A7）：D0/D1 被占用（这是板上的 USB 串口）、Nano 的 D13 被当作输入（板上 LED 会把它拉到约 1.7 V）、A6/A7 只能做模拟输入、AREF 接在电源轨上；需求按 Arduino 引脚判定。
- 需求（requirements）说明固件需要板子提供什么：[{net: "VBAT_SENSE", needs: "adc1"}, {pin: "U1:IO25", needs: ["output", "dac"]}]；needs 可以是 output（非输入专用）、input、adc / adc1（WiFi 开启时可用）/ adc2、dac、touch 或 boot_free（不是 strapping 引脚）。每条需求按信号所在的 GPIO 判定；agent 被要求在接线前就按需求选 GPIO。
- 无法验证，绝不算通过。没有 provider 覆盖的 MCU（ESP32-S3、STM32、其他 ATtiny 和 ATmega 型号、Nano Every、引脚名表里读不懂的自定义符号等）会报告为 cannot_verify 并说明原因；此时结论既不是通过也不是失败，对应的需求显示为 ?。
- provider 就是数据。mcu_data/esp32.json（经典 ESP32 模块和 PICO）、attiny85.json（8 脚 ATtiny25/45/85）、atmega328p.json（ATmega48/88/168/328 系列）、arduino_nano.json 和 arduino_uno.json（表格由厂商数据手册、Espressif 的硬件设计指南和 Arduino 的原理图转录而来，请以你所用型号的数据手册为准核对）声明它覆盖哪些符号，以及每个 GPIO 的关键属性。工程可以在原理图旁放 <系列>.mcu.json 添加自己的系列（id、name、match、gpio_pin_pattern（按端口命名的引脚再加 ports）、pin_aliases、gpios，结构和规则相同；同一 id 以工程文件为准）。/mcu-check 不经过模型，对工程原理图做检查；kicad-mcu-check 技能指导 agent 先定需求、再修复检查结果。

固件与电路板联合仿真

kicad_simulate_firmware {path, firmware?, stimuli?, assertions?, duration?, clock_hz?, ...} 在模拟的 ATtiny25/45/85 或经典 ESP32 上运行固件镜像，芯片按原理图连接，并判定电路板的行为，于是“按下按钮后 20 ms 内 LED 亮起”这类需求会被验证，而不是被假设。固件是你自己构建的：ATtiny 用 .hex 或 .elf（avr-gcc、PlatformIO、Arduino；ELF 还带有 EEPROM 初始内容），ESP32 用合并后的 flash 镜像（见下文）；插件不会构建、编写或编造固件。

- 芯片是一个纯 Python 的 AVR 模拟器（无依赖），按数据手册（Atmel 2586Q，本次完整读过）实现：ATtiny25/45/85 指令集和存储器大小；GPIO；外部中断、引脚变化中断和所有外设中断（按向量顺序）；Timer0 与 Timer1（普通、CTC、相位修正和快速 PWM、翻转输出；比较值像硬件那样在 TOP/BOTTOM 锁存；Timer1 含 64 MHz PLL 时钟、以 OCR1C 为顶点和互补输出）；ADC（单端与带增益的差分通道、单极与双极、带隙、温度传感器、Vcc / 1.1 V / 2.56 V / AREF 基准、连续转换、13/25 个时钟的转换时间）；模拟比较器；EEPROM（3.4 ms 写入、只擦除和只写模式、复位后保留、可从 ELF 的 .eeprom 加载）；看门狗（复位和中断模式、定时序列规则、掉电唤醒）；复位（RESET 引脚、看门狗、64 ms 启动延时、MCUSR 标志）；三线模式的 USI（SPI 主机或从机、软件选通或外部时钟）；空闲与掉电休眠。它用 avr-gcc 在四个优化等级下编译的程序校验过（148 字节的算术、排序、CRC、软浮点结果与 Python 对比），也校验了已知时序。
- 电路板是一个直流网络：电阻、开关、引脚驱动器（40 Ω）和内部上拉（35 kΩ）、RESET 引脚自带的上拉（45 kΩ）、电源轨和地。场景按下按钮就闭合对应开关（RESET 网络到地的开关会让芯片复位）；芯片读到的是网络给这个引脚的电平；LED 报告它是否会亮（正向压降 1.8 V）；PWM 引脚在占空比内为高电平，网络会对每种组合求解。这些网络上的晶体管、IC 等其他元件按开路处理，并列在结果里。
- 场景。 stimuli：{at: "30ms", press: "SW1", name: "press"}、release、toggle、{at, drive: "NET", level: high|low|release|<伏特数>}（理想电压源，也能覆盖电源轨，比如电量下降的电池）、{at, temperature: 85}。assertions：一个对象（{led: "D2", is: "on"}、{pin: "PB4", level: "high"}、{net, level}、以伏特计的 {net, min, max}、PWM 引脚的 {pin, duty, tol} / {pin, freq, tol_pct}、LED 点亮时间占比的 {led, min, max}）加一个时刻（at、{after: "press", within: "20ms"}、全程成立的 {from, to}），或记录下来的事件：{reset: "watchdog", after, within}、{resets: 0, at}、{eeprom: 0, is: 42, at}、{usi: "tx", nth: 1, is: 165, by}。其他输入：eeprom（初始字节）、usi_input（从机移入的数据）、startup_ms、rstdisbl（PB5 作 GPIO）、vcc、led_vf。
- 跟着工程走。save_scenario: true 把参数写入 <原理图名>.fw.json；之后的调用和 /mcu-sim 在该文件存在时直接使用它，改动后所有已保存的需求都会被重新检查（调用中明确给出的参数会替换文件里的同名键）。
- 不请自来的隐患。固件读取了悬空输入（按钮没有上拉）、输出与开关对抗（过流：驱动器经闭合的开关接地是 125 mA）、输入卡在逻辑电平之间，以及每一次复位。
- 它不会假装的。两线模式的 USI（I²C）、死区发生器、强制输出比较、由 Timer0 计时的 USI、Timer0 的模式 5 和掉电检测复位都不仿真。固件用到其中之一时，运行会带着原因和时间停下；之后时刻的断言是 cannot verify，绝不算通过，总体结论也一样。其他 MCU（STM32、ESP32-S2/S3/C3、其他 AVR）会被拒绝；kicad_check_mcu 仍会检查它们的接线。
- 速度：休眠的芯片几乎不耗时；忙等循环每秒可执行数百万条指令，并有墙钟 timeout。clock_hz 默认 1 MHz（出厂 8 MHz RC 加除以 8 的熔丝）：请设成固件构建时使用的时钟。

经典 ESP32（WROOM/WROVER 模块和 PICO）运行在 Espressif 的 QEMU（qemu-system-xtensa -machine esp32）上：ROM、二级 bootloader、你的应用和双核 FreeRTOS 都在跑，所以 ESP-IDF 或 Arduino-ESP32 的构建产物可以原样运行。QEMU 需要单独安装：kicad_doctor 会报告它，/kicad-install qemu-esp32 下载 Espressif 的发布包（校验 SHA-256，不需要 root），ESP-IDF 自带安装的版本（idf_tools.py install qemu-xtensa）也能被找到；用 qemu 设置或 $QEMU_XTENSA 指向其他位置。

- 固件：合并后的 flash 镜像（bootloader 在 0x1000、分区表、应用：在 ESP-IDF 构建目录里执行 esptool.py --chip esp32 merge_bin -o flash.bin @flash_args，或 Arduino 的 .merged.bin），也可以直接给构建目录里的 flasher_args.json，由插件合并。镜像会被补齐到 QEMU 接受的 flash 大小；原文件不会被改写。
- 引脚。QEMU 的 ESP32 GPIO 外设只是个空壳，IO_MUX 和 RTC_IO 也没有模拟，所以 sidecar 通过 QEMU 的 gdb stub 观察芯片，并亲自完成对这些寄存器的每一次读写：输出、开漏、内部上拉下拉、输入使能和 GPIO 矩阵都跟着固件走；读-改-写（ESP-IDF 配置引脚的方式）从芯片实际保存的值开始；读 GPIO_IN 得到电路板给引脚的电平。断言里引脚写作 GPIO2、IO2 或 U1:IO2。电路板一侧是同一个直流网络（引脚驱动按驱动强度计，默认约 33 Ω；45 kΩ 上下拉；ESP32 的逻辑阈值）。
- 启动与复位。上电时求解 strapping 引脚（GPIO0、2、4、5、12、15）的电平并交给 QEMU：GPIO0 被拉低时芯片真的会进入串口下载模式，GPIO12 为高是错误（选择 1.8 V flash）。EN 为低时芯片保持复位，直到 EN 升高；每次复位都会记录原因（{reset: "watchdog"}，还有 power-on、software、external、deep-sleep、brownout）。UART0 的输出会被捕获：{uart: "ready", by: "2s"} 或 {uart: "Guru Meditation", is: "absent"}。
- GPIO 中断。QEMU 的 GPIO 空壳不会产生中断，所以由 sidecar 自己维护中断状态：电路板给引脚的边沿或电平按该引脚的 GPIO_PINn 设置（上升沿、下降沿、任意边沿、低电平或高电平）锁存，PCPU_INT/ACPU_INT 按 CPU 显示，并通过 QEMU 的 qtest 套接字拉起 QEMU 中断矩阵里的 GPIO 中断源。CPU 会按固件的映射响应中断，因此 attachInterrupt、gpio_isr_handler_add 和 MicroPython 的 Pin.irq 的处理函数都会运行，比激励晚约 2 ms（仿真器在它旁边停下来所需的时间）。结果会列出每一次中断。
- PWM（LEDC）。QEMU 只保存 LED PWM 控制器的少数寄存器（不能回读占空比，没有渐变，也没有中断），所以它也由 sidecar 维护：GPIO 矩阵路由到某个通道的引脚输出该通道寄存器给出的 PWM 波形（定时器时钟和带小数的分频、分辨率、HPOINT、抖动位、输出关闭时的 IDLE_LV），包括硬件渐变及其结束中断。于是 {pin, duty}、{pin, freq} 和 LED 亮度（{led, min, max}）都和 ATtiny 一样可用：MicroPython 的 PWM(Pin(2), freq=1000, duty_u16=16384) 报告 998 Hz，仿真得到的也是 998 Hz。渐变在时间线中以第一步和最后一步表示。驱动板上引脚的定时器被暂停或保持复位，以及定时器的溢出中断（每个周期一次），都会使运行停止。
- ADC。两个 SAR ADC 所在的 SENS 模块 QEMU 没有实现，所以也由 sidecar 维护：经 RTC 控制器的单次转换（ESP-IDF 的 adc_oneshot_read、Arduino 的 analogRead 和 MicroPython 的 ADC 都是这样做的）读取电路板加在该通道引脚上的电压（分压器、用 drive 驱动的网络），并按该通道的衰减和位宽转换。读数是一颗典型芯片的读数：按仿真芯片 eFuse 中 1100 mV 的基准，对 ESP-IDF 自己的校准（线性拟合，以及 12 dB 量程顶部的查找表）求逆。因此 analogReadMilliVolts、adc_cali_raw_to_voltage 和 MicroPython 的 read_uv() 得到的电压与电路板上的相差不超过 1 mV：MicroPython 的 ADC(Pin(34), atten=ADC.ATTN_11DB) 在 1.65 V 分压器上读到 1872，报告 1650 mV。结果列出每个通道的第一次转换以及每次变化（引脚电压、读数及其校准值）。噪声、芯片间的离散以及 ADC2 与 WiFi 的仲裁不仿真。悬空的引脚读为 0 并报告为隐患；引脚上的 PWM 波形只有经过 RC 滤波（网络上有电容）时才按平均值读取，否则运行停止，读取霍尔传感器时也一样。
- 时间是 QEMU 的虚拟时钟（-icount）：每条指令让它前进 8 ns，所以忙碌的代码在任何主机上耗费的仿真时间都相同；空闲时间（CPU 在 WAITI 中等待，FreeRTOS 的空闲任务就是这样）则按真实时间流逝。因此一次运行至少要花与仿真时长相当的墙钟时间。应用内部的时序在各次运行之间的差异远小于 1 毫秒；双核固件的启动过程会相差几十毫秒（QEMU 让两个核轮流运行）。仿真时间包含启动过程：小程序约 0.2 s，MicroPython 约 2 s，所以激励应放在固件配置好引脚之后（时间线会显示何时）。如果固件休眠时没有任何定时器（FreeRTOS 的 tick 总是有的），QEMU 的时钟会停住：到下一个激励之前的时间只对电路板流逝（结果会注明），没有激励时运行就以停滞（stall）结束。duration 默认 2 s（最多 30 s）。
- 它不会假装的。电路板上由其他外设驱动的引脚（I2C、SPI、RMT）电平未知，运行到此停止；崩溃（Guru Meditation、abort()）以及等待永远不会响应的硬件的固件也一样。此后的断言为 cannot verify。固件运行时用到的、仿真没有模拟的硬件（WiFi、蓝牙、触摸板、温度传感器等）会列在 not_emulated 中。

3D 视图

打开 .kicad_pcb，在“交互 / SVG”旁选择 3D，相当于 KiCad 的“视图 → 3D 查看器”。Host 把电路板导出为二进制 glTF 场景（kicad-cli pcb export glb，含铜皮、焊盘、覆铜、阻焊、丝印和封装的 3D 模型），存放在 <工程>/.dsh-kicad/render/<板名>/，按电路板内容缓存，再次打开即时显示。查看器通过 remote.workspaceFiles 读取（原始字节；超过 dsh 32 MiB 整文件上限时按 2 MiB 分段读取），用 three.js 显示：拖动旋转，右键或 Shift 拖动平移，滚轮缩放；顶面 / 底面 / 前 / 后 / 左 / 右 / 轴测、透视 / 正交、元件开关和重置视角。电路板变化时（agent 修改、KiCad 保存）静置一秒后重新导出，视角保持不变；导出失败时保留上一次的模型并说明原因。

修改后的 3D 视图（左）与同一视角的 KiCad 渲染（右）

KiCad 渲染按钮用 KiCad 自己的渲染器渲染当前视角（kicad-cli pcb render --quality high，几秒钟），把轨道相机换算为 --rotate / --zoom / --pivot / --perspective，得到与 KiCad 完全一致的效果。浏览器不支持 WebGL 时，3D 模式显示这种渲染图，视图按钮同样可用。

three.js（约 645 KB，gzip 后 163 KB）是单独的客户端分块 lib/client.three.js，第一次以 3D 模式打开电路板时才由 dsh 加载；主客户端模块只增加约 28 KB。

模型也能从任意角度查看：kicad_render {view: "3d", side?, rotate?: "-45,0,45", zoom?, pivot?, perspective?, quality?: "basic" | "high"}（默认值和返回结果不变；在对话中用 /kicad-render <板> --3d --rotate=-45,0,45）。

KiCad 3D 模型库。 元件外形来自 KiCad 的 3D 模型库（${KICAD10_3DMODEL_DIR}），多数 Linux 发行版把它单独打包。/kicad-doctor 会检查它（变量按 KiCad 的方式解析：环境变量，其次“首选项 → 配置路径”，最后是内置默认路径）；封装引用的模型找不到时，3D 视图会显示带修复方法的提示：

| 平台 | 3D 模型库 | dsh 能否代为执行 |
| Fedora | sudo dnf install -y kicad-packages3d | 否：需要 root，提供 复制命令 |
| Debian、Ubuntu（含 KiCad PPA） | sudo apt-get install -y kicad-packages3d | 否（root） |
| Arch | sudo pacman -S --needed kicad-library-3d | 否（root） |
| openSUSE | sudo zypper install kicad-packages3D | 否（root） |
| Flatpak 版 KiCad | flatpak install --user flathub org.kicad.KiCad.Library.Packages3D//stable | 可以，按用户安装（下载约 640 MB） |
| macOS | 已包含在 KiCad.app 中（DMG 与 Homebrew cask）；brew reinstall --cask kicad 可恢复 | 可以，需 Homebrew |
| Windows | 完整安装包（以及 winget install KiCad.KiCad）已包含；保留“3D models”组件 | 链接 |
| 所有平台 | 下载与 KiCad 版本对应的 kicad-packages3D 压缩包，再设置 KICAD10_3DMODEL_DIR | 链接 |

发行版软件包下载约 270 MB，安装后约 3.1 GB。没有它时，3D 视图和渲染图只显示带焊盘、铜皮和丝印的裸板。

制板输出

/kicad-fab [board.kicad_pcb] [--preset jlcpcb|pcbway] [--force] [--step] [--ipc2581] [--odb]（agent 使用 kicad_export_fab）先由 KiCad 判定电路板：存在 DRC 错误、未布通的连接、原理图一致性（parity）问题（原理图与电路板在同一目录时检查），或在指定预设时违反该板厂的工艺限制，都会拒绝导出，且不写任何文件。--force 强制导出，结果和 fab-manifest.json 会注明这一点。

输出位于 <工程>/fab/<预设或 kicad>/：铜层、阻焊、钢网、丝印与 Edge.Cuts 的 Gerber 及 Gerber job 文件；Excellon 钻孔文件及 Gerber X2 钻孔图；assembly/ 中的坐标文件和 BOM（--preset jlcpcb 时另有 JLC 格式的 BOM/CPL）；preview/ 中的正反面 3D PNG；以及包含除预览外全部文件的 <板名>-<预设或 fab>.zip。

kicad_fab_preset 把板厂的工艺限制（最小线宽、间距、钻孔、焊环、孔间距、铜到板边距离）设为工程设计规则，让 kicad_drc 按板厂能力检查：板级最小值写入 .kicad_pro，自定义规则写入 .kicad_dru 中的受管理区块（你自己的规则保持不变）。数值来自各板厂公布的工艺能力（presets/），最终以板厂审单为准。

独立 MCP server（Claude Code、RL 环境）

claude mcp add kicad -- uvx --from "git+https://github.com/LuYanFCP/dsh-kicad#subdirectory=packages/kicad-bridge/sidecar" dsh-kicad-sidecar --root .
或从源码运行，无需 uv：
PYTHONPATH=packages/kicad-bridge/sidecar/src python3 -m dsh_kicad_sidecar --root /path/to/project

--root（可重复）限制可访问的目录；--call <tool> --args '<json>' 运行单个工具并打印结果。

KiCad 端 “Open in DSH”（可选）

把 kicad-plugin/ 复制到 KiCad 的 IPC 插件目录（KiCad 9/10：KiCad 文档目录下的 plugins，例如 ~/Documents/KiCad/10.0/plugins/dsh-kicad），在 Preferences → Plugins 中启用 KiCad API，然后重启 KiCad。工具栏按钮会把工程路径复制到剪贴板，并在工程目录下启动 dsh web（dsh web 没有指定工作区的参数，请用 Add workspace 粘贴路径）。

配置

| 行（cordis.patch.yml id） | 字段 | 默认值 | |
| kicad-bridge | launcher | python | python 从源码运行 sidecar；uv 在 uv 虚拟环境中运行并安装 uvExtras（png、ipc） |
| | python （实时） | python3 | 解释器 |
| | kicadCli （实时） | 自动 | kicad-cli 路径 |
| | java （实时） | 自动 | Freerouting 使用的 Java 25+（依次查找 $JAVA_HOME、PATH） |
| | freerouting （实时） | 自动 | freerouting.jar（依次查找 $FREEROUTING_JAR、/kicad-install freerouting 下载的 jar） |
| | ngspice （实时） | 自动 | kicad_simulate 使用的 ngspice（依次查找 $NGSPICE、PATH） |
| | qemu （实时） | 自动 | ESP32 固件仿真使用的 Espressif qemu-system-xtensa（依次查找 $QEMU_XTENSA、PATH、ESP-IDF 的工具目录、/kicad-install qemu-esp32 下载的版本） |
| | requestTimeoutMs | 300000 | |
| kicad-policy | approval （实时） | ask | 设计修改 ask / allow |
| | autoErc （实时） | true | 每次修改原理图后运行 ERC |
| | autoDrc （实时） | true | 每次修改电路板后运行 DRC（板上有覆铜区时加 --refill-zones） |
| | autoRender （实时） | true | 每次修改后刷新侧边栏 SVG |
| | restrictToWorkspace、extraRoots | true、[] | 写入范围限制 |
| | guidance、projectContext | true | 提示词 section / 动态上下文 |
| kicad-tools | attachRenders | true | 模型支持图片时附带 PNG |

（实时） 字段可在 Plugins 页面修改且无需重启。

开发

pnpm install && pnpm run build
pnpm test # vitest：Host 包在 dsh 真实 ToolRuntime/SkillRegistry + 真实 sidecar 上测试；Client 在 jsdom 中测试
pnpm run test:py # pytest：S 表达式 round-trip（KiCad demo 文件）、由 kicad-cli 判定的原理图与电路板编辑、MCP server
python packages/kicad-bridge/sidecar/tests/make_fixtures.py # 用编辑器本身重新生成测试 fixture

无需 API key 的真实 dsh 冒烟测试：安装 bundle 后，在含 KiCad 工程的目录中运行 dsh --profile web --patch scripts/dsh-smoke/smoke.patch.yml --no-open，查看 dsh-kicad-smoke.json。

前端由 scripts/build-client.mjs 编译，它复现了 dsh 的模块加载产物格式（window.__ModuleLoader__.load({ id, factory(require) })），只把宿主平台模块作为 external。第三方 Host + Client 加载的验证过程见 docs/spike-third-party-bundle.md。

已知限制

- 电路板可以从原理图创建并保持同步（kicad_update_pcb），可以自动布局（auto_place）、编辑、自动布线（kicad_autoroute）、检查和制板输出（kicad_export_fab）。自动布线需要另行安装 Java 25+ 与 Freerouting（见布线）；高密度电路板可能留下少数未布通的连接，由 agent 手工补齐。
- 仿真只覆盖 ngspice 能做的模拟行为；没有 SPICE 模型的元件会被排除，固件、信号完整性、EMC 与热行为不在仿真范围内。普通的 Device:LED / Device:D 符号需要设置 Sim.Device（见仿真验证）。
- 固件仿真覆盖 ATtiny25/45/85 和经典 ESP32（运行在需单独安装的 Espressif QEMU 上）；没有实现的一律拒绝（见固件与电路板联合仿真；ESP32 上包括深度睡眠、由 I2C、SPI 或 RMT 驱动的引脚、WiFi 和蓝牙等）。除此之外 MCU 检查是静态的，且只覆盖有 provider 的系列（目前是经典 ESP32、8 脚 ATtiny25/45/85、ATmega48/88/168/328 和 Arduino Nano/UNO；ATmega328P 的固件仿真正在进行中）；其他 MCU 见 #31。ESP32 引脚表的准确性取决于转录，请对照具体模块的数据手册核对。
- 板厂预设数值读取自 JLCPCB 与 PCBWay 的工艺能力页面（2026-10-21），之后可能变化。JLC 的 CPL 保留 KiCad 的旋转角度，JLCPCB 预览中可能需要逐个修正。
- 编辑覆盖元件、属性、导线、标签、电源符号、结点与不连接标记；不支持创建层次图纸、总线与图形元素。
- 新放置在子图纸中的元件只向上查找一层根图纸来确定 instance 路径；更深的层次可能需要 KiCad 重新标注。
- 只有当模型路由声明支持图片输入且挂载了附件存储时，图片才会传给模型；否则渲染工具只返回 SVG 路径。
- 审批需要交互式审批通道；没有审批通道的 headless 运行会拒绝设计修改，除非设置 approval: allow。
- 3D 视图需要 WebGL（否则显示 KiCad 渲染图）。其颜色来自 KiCad 的 GLB 导出，KiCad 把 sRGB 颜色直接写成 glTF 的线性颜色系数；查看器按 sRGB 读取以与 KiCad 一致，因此其他 glTF 查看器显示同一文件时会偏亮。
- 交互查看器是 KiCanvas，由 scripts/vendor-kicanvas.mjs 按固定 commit 打包进插件（离线、图标、主题等补丁见 packages/client-ui-kicad/vendor/kicanvas/README.md）。它能解析 KiCad 10 文件，但会忽略尚不认识的新字段；SVG 模式是 kicad-cli 的准确渲染。需要 WebGL2。
- IPC 通道目前只有状态探测和 KiCad 端启动按钮，未实现通过 IPC 实时编辑（KiCad IPC API 以 PCB 为主）。
- Flatpak 方式以 flatpak run --filesystem=host --filesystem=/tmp --command=kicad-cli org.kicad.KiCad 运行 kicad-cli；只用替身 flatpak 测试过，未在真实的 Flatpak KiCad 上验证。apt/pacman/zypper/brew/winget 的安装命令只在 Fedora 上验证过展示逻辑。
- 从设置页发起的检查会在被借用会话的日志里留下 /kicad-doctor 记录（dsh 会记录每条命令）。

许可证

MIT