Skip to content

About

运动世界校园 自动刷跑客户端 · 纯 Rust,极验本地求解,七步数据自检

Topics

Resources

Stars

62 stars

Watchers

0 watching

Forks

Latest commit

 

History

100 Commits

Folders and files

Repository files navigation

pace-forge

运动世界校园 非官方客户端 — 纯 Rust,一条命令完成登录、轨迹生成与提交。

针对 7.4.01 实测。CLI + Web 双模式,不用装 App、不用模拟点击、不用真机跑。 版本号是硬编码的,厂商换版本需要重新对齐(见「已知局限」)。

⚠️ 本项目涉及第三方应用私有协议的逆向实现,运行结果会直接落到你的账号上。使用前请阅读免责声明与使用者的义务。

pace-forge run 2 12      # 跑 2 公里 / 12 分钟,直接提交
pace-forge web           # 或者开网页,点一下就跑

记分跑

记分跑 = runMode=1 校园跑,是计入体育课成绩的那种。和自由跑的区别:

记分跑 自由跑
接口 runMode=1 runMode=2/3
时段 有固定时段,不在时段内报 11016 无限制
打卡点 必须全过 无
围栏 必须在校区内 无
学期目标 有(semesterDis / selDistance) 无

生成记分跑记录前先查学期进度:

pace-forge semester        # 看还差多少公里 / 几次
pace-forge run 2 12        # 在有效时段内提交

selDistance 用的是规则给的最小里程,不是你自己设的目标——填错会被驳回。

它能做什么

步骤 说明
⓿ 查进度 学期累计里程 / 次数,知道还差多少
① 登录 极验 v4 全本地求解,不需要打码平台
② 拉策略 runModePolicy,拿规则串和最小里程
③ 选围栏 多校区按定位锚点自动选对
④ 拉打卡点 必经点全部命中
⑤ 规划轨迹 闭环折线,凑到目标里程
⑥ 反推时间戳 由速度剖面算出每点时刻
⑦ 合成步数 步频 / 步幅 / 10 秒分桶
⑧ 自检 八类检查,不过就不发
⑨ 上传明细 OBS 对象存储
⑩ 提交成绩 runnings/save/record

Web 界面默认 :9999(pace-forge web 0.0.0.0:9999):登录、记录列表、轨迹地图、模式切换、自检结果实时显示。

为什么这个能过

市面上流通的实现大多只做到「报文能发出去」,数据本身经不起看。这三个问题是实测发现的:

① 步频、步数、速度三者打架

服务端拿 totalSteps / totalTime 和 totalDis / totalTime 一除,就能反推你声明的步频,跟配速对不上就驳回。

常见的 150 + 12v 公式在 6:40/km 会给出 180 步/分,真实数据只有 144——差 36 步,而且形态是反的:

配速 实测步频 正确公式 拍脑袋公式
5:31/km 170 169 173
6:40/km 144 146 180
7:02/km 139 140 177
8:19/km 125 124 162

慢配速时步频掉得更快,是步幅主导而不是步频主导。pace-forge 用的关系式由下面 4 组样本拟合得出:

⚠️ 样本量说明:n=4 的一元线性回归只剩 2 个自由度,残差标准差和 R² 都没有统计意义。 这条公式是基于 4 个点的拟合与推测,不是经过验证的规律。它的价值在于「比常见的 150+12v 形态正确」,而不在于精确。要当成结论用,需要补到 30 份以上真实记录。

步频(步/分) ≈ 34.4 + 44.5 × 速度(m/s)

并写成硬约束,误差 < 1e-9:

v = (cadence / 60) × stride

⚠️ 上表和 evidence/ 里的真机记录口径不同,两个都对: 两条真实记录的 App 汇总页是 6'44"→90 步/分、6'08"→104 步/分 (见 证据文档),比上表低 50 步上下。 原因是 App 那两个字段由「步数 ÷ 时长」「距离 ÷ 步数」派生,而手机计步器 会少计(手持/放包里),于是步频偏低、步幅偏大。上表是步态,真机汇总是 计步口径。我们目前发的是步态(约 157 步/分 @ 5'47"),所以 totalSteps 会比真机记录高——这一处还没对齐,写在「已知偏差」里。

② 10 秒分桶是白噪声

stepsPerTenSec 如果用均匀随机数抖,相邻桶互相独立——一阶自相关 0.089,这是随机数的指纹。真人步频有惯性,自相关显著为正。

用 Ornstein-Uhlenbeck 过程做均值回归:

c_{t+1} = c_t + θ(target_t − c_t)·Δt + σ·√Δt·Z,   Z ~ N(0,1)

对比(0.089 是均匀随机生成器的理论值,0.569 来自少量真人记录的估算,样本不足以给出置信区间):

方案 标准差 相邻差 一阶自相关
均匀随机 3.36 3.66 0.089 ← 随机数指纹
OU 均值回归 2.01 1.42 0.569 ← 真人量级

θ=0.07 对应相关时间约 14 秒,桶间隔 10 秒时相关性还有 0.5。

这里的自相关是真的有测试守着的:lag1_autocorr() 按标准定义算 r1 = Σ(x[i]-μ)(x[i+1]-μ) / Σ(x[i]-μ)²,测试要求生成结果高于白噪声上界 2/√n, 并用一条反向测试确认纯白噪声会被判为无相关。

③ 时间戳和速度对不上

如果点位等距、时间戳也等距,等于全程匀速;但报文里的 speedPerTenSec 有起伏,两者放在一起自相矛盾。

正确关系是 dt_i = d_i / v_i:速度快的段用时短。总时长用最大余数法分配,Σdt 从构造上精确等于目标,不存在累积舍入误差。

实测偏差:

剖面速度 vs 实测速度:平均 0.23%,最大 0.49%
分桶速度 vs 桶内实测:最大 0.00%
总时长误差:0 ms

速度剖面是物理的

不是恒定配速,也不是纯随机波动:

  • 起跑热身:前 20 秒从 0.85× 匀速 ramp 到 1.0×
  • 中段起伏:OU 均值回归
  • 弯道预判:v² ≤ v_corner² + 2·b·d,提前 40m 以 1.5 m/s² 收速
  • 终点冲刺:最后 150m 线性提速 12%

全程匀速跑完是最容易识别的机器特征之一。

关于弯道减速:400m 标准跑道内圈半径 36.8m,2.8 m/s 配速过弯的向心加速度只有 0.198 m/s²,远低于人体上限(约 2.5 m/s²)——这个配速本来就不需要减速。弯道限速只在速度 >4 m/s 或半径 <10m 的急弯实际生效。

两种路线模式

自由路线

在定位锚点周围生成闭环折线,自动凑到目标里程,必经打卡点全部穿过。

操场绕圈

按 World Athletics 标准 400m 跑道建模:

        ┌──────────────────────┐
       ╱                        ╲
      │   直道 84.39m            │     弯道半径 36.50m
       ╲                        ╱      半圆长 115.61m
        └──────────────────────┘

  一圈 = 84.39×2 + 115.61×2 = 400.00m

支持 1–8 道(每道宽 1.22m)。实测:

道次 圈长 生成 5 圈 闭合误差 弯道曲率
第 1 道 400.0m 1999.1m 0.00m 0.02719
第 2 道 407.7m 2037.5m 0.00m 0.02632
第 4 道 423.0m 2114.2m 0.00m —

理论曲率 1/36.8 = 0.02717,实测 0.02719。直道曲率 0.00000。

提交前自检

宁可本地失败,也不要把注定被驳回的报文发出去。 驳回会记错误次数,异常多了触发风控,连正常提交都会被拦。

八类,分两级(致命先拦,警告只提示):

检查项 等级 内容
时间轴 致命 起止戳缺失、顺序颠倒、跨度与 totalTime 不符
轨迹时间 致命 首末点没落在报文边界、时间戳非严格递增
里程 致命 折线实测与声明差 >2m
坐标 致命 越界 / (0,0) / 相邻跳变 >200m
打卡点 致命 任一必过点最近距离 >0.5m
分桶 致命 桶数不符、步数和不等于总步数
上报节奏 致命 采样轴不是 5 秒等时间(出现 1~2 秒空洞即 SAMPLE_RATE / SAMPLE_RATE_SHORT);配置偏离真机只报警告
物理 致命/警告 配速超规则区间、步频超人体范围、步幅异常、步态不匹配
pace-forge dry 2 12      # 只走自检,不发任何写请求

主体配速

自检里有一条只提示、不拦:主体配速。

起步窗口占时长但不产里程(startup_sec 秒里几乎不动),剩下的时间要把全部里程跑完,所以真正发出去的逐点配速是主体配速,不是「距离/时长」那个平均值,两者能差半分钟以上。

这个差别决定一条记录在 App 里看起来红不红。学校区间是 5'00"~10'00" 时:

距离/时长 平均 主体 结果
2km/12min 6'00" 5'04" 距下界只有 4 秒,逐点反复穿越 → 红蓝交替
2km/14min 7'00" 5'55" 越界,整条红
2km/16min 8'00" 7'12" 落在区间中央,基本全蓝

生成时会打印:

! [pace] 主体配速 5'04" 距区间边界只有 4 秒(区间 5'00"~10'00")——正常的逐点波动就会越过边界标红,建议留出 1 分钟以上余量。

距离和时长是用户选的,主体配速是它们的数学结果,所以这里只报警不改参数。

提交台账(防重复记录)

提交请求发出去但结果没回来的情况只有三种:超时、连接被重置、响应体解析失败。这三种里服务端都可能已经入账了。此时再跑一次,服务端就会看到同一时间段的两条记录——那不是「配速偏快」这种能解释成跑者习惯的差异,而是物理上不可能:一个人不可能在同一段时间里跑两次。这是最容易被判定异常、也最难解释的形态。

所以台账记的是意图而不是结果:请求发出之前先落盘一条 pending,拿到 rrid 之后补 accepted,服务端明确驳回才补 rejected。

# 台账位置:~/.pace-forge/submissions/<uid>.jsonl
# 每行一个事件,O_APPEND 单次 write,多进程不会互相截断

三道拦截:

情况 行为
同一时间段上次结果未知 拦住,提示去运动记录页核对。「查不到」不等于「没入账」,不自动重试
别的时间段上次结果未知 放行,另起一行提醒「另有某时段结果未知,建议核对」
该时间段已有本工具提交的记录 拦住,报出冲突的 rrid
不同账号 各记各的文件,互不牵连

第一行和第二行的区别很关键:拦的依据只有「同一段时间不能跑两次」。一次超时把账号永久卡死,比放任一条待核对记录糟糕得多。

「明确驳回」才释放时间段:有业务错误码、能确定没入账的(11016 不在时段、10003 签名错误、10603 被限流等)。网络错误、HTTP 异常、响应看不懂一律保留 pending。

违规名单自查

提交成功不代表没被标记——很多判定是事后跑批判定的。服务端有 POST /api/v78/cheat/cheatlist,本项目把它接出来了:

pace-forge cheat          # 退出码:0 无记录 / 2 已标记 / 3 结果未知或过期

Web 界面走 GET /api/cheat。四种状态分得很清楚:

状态 含义
no_record 服务端明确返回 null 或 count=0
flagged 服务端已标记,带原因、时间、申述状态、关联 rrid
unknown 字段缺失或格式异常。不等于清白
stale 超过 5 分钟,请重新查

第二条是这套逻辑的重点:self 字段整个缺失、count 是字符串、self 是非对象——这些都算「未知」。把未知报成清白比不报更糟,用户会以为查过了没问题。

客户端本地校验对齐

7.4.01 在客户端本地加了一层校验逻辑,本项目在提交前会用同一套规则先验证一遍,避免发出注定被拒的数据。

点位打分

7.4.01 新增的 libswsport.so 里有个 isValidPoint,不是布尔判断,是打分:

score = 基础分(点位等级) + 模式分 + 距离分 + 时间分
valid = (标志A == 0) && (标志B != 0) && (score > 65)

各项上限:基础 30、模式 30、距离 30、时间 10,满分 80。 要过 65 分,基础分必须 ≥ 25,也就是点位等级要够高——不是随便一个点都算数。

距离分的关键阈值是 10 米:相邻点间距低于 10 米才拿满分。

pace-forge 默认采样 5 米一个点,所以满分区占比 100%:

$ pace-forge check 2 12
=== 点位体检(模拟 7.4.01 本地规则)===
  点位检查通过 · 满分区 100.0% · 平均间距 5.0m
  判定: ✓ 通过

间距超过 10 米只扣分,超过 20 米直接拦截——因为那已经不是"跑步采样稀疏",是"轨迹断了"。

心率字段

7.4.01 移除了 BODY_SENSORS 权限,不再读心率。所以报文里如果还带心率, 反而是"用旧版本伪造"的信号。提交前会自动剔除:

pub const FORBIDDEN_FIELDS: &[&str] = &[
    "heartRate", "heartRates", "hrData",
    "avgHeartRate", "maxHeartRate", "bodySensors",
];

硬件指纹

7.4.01 的 Manifest 把这三个设成 required=true(不满足就装不上):

android.hardware.sensor.stepcounter    计步器
android.hardware.sensor.stepdetector   步伐检测
android.hardware.bluetooth             蓝牙

前两个是步数来源,第三个对应新增的 getBluetoothInfo(穿戴设备同步)。 纯软件方案不带这些,属于"设备指纹不全",但服务端目前没有强制校验的证据。

下载与安装

预编译包(Windows x64 / Linux x64)

提供发布包后,可到 GitHub Releases 选择对应系统的版本:

系统 发布包
Windows x64 pace-forge-v{version}-windows-x86_64.zip
Linux x64 pace-forge-v{version}-linux-x86_64.tar.gz

归档包包含可执行文件、LICENSE、本 README、build-info.json 和启动脚本:Windows 使用 start-web.cmd,Linux 使用 start-web.sh。预编译包不需要安装 Rust/Cargo。当前发布目标为 Windows x64 MSVC(静态 CRT)和 Linux x64 musl;具体兼容性以对应版本的 CI 构建结果为准。

Windows:解压 ZIP,在解压目录打开 PowerShell,运行:

.\pace-forge.exe web

也可以运行 start-web.cmd。终端窗口会保持打开;访问 http://127.0.0.1:9999,结束时在终端按 Ctrl+C。

旧版 Windows 若没有设置 HOME,可能把数据写在启动盘根目录的 \tmp 下。升级前关闭程序,将旧目录中的 .pace-forge 文件夹和同级的 .pace-forge-device-id* 文件一起复制到新的数据根目录(通常为 %USERPROFILE%),保留旧文件,避免覆盖新目录中已有的账号数据。设备标识也要一起保留,才能继续复用原来的登录设备身份。

Linux:解压归档,进入包含 pace-forge 的目录,运行:

tar -xzf pace-forge-vX.Y.Z-linux-x86_64.tar.gz
cd pace-forge-vX.Y.Z-linux-x86_64
./pace-forge web

也可以运行 ./start-web.sh。访问 http://127.0.0.1:9999,结束时在终端按 Ctrl+C。将命令中的 X.Y.Z 替换为下载文件对应的版本号。

Pull request、推送到 main 和手动运行发布工作流会生成供检查的 Actions artifacts。预览包文件名会在版本号后附上构建提交的前 7 位,并包含 build-info.json;它们属于对应工作流运行的预览构建,不是正式 Release。正式发布包只会出现在上面的 Releases 页面。

维护者发版

预览构建用于检查工作流产物;手动运行工作流也只生成预览包,不会创建 Release。正式发版前先确认 Cargo 包版本与 Git tag 中的版本一致,再推送 v* tag(例如 Cargo 版本 1.2.3 对应 tag v1.2.3)。通过验证的 tag 工作流会创建 GitHub Release,附上 Windows/Linux 包和汇总校验文件 SHA256SUMS。

从源码构建

需要安装 Rust/Cargo;Windows 还需要 MSVC C++ 构建工具。

git clone https://github.com/IRmsk/pace-forge.git
cd pace-forge
cargo build --release --locked

./target/release/pace-forge help

Windows 生成的程序名为 target\release\pace-forge.exe。源码构建可用于不在上述预编译目标内的平台。

使用

命令行

# 先登录(也可以在网页里登)
pace-forge web
# 打开 http://127.0.0.1:9999,输入手机号和密码

# 生成并提交
pace-forge run 2 12        # 2 公里 / 12 分钟,提交前会问一次
pace-forge run 3 18 -y     # 加 -y 跳过确认

# 只预演
pace-forge dry 2 12

# 操场参数
pace-forge stadium 5 2     # 第 2 道跑 5 圈

# 违规名单自查(0 无记录 / 2 已标记 / 3 结果未知)
pace-forge cheat

Web 界面

pace-forge web 0.0.0.0:9999

登录 → 记录列表 → 轨迹地图 → 设置里程时长 → 点「生成」看自检结果 → 点「提交」。

只想看校区围栏和必到点、不想生成轨迹时,点纬度/经度那行的「查围栏/点位」: 它走只读的 GET /api/points,返回围栏(已转 GCJ-02)和点位,不会触发规划。 锚点留空就取围栏质心。

作为库

use pace_forge::track::{
    plan, sample_times, sample_by_time, simulate, inspect,
    Check, PlanRequest, SimParams, KinParams, SAMPLE_INTERVAL_SEC,
};

let planned = plan(&req, &mut rng)?;                                  // ① 规划
let xy: Vec<(f64, f64)> = planned.points.iter().map(|p| (p.lat, p.lon)).collect();

// ② 5 秒等时间轴(真机上报名就是 5 秒一点,别自己造 1~2 秒的间隔)
let times = sample_times(720, start_ms, SAMPLE_INTERVAL_SEC);

// ③ 按时间积分弧长:每个采样点落在「这一拍该走到的弧长」上。
//    打卡点要一起传进去,规划完会把最近的采样点吸附到打卡点的路径投影上,
//    否则点位离打卡点十几米,服务端判「没经过」。
let track = sample_by_time(
    &xy, &times, start_ms as u64, &KinParams::default(),
    0.9, 6.3, &[], &cps,
);

// ④ 合成步态/分桶
let pts: Vec<(f64, f64, i64)> = track.iter().map(|t| (t.lat, t.lon, t.time_ms)).collect();
let sim = simulate(&pts, &SimParams {
    total_distance_m: len as f64,
    total_sec: 720,
    start_ms,
    target_steps: None,
    seed,
    ..Default::default()
})?;

let report = inspect(&check);                                         // ⑤ 自检
if report.blocked() {
    eprintln!("{}", report.summary());
}

别用 track::simulate::retime():那是「等距点位 + 按速度分配时间」的旧路径, 给出的时间轴是等距的,和真机 5 秒等时间采样对不上。现在只有历史测试还在用它。

架构

.
├── lib.rs / main.rs / test_support.rs   crate 入口、CLI、测试夹具
├── crypto/          NetSecKit 4.2.4 加解密
│   ├── kdf.rs       三段式 KDF(byte_hash → feistel → final_mix)
│   ├── envelope.rs  RSA-1024 + AES-128-CBC(零 IV) 信封
│   ├── decrypt.rs   响应解密
│   ├── sign.rs      MD5 盐签名
│   ├── geetoken.rs  极验 token 组装
│   └── consts.rs    硬编码常量(版本号等)
├── api/             协议层
│   ├── client.rs    设备指纹 + 请求组装
│   ├── coord.rs     BD-09 / GCJ-02 / WGS-84 互转
│   ├── login.rs     登录(含单设备冲突处理)
│   ├── gt4.rs       极验 v4 全本地求解
│   ├── gt4image.rs  Canny + 归一化互相关
│   ├── policy.rs    规则
│   ├── fence.rs     多校区围栏选择(环统一为 BD-09)
│   ├── points.rs    打卡点
│   ├── records.rs   跑步记录列表 / 详情
│   ├── semester.rs  学期进度
│   ├── start_time.rs 有效时段
│   ├── obs.rs       对象存储上传 + 回读校验
│   ├── submit.rs    报文组装 + 提交
│   ├── flow.rs      十步编排
│   ├── gmttime.rs   设备时间对齐
│   ├── accounts.rs  多账号
│   └── session.rs   会话持久化
├── track/           轨迹合成
│   ├── geo.rs       球面几何
│   ├── planner.rs   闭环规划 + 打卡点命中
│   ├── fence_route.rs 围栏内铺路
│   ├── roadnet.rs   路网建图
│   ├── tileroad.rs  瓦片道路识别
│   ├── biomech.rs   步态模型
│   ├── kinematics.rs 速度剖面(OU + 弯道预判刹车)
│   ├── stadium.rs   田径场几何
│   ├── simulate.rs  数据合成 + 一致性校验
│   ├── buckets.rs   10 秒分桶
│   ├── detect.rs    反检测自查
│   └── preflight.rs 提交自检
├── web/             控制台(index.html 编进二进制)
├── docs/            审计、修复记录、笔记(见 docs/README.md)
├── evidence/        可复核的数据底稿
└── tools/           辅助脚本

协议要点

几个容易踩的坑,都是实测确认的:

信封:{"d","h","k","p":"101","t":"0"}。RSA-1024 加密 AES 密钥,AES-128-CBC 用全零 IV,密钥派生是三段自定义函数(byte_hash → feistel_transform → final_mix)。

速度字段(两个层级不同,别混):记录级 speed = 配速(分/公里) × 1000(整数,用 speedTop=2.0 / speedBottom=10.0 反推确认);点位级 speed 就是配速 min/km 浮点(5.08 这种),和 avgSpeed(m/s) 满足 speed × avgSpeed = 1000/60。点位 bdS 是独立的低通速度,不与 speed 同源。

点位接口:runec 字段是额外一层信封,外层顺序 k,p,d,h,t(不是标准体的 d,h,k,p,t);sign = MD5(http版URL + 盐),注意是 http:// 不是 https://;限流 5 分钟 3 次。

OBS 上传:method 参数是 "Put" 首字母大写,不是 "PUT"。

静默窗口:提交后 600 秒内不能再发跑步请求,否则判异常。

测试

cargo test

321 个单测,覆盖:

  • KDF 三段函数(含黄金向量)
  • 信封与签名(含真实样本)
  • 极验图像匹配(合成图验证)
  • 步态等式约束(误差 < 1e-9)
  • OU 过程 lag-1 自相关(真统计量,含白噪声反向对照)
  • 时间分配精确性(Σdt 严格等于目标)
  • 田径场几何(圈长、曲率、闭合误差)
  • 围栏多边形(点在环内、多校区选择、重叠合并)
  • 自检八类的正反例(含采样节奏:2 秒轴、1 秒空洞必须被拦)
  • 报文不变量:stepsPerTenSec 逐项等于 sim.step_buckets、不许有空桶
  • 报文往返:verify_view() 反解出的桶/坐标/时间与原始一致(±1m / ±1s)
  • 配速区间:speedTop/Bottom 三种单位解析 + PACE_OUT 真会触发
  • 分桶分配:三段之和精确等于桶步数、无负值、diff 字段不退化
  • 上报节奏:时间轴必须是 5 秒等时间采样,1~2 秒的空洞会被判 Fatal
  • 围栏坐标系:ring 是 BD-09、ringGcj 是 GCJ-02,逐点断言转换发生且位移在百米量级
  • 配速三口径:speed(min/km) 与 bdS(m/s) 互为倒数、点位配速中位数不许被低速点拉爆
  • 打卡点吸附:规划后采样点必须回到打卡点的路径投影上,残距 ≤ 20m

状态

模块 状态
加解密 / 签名 ✅ 真实接口实测通过
极验求解 ✅ 全本地,实测到密码校验
登录 / 会话 ✅ 含单设备冲突处理
轨迹合成 ✅ 321 单测
提交自检 ✅ 八类
策略 / 围栏 / 点位 / OBS ✅ 接口实现完成
完整提交 ✅ run 命令已接入
围栏 / 点位预览 ✅ 独立只读入口,不依赖规划

文档

根目录只放这一份 README。实现依据、验证记录、排查笔记都在 docs/:

  • docs/audit/ — 逐项审计清单,代码注释按编号引用
  • docs/fix/ — 每次「发现偏差 → 定位 → 改法 → 实测数字」的完整记录
  • docs/notes/ — 零散观测与排查笔记

数据依据

evidence/ 下的文件是可复核的底稿,代码注释里凡是写「真机实测 X」都应该 能在这里找到出处。

文件 内容 能裁决
real-device-app-summary.md 两条真实记录的 App 汇总页数值 字段语义(speed 是配速不是 km/h)、极端配速点深度、步频/步幅是派生量

早期注释反复引用 evidence/obs_real_20261002.json(逐点报文),但该文件从未 入库。凡是只有那个引用支撑的断言,都当作「未复核」看待。

已知偏差

对着真机汇总值比出来的、暂时还没修的两处方向性差异(详见 evidence 文档):

  • 极端慢点深度不够:真机能出现 364 min/km 的点(5 秒走 23 厘米),我们最低 到 31'46"。卡在 track::MIN_SAMPLE_GAP_M = 0.5——相邻采样点间距被钉在 0.5 米,配速上限就被钳住了。
  • 步态偏「小步高频」:真机两条记录是 90104 步/分 × 158164cm,我们是 157 步/分 × 110cm。乘积相同所以配速对得上,但真机那两个数其实是 「距离 ÷ 步数 ÷ 时长」派生的(手机计步器少计),不是真实步态。

许可

MIT

免责声明

本项目的性质

pace-forge 是一个非官方客户端实现,用于学习移动端通信协议与运动数据建模。它从公开渠道获取的客户端样本出发,还原了应用层加解密、签名、轨迹几何与步态建模,并整理成可复用的 Rust 库与 CLI。

项目不包含厂商的私有代码、密钥或证书,不代理、不改写服务端行为。所有请求由使用者本机直接发往官方域名。

使用者的义务

本项目面向协议学习、逆向工程实践与数据建模研究。请确认你满足以下条件:

  • 使用的是你自己的账号,不涉及他人
  • 已了解你所在学校或单位对相关应用的规定,并自行承担合规责任
  • 不将其用于任何形式的收费服务或转售

不满足上述任一条,请停止使用。

可能出现的后果

代码是可运行的,运行结果会真实落到你的账号上。使用前请知悉:

情况 说明
记录被驳回 服务端有数据合理性判定,不符合约束的提交不会计分
账号受限 异常提交会被计数,累计到阈值可能触发账号保护或封禁
数据失效 账号受限后,该账号的成绩与历史记录可能一并不可用

这些是使用第三方客户端或非常规方式访问在线服务时普遍存在的风险,与本项目能否跑通无关。作者不对上述结果承担责任。

责任归属

本项目按「AS IS」提供,作者不承担因使用本项目导致的任何直接或间接损失,包括但不限于成绩认定、账号状态、纪律处分或数据丢失。

下载、编译、运行即表示你已阅读并接受本节全部内容。 不接受请勿使用。

数据处理

  • 数据根目录:Windows 优先使用 HOME,未设置时使用 USERPROFILE,两者都不可用时回退到系统临时目录;Linux 使用 HOME,未设置时回退到系统临时目录。
  • 账号库和当前会话保存在数据根目录下的 .pace-forge/accounts.json 与 .pace-forge/session.json;密码经 AES 加密,uid、登录令牌等字段以未加密的 JSON 保存在本机。设备标识文件保存在数据根目录下的 .pace-forge-device-id-<hash>。请妥善保护这些文件及其备份。
  • 所有请求由本机直接发往官方域名,无中间服务器
  • 无遥测、无统计上报、无远程控制,作者无法获知使用情况

无担保范围

按 MIT 协议「AS IS」提供,明确不担保:

  • 判定结果。服务端规则由厂商控制且会变更,文档中的实测数据均以 7.4.01 为前提,换版本可能全部失效
  • 模型精度。步频关系式由有限样本拟合,theta=0.07 参考自少量真人记录,其价值在于形态比常见实现更接近真实,而非精确复现
  • 账号安全。单设备登录冲突、接口限流、风控计数都会实际影响账号状态

登录失败排查

登录是最容易卡住的一步,绝大多数失败都能从错误码直接定位。先看服务端返回的 error 值(Web 界面会原样显示,CLI 会打在 stderr):

10121 · 此账号已在其他设备登录

10121 登录失败,此账号已在其他设备登录,因账号保护机制,原状态未退出;
请过一小时后登录或原设备退出后再登录

服务端按 device_id 认设备。同一个账号每次登录必须用同一个 device_id,否则它认为你在换手机,直接锁号一小时。

本项目按「手机号」做作用域,一个账号有且只有一套 device_id,存在数据根目录下的 .pace-forge-device-id-<hash>。会触发这个错误的情况:

  • 之前用过别的同类工具,它给账号挂了另一个 device_id
  • 手动删过数据根目录下的 .pace-forge-device-id* 文件
  • 用同一个账号在手机 App 和本工具之间来回登录

处理:等满一小时再试。如果反复触发,去手机 App 里主动退出登录,让它清掉旧会话,再回来登录。

注意:锁定期内每次重试都会重新计时,越试越久。等就行,别刷。

需要过极验滑块

极验 v4 是本地求解(Canny 边缘 + NCC 匹配 + PoW),不需要打码平台。如果反复失败:

  • 检查出口 IP。机房 / 公共代理的 IP 会被极验直接判风险,换成家宽
  • 网络抖动导致 challenge 过期。重试即可
  • 出口走了透明代理(Clash TUN 之类)时,run.gxapp.iydsj.com 的 TLS 指纹可能被改,直连或加规则绕开

连接失败 / Connect error

不是账号问题,是本机到 run.gxapp.iydsj.com 不通。先确认:

curl -sS -o /dev/null -w '%{http_code}\n' https://run.gxapp.iydsj.com/

通不了就是网络层的事(代理、DNS、防火墙),和本项目无关。

拉数据失败但登录成功

登录成功、后面某一步失败,通常是接口限流。打卡点接口限「前 5 分钟内最多 3 次」(错误码 10603),本项目带 5 分钟缓存,正常用不会碰到。如果手快连点,等 5 分钟。

其他错误码

把完整错误贴到 Issue 里,包括 error= 后面的数字和 message。只写「登录不进去」没法定位——10121(设备锁)、10603(限流)、密码错、极验失败,处理方式完全不同。

另外请带上:操作系统、pace-forge --version、用的是 Web 还是 CLI、有没有挂代理。

模板已经去掉了,新建 issue 随便写。 但上面那几样(错误码、版本、平台、rrid)能给就给——少一样就得来回问一轮。

About

运动世界校园 自动刷跑客户端 · 纯 Rust,极验本地求解,七步数据自检

Topics

Resources

Stars

62 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages