插件市场:一键安装插件的正确姿势
1000+ 插件是这个生态最大的资产。装插件本身只要几秒钟,真正需要学的是「装什么样的」和「装完怎么确认它活着」。

安装一个插件的标准流程
- 打开市场:面板「插件」页,顶部标签切到「插件市场」(路由 /extension/plugins/market)
- 找插件:按名称搜索,或从推荐位逛起;列表里有描述、作者、Star 数、最近更新时间和标签
- 看一眼再装:点开详情看文档(Docu)与来源,确认功能对口、维护活跃、来源可信
- 安装:点安装按钮,等依赖自动装完
- 确认加载成功:切回「已安装」标签看到插件处于启用状态,日志里没有加载报错
插件、技能、MCP 和管理行为都收纳在插件工作区顶部的标签页里——这是 v4 系列把扩展体系统一收纳后的布局。
装完如何验证
- 插件如果注册了指令,聊天里敲一下看响应
- 插件如果提供工具,到人格设定的能力列表里确认出现并勾选
- 插件带了技能,技能列表里会按插件分组出现
- 有配置项的插件,在配置文件「插件」分区里填参数
加载失败的一键重载
插件加载失败时,管理面板会显示错误信息,并提供「尝试一键重载修复」按钮——修复环境(比如补装了缺失依赖)或改过代码后,不用重启整个程序就能重新加载插件。这个按钮是排障过程中的高频动作。
手动安装的兜底
市场里搜不到、或者想装私有插件时:点插件页右下角 + 按钮,支持两种方式:
- 从链接安装:粘贴插件仓库地址
- 从文件安装:上传插件压缩包
国内访问仓库网络不通时,先到「设置 → 网络 → 代理与依赖源」配 HTTP 代理或 GitHub 加速地址;都不行就手动下载压缩包再从文件安装,完整流程见手动装插件。
安全边界,官方原话级别
官方文档明确:由于插件更新机制,无法完全保证插件市场中插件的安全性,请仔细甄别;因插件原因造成损失的,不予负责。实操建议:只装来源清楚、仓库可查的插件;敏感环境先读源码再装;装完观察日志与行为,异常立即停用删除。