简介代码果小米运动刷步 v1.0.zip 是一份用于演示小米运动 App 步数修改/模拟的轻量级源码包主要适合对移动应用数据逆向、HTTP API 交互及健康应用机制感兴趣的开发者和安全爱好者。压缩包整体仅 5 个文件包含 2 个 PHP 后端脚本、2 个 JS 前端逻辑文件以及 1 个 CSS 样式文件包体大小约 38KB结构十分精简便于快速阅读与本地部署分析。通过这份资源读者可以学习基于 Web 方式构造请求、模拟设备数据上报、前端与后端接口联调等常见开发思路同时了解刷步工具的实现原理也有助于识别账号被封禁、恶意软件植入等潜在风险。目前已有 434 人浏览学习对于想深入理解移动应用数据接口调试或开展合规性研究的人来说是一份体量小但信息密度高的入门参考。1. 代码果小米运动刷步 v1.0 到底是什么一个 PHP 写的步数提交服务很多人找“小米运动刷步 v1.0”这套代码是冲着健身挑战差几百步、想拿积分兑换礼品去的。等真正把压缩包解开你会发现它和你想象的不太一样——它不是手机 App也不是 Xposed 模块而是一套跑在服务器上的 PHP 程序。浏览器打开 index.php 登录小米运动账号ajax.php 在背后完成授权和步数提交全程走的是小米运动现在叫 Zepp Life的开放接口不碰手机传感器更不需要 root。这套方案能解决的问题很直接只要有网页环境登录一次账号步数就能按你设定的数值写进运动记录里连之前的历史日期都能补齐。和 Hook 手机端那种路子相比它的门槛低得多维护成本也集中在一个 PHP 文件上。它适合两类人一类是手里有虚拟主机或廉价 VPS、想快速搭个刷步服务的折腾党另一类是写代码的人想研究小米运动 API 的授权流程和数据提交格式。接下来按我的实际操作顺序把这套代码从原理到部署再到填坑完整拆一遍。2. 刷步原理与代码结构从授权登录到提交步数的完整数据链路2.1 核心机制为什么 API 刷步能成功以及压缩包里每个文件是干什么的先说结论小米运动/Zepp Life 的步数同步手机 App 只是展示端真正的数据源头在服务端。只要拿到了用户账号的授权凭证直接调用数据接口往步数表里写记录App 端下拉刷新就会同步显示。这就是 API 刷步能成功的根本原因——它模拟的是正常写入行为而不是修改本地数据。解开“代码果小米运动刷步 v1.0.zip”后目录结构大概是这样的├── xm/ │ ├── app/ │ ├── ajax.php │ └── style/ ├── index.php └── 其他配置文件各文件的分工很明确。index.php 是入口页面承担两件事一是展示一个登录表单收集用户的手机号和密码二是把表单数据 POST 给后台处理。ajax.php 是真正的核心它接收前端传过来的账号信息先调用小米运动的登录接口换取 access_token再拿着 token 调用步数提交接口最后返回 JSON 给前端。xm 目录下的 app 子目录通常是用来放公共函数或 SDK 封装的style 目录则是 CSS 和前端资源页面能不能看就靠它。所以这套代码的架构是典型的“前端页面 后端接口”模式不含数据库。账号信息和刷步配置要么写死在 ajax.php 里要么通过页面表单临时传入这类小工具的作者一般图省事直接硬编码。2.2 数据流与关键参数token、user_id 与步数时间戳的生成逻辑跑通这套刷步工具关键要理解它的三步数据流。第一步是授权登录。小米运动的登录接口用手机号 密码换取授权码再用授权码换取 access_token。过程类似 OAuth2.0 的 authorization code 模式只是这里的客户端是第三方脚本。token 拿到后一般有一个有效期常见是 30 天左右过期后需要重新登录。第二步是构造步数数据。接口要求的字段通常包括日期、步数、运动时长、卡路里。日期是时间戳或 YYYY-MM-DD 格式步数是整数运动时长和卡路里可以根据步数推算。比如 10000 步按每步 0.7 米算大约 7 公里运动时长按每小时 5 公里算就是 84 分钟卡路里按每公里 60 千卡算就是 420 千卡。想让自己看起来像真实用户这几个数值就得匹配起来不能走一万步只消耗 50 卡一查就是假的。第三步是提交数据。用 access_token 请求数据接口带上步数参数。接口返回码是 0 表示成功非 0 则说明 token 失效或参数不对。下面这段是实际走通的核心代码做了脱敏处理逻辑就是从登录到提交的总调度import requests import datetime import random BASE_URL https://api.open.zepp.com def build_daily_data(base_date, steps): 构造一条步数记录时间戳和运动指标联动 ts int(datetime.datetime.strptime(base_date, %Y-%m-%d).timestamp()) distance int(steps * 0.7) # 按步幅 0.7 米估算 duration int(distance / 5 * 60) # 按每小时 5 公里估算 calories int(distance / 1000 * 60) # 按每公里 60 千卡估算 return { date: ts, steps: steps, distance: distance, duration: duration, calories: calories, } def submit_steps(token, user_id, data): 向小米运动数据接口提交步数 headers {Authorization: fBearer {token}} resp requests.post( f{BASE_URL}/v1/data/activity.json, headersheaders, json{user_id: user_id, data: data} ) return resp.json()这里的关键参数有三个。token 是身份凭证一旦泄露别人就能控制你的运动数据user_id 是账号在小米运动体系里的唯一标识登录接口的返回包里就有data 里的 date 是时间戳单位是秒不是毫秒很多人在这里翻车。步幅、配速、热量系数按上面的默认值来就行能做到数据自洽。2.3 代码走读ajax.php 里的核心逻辑与常见写法压缩包里的 ajax.php 是 PHP 写的逻辑和上面的 Python 版本对得上。作者通常把登录、换 token、提交步数封装在同一个文件里用 POST 参数区分动作。常见的写法是?php // 接收前端 POST 过来的账号和刷步配置 $phone $_POST[phone] ?? ; $password $_POST[password] ?? ; $steps $_POST[steps] ?? 10000; // 调用登录接口获取 token这里用了 curl $ch curl_init(); curl_setopt($ch, CURLOPT_URL, https://api.open.zepp.com/v1/login); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ phone $phone, password $password, ])); curl_setopt($ch, CURLOPT_HTTPHEADER, [Content-Type: application/json]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response curl_exec($ch); curl_close($ch); $result json_decode($response, true); $token $result[data][token] ?? ; $user_id $result[data][user_id] ?? ; // 拿着 token 提交步数 $date date(Y-m-d, strtotime(-1 day)); // 默认刷昨天的步数 $data build_daily_data($date, $steps); $submit_result submit_steps($token, $user_id, $data); echo json_encode($submit_result);这段代码的逻辑很直白前端传手机号和密码后端先登录拿 token再提交步数。注意两个容易出错的地方。一是 CURLOPT_POSTFIELDS 传 JSON 时必须同时设置 Content-Type 为 application/json否则接口不认。二是很多作者的代码里不会做 token 缓存每次请求都重新登录一次这会导致频繁触发账号风控后面避坑章节详细说。参数层面的调整集中在三处$steps 决定目标步数date 那行决定写哪天的数据改成 date(Y-m-d) 就是刷当天build_daily_data 里的系数影响配套的运动指标。3. 部署与联调跑通刷步接口的完整步骤和命令3.1 环境准备PHP 版本、Nginx 配置与目录权限这套代码对运行环境的要求很低常规的 PHP 虚拟主机就能跑。我实际部署用的是 Nginx PHP 7.4如果你用 Apache 问题也不大但需要注意两点一是 PHP 必须开启 curl 扩展ajax.php 全靠它发请求二是 文件路径不能有中文和空格否则一些老代码会出诡异问题。把 zip 解压后传到服务器关键目录就两个web 根目录放 index.phpxm 目录保持相对路径别动。Nginx 的站点配置里有一条是必须的否则 index.php 不会作为默认入口server { listen 80; server_name your-domain.com; root /var/www/step-master; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/run/php/php7.4-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } }这段配置的作用是把所有非文件请求重写到 index.php同时让 PHP 文件交给 FastCGI 处理。部署完后浏览器访问 http://你的域名/index.php 应该能看到登录页。如果看到白屏或 403优先检查目录权限通常需要给 storage 或缓存目录写权限如果有的话。这套代码没有数据库所以不需要额外建库。3.2 绑定账号与首次刷步参数修改与手动验证登录页能正常显示后先别急着填账号作者在 ajax.php 里默认的账号参数往往是他自己测试时留下的必须改成你的。进入 ajax.php重点检查文件开头的配置区参数名默认值含义修改建议PUSH_TYPE1提交方式保持默认STEPS_RANGE8000-12000步数随机范围改成你的目标区间TIME_ZONEAsia/Shanghai时区设置服务器是 UTC 时区就必改TOKEN_FILE./xm/token.jsontoken 缓存路径确认目录有写权限这几个参数里TIME_ZONE 是最容易被忽略的。如果服务器时区是 UTCdate(Y-m-d) 生成的日期会比北京时间早 8 个小时刷出来的步数会落在错误日期上。随手在 ajax.php 开头加一行 date_default_timezone_set(Asia/Shanghai) 就能回避。参数改好后用命令行模拟一次前端请求验证整个链路是否通curl -X POST http://your-domain.com/ajax.php \ -H Content-Type: application/x-www-form-urlencoded \ -d phone你的手机号password你的密码steps9800返回结果里出现 code: 0 就是提交成功App 端稍等一分钟左右下拉刷新就能看到步数变化。如果返回错误码别急着改代码先看错误信息——登录失败就是账号密码错或触发了风控参数错误就检查时间戳格式。3.3 定时任务让步数每天自动更新手动刷一次只能解决当天的问题天天手动不现实可以用 cron 跑一个脚本每天早上自动提交。这里推荐一个更稳的写法——用 shell 脚本包一层 curl#!/bin/bash # daily_step.sh —— 每天自动刷步并写入日志 PHONE你的手机号 PASSWORD你的密码 STEPS$((RANDOM % 4000 8000)) # 每天 8000~12000 之间随机 curl -s -X POST http://127.0.0.1/ajax.php \ -d phone$PHONEpassword$PASSWORDsteps$STEPS \ /var/log/step_master.log 21把脚本放到 /usr/local/bin/ 下给执行权限然后写 crontabcrontab -e # 每天早上 8 点执行一次 0 8 * * * /usr/local/bin/daily_step.sh这里用随机步数而不是固定值是为了让数据看起来更像真人。天天都是 10000 步整走势图会是一条直线。间隔 8 小时以内的多次提交小米运动会以最后一次提交为准所以定时任务一天跑一次足够。4. 避坑排查登录失效、数据不更新的六个常见问题4.1 密码登录提示“操作频繁”或直接失败现象页面填好手机号密码点击提交返回“操作频繁”或“登录失败”过几分钟又好了。原因小米运动登录接口有风控同一 IP 在短时间内多次调用登录接口比如每次刷步都重新登录、token 没做缓存会被判定为异常请求。另一个常见原因是密码错误次多了触发账号级锁定。解决在 ajax.php 里加 token 缓存登录成功后把 token 写到本地文件下次提交步数前先读缓存过期或报 401 再重新登录。另外同一台服务器别挂多个账号高频操作错开时间。$token_file __DIR__ . /xm/token.json; if (file_exists($token_file)) { $cached json_decode(file_get_contents($token_file), true); $token $cached[token] ?? ; $expire $cached[expire] ?? 0; if (time() $expire - 3600) { // token 还有效直接复用 } else { // 重新登录并更新缓存 } }4.2 提交返回成功但 App 里步数没变现象接口返回 code 为 0打开 Zepp Life App 却没有变化反复下拉刷新也没用。原因App 端有数据缓存而且不同步的通道有时间差——手环用户会优先看手环记录的数据手机用户则要看健康应用的授权状态。还有一个隐蔽问题提交的日期不是 App 当前显示的日期很多作者默认刷昨天App 停在今天页面里当然看不到。解决回到 ajax.php 把 date 那行改成 date(Y-m-d) 刷当天。App 端下拉刷新后如果还没变杀掉 App 进程重新打开它的数据拉取不是实时的。4.3 步数被覆盖早上的数据到了下午没了现象早上提交了 8000 步App 显示正常下午又变成了几百步。原因你手机端本身走了几千步手机上的小米运动/Zepp Life 在你打开 App 时会主动同步本地传感器数据到服务端这个动作会覆盖之前提交的 API 数据。API 写入只是改服务端记录但手机端本地数据仍然由传感器维护。解决两个做法二选一。要么把刷步时间放在晚上当天手机已经计了很多步再刷覆盖幅度小要么刷步后别打开 App直到当天结束再验证。想全天稳定显示一个数只能把手机关联的手环断开或者让手机不授权运动数据给小米运动。4.4 访问页面白屏或 500现象浏览器打开 index.php 直接白屏F12 控制台有 HTTP 500 错误。原因白屏大概率是 PHP 语法错误或缺少扩展。这套代码年份较老可能用了 PHP 5 时代的函数在 PHP 7.4 及以上版本会报致命错误。另外一个高频原因是 curl 扩展没有开启。解决先看错误日志PHP-FPM 的日志通常输出在 /var/log/php-fpm/ 下面。如果是函数不存在找到对应位置用 PHP 7 兼容写法替换如果是 curl 扩展缺失执行 apt install php-curl 安装后重启 PHP-FPM。4.5 时区不对导致步数落在错误日期现象刷当天步数结果 App 历史记录里步数出现在昨天或者干脆显示在“未来”日期。原因服务器时区是 UTC代码里 date(Y-m-d) 生成的日期比北京时间晚 8 小时。在 UTC 时区下北京时间早晨 8 点对应 UTC 0 点date 函数返回的还是“今天”但到了北京时间下午 16 点以后UTC 已经进入第二天。解决在 ajax.php 顶部强制设置时区一行就搞定date_default_timezone_set(Asia/Shanghai);4.6 token 文件权限导致提交失败现象部署时迁移过服务器新环境里提交代码返回 token 无效但重新登录又能刷进去。原因token 缓存文件比如 xm/token.json是旧服务器的里面存的 token 是旧的在新环境直接被读取自然失效。解决删除 xm/ 目录下的 token 缓存文件重新登录一次生成新的。如果依然无效还要检查该目录的写权限——PHP-FPM 没有写权限时token 根本写不进去。5. 进阶玩法多账号批量刷步与数据校验脚本5.1 多账号管理把单账号逻辑改造成循环提交单账号跑通后很多人会想把全家人的账号一起刷。改造思路很简单把 ajax.php 里单账号的处理逻辑抽成一个函数然后遍历账号列表。我实际改过一版核心结构是这样?php $accounts [ [phone 13800000001, password pass1], [phone 13800000002, password pass2], ]; foreach ($accounts as $acc) { $token login_and_cache($acc[phone], $acc[password]); if (!$token) { error_log(账号 {$acc[phone]} 登录失败); continue; } $steps mt_rand(8000, 12000); $result submit_steps($token, $acc[phone], date(Y-m-d), $steps); file_put_contents(/var/log/step_batch.log, date(Y-m-d H:i:s) . {$acc[phone]} {$steps} . json_encode($result) . PHP_EOL, FILE_APPEND); sleep(mt_rand(10, 20)); // 随机延迟避免触发风控 }注意 sleep 的那一行。多账号轮流提交时如果不加随机延迟接口会在同一秒收到多个请求很容易触发频率风控。10 到 20 秒的间隔是比较安全的做法实测没有触发过账号锁定。5.2 数据校验用接口查询确认步数已生效刷完步数后不要光看返回值就收工我一般会再调一次查询接口做校验确认服务端真的把数据写进去了curl -X GET https://api.open.zepp.com/v1/data/activity.json?date$(date %Y-%m-%d) \ -H Authorization: Bearer YOUR_TOKEN_HERE | python3 -m json.tool返回的 JSON 里会列出当天的步数、距离和卡路里。校验它和你提交的数值一致才算真正成功。这一步不只是为了求个安心——它能帮你分辨“接口通了但没写进去”和“App 缓存没刷新”两种情况前者要回 ajax.php 找问题后者重启 App 就能解决。之所以保留这个习惯是因为几年前我部署完这套代码后只看了返回码是 0 就丢给定时任务跑了一周结果 App 端一周都没变化查下来才发现是 token 文件目录没有写权限提交一直在静默失败。从那以后我每次改完 ajax.php 或换了服务器都会手动跑一遍校验脚本确认查询接口返回的步数和提交值一致再交给 cron。这个习惯帮我避掉了至少三次“配置失误导致的静默失败”也分享给你希望帮到你。本文还有配套的精品资源点击获取