easyeda-agent 使用指南
把嘉立创 EDA 专业版封装成可被 DSH Agent 调用的 MCP 工具集与 Skill,让模型在 Harness 内驱动原理图与 PCB 自动化。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
easyeda-agent
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add github:zhoushoujianwork/easyeda-agent
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- Skill 描述专家工作流和护栏;
- Go CLI/daemon 暴露稳定的 typed actions;
- EasyEDA 连接器插件 只做到官方
eda.*的桥接; - 产物、截图、DRC 结果、审计日志都是一等输出。
- Skill 或人跑一条
easyeda命令;
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
这个插件装上就能用了吗?
不行。本插件只是把仓库自带的 stdio MCP server 桥接到 DSH、以及把 skills/easyeda-agent/ 注册成 Agent skill,但真正干活的「Go CLI/daemon」二进制和「EasyEDA 连接器 .eext」并不在本包里——必须先跑一次官方一键安装脚本(curl -fsSL .../install.sh | sh)把 CLI、连接器、skill 三件套各自落到本地,EasyEDA 还要在「扩展中心」里手动开启「允许外部交互」。
安装命令里能看到「easyeda_*」这类工具列表吗?
装完本包并加载对应 profile 后,模型侧会自动多出 mcp__easyeda__easyeda_health / easyeda_actions / easyeda_schematic / easyeda_pcb / easyeda_board / easyeda_artifact / easyeda_document / easyeda_project / easyeda_system / easyeda_blocks / easyeda_workflow 等工具;如果看不到,先 easyeda health 看本地 daemon 和 EasyEDA 窗口连接状态,daemon 没起或连接器没装都会让模型收到 NO_CONNECTOR。
CLI、Skill、连接器三者版本对不上会怎样?
easyeda daemon health 会把落后的连接器标成 stale 状态并打印一条告警日志;MCP 这边调用 easyeda_health 也能看到 connectorVersionOk:false。解决方法是跑 easyeda update --check 看三方对齐表,再用 easyeda update 拉齐 CLI 与 skill;侧载的 .eext 不能自动升级,需要手动卸载老版本再导入新版本。
能在 DSH web profile 里跑这个插件吗?
可以。cordis.patch.yml 用了一个独立的 providerName: easyeda 的 skill-filesystem 实例并设置 includeDefaultRoots: false,故意避开官方 bundle 在 web profile 下预置的 skill-filesystem,所以两者不冲突。MCP 桥接部分对所有 profile 通用。
这个插件离线能用吗?
部分能。easyeda_blocks、easyeda_health 这类只查内置目录或本地 daemon 的工具不依赖网络;其他工具会走到 EasyEDA 编辑器内的 eda.* API 以及立创 LCSC 库(按需联网),自更新走 api.github.com 也会产生一次 HTTP 请求。
卸载会留下什么?
DSH 侧只是把 cordis.patch.yml 里 easyeda-mcp 和 easyeda-skill-fs 两条 row 拿掉,profile 重启后即失效。本包不写任何用户文件,不创建任何持久状态;Go CLI、.eext 连接器和 EasyEDA 端的「允许外部交互」开关由各自安装脚本控制,需自行决定是否清理。
沙箱调试用「debug.exec_js」之类的原生逃生口怎么用?
MCP 桥接刻意没有把 debug.exec_js 域暴露给模型(mcp/src/server.mjs 只白名单了 7 个 typed domain + 几个健康/发现工具)。要让模型绕过 typed action 直接执行 JavaScript,必须在本地 daemon 之外的路径——例如人在终端里手动跑 easyeda call debug.exec_js,并自行承担二次确认责任。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 未声明(依赖宿主自带 @deepseek-ai/dsh-mcp-client 与 dsh-skill-filesystem,版本由宿主编译期决定)
- Node: >=20.17.0
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则