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. 需要获取的组件

⚠️ 提示：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 桥接）

主要功能

模型切换与余额处理

• 右上角「模型」按钮会列出你在 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