WorkBuddy Check-in Plus
当前版本：1.1.2。
使用用户本机已登录的 WorkBuddy 会话领取 Buddy 加油站每日积分，并通过领取前余额、领取结果、领取后余额和余额差额核对结果。只用于用户自己的单一账户。
判断用户要做什么
- 只安装或只运行一次：检查环境并执行一次签到，不创建后台任务。
- 明确要求“安装并自动签到”“每天自动领取”或给出执行时间：首次验证成功后创建并启用自动化任务。
- 只询问原理或安全性：解释现状，不安装、不签到、不创建任务。
安装 Skill 不等于授权创建后台任务。没有明确的自动化意图时，不得写入 crontab、launchd、Windows 任务计划程序或 Codex 自动化。
执行流程
- 确认 WorkBuddy 桌面端已安装、已登录，操作对象是用户自己的账户。
- 确定 Skill 的持久化安装目录，并使用该目录下脚本的绝对路径；不要从临时目录创建自动化。
- 按平台运行环境检查：
- macOS、Linux、Git Bash：bash scripts/setup.sh
- Windows PowerShell：powershell -ExecutionPolicy Bypass -File scripts\setup.ps1 - 环境检查通过后手动运行一次签到脚本，记录四项结果：领取前余额、签到状态、领取后余额、余额差额。
- 按“结果判定”汇报，不把请求已发出等同于领取已确认。
- 仅当用户明确要求自动化且首次运行结论不是“无法确认”时，按“创建自动化任务”继续。
结果判定
- 领取成功并已核对：接口返回领取成功，领取前后余额均可读取，并输出余额差额。
- 今日已领取：状态接口或领取接口确认今日已领；重复运行视为幂等成功，余额差额通常为
0。 - 请求成功、余额待确认：领取接口成功，但领取后余额暂时不可读或差额未更新。只能这样表述，不能写“已核对到账”。
- 无法确认：网络重试耗尽、登录失效、响应无法解析或余额前后均无法读取。不得猜测领取成功。
创建自动化任务
用户给出明确自动化要求时，该要求同时授权创建对应的定时任务，不需要用户再粘贴第二段提示词。
- 使用用户指定的时区和时间；未指定时间时先询问，不自行启用推荐时间。
- 电脑并非全天开机时，可建议
09:00、12:00、15:00、18:00、21:00作为补签时间，但必须由用户接受或在原请求中明确给出。 - 优先使用当前宿主提供的原生 recurring automation；不可用时，只有获得同等明确授权才可配置系统调度器。
- 任务必须使用 Skill 持久化目录中的脚本绝对路径，并说明电脑关机或休眠时本地任务不会执行。
- 多个时间点只是补签检查。脚本会把已领取识别为成功，不重复领取。
- 创建后检查并汇报：任务名称、时区、执行时间、脚本路径、启用状态和下一次运行时间。
- 无法读取任务状态或下一次运行时间时，不得声称自动化已经配置完成。
自动化任务每次运行只需执行对应平台的签到脚本，并汇报四项结果。不要在任务提示中嵌入令牌、Cookie、用户身份字段或接口原始响应。
网络与错误恢复
- 脚本会对网络断开、
408、429和常见5xx响应最多尝试三次，并采用短暂递增等待。 401、403、验证码、短信验证和登录状态不明确时立即停止，不重复尝试；提示用户打开 WorkBuddy 刷新登录态。- 失败后只能重跑幂等签到脚本，不得改用浏览器绕过验证或尝试其他账户。
- 面向用户先说明“发生了什么”和“下一步怎么做”，技术状态码放在括号中。
常见问题和具体处理方式见 references/troubleshooting.md。平台依赖与登录态路径见 references/dependencies.md。
安全边界
- 只使用用户自己的 WorkBuddy 账户，不支持多账户、批量领取或奖励滥用。
- 令牌只在进程内存中使用；不得显示、记录、保存、上传或提交。
- 网络请求仅发送到
copilot.tencent.com。 - 日志只包含汇总余额、积分包数量、领取状态和余额差额，不包含原始响应或身份字段。
- 不绕过登录、验证码、短信验证或其他安全检查。
- 客户端观察到的接口可能随 WorkBuddy 更新而改变；异常响应必须视为未确认。
已验证范围
- macOS Bash 语法、WorkBuddy 5.3.14 余额读取和“今日已领取”幂等路径已验证。
- Windows PowerShell 5.1 已于 2026-08-29 实机验证：余额读取（126 个积分包汇总）与“今日已领取”幂等路径通过。验证中修复两个 PS 5.1 兼容问题（JSON 请求体传参被损坏致 HTTP 400；stdout 按 GBK 解码致 UTF-8 中文响应解析失败），详见 CHANGELOG 1.1.2。
- 正向领取后余额差额在 macOS 与 Windows 均仍需在未签到日期继续验证。
