WorkBuddy 自动签到（本地优先）

为当前电脑上已经登录的 WorkBuddy 账号，每天执行一次积分签到。不会收集、上传或保存 Token、Cookie 或登录文件。

这是非官方社区工具，与 WorkBuddy、CodeBuddy 或腾讯没有隶属关系。接口、登录文件位置和活动规则可能变化；请自行确认产品规则并仅用于自己的账号。

一句话安装

把仓库链接和下面这段话发送给 WorkBuddy：

请完整阅读 README.md、SKILL.md 和 安装说明-复制给WorkBuddy.txt，识别我的系统后，只使用仓库现有脚本安装并测试 WorkBuddy 自动签到。先 dry-run，不要显示、上传或记录登录凭证；默认每天 06:05 运行。

不能访问 GitHub 时，下载 ZIP、解压并用 WorkBuddy 打开该文件夹，再复制安装说明中的“本地安装”提示。仓库地址：AmberTreelet/workbuddy-auto-checkin。

手动使用

前提：已安装 Python 3，且已在 WorkBuddy 桌面端登录。

python3 scripts/workbuddy_checkin.py --dry-run
python3 scripts/install.py --time 06:05 --run-now

Windows 可将 python3 替换为 py -3。更改时间再次执行安装命令；卸载：

python3 scripts/install.py --uninstall

仅查看任务是否已安装、计划时间与核心脚本状态（不读取登录文件）：

python3 scripts/install.py --status

安全设计

• 只在执行请求时从本机 WorkBuddy 登录文件读取 access token；不会在控制台或日志输出它。
• 单实例锁避免同一台电脑同时发送多个请求；不自动重试，避免触发重复或限流。接口返回非 JSON 数据时会安全失败，且日志会额外过滤常见 Bearer/JWT 形态的敏感字符串。
• macOS 用当前用户 LaunchAgent；Windows 用当前用户、最低权限的计划任务，并支持错过时间后补跑。安装器会拦截常见的旧签到任务，避免重复请求。
• Windows 双击安装器只会选择一个可用 Python 解释器执行，避免因运行时失败而二次发起签到请求。
• 日志只含时间与脱敏后的状态。卸载不会删除 WorkBuddy 登录信息或日志。

验证范围

tests/ 覆盖登录文件定位、Token 解析、幂等状态、锁与 macOS/Windows 定时任务定义。真实领取必须在已登录的 WorkBuddy 机器上最终验收。

致谢与许可

本项目在设计上参考了 liubinne/workbuddy-free-credits 的 MIT 许可实现，并重新组织了安装流程与安全限制。代码以 MIT 许可发布，详见 LICENSE。