插件使用

ChipCode 的能力以插件形式扩展：工具链（Arduino / ESP-IDF / STM32 / 51 / Wokwi / 立创EDA / OpenSCAD）、浏览器自动化、插件开发工具链都是插件。

从哪里进

• 左侧活动栏的插件图标；
• 或「设置 → 集成 → 插件」。

面板顶部有两个视图标签：官方市场 与 已安装。

官方市场：安装

步骤	说明
1	切到「官方市场」，浏览卡片（名称、版本、分类、能力标签）
2	点「安装」，看到进度：下载插件包 → 解压 → 下载依赖 → 安装 → 完成
3	装完会问「是否立即启用？」——选「启用」后插件才开始工作

安装与启用是两件事：装好但未启用的插件占空间、不占资源，也不给 AI 提供工具。

依赖（例如 arduino-cli、便携 Node）会随插件下载，国内走镜像；已有依赖会被复用，不会重复下载。

市场卡片会按状态显示不同按钮：安装 / 更新到 vX / 已安装 / 内置 / 开发中。有新版本时在「官方市场」里点「更新到 vX」即可。

已安装：管理

已安装列表里每个插件有：

• 启用 / 停用开关：停用后插件贡献的视图、命令与 AI 工具全部下线，后端进程停止；
• 重试依赖：依赖下载失败时可以单独重试，不必重装整个插件；
• 详情页：版本、能力、贡献的命令与视图、后端进程状态；
• 卸载：会同时删除该插件的技能 / MCP 注册、后端进程，以及它下载的工具链依赖。

卸载的主要影响在依赖：例如卸载 Arduino 工具链时，它下载的 arduino-cli 与板卡包会一并删除，重装需要重新下载。

离线安装

没有网络或需要指定版本时：

1. 「已安装」视图底部有「从文件夹安装」与「从 ZIP 安装」；
2. 选择插件目录（含 plugin.json）或插件 ZIP；
3. 安装完成后同样会询问是否启用。

装完之后，多出来什么

位置	变化
活动栏	出现该插件的图标，面板内是「设备 / 插件视图 / 设置」选项卡
工具栏	插件提供的能力按钮（例如「编译」「上传」），正在编译时会变成「取消」
新建项目	插件提供的项目类型出现在类型列表里（如 Arduino 项目）
AI	同时获得该插件的工具与技能；输入 / 可以查看可用技能

与项目的关系

• 插件是全局安装的，所有项目共用；
• 打开某类项目时，如果对应插件已安装但未启用，面板会提示启用；
• 一个项目可以同时用到多个插件（例如 Arduino 编译 + Wokwi 仿真）。

常见问题

Q：安装失败如何处理？ 先看错误提示：网络问题会停在「下载依赖」阶段；版本不兼容会在「安装」阶段报错。重试无效时，可以把错误文本发给 AI 判断，或在「已安装」中卸载后重新安装。

Q：安装完成后 AI 仍无法使用该插件？ 确认插件处于启用状态。启用后 AI 的工具列表才会包含它；必要时新建一个会话。

Q：插件是否开源？ 官方插件全部开源（Apache-2.0），源码在 GitHub 上，可以自行审计或 Fork。

Q：卸载插件会删除项目文件吗？ 不会。项目文件不受影响，删除的只是插件自身与它下载的工具链依赖。