在插件市场中找和装插件——社区插件安装指南
打开插件市场
在 AstroBox 里打开插件市场的方式:
- 电脑端:左侧导航栏 → 「插件市场」图标
- 手机端:底部 Tab 栏 → 「插件市场」

浏览和搜索
浏览
插件市场按分类展示,常见分类:
- 资源源插件——接入第三方资源社区
- 数据插件——数据传输、导出、统计
- 工具插件——实用小工具集合
- 开发者工具——调试、测试辅助
2.1 版本起,插件市场页面顶部有悬浮搜索框,搜索时会展示对应插件图标,帮助快速定位。
搜索
直接在搜索框里输入关键词,比如:
- 社区名(如「米坛」「B站」)
- 功能(如「数据导出」「备份」)
- 插件名的一部分
安装插件
从插件市场一键安装
- 在插件市场浏览或搜索到想要的插件
- 点击插件卡片进入详情页
- 查看插件说明、版本号、适配的 AstroBox 版本
- 点击「安装」按钮
- AstroBox 会下载插件并弹出「需要重启」提示
重启生效
装完必须重启 AstroBox——插件在启动时加载,运行时不能热加载。
- 确认保存好你的工作(如果在编辑表盘等)
- 关闭 AstroBox
- 重新打开
重启后:
- AstroBox 会弹出权限申请——全部同意(这是正常流程)
- 插件生效
验证插件已生效
- 如果是资源源插件:去全部资源页 → 右上角源选择器 → 应该能看到新源
- 如果是工具类插件:看主界面有没有新入口,或者设置里有没有新选项
更新插件
插件有新版本时:
- 插件市场会提示有更新
- 点击「更新」下载新版本
- 更新后同样需要重启 AstroBox
卸载插件
- 进入已安装插件列表
- 找到要卸载的插件
- 点击「卸载」
- 卸载后可能也需要重启
本地 .abp 插件安装
如果你拿到了 .abp 格式的插件文件(从 GitHub Releases、创作者发给你的等),不用通过插件市场,直接手动装:
步骤
- 进入 AstroBox 的「插件」页面(不是插件市场)
- 点击页面右上角加号
- 选择你本地的
.abp文件

- AstroBox 提示重启,重启后弹出权限申请
- 同意权限后插件生效
关于插件安全
装插件前建议
- 优先从插件市场安装——市场里的插件至少有社区验证
- 看一下插件的下载量和用户评论
- 对于本地 .abp 文件,确认来源可信(GitHub Releases、官方创作者群等)
权限申请
插件第一次加载时,AstroBox 会弹出权限申请。常见权限:
| 权限 | 说明 |
|---|---|
| 网络访问 | 插件需要联网(比如获取资源列表、传输数据) |
| 文件读取 | 插件需要读取本地资源文件 |
| 设备访问 | 插件需要和穿戴设备交互 |
| 启动时运行 | 插件开机自启 |
如果你觉得某个插件申请了不必要的权限,可以拒绝安装。
常见问题
装完重启后插件没有出现
- 确认 AstroBox 版本是 2.0 以上
- 看看是不是 API Level 不匹配旧版 AstroBox(比如 Level 4 插件不能在 2.0 上用)
- 到设置 → 插件页面看一下插件有没有在列表里
- 实在不行,卸载后重新装
插件装完界面没变化
某些插件(比如后台数据传输类)不会在主界面出现,需要去设置或对应功能页找入口。先仔细读插件的说明文档。
装插件后 AstroBox 变慢
可能是某个插件性能不好。试试:
- 禁用 / 卸载最新装的几个插件
- 看哪个装回去就变慢
- 反馈给插件作者