AstroBox 使用指南——穿戴设备第三方工具箱完全手册
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
关于 AstroBox
AstroBox 是一款跨平台的穿戴设备第三方工具箱，由 Rust 驱动构建。它的核心使命是：让你对自己的智能穿戴设备拥有更多控制权——安装表盘、安装快应用、刷写固件、通过插件扩展功能，全部可以在一个应用内完成。
从 2.0 版本开始，AstroBox 进行了彻底重构，引入了 WASI + wasmtime 的插件运行时、全新的 MD3 主题系统、多设备同时连接、CreatorConsole 创作者平台等一系列重量级特性。
产品档案
| 项目 | 说明 |
|---|---|
| 最新版本 | V2.2.0（桌面端 / Android）、V2.2.2（iOS） |
| 技术栈 | Rust + Tauri（桌面端）、原生 Android/iOS |
| 插件运行时 | WASI Preview 3（wasmtime） |
| 开源协议 | GNU Affero General Public License |
| 支持平台 | Windows 10 / macOS Sonoma 14+ / Linux（x86_64）/ Android 10+ / iOS 16.5+ |
| 支持设备 | 小米手环 9/9 Pro、REDMI Watch 5、小米 Watch S3、vivo Watch GT 等 |
| 主要功能 | 表盘/快应用/固件安装、多设备管理、插件系统、创作者工具 |
快速开始
- 你的设备支不支持？ → 先看 支持哪些设备
- 我该装哪个平台？ → 跨平台支持概览
- 装完怎么连设备？ → 小米账号同步（推荐）或 Authkey 手动连接
- 怎么装表盘？ → 官方源下载 或 本地资源安装
- 想写插件？ → 插件系统概览 + 开发者入门
内容导览
产品定位与设备兼容
搞懂 AstroBox 是什么，确认你的穿戴设备在不在支持列表里，了解五大平台的支持情况。
→ 进入第一组
安装与部署
从 Windows、macOS、Linux、Android、iOS 五大平台中找到你的安装指南，各平台有特殊注意事项（比如 macOS 的签名绕过、iOS 的系统版本要求、Linux 的发行版对应包型）。
→ 进入第二组
设备连接
连接是使用 AstroBox 的前提。推荐用小米账号一键同步，也可以手动输入 Authkey 或 OpenID。2.2 版本起支持多设备同时连接与快速切换。
→ 进入第三组
资源安装
表盘、快应用、固件——三种资源三种渠道（官方源 / 三方源 / 本地）。电脑端还支持直接拖拽文件安装。未适配的设备不要强装，有安全风险。
→ 进入第四组
账号体系
AstroBox 自有账号 + 米坛 / GitHub / 爱发电 / Apple 四大绑定。绑定爱发电后可以激活付费权益和购买的资源。
→ 进入第五组
插件与扩展
AstroBox 基于 WASI 的插件系统是其高可扩展性的核心。API Level 4 新增 HTTP 服务器和应用内浏览器，并将 Python 与 JavaScript 纳入官方支持语言。
→ 进入第六组
创作者工具
CreatorConsole 让第三方创作者可以用图形界面上传资源、加密防护、关联爱发电商品实现付费售卖。资源类型包括表盘和快应用（.rpk）。
→ 进入第七组
界面与设置
浅色模式 / 主题配色、设备页小组件自定义、CDN 测速切换、导航栏样式、多语言——日常使用中会调整到的设置项都在这里。
→ 进入第八组
问题排查
蓝牙连接失败、Android 闪退、iOS TargetRejected 配对报错、小米账号登录失败、资源安装报错、队列卡住——遇到问题先查这里。
→ 进入第九组