小米账号联动设置——自动同步与固件共享计划

小米账号联动的几项设置

在 AstroBox 设置 → 账号设置 → 更多设置 → 小米账号区域，你可以看到以下选项：

启动时自动同步

开启后的效果

• 每次打开 AstroBox，自动登录小米账号并拉取最新设备列表
• 如果小米账号下新增了穿戴设备，会自动出现在设备列表里
• 如果某个设备从小米运动健康里解绑了，AstroBox 下次同步时也会移除它

为什么推荐开启

• 省心——不用每次手动点「同步」按钮
• 保证设备列表和你实际绑定的设备始终一致
• 不会因为小米账号会话过期而掉链子

为什么可能不想开

• 每次打开 AstroBox 会多一个网络请求（极快，一般无感知）
• 如果你在 AstroBox 登录多个小米账号，自动同步会优先同步最近登录的那个

Authkey 自动覆盖

什么是 Authkey 自动覆盖

小米账号登录后，AstroBox 会自动获取当前设备的 Authkey。当小米服务端返回的 Authkey 发生变化时（这是正常的安全机制），AstroBox 会自动更新本地缓存。

开启后：自动用小米返回的最新 Authkey 覆盖本地关闭后：保留你手动输入的 Authkey，除非手动更新

推荐设置

一般用户：开启（省心，跟着小米的最新 Authkey 走）高级用户 / 开发者：如果需要固定 Authkey 做测试，可以关闭

固件共享计划

什么是固件共享计划

开启后，AstroBox 会自动检查并上报所有小米导入设备的固件版本信息到 AstroBox 的服务器。

上报内容：

• 设备型号
• 当前固件版本号
• AstroBox 版本号

不上报：设备的序列号、位置、小米账号 ID、任何个人身份信息。

为什么要开

• 帮助 AstroBox 社区积累设备固件数据库
• 这些数据用于：
• 检测某个版本是否有大面积 bug
• 帮助 CreatorConsole 创作者了解哪些设备最活跃
• 未来可能用于自动匹配适配资源

为什么可能不想开

纯隐私考量。如果你不想让 AstroBox 知道你设备的固件版本，可以关闭。

关闭后

• AstroBox 仍然会正常检查你设备的固件更新（本地检查，不上报）
• 只是不再把版本信息发送到服务器

小米账号会话过期

小米账号的登录会话会自动过期（小米的安全机制）。遇到这种情况：

1. AstroBox 检测到会话过期
2. 会自动弹出小米账号重新登录页面
3. 重新登录后恢复同步

2.1 版本后，重新登录流程优化过——不会丢失已连接的设备。

小米账号 vs Authkey 连接的选择