技能介绍

解决什么具体问题

WorkBuddy 桌面客户端的“Buddy 加油站”每天可以签到领积分，但必须手动进入个人中心、找到入口、点击领取。对于希望用自动化流程把日常任务串起来的工程师来说，缺少官方 API 意味着要么每天记得打开客户端手动点，要么自己写一套不稳定的 UI 脚本。本技能用 wb_gas_claim.py 把这套操作封装成一个可被 Agent 直接调用的技能：探测客户端是否运行、在需要时启动、进入个人中心、定位签到按钮、完成领取并验证结果。

技能如何工作

核心逻辑全部内置在脚本里，Agent 不需要理解 UI 自动化细节，只需要看退出码和最后的 RESULT: 行：

环境准备：脚本自动管理 Python venv，首次运行会自动安装 uiautomation，无需手动配置依赖。
客户端探测与启动：优先复用已登录的 WorkBuddy 实例；若未运行，则按默认或自定义路径启动。
防假阳性刷新：领取前会先收起再展开左侧面板，强制刷新 UI 树，避免读到上次会话残留的“今日已领”状态而静默漏领。
区域过滤与关键词匹配：只在个人中心面板范围内查找入口，过滤主聊天区的预览文本；对入口、领取、已领等状态使用多别名关键词集合，并兼容英文文案。
两层有限重试：脚本内部对首次点击未确认会做一次面板刷新重试；如果仍失败，Agent 层可以再兜底重试一次，总上限不超过 2 次，避免无限循环烧积分。
结果验证与日志：脚本通过验证按钮是否变为“今日已领”来判断成功，退出码 0 表示已领取或本来已领，1 表示失败，2 表示环境异常；详细日志写入 wb_gas_claim.log。

适用边界与注意点

这个方案是 Windows UI 点击，不是官方 API，因此有几个硬前提：

仅支持 Windows，且需要已安装并登录 WorkBuddy 桌面客户端。
客户端个人中心必须存在“Buddy 加油站签到领积分”入口；没有该入口的账号无法使用。
需要 Python 3.8+；首次运行会自动建 venv。
如果 WorkBuddy 改版导致入口文案或面板位置变化，脚本可能找不到按钮。排错时可以先跑 python wb_gas_claim.py --dry-run，再按文档调整关键词或窗口参数。
不要在未登录、非 Windows 或客户端没有加油站入口的环境下强行重试，也不要在第二次仍失败后继续重跑。