（8118期）wb-buddy-checkin – WorkBuddy 自动签到积分助手

WorkBuddy 自动签到积分助手 基于纯 ctypes 实现 Windows 自动化签到，零第三方依赖，通过截图灰度校验实现主题无关的可靠领取，每日自动获取 100 积分。 使用说明 核心用法 wb-buddy-checkin 是一款专为 WorkBuddy 桌面客户端设计的 Windows 自动化签到工具，用于每日自动完成「Buddy 加油站」的积分领取。该技能通过纯 ctypes 调用 Windows 系统 API（user32/gdi32）实现窗口置前、坐标点击与截图校验，无需安装任何第三方 Python 包。 使用流程分为三个步骤：首次使用必须通过 -calibrate-gui 弹窗校准或 -calibrate 终端校准记录屏幕坐标；日常执行使用 -run 模式自动完成签到；签到结果保存为 checkin_result.png 供人工确认。脚本内置多层容错机制，包括 DPI 感知设置、窗口精确匹配、最小化恢复置前、中段面板校验及最终的灰度像素判定，确保在亮/暗主题下均能正确识别「今日已领」状态。 显著优点 零依赖架构：仅使用 Python 标准库，通过 ctypes 直接调用 Win32 API，杜绝了第三方包的安全风险与版本冲突问题，部署成本极低。 主题无关的可靠校验：创新性地采用「近黑像素数」灰度判定替代 OCR 或白字识别，兼容 WorkBuddy 的亮色/暗色主题切换，识别准确率不受 UI 风格影响。 坐标自适应机制：使用「相对客户区左下角」的坐标系，窗口任意缩放后仍可命中目标；结合 GetWindowRect 动态跟踪窗口位置，天然免疫「窗口被移动」问题，无需强制钉死窗口位置。 多重防假阳性设计：中段校验确保「Buddy 加油站」面板已打开才点击领取，避免主界面截图误判为已领取；精确窗口标题匹配防止命中幽灵子窗口；argtypes 显式声明杜绝 64 位指针截断导致的静默失败。 校准友好：提供 GUI 弹窗校准（推荐）与终端回车校准双模式，首次使用门槛低，校准文件 calibrate.json 可持久复用。 潜在缺点与局限性 平台受限：严格依赖 Windows 系统与 ctypes.windll，无法在 macOS/Linux 上运行，跨平台迁移需完全重写。 首次校准必需：作者屏幕的默认坐标对他人设备几乎必然失效，跳过校准会导致「只点头像、后续打空」的典型故障，初次使用成本较高。 UI 变动敏感：虽然主题无关，但若 WorkBuddy 更新后调整了「Buddy 加油站」入口位置或按钮尺寸，需重新校准坐标；重大改版可能使像素校验逻辑失效。 无内置通知： skill 本身不包含微信/钉钉等推送通道，结果通知需由调用方在外部配置，对非技术用户不够闭环。 DPI 边缘情况：虽设置了 DPI 感知，但在多显示器混用不同缩放比例、或 Windows 缩放设置动态切换时，仍存在坐标漂移的潜在风险。 适合的目标群体 WorkBuddy 深度用户：每日依赖 WorkBuddy 协作且希望自动化积分领取的个人用户。 Windows 自动化学习者：希望研究纯 ctypes Win32 编程、无依赖自动化方案的开发者。 企业内部运维：需要为团队批量配置签到任务、已有消息推送基础设施的技术管理员。 低权限环境用户：无法安装第三方 Python 包、仅能使用标准库的运行环境。 使用风险 误操作风险：坐标校准错误可能导致点击到非预期位置，建议首次运行时启用 -dry 模式观察坐标位置，或在虚拟机中测试。 窗口状态竞争：若用户人工操作 WorkBuddy 与脚本执行重叠，可能导致窗口焦点争夺、点击失效或校验异常，建议设置定时任务避开高频使用时段。 平台更新失效：WorkBuddy 客户端或 Windows 系统更新可能改变窗口类名、客户区行为或 API 语义，需持续关注兼容性。 积分规则变更：自动化签到若被平台判定为违规，存在积分清零或账号限制风险，建议控制执行频率（每日一次）并保留人工干预入口。 截图隐私：checkin_result.png 包含屏幕画面，若共享环境运行需注意清理历史截图，避免信息泄露。 原始说明 自动完成 WorkBuddy 桌面客户端「Buddy 加油站」每日签到、领取积分。当用户需要在 Windows 上自动点击头像→Buddy加油站→立即领取，并通过截图灰度校验是否成功（灰底「今日已领」）时使用。基于纯 ctypes 实现窗口置前、坐标点击与窗口截图，零第三方 Python 依赖，仅依赖 Windows 系统 API（可选复用 desktop-control-win skill 的截图）。