@dsh-external/dsh-easyeda-bridge
嘉立创EDA(EasyEDA 专业版)WebSocket 桥接插件：内置 easyeda-bridge 网关，让 DSH 直接驱动正在运行的嘉立创EDA窗口，含内置官方 API 参考文档
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:hffs6/dsh-easyeda-bridge#2edffe292925b460fba0a31f4091371a5cfb39baEasyeda Bridge 以 @dsh-external/dsh-easyeda-bridge 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English: README.en.md
嘉立创EDA（EasyEDA 专业版）桥接插件 — 在 DeepSeek Harness (DSH) 内内置 easyeda-bridge WebSocket 网关，让 DSH 直接驱动用户本机正在运行的嘉立创EDA 专业版窗口。
配套 EDA 侧扩展：run-api-gateway
（即 run-api-gateway_v1.0.5.eext，嘉立创EDA 专业版扩展）。
┌──────────┐ WS(/eda) ┌──────────────────────────┐ HTTP/WS ┌──────────────┐
│ DSH │ ◄────────► │ 本插件（内置 Bridge） │ ◄────────► │ EasyEDA │
│ (Agent) │ 4 个工具 │ 127.0.0.1:49620-49629 │ 自动 │ (Pro Client)│
└──────────┘ └──────────────────────────┘ └──────────────┘
scripts/bridge-server.mjs：EDA 扩展连入
ws://127.0.0.1:<port>/eda → 服务端发 handshake(service=easyeda-bridge) → 扩展
register(windowId) → 服务端下发 execute(id, code) → 扩展执行并回 result/error。own — 端口区间（默认 49620-49629）内没有桥 → 本进程内自建 HTTP+WS 服务adopt — 已有其它桥（如 OpenCode 拉起官方 bridge-server）→ 直接复用其 HTTP API，
避免 EDA 扩展到另一个桥而工具落空；own 模式空置且有外部桥时自动切换（自愈）| 工具 | 用途 |
|---|---|
easyeda_status | 桥/EDA 连接状态、窗口列表、当前文档/图页、页框范围、未连接排查提示 |
easyeda_windows | 列出已连接窗口；selectWindowId 切换活动窗口 |
easyeda_device | 查器件：query 关键词搜索（带 limit）/ cNumber 立创 C 编号精确查找，返回名称/库UUID/器件UUID/封装 |
easyeda_execute | 在目标窗口执行 async (eda) => { … } 代码并回传结果 |
easyeda_docs | 检索内置官方 API 参考（query 搜索签名 / doc 读全文） |
docs/，vendored from easyeda/easyeda-api-skill，MIT）：
120+ 类、62 枚举、70 接口 + 工程/原理图/PCB 源文件格式 + 扩展开发向导，离线可查。GET /health、GET /eda-windows、POST /eda-windows/select、
POST /execute，其它 AI 工具（OpenCode 等）可同时使用同一座桥。# 在本插件目录内构建（lib/ 必须是最新）
DSH_CHECKOUT=<dsh checkout> bash scripts/build.sh
# 在 DSH 环境内注入本插件目录
dev_inject_plugin <path/to/dsh-easyeda-bridge>
# DSH 环境内：写入 profile 的 bundles + link 依赖，并热装载
dev_install_package <path/to/dsh-easyeda-bridge>
插件 cordis.patch.yml 会在装配时插入 easyeda-bridge 行（无配置即可用）。
嘉立创EDA，启动！
DSH 会依次：easyeda_status 确认桥与窗口 → （多窗口时）easyeda_windows 选定 →
easyeda_execute 验证 return await eda.dmt_Project.getCurrentProjectInfo();。
执行代码规则（完整版见插件 systemPrompt 引导）：
async (eda) => { … }，必须 return（console.log 不回传）；Promise 必须 awaiteda.sys_* 替代浏览器 APIEPCB_LayerId.TOP），先用 easyeda_docs 查 references/enums/eda.dmt_Project.getCurrentProjectInfo() +
eda.dmt_SelectControl.getCurrentDocumentInfo()（PCB API 只对活动 PCB 文档有效）const p = await eda.pcb_PrimitiveVia.get([id]); const a = p.toAsync(); a.setState_X(..); a.done()npm install # 安装 ws 等依赖
DSH_CHECKOUT=<checkout> bash scripts/build.sh
node scripts/mock-eda.mjs # 端到端协议冒烟（模拟 EDA 扩展：handshake/register/execute/ping + HTTP API + /agent 通道）
node scripts/test-adopt.mjs # adopt 模式测试（模拟“外部已有桥”场景）
文档同步：见 docs/README.md（从 easyeda/easyeda-api-skill 拉取更新）。
插件代码 MIT。内置文档（docs/）来自 easyeda/easyeda-api-skill
（作者 JLCEDA，MIT），归属与署名见 docs/README.md。