每天 11 点自动领 100 分:WorkBuddy 签到自动化踩坑全记录(含 token 被吊销的血泪复盘)
本文记录了一次完整的"每日签到 + 派喵喵旅行"自动化落地过程:从一份跑不起来的伪代码脚本,到云端定时任务,再到被桌面端会话顶掉后整条凭据链失效、最终用 CLI OAuth 独立会话根治。所有接口、字段、坑点均为实测,代码已脱敏。
前言
WorkBuddy / CodeBuddy 有一个"Buddy 加油站"每日签到,每天 100 积分,连签还有额外奖励;另有"派喵喵去旅行"玩法,猫咪旅行回来可领 5~10 积分,一天能领数次。
目标很明确:每天 11 点自动签到 + 自动派猫领积分,电脑关机也要能跑,手机微信小程序能看结果。
听起来就是"写个脚本 + 挂个定时任务",实际做下来踩了一连串坑。下面按踩坑顺序复盘。
一、最终架构长什么样
先给结果,后面再讲为什么这么设计。
组件 | 实现 |
|---|---|
调度 | 云端定时任务(sandbox_agent),每天 11:00 / 15:00 / 19:00 各一次 |
签到 | checkin.py --real --json:先查状态,未签才签到(幂等) |
旅行 | travel.py --auto:状态机驱动,到达领奖 → 空闲派出 |
凭据 | 独立 OAuth 会话 + 自动续期 + 探活检测 |
结果 | 输出脱敏 JSON,在小程序自动化任务里查看 |
一个关键认知:定时任务必须跑在云端,不能跑在本机 cron / 任务计划。 用户要的是"电脑关机也能签到",只有云端的调度器满足这个条件。
二、踩坑一:拿到的"脚本"根本跑不起来
最初那份 checkin.py 只有 11 行,是伪代码片段,真实报错:
三处硬伤:
29 处 U+00A0 不换行空格——看起来和普通空格一模一样,Python 直接拒绝解析;
urllib.request.Request(url, ...) 里的 ... 是占位符,不是合法参数;
缺少 import os/urllib.request/json 和 __main__ 入口。
处理原则:不改语义、只补全实现。把原文逐行注释保留(U+00A0 降级为普通空格,否则连注释外的代码都会被解析器拒绝),再补上完整实现。
三、踩坑二:uid 还是 uin?登录态读取的顺序陷阱
登录态文件里同时存在两个 ID:
uid:36 位 UUID,dc4678a4-...
uin:12 位数字,330106837835
最初的实现是遍历字典,谁先命中就用谁。结果字典迭代顺序一变,就取到了 uin,签到请求带上错误的 uid,接口返回业务错误。
修法:候选键按优先级逐个匹配,而不是按字典插入顺序"先到先得"。
这个坑的隐蔽之处在于:它有时候是"对的"——只有字典顺序恰好把 uid 排在前面时才正常,所以本地测试可能蒙混过关,一到线上就翻车。
四、踩坑三:网关用 HTTP 400 包裹业务码
官方文档未公开时,最常见的错误写法是:
问题是这套网关会把业务错误包在 HTTP 400 里。如果只处理 2xx,HTTPError 一抛,真实业务码就被吞掉了,日志里只剩一句"HTTP 400",排查无从下手。
修法:HTTPError 也必须把 body 读出来解析。
另一个小坑:billing 接口必须带浏览器 User-Agent,否则服务端裸返 400;而旅行接口不校验 UA。这类" undocumented 契约"只有实测才能发现。
五、踩坑四:响应字段藏在 data 里,字段名还有一堆别名
官方接口把业务数据包在 data 里,而且不同接口/版本的字段名不统一:
今日积分:today_credit / daily_credit / score / points ...
累计积分:total_credits / totalpoints / total ...
连续天数:streak_days / continuedays / streak ...
硬编码单一字段名的脚本,换个接口就取不到值。修法:候选键按优先级 + 广度优先遍历(BFS),先按 keys 顺序、再按层级由浅到深,命中即返回。
六、踩坑五:喵喵旅行是"另一套系统"
这是最容易栽跟头的地方——签到和旅行不是同一个域名,路径规则也不一样:
功能 | 域名 | 路径 |
|---|---|---|
签到(查询/执行) | www.codebuddy.cn | /v2/billing/meter/... |
喵喵旅行 | www.workbuddy.cn | /activity/growth/buddy/travel/...(无 /v2) |
把两者塞进一个 provider、统一域名前缀,改签到路由时会连累旅行,组合起来直接 404。所以拆成两个独立脚本,域名写死,只有服务端路由变了才用环境变量覆盖。
旅行接口共四个端点:
七、踩坑六:幂等是自动化的生死线
定时任务会抖动、会重试、会被手动补跑。如果脚本不幂等,轻则重复请求,重则白记一次派遣次数。
签到的幂等:先调 checkin-activity-status 查今日状态,已签直接返回 already(退出码 0,不报警),未签才调 daily-checkin。
旅行的幂等——服务端状态是唯一权威,脚本无状态:
还有两条安全约束:
写操作只有显式加 --auto 才执行,默认只读查询;
到达后状态保持 arrived,即使本次领奖失败,下次巡检会自动补领,积分不会丢。
退出码也要设计成"语义化":成功、今日已签、未签到(只查询模式)都返回 0,只有真失败返回 1。否则自动化任务天天因为"今日已签"误报失败。
八、踩坑七(血泪):桌面端一次刷新,云端主备凭据全军覆没
这是整个项目最致命的一坑,发生在上线第二天。
现象:定时任务跑了一天一切正常,第二天早上 11 点签到失败。手动执行,签到和旅行接口全部返回 401。
排查:
诡异的是,accessToken 的 JWT 里 exp 显示还有 27 天有效期,本地完全没临期。继续调用刷新接口,服务端返回:
真相:Keycloak 的刷新令牌是按会话链式管理的。我在桌面上登录 WorkBuddy 客户端时,客户端刷新了同一个 session 的 token 链,导致我之前从这个会话导出的凭据(以及备份凭据——它们同属一个 session)整条被吊销。JWT 没过期,但服务端已经不认了。
教训:
从桌面登录态文件复制出来的凭据,和桌面端共享同一个会话生命周期。桌面端一动,云端副本就废。这种方案做临时验证可以,做长期无人值守Automation是定时炸弹。
根治方案:改用官方 CLI OAuth 授权流程,创建独立于桌面端的全新会话:
这个会话和桌面端登录彻底隔离——桌面端怎么刷新、重登,都不会再影响云端签到。
九、踩坑八:续期脚本的盲区——只看过期时间不够
上一个坑还暴露出续期逻辑的缺陷:脚本只看本地 JWT 的 exp,发现"还有 27 天"就跳过刷新,完全不知道 token 已经被服务端吊销了。
修法:加一层探活检测——每次任务运行,先用当前 token 发一次只读状态查询:
返回 401 → 说明 token 已被吊销,立即强制刷新;
返回 200 → 正常,再按过期时间决定是否临期续期。
另外,即使主 refreshToken 刷新失败,也预留了降级到备份凭据的容灾分支,两道保险。
十、安全设计
自动化脚本手持用户完整登录态,安全边界必须显式:
脱敏:任何输出经过 _redact() / _sanitize_text(),token、refreshToken 等字段一律替换为 ***,不进 stdout、不进日志、不外传;
只读登录态:签到脚本绝不写入/修改凭据文件,续期脚本原子替换(.tmp + os.replace);
写操作白名单:只允许 daily-checkin、travel/claim、travel/depart 三个已验证接口,不碰兑换、抽奖等其他写接口;
前置检查:派出前必查 daily_limit_reached,达上限绝不发写请求;
失败如实上报:凭据缺失或过期时停止并提示,绝不伪造数据。
十一、最终效果与踩坑速查表
# | 坑 | 一句话经验 |
|---|---|---|
1 | 伪代码 U+00A0 / 占位符 | 逐行注释保留原文,再补全实现,不要直接改语义 |
2 | uid/uin 顺序陷阱 | 候选键按优先级匹配,别信字典顺序 |
3 | HTTP 400 包裹业务码 | HTTPError 也要读 body 解析 |
4 | 响应字段藏在 data、别名多 | BFS + 候选键优先级取值 |
5 | 签到/旅行跨域名跨路径 | 拆成独立 provider,域名写死 |
6 | 定时任务重复触发 | 先查后做 + 服务端状态驱动,幂等退出码 |
7 | 桌面端刷新顶掉云端凭据 | 用 OAuth 独立会话,别从桌面登录态复制长期用 |
8 | 续期只看过期时间 | 加 401 探活,被吊销立即强制刷新 |
最终效果:每天 11 点自动签到(+100 分),15/19 点各巡检一次旅行(领奖 + 派出),电脑关机照常运行,手机小程序查看结果。上线后连签天数稳定增长,再没因为凭据问题掉过链子。
结语
自动化签到的难点从来不是"发一个 POST 请求",而是在真实运行环境里把幂等、凭据生命周期、多源解析、网关怪癖这些边角料全部处理干净。尤其凭据——只要它和别的客户端共享会话,就永远悬着一把达摩克利斯之剑。独立会话 + 探活 + 容灾,三层加起来才敢说"长期无人值守"。
希望这篇复盘能帮你少踩几个坑。如果你也在做类似的积分自动化,欢迎在评论区交流。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。