资源安装报错排查——从官方源或本地安装失败的处理

从官方源安装报错

资源未适配

这是最常见的错误——你当前选中的设备不适配这个资源。

症状：

• AstroBox 弹出「资源未适配你的设备」提示
• 下载按钮变灰

解决方法：

• 强制安装很危险——可能导致设备异常甚至变砖
• 先检查有没有适配版本（资源详情页右侧下拉切换）
• 没有的话换一个适配的资源

详见 未适配设备处理。

下载后安装失败

资源下载成功了，但推送到设备时报错。常见原因：

本地安装报错

拖拽文件没反应

桌面端拖拽安装无反应：

1. 确认设备已连接——没连接设备，队列按钮都不会出现
2. 确认自动安装开关——关掉自动安装的话，拖拽只会进队列，不会自动推送
3. 进队列页面手动点「开始」推送

文件格式不识别

AstroBox 不认识你拖的文件：

• 确认文件是 AstroBox 支持的格式（.dwz / .mwz / .rpk / .bin / .abp）
• 如果是 .zip，先解压看看里面有没有实际的资源文件
• 如果是第三方格式，可能需要先转换

安装到设备上报错

和官方源安装同样的问题，检查：

• 设备蓝牙连接是否稳定
• 设备空间是否充足
• 目标设备是否正确

安装到一半卡住

卡在「正在推送」

可能原因：

• 设备蓝牙信号差 → 把设备靠近手机/电脑
• 设备电量低 → 先充电
• 队列里前面的某个资源报错卡住了后面的 → 清除出错项

卡住后队列状态

AstroBox 2.1 起支持断点续传。如果推送中断：

1. 断开不会清空队列（除非你手动清）
2. 重新连接设备
3. 点队列上的「开始」，未完成的会继续推送

固件刷写报错

固件刷写比安装资源更敏感：

• 刷写中千万不能断开蓝牙——断开 = 可能变砖
• 电量必须 > 50%
• 确认固件适配你的设备型号（刷错 = 变砖）
• 如果刷写后设备启动慢，等 1-2 分钟，正常

2.1 版本的改进

2.1 版本重写了队列系统：

• 断点续传——推送中断后重连设备继续
• 断连清空队列——可选设置（默认关闭）
• 重连按钮——报错卡片上直接点「重连」
• 前往文档——报错时可以直接跳转相关帮助页面

安装完设备上没出现

资源出现在 AstroBox 里但设备上没看到

• 等几秒——新资源需要设备重新加载
• 断开设备重连一次
• 在设备上看看有没有新资源出现在应用列表里
• 确认装到了正确的设备上（多设备模式下容易搞错）

装完表盘在设备上怎么切换

• 小米手环 9/9 Pro：长按当前表盘 → 左右滑动 → 选新表盘 → 松手
• REDMI Watch 5 / 小米 Watch S3：长按当前表盘 → 左右滑动 → 点选新表盘