技能介绍

要解决什么问题

手环步数往往来自真实运动，但也有人需要在 Zepp Life（原小米运动）里把当日步数同步到指定区间，以便与支付宝蚂蚁森林等依赖步数的场景对齐。手动改数据不现实；本技能面向的是：在本地用华米运动账号，通过官方相关 HTTP 接口自动上报一段随机步数，并能在 Agent 对话里完成配置、执行与结果解读。

技能如何工作

执行前会检查 config.json 里的 accounts 数组。若为空，Agent 按流程收集手机号或邮箱、密码、可选昵称，以及步数范围（默认 15000–16000），再写入配置。实际刷步通过脚本参数控制，例如 --min-steps、--max-steps，多账号时可用 --account 指定；--check 仅做环境与配置检查。

成功时输出 Brush Step Report，需向用户汇总成功账号与步数、失败账号及 [FAIL] 原因，并给出成功数/总数。用户若要求每天自动刷步，可配合 cron（常见建议为每天 20:00），也可分时段设置不同步数区间以模拟渐进增长。

底层依赖 requests 与 pycryptodome（登录 AES），涉及登录 Token、客户端登录与 band_data.json 步数上报等端点。

边界与注意

账号为华米/Zepp Life 体系，APP 请搜索 Zepp Life 注册；无法同步到支付宝等场景时，资料建议考虑新注册账号并在第三方测试页先验证。
密码明文保存在本地 config.json：勿提交公开仓库，建议 chmod 600。
常见失败：Login failed（凭据）、Token failed（网络或限流）、Network error、No valid accounts（未配置），需按表引导重试或补全配置。