WorkBuddy 每日積分自動領取:用 pyautogui 模板匹配爲客戶端搭每日定時點擊

前言

每天手動點 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 內文件爲準。

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

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

小夜