chenjiajungithub/easyeda-deepseekharness

ai助手（deepseek-harness）

嘉立创EDA专业版（EasyEDA Pro）扩展：在 EDA 内接入 DeepSeek Harness，用自然语言驱动原理图 / PCB 设计。

用户输入（如“搜索 NE555 芯片并放到原理图中间”）
│
▼
扩展面板（聊天界面）──WS──► 本地网关（内嵌 DeepSeek Harness agent）
│ 工具调用（搜索/放置/网络标识…）
▼
嘉立创EDA（经 API Gateway 桥接执行 eda.* API）

插件展示

运行截图
运行截图
运行截图
运行截图

功能特性

- 自然语言操作 EDA：让 AI 搜索器件、放置器件、添加电源/地网络标识、查看工程状态
- 按工程选择：面板显示当前操作的 EDA 工程，可下拉切换其他工程
- 文件上传：支持上传 txt / json / pdf 等文件（PDF 自动提取文本），AI 可直接阅读数据手册内容
- 按规范放置：内置原理图设计规范（器件落在页框内、电源上地在下、坐标毫米制等）
- 会话持久化：关闭面板再打开，历史消息与上下文自动恢复

一、前置依赖安装

在安装本扩展之前，需要先准备好以下环境：

1. Node.js（≥ 20）

DeepSeek Harness 与本地网关均基于 Node.js 运行。

- 下载安装：https://nodejs.org/（LTS 版本即可）
- 安装完成后在命令行验证：node -v 能输出版本号

2. DeepSeek Harness（dsh）

本地网关内嵌的 AI 引擎来自 DeepSeek Harness。

- 官方仓库：https://github.com/deepseek-ai/deepseek-harness
- 按官方文档安装 dsh 命令行工具
- 安装后至少启动一次（如 dsh web），让它在 $DSH_HOME（Windows 默认 C:\Users\\.dsh）下完成初始化、安装所需的 @deepseek-ai/dsh- 组件包
- 本扩展的网关会自动从 $DSH_HOME\profiles\node_modules 加载这些组件；若你的 $DSH_HOME 不是默认位置，启动网关前设置环境变量 DSH_HOME 指向它即可

3. 配置 DeepSeek API Key

AI 对话需要调用大模型 API，需要有效凭证：

- DeepSeek 官方（默认）：在 DeepSeek 开放平台 申请 API Key（sk-...）
- 在 DeepSeek Harness 的配置中填写（$DSH_HOME\.credentials.yaml，或运行 dsh web 后在设置页配置模型凭证）
- 也支持配置其它模型供应商（如 MiniMax、GLM、Kimi、Qwen、Grok 等）：在 DeepSeek Harness 的模型设置中添加供应商与 API Key，之后即可在扩展面板右上角「模型」按钮中切换
- 配置完成后，可用 dsh web 随便发起一次对话验证凭证是否有效

4. 嘉立创EDA专业版

- 下载安装：https://pro.lceda.cn/（版本 ≥ 3.2.0）

5. 需要获取的组件

| 组件 | 获取方式 | 作用 |
|---|---|---|
| easyeda-deepseekharness（本扩展） | 嘉立创官方扩展广场中搜索获取 | AI 助手聊天面板 + 本地网关对接 |
| run-api-gateway（API Gateway） | 嘉立创官方扩展广场 | 在 EDA 内建立 WebSocket 桥接，让外部程序执行 eda. API |
| easyeda-api Skill（推荐） | 见下方安装命令 | 提供 Bridge Server、EasyEDA API 文档、调用约定，以及 AI 与 EDA 之间的完整工作流 |

⚠️ 提示：run-api-gateway 扩展需要配合 easyeda-api Skill 一起使用。

推荐安装命令（安装到 OpenCode 的全局 Skill 目录）：

Windows PowerShell：
npx clawhub@latest install easyeda-api --workdir "$HOME/.config/opencode" --dir skills

Windows cmd：
npx clawhub@latest install easyeda-api --workdir "%USERPROFILE%\.config\opencode" --dir skills

macOS / Linux：
npx clawhub@latest install easyeda-api --workdir "$HOME/.config/opencode" --dir skills

用途：该 Skill 提供 Bridge Server、EasyEDA API 文档、调用约定，以及 AI 与 EDA 之间的完整工作流。

二、嘉立创 EDA 设置

开启「外部交互权限」

扩展通过 eda.sys_WebSocket 与本地服务通信，需要 EDA 允许扩展进行外部网络交互：

1. 打开嘉立创EDA专业版
2. 进入「设置」→「扩展」相关页面（不同版本菜单位置略有差异，可搜索“扩展”或“外部交互”）
3. 为 run-api-gateway 与本扩展开启外部交互权限
4. 若找不到该选项，请查阅 EDA 官方扩展文档，或确认你的 EDA 版本支持扩展外部交互

提示：API Gateway（run-api-gateway）扩展加载后会自动连接本机桥接服务；本扩展面板右上角的 Bridge 状态点会显示桥接是否连通。

三、安装步骤（扩展广场方式）

1. 安装 Node.js ≥ 20，命令行验证 node -v
2. 安装 DeepSeek Harness（dsh），启动一次完成初始化；配置 DeepSeek API Key 并验证可对话
3. 打开嘉立创官方扩展广场，获取并安装：
- easyeda-deepseekharness（本扩展）
- run-api-gateway（API Gateway）
4. （推荐）安装 easyeda-api Skill（命令见上文第一节第 5 项）
5. 在嘉立创EDA中开启扩展「外部交互权限」（见第二节）
6. 下载网关（AI 引擎所在，需要单独安装）：

本地网关是 DeepSeek Harness 的本地运行组件，不在扩展包内，需要单独下载。扩展广场发布版不含网关代码，网关需从开源仓库获取。

- 仓库地址：https://github.com/chenjiajungithub/easyeda-deepseekharness
- 从仓库中下载压缩包 gateway.rar（或解压源码中的 gateway/ 目录），解压后得到 gateway\ 目录
- gateway\ 目录包含的文件（相对路径清单）：
gateway\start.bat                  一键启动脚本（推荐）
gateway\install-autostart.bat      注册开机自启动（可选）
gateway\uninstall-autostart.bat    取消开机自启动（可选）
gateway\src\index.mjs              网关主程序
gateway\cordis.yml                 网关组合配置
gateway\package.json               依赖声明
gateway\scripts\gen-cordis.mjs     配置生成脚本（一般无需运行）

- 若使用源码包（已 clone 完整项目），则网关目录已在项目内，直接进入第 7 步启动即可。

7. 启动本地网关（保持窗口运行）：

方式一：在解压出的 gateway 目录里双击
start.bat

方式二：命令行（在解压出的 gateway 目录的上级，项目根目录执行）
node gateway/src/index.mjs

启动前需先完成第一节的 Node.js 与 DeepSeek Harness 安装；若 $DSH_HOME 非默认位置，先设置环境变量 DSH_HOME。
出现 [gateway] boot ok. ws://127.0.0.1:49620 即成功。

✨ 可选：让网关自动启动。 解压出的 gateway\ 目录里双击运行 install-autostart.bat，
网关将注册为 Windows 开机自启（计划任务 easyeda-deepseekharness-gateway），以后无需手动启动。
取消自启动：运行 gateway\uninstall-autostart.bat。
8. 在 EDA 菜单栏找到 「AI 助手」→「打开 AI 助手...」，打开聊天面板即可使用

四、从源码安装（可选，本地构建）

需要自行获取源码（git clone 或下载源码包）的开发者，按以下步骤操作；扩展广场已发布时可直接使用第 6 步构建产物或跳过本节。

1. 获取扩展源码，进入项目根目录执行：

npm install

安装网关依赖（PDF 解析等）。同时生成网关组合配置：

node gateway/scripts/gen-cordis.mjs

2. 启动本地网关（保持窗口运行，关闭窗口即停止）：

方式一：双击运行
gateway\start.bat

方式二：命令行
node gateway/src/index.mjs

出现 [gateway] boot ok. ws://127.0.0.1:49620 即成功。

3. 构建扩展包（若使用扩展广场发布版可跳过）：

npm run build

产物在 build/dist/easyeda-deepseekharness_v1.0.0.eext

4. 在 EDA 中安装扩展：
- 安装 run-api-gateway 扩展（扩展广场获取）
- 安装 easyeda-deepseekharness_v1.0.0.eext（EDA → 设置 → 扩展 → 从本地安装）
5. 开启扩展「外部交互权限」（见第二节），即可使用

五、使用方法

启动

- 每次使用前确保：本地网关已启动（gateway\start.bat）、EDA 已打开且 API Gateway 扩展已连接
- 打开面板后，右上角两个状态点应为绿色：
- Harness: 已连接（DeepSeek Harness 网关）
- Bridge: 已连接（EDA 桥接）

主要功能

| 功能 | 说明 |
|---|---|
| 对话 | 在输入框输入指令，回车发送；「停止」按钮可中止当前生成 |
| 工程选择 | 工程条（📁 当前工程名 ▾）下拉切换操作的 EDA 工程 |
| 文件上传 | 点击 📎 上传 txt / pdf / json 等文件，AI 自动阅读 |
| 模型切换 | 右上角「模型」按钮枚举已配置的模型供应商（DeepSeek 官方 / MiniMax / GLM / Kimi / Qwen 等），一键切换，新对话生效 |
| EDA 操作 | AI 可调用工具完成器件搜索、放置、电源/地标识、查看工程状态 |

模型切换与余额处理

- 右上角「模型」按钮会列出你在 DeepSeek Harness 中已配置的全部供应商与模型，点击即可切换，新对话生效（当前对话不中断）。
- 若当前供应商 API 余额不足，发送后会收到明确提示（例如 Insufficient Balance），此时点击「模型」切换到其它已配置供应商，或将默认供应商切回一个有余额的即可。

典型示例

- 搜索 NE555 芯片，列出型号和封装
- 把 C2690480 放到原理图 (150, 105)mm
- 给 U1 的 VCC 添加电源标识，GND 接地
- 上传器件数据手册 PDF，说：根据这份手册，搜索合适的芯片并放到原理图

六、常见问题

1. 面板显示「未连接」/ Harness 状态为红色

- 网关未启动：在扩展源码根目录执行 node gateway/src/index.mjs（或双击 gateway\start.bat），看到 [gateway] boot ok 字样
- 网关启动报错：确认 DeepSeek Harness 已安装且初始化过（$DSH_HOME\profiles\node_modules 存在）、DSH_HOME 环境变量正确
- 面板会自动扫描 49620-49629 端口寻找网关，无需手动指定

2. Bridge 状态为红色 / EDA 操作失败提示"未找到 easyeda-bridge"

- 确认 EDA 内已安装并加载 run-api-gateway 扩展
- 确认已安装 easyeda-api Skill（见第一节第 5 项）
- 确认已在 EDA 设置中开启外部交互权限
- 重启 EDA 让扩展重新连接

3. 发送消息后无响应

- 确认供应商 API Key 已配置且有效（可先用 dsh web 验证）
- 若提示余额不足（Insufficient Balance）：点击右上角「模型」切换到其他已配置供应商
- 点「停止」后重试；查看网关窗口是否有报错日志

4. 搜索器件报错或结果为空

- 确认 EDA 已打开并处于原理图页面
- 搜索关键字换更通用的型号（如 555 而不是 NE555）

5. PDF 上传后 AI 说无法读取

- 仅支持带文字层的 PDF；扫描版/图片型 PDF 需先 OCR 或转成文本

项目结构

├─ extension.json          扩展清单（名称/版本/菜单）
├─ src/index.ts            扩展入口（打开面板）
├─ iframe/index.html       AI 助手聊天面板
├─ gateway/                本地网关（内嵌 DeepSeek Harness agent）
│  ├─ src/index.mjs        网关主程序（WS 服务 + agent + EDA 工具）
│  ├─ cordis.yml           网关组合配置（由 gen-cordis.mjs 生成）
│  ├─ start.bat            一键启动脚本
│  └─ scripts/             配置生成与测试脚本
└─ build/dist/*.eext       构建产物（EDA 安装用）

开源网址

https://github.com/chenjiajungithub/easyeda-deepseekharness

许可证

Apache-2.0