Buddy 加油站签到助手

技能文档

---
name: buddy-station-checkin
title: Buddy 加油站签到助手
category: 办公效率
description: 读取本机已登录 CodeBuddy 桌面客户端的登录态，直接调用官方接口完成「Buddy 加油站」每日签到（无需点击 GUI），并支持派猫猫旅行全自动闭环（查状态、领旅行积分、派 Buddy 出门），可选桌面通知与微信推送提醒。当用户需要每天自动签到、自动领积分、自动打卡、派猫猫旅行时触发。触发词：自动签到、每日签到、自动打卡、领积分、派猫猫旅行。
---

# Buddy 加油站签到助手

CodeBuddy 桌面客户端的「Buddy 加油站」每日签到本质是一次带本地登录 Token 的 HTTP 接口请求，**不需要**模拟点击 GUI 流程。本技能自带脚本 `scripts/buddy_station_checkin.py`，仅用 Python 标准库，零第三方依赖，跨平台支持 Windows / macOS / Linux。

> 面向用户的完整说明（快速开始 / 桌面通知 / 微信配置 / 环境自检 / FAQ / 排错）见 `references/guide.md`。
> 登录态文件路径与文件名、接口域名、字段与错误码等精确细节见 `references/api-spec.md`。
> 自动化提示词、命令示例与微信配置示例见 `references/examples.md`。

## 技能工作流

### 步骤1：定位登录态并校验 token

- 登录态文件为客户端生成的明文 JSON，按操作系统自动探测（Windows 在 `%LOCALAPPDATA%` / `%APPDATA%`，macOS/Linux 在 `~/Library/Application Support`、`~/.config` 下，精确路径见 `references/api-spec.md`）。
- 确认文件内 `auth.accessToken` 存在且未过期（`expiresAt` 字段）。
- 若文件不存在或 token 失效：如实告知用户「请先在 CodeBuddy 客户端登录」，**不要**伪造或猜测。

### 步骤2：落位脚本并验证

- 把 `scripts/buddy_station_checkin.py` 复制到稳定路径（示例见 `references/examples.md`）。
- 跑一次 `--check-only` 验证接口通、token 有效（应返回 `status_http:200`、`today_signed` 字段）；可顺带跑 `--diagnose` 输出自检报告。

### 步骤3：验证领取分支（可选但建议）

跑一次不带参数的完整脚本：当天已签 → 返回 `skip_already_signed`；未签 → 领取成功并提示用户去 Buddy 加油站界面核对 +100。

### 步骤4：设置每日定时

在 Agent 平台创建每日 09:00 的定时自动化（rrule：`FREQ=DAILY;BYHOUR=9;BYMINUTE=0`），自动化提示词模板见 `references/examples.md`；也可改用系统级定时任务（Windows 计划任务 / macOS launchd / Linux crontab）脱离对话环境运行。

### 步骤5：向用户汇报

汇报自动化名称、执行时间、脚本路径；提醒「若当天已手动签到会自动跳过；首个真实自动领取通常在次日 09:00，请在 Buddy 加油站核对积分 +100」。

## 关键事实（实测验证）

- **接口域名**：以登录态里的 `auth.domain` 为准，不要硬编码网上文章里的旧域名（精确值见 `references/api-spec.md`）。
- **状态查询（只读）**：`POST https://<domain>/v2/billing/meter/checkin-activity-status`，返回 `today_checked_in` / `streak_days` / `daily_credit` 等。
- **领取签到**：`POST https://<domain>/v2/billing/meter/daily-checkin`；成功 HTTP 200 `code:0`；已签到 HTTP 400 `code:10001`——幂等，不会重复发。
- **派猫猫旅行**：旅行接口与签到接口**域名不同**，且路径**不带 `/v2` 前缀**（精确域名见 `references/api-spec.md`）：
  - `GET /activity/growth/buddy/travel/status`：`idle` 空闲 / `traveling` 旅行中 / `arrived` 已到达待领取。
  - `POST /activity/growth/buddy/travel/claim`：仅 `arrived` 时可领。
  - `POST /activity/growth/buddy/travel/depart`：仅 `idle` 且未达每日上限时派遣；地点 1-4 收益完全相同，缺省随机。

## 脚本用法

```bash
python scripts/buddy_station_checkin.py                  # 签到 + 派猫猫旅行全自动闭环（默认）
python scripts/buddy_station_checkin.py --no-travel      # 只签到，跳过旅行（最快档）
python scripts/buddy_station_checkin.py --check-only     # 仅查询状态（只读，不领取、不写旅行）
python scripts/buddy_station_checkin.py travel           # 只查派猫猫旅行状态（只读）
python scripts/buddy_station_checkin.py --location N     # 指定派遣地点（1-4，缺省随机）
python scripts/buddy_station_checkin.py --no-notify      # 跳过全部推送与桌面通知（调试用）
python scripts/buddy_station_checkin.py --diagnose       # 环境自检（只读）
python scripts/buddy_station_checkin.py --init-config    # 生成 notify_config.json.example 模板
```

脚本输出 JSON 结果，退出码成功 0 / 失败 1；全程不打印任何真实 token（仅脱敏展示）。旅行闭环顺序为「先领后派」：`arrived` → 领取 → 重查 → `idle` 且未达上限 → 派出；已达上限一个写请求都不发。

## 通知与推送（可选）

- **桌面通知（默认开启）**：每次执行后弹系统级 toast 展示结果与余额；`--no-notify` 可关闭；无桌面会话时自动跳过。
- **微信提醒（可选）**：按 `references/examples.md` 配置本地 `notify_config.json` 后，失败时推送提醒（企业微信机器人 / PushPlus / Bark）；`success_notify: true` 时成功也播报（默认关闭）。推送密钥只存本地配置文件，永不进入脚本或技能目录。

## 安全约束（务必遵守）

- 只读登录态文件，绝不修改、绝不删除、绝不外传 `accessToken` / `refreshToken`。
- 任何输出（终端、日志、汇报）都不得包含真实 token；脚本已脱敏，也不要回显凭据。
- 不要在网页版尝试签到（网页版无签到入口，仅 PC 客户端专属）。

## 排错要点

- `code=10001` 是今日已签，非错误。
- 404 一定是用了错误域名（脚本自动用本机 `auth.domain`）；旅行接口 404 先核对域名与「路径不带 `/v2`」两条规则（见 `references/api-spec.md`）。
- 「今日派遣次数已用完」是正常服务端每日限额，次日自动恢复，不是故障。
- 旅行中无法提前召回：官方没有召回接口，只能等到达后自动领取。
- 桌面通知不弹通常是无桌面会话（锁屏/无 GUI），属预期，stdout 与日志仍有完整记录。

使用说明

# Buddy 加油站签到助手

读取本机已登录 CodeBuddy 桌面客户端的登录态，直接调用官方接口完成「Buddy 加油站」每日签到与派猫猫旅行，无需点击 GUI、零第三方依赖。

## 使用

```bash
# 立即签到（含派猫猫旅行闭环）
python scripts/buddy_station_checkin.py

# 仅查询状态（只读）
python scripts/buddy_station_checkin.py --check-only

# 环境自检
python scripts/buddy_station_checkin.py --diagnose
```

对 Agent 说「帮我设置每日自动签到」即可完成落位脚本 + 每天 09:00 定时任务；次日自动领取后在 Buddy 加油站核对积分 +100。

## 工作原理

- 从本机客户端登录态文件只读提取 accessToken，直接调用官方签到接口（幂等，已签自动跳过）；
- 签到后自动跑「派猫猫旅行」闭环：领旅行积分 → 派 Buddy 出门；
- 执行结果弹系统桌面通知，可选微信推送提醒；全程不打印任何真实 token。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。