xiaomi-brush-steps（小米刷机步骤）

AI 执行指南

当用户请求"刷步数"、"修改手环步数"、"帮我刷步"时，按以下流程执行：

1. 账号使用说明

在使用本技能前，需要准备华米运动账号：

小米运动自动刷步数（支持邮箱登录）

小米运动自动刷步数，小米运动APP现已改名 Zepp Life，为方便说明，后面还是称其为小米运动。但下载注册时请搜索 Zepp Life。

账号测试建议

注册账号后建议先去以下网站测试自己的账号刷步数是否正常（注意这些网站只是网络上收集的，不保证安全和有效性）：

• https://steps.hubp.de/ - 提示密码错误时可以多试几次或者切换网络
• https://bs.yanwan.store/run4/ - 验证码001或998

⚠️ 重要提示：如无法刷步数同步到支付宝等，建议重新注册一个新的。

2. 首次使用检查

首次执行前，检查 config.json 是否已配置账号：

cat "${SKILL_DIR}/config.json"

若 accounts 数组为空，按以下步骤引导用户：

1. 询问华米运动账号（手机号或邮箱）
2. 询问密码
3. 询问账号昵称（可选，用于显示）
4. 确认步数范围（默认15000-16000）

然后将账号信息添加到 config.json：

# 编辑 config.json，按以下格式添加账号
# {"name": "昵称", "username": "账号", "password": "密码"}

示例：

{
  "accounts": [
    {
      "name": "我的账号",
      "username": "13800138000",
      "password": "your_password"
    }
  ]
}

3. 执行命令

python3 "${SKILL_DIR}/scripts/brush_step_skill.py" --min-steps {min} --max-steps {max}

参数说明：

• --min-steps: 最小步数（可选，默认15000）
• --max-steps: 最大步数（可选，默认16000）
• --check: 仅检查环境和配置
• --account "名称": 指定刷特定账号（多账号时）

4. 输出解析

成功时输出 "Brush Step Report"，格式：

=== Brush Step Report ===
Range: 15000 - 16000
Status: [OK]
Success: 2/2

1. 账号1: 15678 steps [OK]
2. 账号2: 15234 steps [OK]
========================

失败时输出包含 [FAIL]，需提取失败账号及原因。

4. 结果告知

向用户清晰报告：

• ✅ 成功刷步的账号和步数
• ❌ 失败的账号及错误信息
• 📊 统计（成功数/总数）

5. 定时任务

若用户要求"每天自动刷步"：

1. 使用 cron 工具创建定时任务
2. 推荐时段：每天晚上20:00（0 20 * * *）
3. 可设置不同时间点不同步数实现渐进效果：

- 9:00 → 10000-12000步 - 12:00 → 14000-16000步 - 20:00 → 18000-20000步

6. 错误处理

常见错误及应对：

8. 安全提醒

⚠️ 密码明文存储在 config.json 中：

• 仅在本地环境使用
• 不要将 config.json 提交到公开仓库
• 定期检查文件权限（chmod 600 config.json）

技术实现

配置文件格式

config.json 结构：

{
  "accounts": [
    {"name": "账号1", "username": "13800138000", "password": "xxx"}
  ],
  "step": {"min": 15000, "max": 16000},
  "network": {"use_fake_ip": true}
}

依赖

• requests: HTTP请求
• pycryptodome: AES加密（用于登录）

API端点

• 登录: https://api-user.zepp.com/v2/registrations/tokens
• Token: https://account.huami.com/v2/client/login
• 刷步: https://api-mifit-cn.huami.com/v1/data/band_data.json

OpenClaw Skill Compatible