AstroBox V1 升级 V2 注意事项——为什么必须先卸载再装
核心结论
装 V2 前必须先卸载 V1。 不卸载直接覆盖安装会导致运行异常、登录失败、界面白屏等问题。
为什么要先卸载
AstroBox V2 相比 V1 进行了彻底重构——不是增量更新，而是从内核层面重写。两版在以下关键层面完全不同：
| 维度 | V1 | V2 |
|---|---|---|
| 插件运行时 | 旧版 wasmtime + Level 1 API | 新版 wasmtime + WASI Preview 3 + Level 2/3/4 API |
| 账号体系 | 无或极简 | 完整账号体系 + 多方绑定 + 权益激活 |
| UI 框架 | 旧版设计系统 | MD3 主题 + 浅色/深色模式 + 窗口记忆 |
| 数据存储 | 旧版格式 | 新版格式（不兼容） |
| 进程模型 | 单进程 | 多进程（UI + 插件沙箱） |
直接覆盖安装会让新旧数据格式冲突，可能导致：
- 启动后界面空白
- 小米账号登录闪退
- 设备连接失败
- 已安装的资源丢失或损坏
正确的升级流程
- 卸载 V1——在各平台的应用管理中彻底卸载
- 清理残留数据（可选但推荐）
- 下载 V2 安装包——注意各平台版本和架构选择
- 安装 V2——首次安装后的引导流程（OOBE）会重新初始化数据
- 重新连接设备——小米账号同步或 Authkey 重新输入
- 重新登录 AstroBox 账号——之前绑定的第三方账号（爱发电 / 米坛 / GitHub）需要在 V2 里重新绑定
各平台卸载方式
Windows
设置 → 应用 → 找到 AstroBox → 卸载。卸载后建议到 %AppData% 和 %LocalAppData% 中搜索 AstroBox 相关文件夹删除（谨慎操作）。
macOS
打开「应用程序」文件夹，把 AstroBox 拖进废纸篓。然后打开 Finder → 前往文件夹 → 输入 ~/Library/Application Support/，删除 AstroBox 相关文件夹。
Linux
- Debian/Ubuntu：
sudo apt remove astrobox - Fedora/RHEL：
sudo dnf remove astrobox - Arch：
yay -Rns astrobox-ng
Android
长按桌面 AstroBox 图标 → 卸载。然后建议到设置 → 应用 → AstroBox → 清除数据。
iOS
长按桌面 AstroBox 图标 → 删除应用。iOS 卸载会自动清理全部数据，无需额外操作。
旧版本插件怎么办
V1 的插件（API Level 1）在 V2 上无法直接使用。好消息是：
- API Level 2/3 的插件在 V2 上继续可用（不会被移除）
- Level 4 是新增的，支持 Python 和 JavaScript
- 插件市场会根据当前 V2 环境展示兼容的插件
开发者如果还在维护旧版插件，需要为 V2 适配新版本 API。