首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >WorkBuddy自动签到踩坑实录#WorkBuddy#

WorkBuddy自动签到踩坑实录#WorkBuddy#

原创
作者头像
用户12909974
修改于 2026-11-20 13:47:14
修改于 2026-11-20 13:47:14
110
举报

每天 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 删除。

问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档