WorkBuddy Daily Point Auto-Claim: Setting up Daily Scheduled Clicks for the Client via pyautogui Template Matching

前言

每天手动点 WorkBuddy 客户端里的签到领积分,点一两天还好,长期做就显得重复。更麻烦的是,一旦想做成定时自动领取,就要面对屏幕点击、窗口位置、客户端 UI 变化这些具体问题。下面介绍的这个 Skill,就是用 pyautogui 模板匹配来解决 WorkBuddy 每日积分自动领取这件事。

这是什么

「WorkBuddy 每日积分自动领取」是一个基于通用 SKILL.md 格式的 Agent Skill,来自 SkillHub,官方地址是 https://api.skillhub.cn/user_3e8eb506/workbuddy-daily-credits 。它的核心思路是:不硬编码按钮坐标,而是用模板匹配在 WorkBuddy 桌面客户端的固定 UI 上找到每日积分入口,再定时完成点击。

它面向的是开发者自己或替别人配置自动化的场景。官方简介里写得很明确:为任意用户的 WorkBuddy 桌面客户端搭建每日积分自动领取,并且包含一个引导式模板校准脚本,以及一份完整的踩坑清单。也就是说,它不只给一段脚本,还把模板校准和常见问题的处理方法一起给了出来。

在 SkillHub 上,这个 Skill 的分类是 office-efficiency,评分 99066,下载量为 955 次。这些数字只是平台侧的展示数据,不代表实际效果,这里仅按资料如实列出。

核心功能

根据官方简介,这个 Skill 提供的能力主要有三部分。

  1. 基于 pyautogui 的模板匹配点击。它针对 WorkBuddy 桌面客户端里每日积分所在的固定 UI 区域做图像匹配,找到入口后再执行点击,而不是写死像素坐标。

  2. 引导式模板校准脚本。不同机器上客户端窗口位置、缩放比例、深色浅色模式都可能不一样,直接拿一张模板到处用容易匹配失败。这个脚本的作用是引导用户在自己机器上现场截取、确认模板,让模板匹配结果和当前环境对齐。

  3. 完整的踩坑清单。官方资料里明确提到包含踩坑清单,具体条目没有展开,但这类模板匹配流程里常见的问题,比如模板区域选得太小、客户端窗口未置顶、匹配阈值设置过高、多显示器坐标偏移、点击位置与匹配位置不一致等,都属于同一类问题。实际使用前建议先过一遍清单,再按机器环境调整。

它的触发场景按官方简介是:用户希望自动领取 WorkBuddy 每日积分,或者需要在客户端内固定 UI 上设置定时点击流程。

安装与启用

这个 Skill 走的是通用 SKILL.md 格式。本次抓取的官方页面失败了,资料里没有给出具体的安装命令、目录路径或各 AI 编程工具的差异化配置,因此这部分不替官方补写,避免给出无法核实的步骤。

可以核实的是它的来源和定位:官方地址为 https://api.skillhub.cn/user_3e8eb506/workbuddy-daily-credits ,SkillHub 分类 office-efficiency,页面提供评分和下载数据。要安装启用时,建议直接打开官方地址,按页面上给出的安装方式操作,并核对 SKILL.md 中声明的运行条件和命令。

如果之后官方页面恢复,或者你本地已经拿到这个 Skill 的文件,再按 SKILL.md 里的说明配置运行环境即可。下面是拿到 Skill 后通常要确认的几件事,属于使用前的准备,不是官方命令。

1. 确认 Python 环境可用,pyautogui 能正常导入。
2. 确认 WorkBuddy 桌面客户端能启动,并停留在每日积分入口所在页面。
3. 阅读 Skill 内的 SKILL.md,按其中写明的方式运行模板校准脚本。
4. 校准通过后,再配置每日定时执行。

典型用法

官方资料没有提供可复现的完整示例脚本或具体命令,下面只按 Skill 的能力描述,说明一个符合其设计意图的用法,具体参数和路径以你拿到的 Skill 文件为准。

1. 启动 WorkBuddy 桌面客户端,登录到能看到每日积分入口的页面。
2. 运行引导式模板校准脚本。
3. 在脚本提示下,把模板区域对准每日积分按钮,确认保存。
4. 校准完成后,配置一个每日定时任务,触发自动领取流程。

这个流程的关键点在第二步和第三步。模板匹配的可靠性取决于模板本身,所以先做引导式校准,再让定时任务复用校准出来的模板,是这类 Skill 比较稳妥的使用方式。如果跳过校准直接跑,点错位置或者没匹配到按钮的概率会明显更高。

适用场景与注意

适合这几类情况:

  • 每天都需要领取 WorkBuddy 积分,希望交给脚本定时完成。
  • 客户端内的入口位置基本固定,只是机器环境不同导致坐标或截图略有差异。
  • 愿意花一次时间做模板校准,换取后续的无人值守领取。

不适合这几类情况:

  • WorkBuddy 客户端频繁改版,按钮样式和位置变化较大。模板匹配依赖视觉特征,UI 变动后模板很可能失配,需要重新校准。
  • 需要跨多台不同分辨率、不同缩放设置的机器复用同一套模板。这种情况下模板的一致性很难保证,应考虑按机器分别校准。
  • 运行环境没有图形界面。pyautogui 是模拟鼠标键盘操作,需要在有桌面的环境里运行,纯命令行环境跑不起来。

另外需要注意两点。一是定时任务执行时,WorkBuddy 客户端必须已经启动并停留在正确页面,否则匹配会失败。二是模板匹配只能找到视觉上相似的区域,如果界面上有多个相似按钮,可能需要调整模板区域或提高匹配要求,这部分以 Skill 内踩坑清单的说明为准。

结尾

这个 Skill 的价值在于,它把一个重复性的客户端操作拆成了「模板匹配 + 引导式校准 + 定时点击」几件事,而不是丢给用户一套写死坐标的脚本。对需要每天领 WorkBuddy 积分的开发者来说,官方地址是 https://api.skillhub.cn/user_3e8eb506/workbuddy-daily-credits 。由于本次官方页面抓取失败,安装命令和具体配置未能核实,使用时请以官方页面和 Skill 内文件为准。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye