内容
# Fusion 电子学
Fusion 电子学是 Autodesk Fusion Electronics 的 Codex 插件。它为检查当前 Electronics 文档、运行 Electronics 命令、导出 EAGLE 文件以及通过 Fusion 的本地 MCP 服务器进行受控更改添加了 Codex 工具。
该插件转发 Autodesk 的标准 Fusion MCP 工具，并为原理图、PCB 和库工作流程添加了 Electronics 特有的工具。
## 要求
- 已安装并运行 Autodesk Fusion。
- 在 Fusion 首选项中启用 Fusion MCP 服务器。
- 具有插件支持的 Codex。
- Node.js 20 或更新版本。
Fusion 的本地 MCP 端点必须在以下地址可用：
```text
http://127.0.0.1:27182/mcp
```
## 安装
将此仓库注册为 Codex 市场：
```bash
codex plugin marketplace add mdlockyer/fusion-electronics
```
安装插件：
```bash
codex plugin add fusion-electronics@fusion-electronics
```
对于特定分支或标签：
```bash
codex plugin marketplace add mdlockyer/fusion-electronics --ref main
```
## 工具
Fusion 电子学添加了以下工具：
- `fusion_mcp_electronics_list_commands`
- `fusion_mcp_electronics_start_command`
- `fusion_mcp_electronics_text_command`
- `fusion_mcp_electronics_export_eagle`
- `fusion_mcp_electronics_run_python`
Autodesk 现有的 Fusion MCP 工具通过同一插件服务器转发。
## 安全
插件在当前 Fusion 文档上运行。某些工具可以修改未保存的原理图、PCB 或库内容。在运行写入工具之前，请检查当前文档，首先进行命令发现或读取，然后仅在您打算保留更改时保存。
## 故障排除
如果安装后插件未出现，请确认 Codex 可以读取市场：
```bash
codex plugin list --marketplace fusion-electronics
```
如果安装后 MCP 命名空间丢失，请重新加载 Codex 并检查 MCP 注册表：
```bash
codex mcp list
```
预期的 MCP 服务器密钥是 `fusion_el`。
## 开发
对于本地开发，请注册检出路径而不是 GitHub 仓库：
```bash
codex plugin marketplace add /path/to/fusion-electronics
```
运行语法检查：
```bash
npm run check
```
插件服务器是无依赖的 Node ESM，因此验证不需要安装步骤。
仓库布局：
```text
.agents/plugins/marketplace.json # Codex 市场清单
plugins/fusion-electronics/.codex-plugin/ # 插件清单
plugins/fusion-electronics/.mcp.json # MCP 服务器注册
plugins/fusion-electronics/mcp/ # Node stdio MCP 服务器
plugins/fusion-electronics/skills/ # Codex 技能和引用
```
## 许可证
MIT
