AstroBox 中文文档 下载 App

在插件市场中找和装插件——社区插件安装指南

打开插件市场

在 AstroBox 里打开插件市场的方式:

插件市场
插件市场页面

浏览和搜索

浏览

插件市场按分类展示,常见分类:

2.1 版本起,插件市场页面顶部有悬浮搜索框,搜索时会展示对应插件图标,帮助快速定位。

搜索

直接在搜索框里输入关键词,比如:

安装插件

从插件市场一键安装

  1. 在插件市场浏览或搜索到想要的插件
  2. 点击插件卡片进入详情页
  3. 查看插件说明、版本号、适配的 AstroBox 版本
  4. 点击「安装」按钮
  5. AstroBox 会下载插件并弹出「需要重启」提示

重启生效

装完必须重启 AstroBox——插件在启动时加载,运行时不能热加载。

  1. 确认保存好你的工作(如果在编辑表盘等)
  2. 关闭 AstroBox
  3. 重新打开

重启后:

  1. AstroBox 会弹出权限申请——全部同意(这是正常流程)
  2. 插件生效

验证插件已生效

更新插件

插件有新版本时:

卸载插件

  1. 进入已安装插件列表
  2. 找到要卸载的插件
  3. 点击「卸载」
  4. 卸载后可能也需要重启

本地 .abp 插件安装

如果你拿到了 .abp 格式的插件文件(从 GitHub Releases、创作者发给你的等),不用通过插件市场,直接手动装:

步骤

  1. 进入 AstroBox 的「插件」页面(不是插件市场)
  2. 点击页面右上角加号
  3. 选择你本地的 .abp 文件
本地插件安装
选择本地 .abp 文件
  1. AstroBox 提示重启,重启后弹出权限申请
  2. 同意权限后插件生效

关于插件安全

装插件前建议

权限申请

插件第一次加载时,AstroBox 会弹出权限申请。常见权限:

权限说明
网络访问插件需要联网(比如获取资源列表、传输数据)
文件读取插件需要读取本地资源文件
设备访问插件需要和穿戴设备交互
启动时运行插件开机自启

如果你觉得某个插件申请了不必要的权限,可以拒绝安装。

常见问题

装完重启后插件没有出现

插件装完界面没变化

某些插件(比如后台数据传输类)不会在主界面出现,需要去设置或对应功能页找入口。先仔细读插件的说明文档。

装插件后 AstroBox 变慢

可能是某个插件性能不好。试试:

  1. 禁用 / 卸载最新装的几个插件
  2. 看哪个装回去就变慢
  3. 反馈给插件作者