WorkBuddy 每日积分工作流
Overview
本技能把零散的「每天手动跑一次积分签到 + 派猫猫旅行」收敛成一个标准、可复用、可审计的工作流:
- 通过
scripts/workflow.py统一编排:自动定位托管 Python 与引擎脚本 → 调用checkin --travel-auto→ 回显文字播报 → 把每次运行写入runs/日志。 - 通过 WorkBuddy 自动化(recurring automation)实现每日定时触发,使工作流成为唯一可信源、自动化只当薄调度器。
- 安全边界与引擎一致:绝不打印
accessToken/refreshToken;旅行写操作仅在--travel-auto下执行且受每日派遣上限保护;登录态缺失即停并提示。
本技能是编排层,底层积分引擎来自 totorosir-workbuddy-score(MIT-0,技能市场可装)。不重复实现登录态解密/多通道授权等复杂逻辑。
Prerequisites(前置依赖)
安装本技能前,先确认已安装引擎技能(MIT-0):
- 技能市场搜索安装
totorosir-workbuddy-score,或 - 手动放置于
~/.workbuddy/skills/totorosir-workbuddy-score/(其scripts/buddy_station.py为本工作流引擎)。
scripts/workflow.py 会自动在以下位置查找引擎,命中即用:
- 环境变量
WB_SCORE_ENGINE指向的路径 - 调用时
--engine <path>覆盖 - 用户级技能目录
totorosir-workbuddy-score/scripts/buddy_station.py - Windows 典型路径
C:/Users/1/.workbuddy/skills/totorosir-workbuddy-score/scripts/buddy_station.py
若均找不到,脚本会明确提示「请先安装前置技能」,不伪造数据。
Workflow
Step 1 · 校验环境
运行编排脚本前确认:
- 已登录 WorkBuddy 客户端(存在本机登录态文件)。
- 已安装 totorosir-workbuddy-score 引擎技能。
- 优先使用托管 Python:
C:/Users/1/.workbuddy/binaries/python/versions/*/python.exe;缺失则回退python3。
Step 2 · 手动运行(验证)
用 Bash 工具执行:
C:/Users/1/.workbuddy/binaries/python/versions/3.13.12/python.exe \
"<skill-dir>/scripts/workflow.py"
脚本会回显引擎的文字播报(积分余额、连续登录、本周进度、本期活动、成长计划、派猫猫旅行),并弹系统通知。日志落盘 runs/run-<时间戳>.log。
Step 3 · 一键创建每日定时自动化
选定一个固定时段(默认每日 20:00),用 automation_update 工具创建 recurring 自动化,使其仅负责定时触发工作流:
mode:"update"(新建用"create")name:"WorkBuddy 每日积分签到 + 派猫猫旅行(工作流)"scheduleType:"recurring"rrule:"FREQ=DAILY;BYHOUR=20;BYMINUTE=0"prompt(自包含,给未来运行的智能体看):
> 执行工作流:用 Bash 运行 C:/Users/1/.workbuddy/binaries/python/versions/3.13.12/python.exe "<skill-dir>/scripts/workflow.py"。
> 如实回显脚本输出的文字播报,依赖脚本自身弹系统通知,不要输出任何 accessToken/refreshToken。
> 若登录态缺失或 token 过期,停止并提示「请先登录 WorkBuddy 客户端」,不伪造数据。
> 单次运行已构成完整闭环,不要为刷分重复调用。运行后把播报回传到自动化结果,并写入 automation memory.md。
把 <skill-dir> 替换为实际路径。这样自动化成为薄调度器,工作流文件是唯一可信源,后续改调度/加日志/调参数都只动工作流文件。
Step 4 · 审计与排错
- 每次运行在
runs/留痕,排查「今天签到没 / 旅行领了没」直接翻日志。 - 引擎退出码非 0:多为登录态缺失/过期,提示用户登录;其余按引擎播报处理。
- 远程推送由引擎按自身配置处理;本工作流不自行推送。
Safety Constraints(硬规则)
- 绝不向对话/日志输出
accessToken/refreshToken。 - 写操作仅限引擎已验证接口:
daily-checkin、travel/claim、travel/depart;本工作流不新增任何写接口。 - 旅行写操作仅在
--travel-auto下执行,且受daily_limit_reached上限保护,达上限跳过、不发写请求。 - 单次运行即完整闭环,不为刷分重复调用。
- 登录态缺失 / token 过期:停止执行并明确提示,不伪造数据。
Resources
scripts/workflow.py
编排入口:解析运行环境与引擎路径 → 调用 buddy_station.py checkin --travel-auto → 回显播报 → 写 runs/ 日志。支持 --engine <path> 与 WB_SCORE_ENGINE 覆盖。已做语法校验。
references/workflow.md
详细的接口清单、引擎前置说明、自动化 RRULE 示例与常见问题,供按需加载。