Repository navigation
Releases: mo9652962-ai/circuit-agent
Release list
v0.2.2 — 原生 Excellon 数控钻孔 (.drl) · 量产首件交互装配导航 (iBOM) · 26大MCP工具
数控钻孔直出与量产装配导航终态升级 (v0.2.2)
对标 IPC-NC-349 Excellon CNC 格式标准 与 开源硬件装配顶流规范 InteractiveHtmlBom (4.8k stars):
核心新增特性
- 原生 Excellon CNC 数控钻孔文件直出引擎 (
client/excellon_exporter.py):- 原生输出符合 IPC-NC-349 标准的 Excellon 2 数控钻孔文件 (
export_excellon_drill); - 自动按孔径分组 (T01C... T02C...),区分接插件通孔、过孔 (Via) 及 4 角 M3 安装孔;
- 自动并入
export_gerber_bundle,彻底凑齐包含 .gm1, .gtl, .gts, .gto, .drl 在内的 5 层完整 PCB 制造生产包!
- 原生输出符合 IPC-NC-349 标准的 Excellon 2 数控钻孔文件 (
- 量产首件检验交互式装配导航网页生成器 (
client/interactive_bom_generator.py):- 纯 Python 生成自包含单文件
ibom.html; - 左侧按型号封装聚合交互式 BOM 表,右侧矢量 SVG 板图渲染;
- 具备双向悬停与点击高亮发光联动,极大加速车间首件巡检核对 (FAI) 与手工样机焊接;
- 纯 Python 生成自包含单文件
- ERC 规则扩充至 12 条:
- 新增第 11 条规则:
DRILL_ASPECT_RATIO_EXCEEDED(钻孔孔径与板厚深宽比 > 1:10 沉铜破裂风险); - 新增第 12 条规则:
PIN_TYPE_CONFLICT(推挽输出短路冲突检查,预防总线争用烧毁芯片);
- 新增第 11 条规则:
- 官方 MCP 工具矩阵扩充至 26 个:
- 新增
export_excellon_drill - 新增
generate_interactive_bom
- 新增
- 发布双闭环:
- PyPI
circuit-agent-client==0.2.2正式上线; - 官方 MCP Registry 同步发布完成;
- 全套 278 项测试全绿,ruff clean。
- PyPI
Full Changelog: v0.2.1...v0.2.2
v0.2.1 — 原生 Gerber RS-274X 制造包直出 · 工业4层/6层叠层阻抗矩阵 (IPC-2141A) · 24大MCP工具
原生 Gerber 制造直出与工业标准叠层阻抗矩阵升级 (v0.2.1)
对标 Ucamco Gerber RS-274X 国际标准 与 IPC-2141A 高速可控阻抗板设计规范:
核心新增特性
- 原生制造级 Gerber RS-274X 文件包直出 (
client/gerber_exporter.py):- 原生输出符合 Ucamco RS-274X 扩展标准的 4 层完整制造打包文件 (
export_gerber_bundle):- 板框机械外形层 (
board-Edge_Cuts.gm1) - 顶层铜箔布线层 (
board-F_Cu.gtl),包含焊盘闪烁 D03* 与走线段 - 顶层阻焊开窗层 (
board-F_Mask.gts),含 +0.1mm 开窗扩展 - 顶层丝印层 (
board-F_SilkS.gto),含器件外框线与位号标记
- 板框机械外形层 (
- 彻底摆脱对图形化 EDA 工具手动导出鼠标点击的依赖,实现从自然语言到可生产 Gerber 的端到端闭环!
- 原生输出符合 Ucamco RS-274X 扩展标准的 4 层完整制造打包文件 (
- 标准工业四层/六层板叠层架构与阻抗求解矩阵 (
client/stackup_engine.py):- 内置嘉立创标准四层板 (
JLC04161H, 7628预浸料, 1.6mm) 与六层板 (JLC06161H, 3313预浸料, 1.6mm) 叠层参数库; - 包含单端 50Ω 射频微带线、差分 90Ω USB 2.0、差分 100Ω 以太网/PCIe 及差分 120Ω CAN/RS-485 推荐线宽与线距;
- 支持反求自定义目标特征阻抗所需走线线宽 (
solve_target_trace_width);
- 内置嘉立创标准四层板 (
- ERC 电气规则门禁扩展至 10 条:
- 新增第 9 条规则
STACKUP_IMPEDANCE_MISMATCH(走线线宽与叠层设计目标阻抗偏离度过大检查); - 新增第 10 条规则
MISSING_LAYER_RETURN_PATH(高速外设接插件缺少参考地回路检查);
- 新增第 9 条规则
- MCP 官方工具扩充至 24 个:
- 新增
export_gerber_bundle与calculate_pcb_stackup_impedance;
- 新增
- 发布双闭环:
- PyPI
circuit-agent-client==0.2.1正式上线; - 官方 MCP Registry 同步发布完成;
- 全套 274 项单元测试全绿,ruff clean。
- PyPI
Full Changelog: v0.2.0...v0.2.1
v0.2.0 — 工业级 IPC-D-356A 飞针测试网表 · 高速差分对等长与时延差求解 · 22大MCP工具
飞针测试工业标准与高速信号完整性升级 (v0.2.0)
对标 全球板厂飞针测试黄金标准 IPC-D-356A 与 高速总线差分对等长时延规范 (USB 2.0 / 100M以太网 / CAN-FD):
核心新增特性
- IPC-D-356A 工业级裸板飞针测试网表直出 (
client/ipc_d356_exporter.py):- 原生直出符合 80 列定宽国际卡片规范的 IPC-D-356A 飞针测试网表文件 (
export_ipc_d356); - 包含标准
317引脚焊盘、327测试点记录、.drl钻孔与网络映射; - 可直接加载至全球主流板厂飞针测试机 (AEMG, ATG, MicroCraft) 执行 100% 裸板开短路与连通性检验;
- 原生直出符合 80 列定宽国际卡片规范的 IPC-D-356A 飞针测试网表文件 (
- 高速差分对等长与时延差约束求解器 (
client/differential_skew.py):- 精准求解微带线/带状线有效介电常数与传播时延 ({pd} \approx 6.5\sim 6.8\text{ ps/mm}$);
- 支持 USB 2.0 High-Speed (≤10ps / ~1.5mm)、100Base-TX (≤25ps)、CAN-FD (≤50ps) 协议时延偏斜校验;
- 自动反求蛇形绕线 (Serpentine Tuning) 补偿长度、齿数与波距尺寸;
- ERC 电气规则门禁扩展至 8 条:
- 新增第 8 条规则
HIGH_SPEED_PAIR_UNBALANCED(检测高速差分对正负引脚分支拓扑不对称,抑制共模噪声);
- 新增第 8 条规则
- MCP 官方工具扩充至 22 个:
- 新增
export_ipc_d356与calculate_differential_skew;
- 新增
- 发布双闭环:
- PyPI
circuit-agent-client==0.2.0正式上线; - 官方 MCP Registry 同步发布完成;
- 全套 270 项单元测试全绿,ruff clean。
- PyPI
Full Changelog: v0.1.9...v0.2.0
v0.1.9 — KiCad 8/9 原理图文件直出 (.kicad_sch) · 供应链货源与替代料审计 · 20大MCP工具
现代原理图直出与供应链多源弹性审计 (v0.1.9)
对标 KiCad 8/9 原生 S-Expression 原理图规范与 ISO 9001 采购供应链审计:
核心新增特性
- KiCad 8/9 现代原理图文件直出 (
client/kicad_schematic.py):- 原生直出现代 KiCad 8/9 S-Expression 原理图文件 (
.kicad_sch); - 支持在 KiCad Eeschema 中直接以可视化原理图打开编辑(含图块布局、器件符号、引脚网络与 LCSC 编号属性);
- 原生直出现代 KiCad 8/9 S-Expression 原理图文件 (
- 供应链多源弹性与替代料审计器 (
client/supply_chain_auditor.py):- 自动排查单源卡脖子器件风险,自动映射引脚完全兼容的第二货源替代料 (Drop-in Second-Source),附带供应商与封装;
- 输出量化供应链弹性评分 (0-100%) 与采购策略建议;
- MCP 官方工具扩充至 20 个:
- 新增
export_kicad_schematic与audit_supply_chain;
- 新增
- 发布双闭环:
- PyPI
circuit-agent-client==0.1.9正式上线; - 官方 MCP Registry 同步发布完成;
- 全套 265 项测试全绿,ruff clean。
- PyPI
Full Changelog: v0.1.8...v0.1.9
v0.1.8 — 2D 启发式器件自动布局 · Specctra DSN 自动布线导出 · 4大工业扩展积木
自动布局与布线格式 (DSN) + 工业积木拓展 (v0.1.8)
对标 JITX / atopile / Freerouting 工业级代码到 PCB 工作流:
核心新增特性
- 2D 启发式器件自动布局与 Specctra DSN 导出 (
client/placement_engine.py):- 启发式布局规则:MCU 居几何中心、电源输入居左侧边缘、去耦电容紧贴 VDD 引脚 (<3mm)、晶振紧邻 XTAL 引脚、总线收发器与接插件沿板边阵列;
- 输出标准 Specctra DSN (v15.0) ASCII 自动布线交互文件 (
export_specctra_dsn),可直接灌入 Freerouting / Cadence Specctra / KiCad 执行 100% 自动走线;
- 4 大工业与自动化核心积木扩展 (总数 20 → 24 大类):
block_ethernet_phy_w5500: W5500 SPI 硬件 TCP/IP 协议栈 + HR911105A 带隔离变压器与状态灯 RJ45block_isolated_adc_ina219: INA219 0.1Ω 2W 1% 精密检流电阻 I2C 功率/电量遥测模块block_motor_driver_drv8825: TI DRV8825 45V 2.5A 步进电机驱动 + 100µF 50V 高压母线滤波 + XH-4P 接口block_optocoupler_isolated_io: PC817 5000Vrms 高压光耦 + 2.4k 限流与反向保护,适配 24V PLC 工业输入
- MCP 官方工具扩充至 18 个:
- 新增
export_specctra_dsn工具,全量同步中英文档;
- 新增
- 发布双闭环:
- PyPI
circuit-agent-client==0.1.8正式上线; - 官方 MCP Registry 同步发布完成;
- 全套 262 项测试全绿,ruff clean。
- PyPI
Full Changelog: v0.1.7...v0.1.8
v0.1.7 — 工业级对标:系统级电源树分析 (Power Tree) · 差分总线终端阻抗 ERC · IPC-2221B 高压间隙
工业级与高星规范对标升级 (v0.1.7)
参考 JITX / atopile / Altium Power Analyzer 工业方法论与 IPC-2221B / ISO 11898-2 国际标准:
核心新增特性
- 系统级电源树与热功耗分析引擎 (
client/power_tree.py):- 自动追溯系统级电源域流向 (
/VBUS//VIN//VBAT→ LDO / Charger → 各子系统负载); - 依据芯片与外设实测数据精确计算分路典型/峰值电流预算;
- 自动校核 LDO 压差裕量 (
Vin - Vout >= Vdropout); - 评估 LDO 功耗损耗与结温温升 ( = T_a + P_d \times R_{\theta JA}$),超标发出
WARN/CRITICAL_OVERHEAT过热预警;
- 自动追溯系统级电源域流向 (
- 总线差分对 120Ω 终端电阻 ERC 门禁:
- 新增电气规则
MISSING_BUS_TERMINATION(warning, 对标 ISO 11898-2 CAN 与 TIA/EIA-485-A 规范);
- 新增电气规则
- IPC-2221B Table 6-1 高压电气间隙与爬电距离精准求解器:
- 支持 B1 (内层)、B2 (外层裸露)、B4 (涂覆三防漆)、A6 (裸露引脚) 4 种导体类别在 0~500V+ 全电压区间的爬电与电气间隙精准计算;
- MCP 官方工具扩充至 17 个:
- 新增
analyze_power_tree与calculate_ipc2221_clearance;
- 新增
- 发布双闭环:
- PyPI
circuit-agent-client==0.1.7正式上线; - 官方 MCP Registry (
registry.modelcontextprotocol.io) 同步发布更新成功; - 全套 257 项单元测试全绿,ruff clean。
- PyPI
Full Changelog: v0.1.6...v0.1.7
v0.1.5 — Version Metadata Sync & PyPI Quick Start
CircuitAgent v0.1.5
修复:版本元数据全面对齐
此前包已发布至 PyPI(0.1.4),但三处版本号仍停留在旧版本,用户安装后会看到互相矛盾的版本信息。本版一并修正:
| 位置 | 修复前 | 修复后 |
|---|---|---|
client/__init__.py → __version__ |
0.1.0 | 0.1.5 |
client/mcp_server.py → SERVER_INFO |
0.1.1 | 0.1.5 |
README release badge(中/英) |
v0.1.0 | v0.1.5 |
server.json |
0.1.4 | 0.1.5 |
pyproject.toml |
0.1.4 | 0.1.5 |
文档:PyPI 安装成为首选路径
pip install circuit-agent-client中英双语文档均补充了 PyPI 一键安装方式,源码方式保留为方式 B。
其他
- 清理
docs/images/frames/空目录残留 - 120/120 测试通过
- 跨平台 CI 全绿
安装后核验
import client, client.mcp_server as m
client.__version__ # '0.1.5'
m.SERVER_INFO['version'] # '0.1.5'
len(m.AVAILABLE_TOOLS) # 6
len(m.AVAILABLE_RESOURCES)# 7
len(m.AVAILABLE_PROMPTS) # 3已实测:PyPI 0.1.5 独立虚拟环境安装 → 四处版本号全部一致。
v0.1.4 — MCP Registry 登记 + PyPI 发行工程
CircuitAgent v0.1.4
MCP 官方 Registry 登记
本版将 MCP Server 正式登记到官方 Registry(registry.modelcontextprotocol.io),命名空间:
io.github.mo9652962-ai/circuit-agent-client
采用 GitHub OIDC 免 token 认证,server.json 声明 PyPI 包与 stdio 传输方式。此后任何 Cursor / Claude Desktop / Windsurf 用户均可直接检索并挂载。
PyPI Trusted Publishing 发行链
- tag 触发 → 测试门禁 →
uv build→ OIDC 免 token 发布 - 附带 CycloneDX SBOM 工件与 PEP 740 签名(provenance attestation)
- 首发版本:0.1.3
新增工作流
.github/workflows/publish.yml— PyPI 发布.github/workflows/registry-publish.yml— MCP Registry 登记(含 PyPI 上线等待轮询)
交付内容
- 6 Tools / 7 Resources / 3 Prompts 完整 MCP 三元组
- 120/120 测试通过
- 零运行时依赖(纯 Python 标准库)
v0.1.3 — PyPI 首发(Trusted Publishing)
首次发布到 PyPI
pip install circuit-agent-client
circuit-agent-mcp # stdio MCP server · 6 tools / 7 resources / 3 prompts- 发行名:circuit-agent-client(仓库 circuit-agent 的客户端/规范发行版)
- 供应链:Trusted Publishing(OIDC 免 token)+ CycloneDX SBOM + PEP 740 attestation
- 测试门禁:120 tests passed(发布前强制)
- 版本对齐:远端已有 v0.1.0–v0.1.2(tag),PyPI 首发版本从 0.1.3 起
v0.1.2 — Full MCP Triad: 6 Tools, 7 Resources, 3 Prompts & 120 Passed Tests
CircuitAgent v0.1.2 · Complete Model Context Protocol (MCP) Triad Release
🚀 What's New in v0.1.2
-
Complete MCP Triad Architecture:
- Tools (6 engineering tools):
synthesize_circuit: Natural-language prompt to deterministic hardware netlist.search_lcsc_parts: Key-free live query of LCSC/JLCPCB parts, stock, pricing, and packaging.list_circuit_blocks: Query all 10 pre-audited CircuitBlocks in the hardware DSL.validate_netlist: JSON Schema verification against Draft-07 specification.calculate_trace_impedance: Closed-form IPC-2141 microstrip & differential pair impedance solver for USB 90Ω, RF 50Ω, CAN 120Ω.calculate_bom_cost: PCBA cost breakdown estimator calculating bare components + JLCPCB Extended library feeder surcharge (¥20/type).
- Resources (7 direct-mount context URIs):
circuit://specs/netlist-schema: Formal Draft-07 JSON Schema.circuit://specs/cpl-standard: JLCPCB SMT CPL coordinate & rotation standard.circuit://blocks/catalog: Full JSON catalogue of 10 standard CircuitBlocks.circuit://rules/jlc-smt: JLCPCB SMT manufacturing rules and feeder fee structure.circuit://examples/esp32c3-minimal: Minimal reference IoT node netlist.circuit://examples/stm32f103-controller: Industrial controller reference netlist.circuit://examples/rp2040-dualcore: Dual-core high-density reference netlist.
- Prompts (3 slash-command engineering workflows):
/design_hardware_project: Guided end-to-end hardware synthesis, impedance check, and schema validation./audit_schematic_netlist: Senior Principal EE inspection prompt (PI/SI/DFM gates, decoupling capacitor proximity)./optimize_bom_cost: PCBA BOM cost reduction prompt substituting Extended parts for Basic library parts.
- Tools (6 engineering tools):
-
120/120 Tests Passing:
- Total test suite expanded to 120 tests covering all protocol methods, resource loaders, and math solvers.
- Evidence ledger #948 recorded.
- GitHub Actions 8/8 CI matrix all green.
-
Zero External Dependencies:
- Built 100% on the Python standard library.