安装队列管理——断点续传、报错排查与批量推送
队列是什么
安装队列是 AstroBox 管理所有待推送资源的集中地。无论是从官方源下载、三方源添加还是本地拖入的资源,在推送到设备之前都会先进队列。
进入队列页面
- 电脑端:左下角找到队列入口(和设备卡片在同一个区域)
- 手机端:胶囊形设备卡片的右侧按钮(仅在连接设备后显示)

队列的三种基本操作
开始推送
如果你关闭了「本地资源自动安装」,或者有多个资源想攒在一起推送,点击队列上方的「开始」按钮:

AstroBox 会按队列顺序逐个推送到当前选中的设备。
手动添加资源
- 电脑端:拖拽文件进 AstroBox 直接进队
- 全平台:队列页面右上角加号 → 选择资源类型 → 选择文件
清空队列 / 删除单项
在队列卡片上右键(电脑)或长按(手机),可以删除单项或清空整个队列。注意:如果正在推送中,先取消再清空。
2.2 版本新特性
多设备下的队列行为
在多设备模式下(V2.2 新增),队列上方会显示当前的目标设备。当你往队列里添加资源时,AstroBox 会问你要装到哪个设备——这是因为每个设备的队列理论上是独立的。
如果遇到队列混乱,可以:
- 切换设备后看队列内容是否自动更新
- 不行就清空队列重新添加
断点续传
2.1 版本起,队列支持断点续传:
- 如果推送过程中断开了蓝牙连接,已推送的部分资源不会丢失
- 重新连接设备后,点击开始,未完成的资源会继续推送
- 断连时队列不会被清空(除非手动清空)
报错处理
队列中的卡片可能显示错误状态,常见错误:
| 错误类型 | 原因 | 解决方法 |
|---|---|---|
| 设备断连 | 蓝牙连接丢失 | 重新连接设备,点击「重连」按钮 |
| 资源格式错误 | 文件损坏或格式不识别 | 从源重新下载该资源 |
| 设备空间不足 | 设备存储空间满了 | 先删掉一些旧资源再装 |
| 未适配设备 | 资源不适配当前设备 | 参考 未适配设备处理 |
报错卡片的操作
点击报错的队列卡片可以:
- 查看详细错误信息
- 「前往文档」跳转帮助页面
- 「重连」重新连接设备
- 从队列中移除该资源
设置项
在 AstroBox 设置中,和队列相关的选项有:
| 选项 | 说明 |
|---|---|
| 本地资源自动安装 | 开启后,本地拖入 / 选择的资源会自动推送,不用手动点开始 |
| 推送失败自动重试 | 开启后,推送失败的资源会自动重试 N 次(可配置次数) |
| 断连清空队列 | 默认关闭。开启后断开设备时自动清空当前队列 |
常见问题
队列卡住不动
- 看一下设备连接状态——是不是蓝牙断了
- 看一下队列第一个资源是不是报错了(报错会卡住后面的)
- 试试清空队列重新添加
推送一半设备突然震动
这是推送过程正常的反馈——设备每收到一个资源包可能都会震动提示。等全部推完就好了。
手机端找不到队列按钮
手机端队列按钮仅在设备连接后显示。如果没看到,确认设备是否已连接成功。