workbuddy挂机自动领取积分工具详解

WorkBuddy 每日积分自动领取工具 — 技术文档项目内容工具名称workbuddy_checkin WorkBuddy 每日积分自动领取版本1.2更新日期2026-09-09运行平台Windows 10 / 11 64 位交付形态独立单文件 exe 无需安装 Python 及任何依赖库一、项目概述1.1 背景WorkBuddy 客户端提供每日积分签到功能用户每天可在客户端界面左下角点击「立即领取」按钮获得积分。手动签到存在两个痛点容易遗忘需要每天记得打开客户端并点击按钮入口不稳定领取入口有时出现在左下角面板有时收在头像弹出菜单甚至签到子页面里层级不固定。本项目将这一操作完全自动化通过定时截图 → OCR 文字识别 → 模拟点击的方式让计算机自己看界面、点按钮每天自动完成积分领取。1.2 工作原理工具的核心循环是感知—决策—执行阶段技术手段说明感知EnumWindows PrintWindow OCR 评分枚举所有候选窗口每个候选都截图并 OCR 按目标文字内容与位置评分选出真正的 WorkBuddy 主窗口决策RapidOCR ONNX Runtime 识别「立即领取 / 今日已领 / 签到」等关键字判断界面状态执行ClientToScreen SendInput把窗口客户区坐标转成屏幕绝对坐标后点击不占用、不移动真实鼠标光标1.3 业务流程工具按以下优先级逐级查找领取入口与人工操作思路一致观察窗口左下角若有「立即领取」→ 点击领取结束若已是「今日已领」→ 无需操作结束。点击左下角头像观察弹出菜单若有「立即领取」→ 点击若「今日已领」→ 结束。弹出菜单中也没有 → 点击带「签到」字样的按钮再回到第 1 步观察左下角。全部未找到 → 记录日志并以退出码 2 结束供上层监控判断。升级弹窗处理点击头像前若 OCR 检测到界面中央存在升级/会员类弹窗且头像被遮挡工具会按优先级寻找「暂不升级 / 暂不 / 稍后再说 / 取消 / 关闭」等按钮先关闭弹窗再继续正常流程。1.4 目录结构automation-2026-09-09-00-13-29\├── workbuddy_checkin.py # 主程序源码Python├── build_exe.py # 一键打包脚本生成独立 exe├── workbuddy_checkin.spec # PyInstaller 打包配置自动生成├── dist\│ └── workbuddy_checkin.exe # 独立可执行文件约 105 MB含全部依赖├── scripts\│ ├── install_task.bat # 安装 Windows 计划任务管理员运行│ ├── uninstall_task.bat # 卸载计划任务│ └── run_now.bat # 立即手动执行一次└── 说明.txt二、主要特征特点2.1 零依赖部署全部依赖Python 运行时、RapidOCR 模型、ONNX Runtime、Pillow、NumPy、pygetwindow 等均打包进单个 exe目标电脑无需安装 Python 或任何库拷贝即可运行。打包通过collect_all()完整收集 rapidocr_onnxruntime 的 ONNX 模型、YAML 配置与 onnxruntime 的 DLL避免常见的打包后找不到模型问题。2.2 屏幕绝对坐标点击窗口大小位置自适应截图使用PrintWindow(PW_RENDERFULLCONTENT)直接捕获目标窗口客户区不依赖全屏BitBlt全屏截图在该机器上测试不稳定时而成时失败。窗口选择使用EnumWindows枚举标题或进程名命中的候选窗口对每个候选都截图并 OCR 评分出现「立即领取 / 今日已领 / 签到」等目标文字得分高左下角出现额外加分长文本过多的窗口聊天窗口降低权重。选评分最高的窗口避免多 workbuddy.exe、无标题栏、窗口重建时找错窗口。点击先把窗口客户区坐标通过ClientToScreen转成屏幕绝对坐标再用SendInput投递点击不移动、不占用物理鼠标——工具运行时用户可以正常使用电脑做其它事情同时也不受标题栏/边框影响窗口缩小或拖动到任意位置都能点准。坐标基准所有 OCR 区域和点击坐标都以GetClientRect取得的真实客户区尺寸为基准而非窗口外框。2.3 中文 OCR 识别 窗口验证适应界面变化采用 RapidOCRPP-OCRv3 检测 识别模型对中文界面文字识别准确率高。窗口验证不再单纯依赖窗口标题/进程名/面积找窗口而是对每个候选窗口都 OCR按内容 位置评分确保选中真正显示 WorkBuddy 主界面的窗口。不依赖固定像素坐标而是按文字内容 区域范围定位按钮如左下角区域内包含立即领取的文字块对窗口尺寸变化、DPI 缩放、界面小改版都有一定适应性。置信度阈值过滤默认 0.45避免误识别。2.4 分层查找策略 弹窗自动处理领取入口按左下角 → 头像菜单 → 签到页三级逐层查找覆盖入口位置变化的各种情况。自动识别并关闭升级/会员弹窗按「暂不升级 → 暂不 → 稍后再说 → 取消 → 关闭」优先级尝试保证流程不被打断。2.5 可观测、可调试每次运行写日志与 exe 同目录的workbuddy_checkin.log记录窗口信息、OCR 识别结果、每次点击动作和最终结论。明确的退出码约定便于脚本/监控集成退出码含义0今日已领无需操作或已成功点击「立即领取」2未找到任何目标按钮3WorkBuddy 窗口未找到 / 环境异常提供--dry-run模式只截图 OCR 输出识别结果不真实点击用于部署前验证-v输出全部 OCR 明细。2.6 双触发方式既可以通过Windows 计划任务bat 一键安装在任意电脑上定时运行也可以通过WorkBuddy内置自动化调用两种方式互不冲突。三、使用方法3.1 环境要求Windows 10 / 11 64 位已安装 WorkBuddy 客户端并保持登录状态窗口可以最小化但进程需存在建议保持窗口开启以获得最佳识别效果安装计划任务时需要管理员权限3.2 部署到新电脑将整个项目目录复制到目标电脑最少需要dist\workbuddy_checkin.exe和scripts\目录下的三个 bat 文件。打开并登录 WorkBuddy 客户端。右键scripts\install_task.bat→以管理员身份运行即注册每天 09:00 自动执行的计划任务。可选双击scripts\run_now.bat立即执行一次验证功能正常。提示bat 内部通过自身位置自动定位 dist\workbuddy_checkin.exe因此项目目录整体移动位置后无需修改任何配置但若只拷贝部分文件请保持 scripts 与 dist 的相对目录结构不变。3.3 命令行用法workbuddy_checkin.exe ::正常执行真实点击workbuddy_checkin.exe --dry-run :: 只截图OCR不点击部署验证用workbuddy_checkin.exe -v :: 输出 OCR 详细识别结果workbuddy_checkin.exe --avatar-x 30 --avatar-y -40:: 微调头像点击位置偏移默认 25 / -453.4 三个 bat 脚本脚本作用运行方式install_task.bat注册计划任务 WorkBuddyDailyCheckin 每天 09:00 运行 exe右键 → 以管理员身份运行run_now.bat立即手动执行一次并显示退出码双击uninstall_task.bat删除计划任务双击注意bat 文件统一保存为GBK (ANSI)编码避免部分 Windows 终端默认代码页下 UTF-8 中文乱码被当作命令解析。bat 内的提示信息因此使用英文功能与操作步骤不变。3.5 查看结果与排障日志dist\workbuddy_checkin.log包含每次运行的时间、识别内容、点击动作和结论。现象处理退出码 3 找不到窗口确认 WorkBuddy 已登录且进程在运行退出码 2 未找到按钮用 --dry-run -v 查看识别明细若界面改版可能需更新关键字或源码首次运行慢正常现象单文件 exe 需解压 OCR 模型到临时目录约 15~30 秒点击无反应用 --avatar-x / --avatar-y 微调头像位置确认窗口未最小化到托盘计划任务注册失败以管理员身份重试或在 WorkBuddy 设置 → 安全中心放开 系统级工具 权限3.6 重新打包开发者修改workbuddy_checkin.py后在装有完整依赖的 Python 环境中运行python build_exe.py新 exe 将输出到dist\workbuddy_checkin.exe。3.7 与 WorkBuddy 内置自动化配合除计划任务外也可在 WorkBuddy 的自动化任务中配置每日定时调用本工具指向 exe 或源码脚本均可由 WorkBuddy 侧记录执行历史。github链接https://github.com/ygwelcome/workbuddy_autoclaimcredits