简体中文 | English

AI巧绘 — 原理图设计助手

详细开发文档请访问：https://prodocs.lceda.cn/cn/api/guide/

v1.0.9 新特性

本次更新聚焦「客户端环境适配」，核心亮点：

• 🖥️ 客户端私服模式适配：嘉立创 EDA 客户端环境下，「私服」连接模式自动置灰并显示说明。私服使用自签名证书，客户端网络层不接受，请求无法送达服务端；网页版不受影响，私服模式仍可正常使用。
• 🔄 配置自动回退：客户端下若历史配置为私服，打开插件时自动切换为「ARK 官网」并持久化，避免用户面对不可用的配置。
• 🛡️ 双重兜底拦截：保存配置与发送消息两处入口均增加校验，客户端下选择私服模式时给出明确提示并阻止操作。

更多历史变更见文末「更新日志」与 CHANGELOG.md。

功能概述

AI巧绘 是一款专为原理图设计人员开发的智能工具，具备以下核心功能：

1. AI 对话：支持自然语言问答与上下文管理，快速解答原理图设计相关问题
2. 工具调用：AI 可以调用 EDA API 读取原理图信息，如查询选中元件、读取原理图结构等
3. 代码执行：集成火山引擎 ARK API，为设计场景生成代码块，AI 生成的代码块支持直接编辑后经用户确认执行
4. 知识图谱：D3 力导向图可视化展示提示词、工具与资源的引用网络，支持搜索居中与节点高亮
5. 抽屉面板：右侧六栏抽屉（图谱/提示词/精选工具/EDA函数/资源/日志），一键切换浏览
6. 安全确认：代码执行前需用户确认，可开启自动执行开关实现自动执行

私服模式说明

本扩展支持连接外部私服后端进行对话（由私服转发至 ARK ）。需要说明：

• 本扩展侧提供一个「私服登录」跳转入口，用户在私服页面完成登录后领取 Token 即可在配置中使用；
• 私服模式仅在网页版可用。嘉立创 EDA 客户端环境下，私服使用自签名证书，客户端网络层不接受，请求无法送达服务端，配置对话框中的「私服」选项会自动置灰并给出说明。客户端请改用「ARK 官网」或「自定义模型」模式。

---

核心模块与协作

AI巧绘并非一个单一功能的聊天框，而是由几块各司其职的界面与底层数据层协同工作的工具集。理解它们的分工，能帮助你更高效地使用。

模块	它是什么	对你有什么用
对话主界面	日常的问答与操作入口	用自然语言描述需求，AI 在此返回可在画布上执行的代码块，并支持编辑确认后执行
数据管理抽屉（右侧六栏）	存放驱动 AI 的"燃料"：提示词与工具	查看 / 编辑提示词（AI 的指令框架）与工具（AI 能调用的能力清单），让 AI 更智能，更贴合你的设计习惯
关系图谱	把抽屉里的数据画成引用网络	改动前先看清"改一个工具会影响哪些提示词"，避免误删导致 AI 失能

它们如何配合（一句话主线）：

你在对话主界面描述需求 → AI 依靠数据管理抽屉里的提示词与工具来理解和执行 → 关系图谱帮你理清这些提示词与工具之间的引用关系。

典型工作流示例：

1. 初次使用：直接对话即可，AI 基于内置的默认提示词与工具工作。
2. 想要对 AI 的工作流程进行自定义编辑：打开「数据」抽屉，先「导入 → 从源码导入」激活数据库，随后编辑提示词、增删工具。
3. 改动前不放心：切到「图谱」分栏，看清待改条目的引用关系，再决定是否编辑或删除。

快速上手

只需三步即可开始使用：

1. 安装扩展：在嘉立创 EDA 扩展管理器搜索「AI巧绘」安装。
2. 配置 AI 通道：打开对话界面 → 点击右上角「配置」→ 填入火山引擎 ARK 的 API Key（或勾选「使用私服」并先去私服页面登录领取 Token）。
3. 开始对话：在输入框描述需求（如"查询选中元件的详细信息"），对 AI 返回的代码块点击「确认执行」即可在画布上落地。

进阶玩法（编辑提示词 / 工具、查看引用图谱）见下方「数据管理抽屉」与「关系图谱」章节，需先「导入 → 从源码导入」激活本地数据库。

使用说明

1. 导入扩展

扩展广场安装

1. 打开嘉立创EDA专业版
2. 高级 → 扩展管理器
3. 搜索 "AI巧绘" 并安装

本地导入安装

1. 下载构建产物（./build/dist/ 下的扩展包）
2. 高级 → 扩展管理器 → 导入
3. 选择扩展包文件完成安装

2. 配置 API Key

1. 在扩展管理器中启用扩展，并确保已开启 外部交互
2. 打开 AI巧绘对话界面（通过菜单 AI巧绘 → 原理图设计助手）
3. 点击对话界面右上角的 配置 按钮
4. 在配置对话框中填写以下信息：
   • API Key：火山引擎 ARK API Key
   • API Model：API Model（使用私服时不需要填写）
   • 使用私服：可选择使用私服模式，使用私服时只需填写 API Key

注意： 需要配置自己的 AI KEY。ARK API 凭证获取方式：前往 火山引擎官网 注册并获取 API Key 和 Model 信息。 或者点击配置对话框中的"私服登录"链接领取 token 后使用。

3. 使用入口

• Home / Sch / PCB 菜单：AI巧绘 → 原理图设计助手 打开对话
• 关于：AI巧绘 → About...

功能介绍

AI 对话

在输入框中输入原理图设计相关问题，AI 会根据问题给出专业回答。支持自然语言问答与上下文管理，能够理解设计意图并提供针对性建议。

AI 可以调用 EDA API 工具来读取原理图信息，例如：

• 查询选中元件的详细信息（参数、封装等）
• 读取原理图中的所有元件列表
• 获取元件的引脚信息
• 分析原理图结构和连接关系

元件信息查询

在原理图中选中元件后，在对话界面输入相关问题（如"查询这个元件的详细信息"），AI 会调用 EDA API 读取选中元件的信息并返回详细结果。

复合任务处理

AI巧绘支持处理复杂的复合任务，可以一次性完成多个操作。例如：

• 查询多个元件信息并进行分析
• 批量读取原理图数据并进行处理
• 执行多个工具调用完成复杂的设计任务

通过自然语言描述任务需求，AI 会理解任务意图，自动调用多个 EDA API 工具，按步骤完成复合任务。

代码自动执行

AI 可以根据对话内容生成可在画布上执行的代码块，用于读取或修改原理图。代码执行机制：

• 确认执行：默认情况下，AI 生成的代码块会显示在对话界面，需点击「确认执行」按钮才会真正运行，避免误改设计文件
• 自动执行：开启对话界面右上角的「自动执行」开关后，代码块会在短暂延迟后自动执行，适合批量重复操作
• 可编辑：执行前可直接修改代码块中的参数或逻辑，按你调整后的内容运行

支持的操作包括：

• 批量修改元件参数
• 放置元件到原理图
• 创建导线连接
• 查询和分析原理图结构

数据管理抽屉（右侧六栏）

点击对话界面右上角「数据」按钮可打开右侧抽屉。抽屉默认以只读预览方式展示内置数据；点击「导入 → 从源码导入」激活本地数据库后，即可编辑。六个分栏各解决一类问题：

• 图谱：用一张关系网络图，呈现提示词、工具之间的引用关系。何时用：改动或删除某条数据前，先来这里看清"会影响哪些条目"，避免误删导致 AI 失能。
• 提示词：AI 的指令框架（系统提示词、各角色框架提示词等）。何时用：想调整 AI 的回答风格、专业度或约束规则（如元件选型规范）时，在此查看或编辑。
• 精选工具：AI 可直接调用的自定义工具与封装能力。何时用：想扩充 AI 能做的事（如新增一种批量操作）时，在此查看或新增。
• EDA函数：嘉立创 EDA 原生 API 的完整列表。何时用：查阅某个原生接口的能力与参数，作为编写工具的参考。
• 资源：由数据文件导入维护的 EDA 开发资料条目，支持查看、编辑与单条恢复出厂默认。何时用：查阅或维护嘉立创原理图 EDA 相关资料素材时，在此浏览或编辑。
• 日志：每次对话的请求与响应完整记录。何时用：复盘某次对话 AI 到底调了什么、为什么出错时，在此按会话回溯。

这个抽屉能帮你做什么：你可以修改提示词、新增「精选工具」来优化插件在本地的表现（例如补充某种元件选型规范、封装一项批量操作）。当你打磨出好用的数据后，可将其导出为 JSON，通过 GitHub 提交 Pull Request；经管理员审批合并后，这些数据就能提供给更多用户使用。如果你有功能需求或改进想法，也可以通过下方的「客服」通道直接联系管理员，我们很乐意听取你的建议。

关系图谱

图谱面板以力导向图形式呈现提示词、工具之间的引用关系网络：

• 节点越大表示被引用的次数越多；连线越粗表示调用关系越强（弱引用以虚线区分）
• 单击节点可高亮其关联链路，双击节点可跳转到对应条目编辑界面
• 搜索时唯一匹配节点自动居中定位
• 悬浮节点可查看详细信息

代码块可编辑

AI 生成的代码块支持直接编辑，修改后仍可执行：

• 点击代码块进入编辑模式，修改参数或逻辑
• 修改后点击「确认执行」按钮，即按修改后的代码运行（未勾选「自动执行」时不会自动执行）
• 编辑与只读模式互斥，避免误操作

数据导入导出

数据面板提供本地数据管理能力：

• 导入数据：弹出询问框，可选择「从源码导入」（加载内置工具与提示词数据，也是首次激活数据库的入口）或「从本地文件导入」（从外部 JSON 文件导入自定义工具或提示词）
• 删除数据库：独立的入口，删除本地 IndexedDB 数据库并回退到原始 JS 内置默认数据（不参与上方导入流程），用于放弃全部用户修改、恢复出厂状态
• 导出：将当前数据导出为单个 JSON 文件，可分享给其他人使用
• 存储说明：所有数据保存在浏览器本地的 IndexedDB 数据库中（底层由 AlaSQL 提供 SQL 能力），关闭插件后持久保留，无需联网

兼容性

• 依赖嘉立创EDA专业版 >= 2.3.0（与 extension.json engines.eda 保持一致）

开发与构建

1. 克隆仓库

   git clone --depth=1 https://github.com/np1139059565/pro-schematic-ai-drafty.git
   

2. 安装依赖

   npm install
   

3. 编译扩展包

   npm run build
   

4. 在嘉立创EDA中导入 ./build/dist/ 的扩展包进行调试

更新日志

• 详见 CHANGELOG.md

反馈与支持

• Issues: https://github.com/np1139059565/pro-schematic-ai-drafty/issues
• 客服通道：在插件对话界面的「客服」入口可直接与管理员沟通，无论是功能建议、使用问题还是故障反馈，管理员都会第一时间看到并回复
• 使用前请备份设计文件；建议先在测试工程验证

贡献指南

我们欢迎所有形式的贡献！无论是报告问题、提出功能建议，还是提交代码改进，都是对项目的宝贵支持。

如何参与贡献

1. Fork 本仓库：点击 GitHub 页面右上角的 Fork 按钮，将仓库复制到你的账户
2. 创建分支：从 main 分支创建一个新的功能分支

   git checkout -b feature/your-feature-name
   

3. 进行开发：在本地进行代码修改和测试
4. 提交更改：提交你的更改并推送到你的 Fork

   git commit -m "feat: 添加新功能描述"
   git push origin feature/your-feature-name
   

5. 创建 Pull Request：在 GitHub 上创建 Pull Request，详细描述你的更改内容

贡献类型

• 🐛 Bug 修复：修复代码中的错误
• ✨ 新功能：添加新的功能特性
• 📝 文档改进：改进项目文档
• 🎨 代码优化：优化代码结构或性能
• 🔧 工具改进：改进开发工具或构建流程

代码规范

• 遵循项目现有的代码风格
• 确保代码通过 ESLint 和 Prettier 检查
• 添加必要的注释和文档
• 提交前运行 npm run fix 确保代码格式正确

问题反馈

如果发现 Bug 或有功能建议，请在 Issues 页面提交。

感谢你的贡献！🎉

开源许可

本扩展包使用 Apache License 2.0 开源许可协议。