WorkBuddy 自动化工具箱（青龙面板版） ⚡

把 WorkBuddy 的「每日签到」和「宠物自动探险领积分」两个高频手动操作完全自动化，纯 Python 跑在青龙面板上定时执行。

🐱 一键订阅到青龙 · 🐛 报 Issue · 💡 提需求

• ✨ 功能
• 💡 为什么用这个
• 🔧 安装
• 🚀 快速开始
• 🔀 工作流
• 🏗️ 架构
• 🔐 获取 Token
• 🌿 环境变量
• 🗺️ 路线图
• ❓ 常见问题
• 🙏 致谢

两个脚本共用同一套设计原则：

• 零重依赖：仅需 requests（青龙一般已自带），缺失时自动回退标准库 urllib
• Token 不写死：全部从环境变量读取，支持多账号一行配置
• 幂等安全：高频运行无副作用；已签到 / 宠物空闲时调用领取会被优雅跳过
• 青龙友好：输出直接被面板捕获并推送通知（Server 酱 / 钉钉 / 企业微信 / Telegram）

⚠️ 本工具仅向官方接口 copilot.tencent.com 发送你自己的 Bearer Token，不会上传到任何第三方。Token 属于敏感凭证，请勿提交到公开仓库、也不要在公开场合泄露。 登录态通常约 90 天有效，过期后需重新获取并更新环境变量。

方式一：青龙面板订阅（推荐）

1. 打开青龙面板 → 订阅管理 → 新建订阅
2. 填写：
   • 名称：workbuddy-checkin
   • 仓库地址：https://github.com/xmgzxmgz/workbuddy-checkin-qinglong
   • 定时规则：0 0 * * *（每天 0 点，可按需调整）
3. 保存并运行一次拉取脚本

方式二：本地 / 服务器

git clone https://github.com/xmgzxmgz/workbuddy-checkin-qinglong.git
cd workbuddy-checkin-qinglong
pip install -r requirements.txt   # 仅 requests

配置环境变量（青龙：配置文件 / 环境变量；本地：直接前缀）：

# 单账号
export WB_ACCESS_TOKEN="eyJxxxx.your.token"

# 多账号（逗号分隔，支持 uid:token 或纯 token）
export WB_ACCESS_TOKENS="eyJ...a,10086:eyJ...b"

青龙里给两个脚本分别建任务，命令如：

task workbuddy_checkin.py
task workbuddy_buddy_travel.py

本地调试（不依赖青龙）：

WB_ACCESS_TOKEN=xxxx python3 workbuddy_checkin.py
WB_ACCESS_TOKENS=xxxx python3 workbuddy_buddy_travel.py

每日签到

flowchart TD
  A[定时触发] --> B{今日已签到?}
  B -- 是 --> C[跳过 · 无副作用]
  B -- 否 --> D[调用 daily-checkin]
  D --> E[领取积分]
  E --> F[打印结果 · 青龙推送通知]

宠物自动探险（状态机）

stateDiagram-v2
  [*] --> idle
  idle --> traveling: depart 派出
  traveling --> arrived: 探险归来
  arrived --> idle: claim 领取积分
  arrived --> idle: 已达每日上限 → 跳过
  idle --> idle: 仅领取模式 WB_TRAVEL_AUTO_DEPART=0

flowchart LR
  S1[workbuddy_checkin.py] --> API[copilot.tencent.com 官方接口]
  S2[workbuddy_buddy_travel.py] --> API
  API --> Q[青龙面板 · 捕获 stdout 推送通知]
  ENV[(环境变量 Token)] --> S1
  ENV --> S2

1. 登录 WorkBuddy 桌面客户端。
2. 找到本机登录态文件：
   • macOS：~/Library/Application Support/CodeBuddyExtension/Data/Public/auth/workbuddy-desktop.info
   • Windows：%LOCALAPPDATA%\CodeBuddyExtension\Data\Public\auth\workbuddy-desktop.info
   • Linux：~/.config/CodeBuddyExtension/Data/Public/auth/workbuddy-desktop.info
3. 用任意编辑器打开，取 auth.accessToken 字段的整串值（通常以 eyJ 开头）作为 Token。

• 每日自动签到（幂等）
• 宠物自动探险 + 自动领积分（@jinyehyy 提议）
• 签到日历 / 连续天数统计
• 失败自愈重试 + 企业微信单独告警
• Web 配置面板（可视化填 Token）

本项目的「宠物自动探险并自动领取积分」能力，由社区用户 @jinyehyy（能猫期货哥） 在 Issue #1 中提出并实现跟进，已随 workbuddy_buddy_travel.py 一起发布。欢迎更多朋友提 Issue / PR。

MIT © 贵志

用 ⚡ 与 ☕ 制作 · 让签到自动跑