跳到主内容

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

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则