极氪 App 自动签到 · 多客户端脚本

每天自动完成极氪 App 的 签到 → 上报步数 → 做任务（阅读文章 / 每周点赞）→ 领取奖励（碎片 / 能量球 / 极值）。

一套逻辑，五个平台可用：Quantumult X / Loon / Stash / Egern / 青龙（同一份 zeekr.js 在 Surge、Node.js 上也能跑）。 跑在手机上（代理客户端）或服务器上（青龙），不需要手机常开。

国内访问 raw 慢/不稳的话，可换 jsDelivr 镜像： https://cdn.jsdelivr.net/gh/m20104600/zeekr-checkin@main/dist/zeekr.js 或者把文件下载后放自己的服务器/对象存储（客户端也支持本地文件）。

• 零依赖纯 JS：SHA1 签名、base64（步数 secret 要套 5 层）都是手写实现， QX/Loon/Stash 这类没有 crypto / Buffer 的运行环境照样跑。
• 签到 + 步数 + 任务 + 领取全套：阅读文章、每周点赞（自动判断本周是否已完成、 只在需要时点一次）、能量球 / 极值 / 碎片领取。
• 处理「奖励延迟入账」：极氪的碎片/能量球是任务做完后 1~3 分钟才到账的。 默认「快跑 + 补领」：主任务跑完只领一轮，10 分钟后再跑一条只领取的任务收尾； 客户端超时够宽的话也可以开 POLL=1 让脚本自己轮询到领光。
• 手机端自动抓 Token：配一条抓取规则 + 开 MITM，打开极氪 App 点一下， Token 自动存进客户端（键名 zeekr_val），之后定时任务不用填 Token。 抓取成功的通知里会附上完整 Token 文本，方便复制到青龙那种抓不了的平台。
• Token 清洗：带单/双引号、前后空格、零宽字符、只粘裸 JWT（自动补 Bearer ）都能用。
• 通知只给结论：不刷屏（VERBOSE=1 才输出逐轮明细）。
• 青龙多账号：ZEEKR_TOKEN 里换行分隔多个 Token，或 ZEEKR_TOKEN_1/2/...。

配置文件片段都在 configs/ 里，照抄即可：

Loon 插件（直接贴进 Loon 的插件页）：

https://raw.githubusercontent.com/m20104600/zeekr-checkin/main/configs/loon.plugin

Egern 模块（直接贴进 Egern 的模块页）：

https://raw.githubusercontent.com/m20104600/zeekr-checkin/main/configs/egern.yaml

QX / Stash 用 configs/qx.conf、configs/stash.yaml 里的内容（地址已经填好，直接复制）。

国内更快的镜像（jsDelivr，把 raw.githubusercontent.com/m20104600/zeekr-checkin/main 换成 cdn.jsdelivr.net/gh/m20104600/zeekr-checkin@main 即可）。

手机端（QX / Loon / Stash / Egern）自动抓：开 MITM（信任 CA 证书）+ 配上片段里的抓取规则 → 打开极氪 App 随便点一下 → 收到 「✅ 极氪 Token 已自动保存」通知，Token 已存进客户端，定时任务无需再填。

Egern 的「抓取 Token」开关（模块设置页里，默认开）：

• 开 = 打开极氪 App 就抓取并存进持久化存储；Token 变了立刻弹一条通知， 没变则 10 分钟内最多一条（等于每次开 App 有一条确认，又不会刷屏）
• 关 = 完全不抓取、不写存储、不弹任何通知（连「抓取调试」也不弹）
• 改完开关要把 Egern 的 VPN 开关断开重连一次，模块参数才会重新加载

模块设置里没有「极氪 Token」栏（2026-09-20 起删掉）：Egern 不允许脚本回写设置页， 抓到的 Token 只活在「持久化存储」里（键 zeekr_val），定时任务每次自动读 —— 放一个 永远填不进去的输入框只会让人误会为什么"抓到了却没填上"。 想把 Token 拿去别处用（青龙等）：点一下抓取通知即可复制到剪贴板。 Egern 版脚本不读任何手填的 Token（ZEEKR_TOKEN 给了也一律忽略，日志里会写明）—— 唯一来源就是抓取到的那个，这样不会再有人问"我填了这一栏怎么没用"。

青龙没有 MITM，抓不了 —— 用手机抓一次，把通知正文最后那行 Bearer eyJ... 复制过去，粘到环境变量 ZEEKR_TOKEN； 或者把整段 JSON 粘给 zeekr_val / ZEEKR_VAL（与常见极氪脚本格式互通，脚本会自动认）。

也可以自己抓包：过滤域名 api-gw-toc.zeekrlife.com，复制任意请求头里的 Authorization。

推荐「三场 × 2 条」（与服务器版 systemd 三场一致，00:01 / 08:10 / 21:30 各一场， 10 分钟后再补一条只领取）：

00:01 全流程    00:10 只领取（补延迟入账的奖励）
08:10 全流程    08:20 只领取
21:30 全流程    21:40 只领取

超时能放宽的客户端（Loon 600s / Stash 420s / Egern 600s / 青龙 420s+）可以只用 3 条 cron + POLL=1，脚本自己轮询到领完（单次约 3~5 分钟）。 QX 的脚本执行上限约 30 秒且不可配置，别用 POLL=1。

写在客户端的 argument / # 参数 / env 里，或者本地脚本顶部的 ZEEKR_DEFAULT_CONFIG。 前缀 ZEEKR_ 可有可无，大小写不敏感（TOKEN、zeeKr_token、ZEEKR_TOKEN 都认）。

示例：

QX   : script-path=.../zeekr.js#TOKEN=Bearer eyJ...&TAG=凌晨场
Loon : argument="TOKEN=Bearer eyJ...,TAG=凌晨场"
Stash: argument: '{"ZEEKR_TOKEN":"Bearer eyJ...","ZEEKR_TAG":"凌晨场"}'
Egern: env: { ZEEKR_TOKEN: "Bearer eyJ...", ZEEKR_TAG: "凌晨场" }
青龙 : 环境变量 ZEEKR_TOKEN / ZEEKR_MODE / ZEEKR_TAG

├── dist/                  ★成品脚本（客户端引用这三个）
│   ├── zeekr.js           QX / Loon / Stash / Surge / Node
│   ├── zeekr.egern.js     Egern（ES Module + ctx API）
│   └── zeekr.qinglong.js  青龙（多账号 + sendNotify + 无 fetch 时 https 兜底）
├── configs/               各客户端配置（qx.conf / loon.plugin / loon-snippet.conf / stash.yaml / egern.yaml / qinglong.md）
├── parts/core.js          核心逻辑（运行时无关）
├── tpl/{classic,egern,qinglong}.js   三个模板，含 /*__CORE__*/ 占位
├── build.py               把 core 内联进模板 → dist/，并做 node --check
├── gen_configs.py         生成 configs/
└── tests/                 4 套自动化测试

自行改逻辑：改 parts/core.js（或 tpl/*）后

python3 build.py        # 重新生成 dist/ + 语法检查
python3 gen_configs.py  # 重新生成 configs/（一般不用动）

签名密钥在源码里是 __ZEEKR_SECRET__ 占位符，构建时自动填入；来源优先级： ZEEKR_SECRET_SRC 环境变量 → 本机 node 版脚本 → 已有的 dist/zeekr.js （所以直接克隆本仓库也能构建）。

node tests/unit.js            # 35 项：纯 JS SHA1/base64 与 Node 原生逐字节比对、JWT 解析、参数解析、Token 清洗
node tests/e2e.js             # 36 项：模拟 Loon/Stash/QX 运行时，真打极氪接口（claim 幂等）
node tests/e2e-egern.mjs      # 24 项：模拟 Egern ctx（schedule + 抓取 + 取头兼容 + 「抓取 Token」开关与通知门控）
python3 tests/e2e-qinglong.py # 22 项：真跑青龙脚本（多账号、zeekr_val、裸 JWT、无 fetch 的 https 兜底）

合计 103 项断言。E2E 会真的请求极氪接口，需要一个属于你自己的 Token： 读环境变量 ZEEKR_TOKEN，没有则读 /root/.config/zeekr-checkin/env。 其中 MODE=claim（只领取）与 MODE=all（签到当天幂等、步数重复上报无副作用）都是安全的。

• 脚本只使用你自己抓包/抓取得到的 Authorization Token，不保存账号密码、不模拟登录。
• 源码里内嵌的 SECRET 是极氪 H5 前端的固定签名 key（公开前端里就有，非账号凭证）， 用于生成 x_ca_sign 请求头。
• 仅供个人学习与自用；上游接口/页面一旦调整可能失效，请自行评估使用风险。
• 本仓库此前用于存放签到记录存档，现已改为多客户端脚本；旧存档已转入私有仓库。

用到的接口（2026-09 实测）： zgreen/center（签到）、walkData/initDayWalkData（步数）、 taskProgress/taskMsg（任务列表）、invitation/pub/detail（阅读）、 invitation/pub/list + clicks/fabulous（点赞）、 carEnergy/getUncollectedBallsPageNew（可领取）、 apply/batchApply（碎片）、carEnergy/collectedAllEnergy（能量球）、 carEnergy/collectIntegralZeekrBalls（极值）。

• 2026-09-25（v2.3.0）：修七日连签抽奖球领取 —— SIGN_CONTINUOUS_7_LOTTERY 不再按普通碎片走 batchApply，改用 App 抓包确认的 applyV2/apply + record=zgreen_7day_activity + fixedZgreenAssetId，可领取锦鲤泡泡 / 5Kr 等七日奖励。

• 2026-09-21（v2.2.0）：修**「通知说领完了、App 里碎片/能量还在」（真事故）—— ① 批量领取碎片里有个别失败时真的逐个重试**（旧版只打一句「逐个重试」的日志、实际没重试）， 并把服务端返回的失败原因原样写进日志（旧版把原因丢掉，事故因此查不出来）； ② 领取循环只有在确实领到之后才把条目记为已领 —— 旧版在领取之前就记， 一次失败就永不重试，列表还被过滤成空，于是打出「✅ 可取皆已领完」； 失败项现在会留到下一轮再试（最多 3 次）； ③ 还有没领掉的时结论写「⚠️ 仍有 N 项未领到」，通知标题变 「⚠️ 极氪签到（未领净）」、 正文列出 名称→原因，不再写「🎉 全部完成！」。 新增离线回归 tests/claim-retry.js（12 项断言，不打真接口）。

• 2026-09-19（v2.1.0）：修 Egern 抓取 + 加「抓取 Token」开关 —— ① 取头大小写：Egern 递进来的 ctx.request.headers 是普通对象、键名保留原始大小写 （Authorization），旧代码只试小写键 → 恒取不到值（现象：日志写「这条请求没有 Authorization 头」）。现在键名一律小写归一化后再匹配（对齐参考脚本 wf021325/qx 的 ObjectKeys2LowerCase 写法），Headers 对象（get/forEach）与普通对象都认； ② 跳过 OPTIONS 预检请求，裸 JWT（无 Bearer 前缀）也自动补齐后保存； ③ 模块设置新增 「抓取 Token」开关（默认开）：开 = 开 App 就抓并弹通知（Token 变了 立刻弹，没变则 10 分钟最多一条）；关 = 不抓、不存、不弹任何通知（含调试）； ④ 抓取通知点一下即把 Token 复制进剪贴板（iOS 不允许脚本回写模块设置页， 想填那一栏就点通知再粘贴）；通知里也会标明开关状态与脚本版本； ⑤ 补硬闸：HTTP 上下文里只抓 Token，绝不误跑签到流程； ⑥ 模块设置里删掉「极氪 Token」栏（用户要求：Egern 不允许脚本回写设置页， 留一个填不进去的输入框只会误导），同时把「env 里的 Token」改成必须形态合法才算配置 —— 占位符/垃圾值一律忽略，回落到抓到的那个。 回归测试见 tests/e2e-egern.mjs（B2 取头兼容 6 条 + D 开关门控 8 条）。

• 2026-09-19：修正配置文件的两个致命问题 —— ① Loon 配置改成真正的插件（configs/loon.plugin，首行 #!name，带 [Argument] 参数 UI）， 之前的片段式写法 Loon 加载不出来； ② Egern 配置改成真正的模块（元数据 + mitm + scriptings，正则改单引号）， 之前的双引号 \d 会让 Egern 直接报 YAML 解析错误； ③ 修正所有客户端抓取正则多转义一层的问题（原来 \. 写成 \\.，等于匹配"反斜杠+任意字符"，一条都命中不了）， 并新增 tests/configs-check.py 做回归（校验 YAML 可解析 + 每条正则真能匹配目标 URL + 插件/模块格式）。