Multisim MCP + Skills

中文（当前） | English

让 AI Agent 根据实验要求自动生成 Multisim 电路、运行仿真、提取实验数据，并导出 电路图、CSV、波形图和实验报告。

当前稳定发行版为 v1.1.0。项目非 NI 官方产品，需要本机安装并授权 Multisim 14+；COM 在独立 32 位 Python worker 中运行，MCP 前端可使用 32 或 64 位 Python。

四个开发阶段和 1.0 发布门禁见 1.0 路线图。

PyPI 安装包 · 官方 MCP Registry 条目 · DeepSeek Harness npm 插件 · GitHub Release

开源发布状态

1.1.0 是当前稳定发行版；PyPI 包和 io.github.yxy050208/multisim-mcp 官方 MCP Registry 条目使用同一版本号。由本地 NI 样例提取的 XML 模板不属于 MIT 代码授权范围，公开仓库默认不应包含这些文件。用户需要运行 tools/bootstrap_local_component_pack.py，从自己已授权的 Multisim 安装生成本地模板包。

请不要上传 analysis/、.ms14、解码 XML、类型库转储、实验输出或当前包含 142 个 本地模板的开发 wheel。完整发布步骤见 docs/PUBLISHING.md。

已实现的完整闭环

run_circuit_experiment 可以从同一份受限 SPICE 网表完成：

1. 网表和实验命令安全校验。
2. 生成可编辑 .ms14 原理图。
3. 由真实 Multisim 打开并反向枚举验证。
4. 导出原理图 PNG。
5. 运行 DC、AC、瞬态或工作点实验。
6. 导出 raw、CSV、SVG 波形和命令日志。
7. 生成 Markdown、中英双语独立 HTML/PDF 报告及带 SHA-256 的 manifest.json。

对于较长实验，submit_circuit_experiment 持久任务接口会立即返回 job_id，可通过 get_experiment_job、list_experiment_jobs、 cancel_experiment_job、retry_experiment_job 或 multisim://jobs/{job_id} 查询、 取消和重试任务。每个实验 运行在隔离任务进程中；全部 Multisim COM/编解码操作还会进入长期驻留的 32 位 COM worker。worker 崩溃、RPC 超时或心跳超时不会拖垮 MCP 服务，后续调用可重启 COM worker，服务重启后未完成任务会安全地重新排队。

1.0 还加入了可计算的设计验收与批量实验：

• run_verified_circuit_experiment 接收版本化 ExperimentSpec，自动测量时域频率、 THD、增益、带宽、截止频率、上升时间、过冲、纹波、功耗等指标，并把逐项 pass / fail / unverified 结论写入 verification.json 和实验报告。
• measure_experiment 与 verify_experiment_requirements 可对已注册实验重新计算 指标；信号或证据缺失时只返回 unverified，不会猜测结果。
• plan_experiment_sweep、run_experiment_sweep、submit_experiment_sweep 支持 参数、容差、温度与可复现 Monte Carlo 扫描。每次扫描最多 100 个运行点，长扫描 复用持久任务的取消、超时、崩溃恢复与输出锁。
• 扫描输出 summary.json、扁平 data.csv 和每个运行点的原始产物，并通过 multisim://sweeps/{sweep_id}/summary|data 读取。

验收请求的核心结构如下；operator 支持 at_least、at_most、between 和 approximately：

{
  "spec": {
    "schema_version": 1,
    "title": "分压器验收",
    "netlist": "VIN vin 0 DC 10\nR1 vin vout 1k\nR2 vout 0 1k\n.end\n",
    "commands": "dc VIN 0 10 1",
    "requirements": [
      {
        "id": "gain",
        "metric": "gain",
        "signal": "V(vout)",
        "reference_signal": "V(vin)",
        "operator": "approximately",
        "target": 0.5,
        "tolerance_percent": 1
      }
    ],
    "theoretical_values": {"gain": 0.5}
  },
  "output_dir": "C:\\experiments\\divider-verified"
}

扫描的 mode 可设为 parameter、tolerance、temperature 或 monte_carlo。元件数值使用有限数字替换已声明的 {{NAME}} 占位符；建议先调用 plan_experiment_sweep 检查完整展开结果，再提交真实运行。

已经在 Multisim 14.3 上完成分压器、耦合电感、数字门/JK 时序以及 函数发生器 + 示波器联合实验的真实验证。

1.0 加入不分发 NI 数据库资产的可移植元件与数据仪器：

• @TRANSFORMER、@POTENTIOMETER、@RELAY、@CRYSTAL、功率二极管/MOS；
• @DFF、@TFF、@COUNTER4、@SHIFT_REGISTER4、@ADC1、@DAC1；
• read_virtual_multimeter、analyze_bode_response 和 analyze_logic_signals；
• export_formal_experiment_report，以及 5 个新的正式报告/清单 Resource。

…