astrbot 中文文档 下载 App

插件市场:一键安装插件的正确姿势

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

插件市场:推荐位与全部插件列表

安装一个插件的标准流程

  1. 打开市场:面板「插件」页,顶部标签切到「插件市场」(路由 /extension/plugins/market)
  2. 找插件:按名称搜索,或从推荐位逛起;列表里有描述、作者、Star 数、最近更新时间和标签
  3. 看一眼再装:点开详情看文档(Docu)与来源,确认功能对口、维护活跃、来源可信
  4. 安装:点安装按钮,等依赖自动装完
  5. 确认加载成功:切回「已安装」标签看到插件处于启用状态,日志里没有加载报错

插件、技能、MCP 和管理行为都收纳在插件工作区顶部的标签页里——这是 v4 系列把扩展体系统一收纳后的布局。

装完如何验证

加载失败的一键重载

插件加载失败时,管理面板会显示错误信息,并提供「尝试一键重载修复」按钮——修复环境(比如补装了缺失依赖)或改过代码后,不用重启整个程序就能重新加载插件。这个按钮是排障过程中的高频动作。

手动安装的兜底

市场里搜不到、或者想装私有插件时:点插件页右下角 + 按钮,支持两种方式:

国内访问仓库网络不通时,先到「设置 → 网络 → 代理与依赖源」配 HTTP 代理或 GitHub 加速地址;都不行就手动下载压缩包再从文件安装,完整流程见手动装插件。

安全边界,官方原话级别

官方文档明确:由于插件更新机制,无法完全保证插件市场中插件的安全性,请仔细甄别;因插件原因造成损失的,不予负责。实操建议:只装来源清楚、仓库可查的插件;敏感环境先读源码再装;装完观察日志与行为,异常立即停用删除。