---
name: workbuddy-credits
description: >-
  查询 WorkBuddy 积分余额、签到活动、成长计划与 Buddy 旅行状态，领取签到和旅行奖励，
  管理本机自动领取及结果通知。当用户提到 WorkBuddy 查积分、签到、旅行领奖、
  开启或关闭自动领取、检查后台、配置领取通知时使用。
---

# workbuddy-credits — WorkBuddy 积分托管

## 运行入口

从当前 `SKILL.md` 定位 `scripts/credits.py`，使用本机 **Python 3.10+**，先检查解释器版本。基础功能只用标准库；macOS、Windows 支持系统调度，Linux 可手动执行。

使用解释器与脚本的绝对路径，正确引用空格或中文路径。Windows PowerShell 在带引号的解释器路径前加 `&`。先运行离线检查：

```text
"<Python绝对路径>" "<skill绝对目录>/scripts/credits.py" doctor
```

下表命令接在同一解释器与脚本路径后，完整参数见 `--help`。状态目录默认 `~/.workbuddy/credits-autopilot`；指定 `--state-dir <目录>` 时，后续操作使用同一目录。

| 用户意图 | 命令 |
|---|---|
| 查询余额、签到、成长与旅行 | `status`；可加 `--html <本地文件>` |
| 只查旅行 | `travel` |
| 签到并处理旅行领奖、派遣 | `run` |
| 只签到 | `checkin` |
| 只领取旅行并继续派遣 | `travel --auto` |
| 开启自动领取 | `setup --interval 30` |
| 只准备配置 | `setup --prepare-only` |
| 检查后台 | `service status` |
| 修复路径或更新后台运行副本 | `service repair --interval 30` |
| 关闭自动领取 | `service uninstall` |

## 执行规则

- 查询使用 `status` / `query` / 不带 `--auto` 的 `travel`。用户明确要求领取或开启自动领取时执行对应命令，无需重复确认；`setup`、`service install/repair` 可能立即领取。
- 凭据通过本人本地登录文件或授权 JSON 处理，密钥不进入聊天或命令行参数。只有显式允许刷新时才续期；授权失败按下方指南处理。
- 分别报告本次领取、签到累计、可用余额和连续签到天数；缺失字段写“未知”。`partial` / `error` 保留成功项与失败项，通知结果单独报告。
- 领取或派遣回执不明时先只读核对，不立即重试。启用后台后用 `service status` 核验实际执行；配置生成或任务注册不等于业务成功。

## 按需读取

- 首次授权、设置/修复后台或清理数据：读 [授权与后台排障](references/usage.md)。
- 配置领取结果通知：读 [通知配置](references/notifications.md)；默认不发送通知。
- 接口字段变化或请求报错：读 [接口排障](references/protocol.md)。