workbuddy-checkin

---
name: workbuddy-checkin
description: 当用户想要在 WorkBuddy 上完成每日签到（获取签到积分）时使用此技能。若 WorkBuddy 未运行则自动启动，使用 Playwright 通过 CSS Selector 定位 DOM 元素并点击：先点击左下角用户菜单（class="user-menu"），等待 2 秒后，再点击「立即领取 →」按钮（class="daily-checkin-banner-action"）完成签到。触发关键词包括"签到"、"WorkBuddy签到"、"每日签到"、"打卡积分"等。
---

# WorkBuddy 每日签到技能

## 概述

本技能用于自动化执行 WorkBuddy 应用程序的每日签到操作，通过模拟用户点击来完成签到领取积分的流程。

## 签到流程

签到操作需要按顺序执行以下步骤：

1. **启动 WorkBuddy**（如程序未运行）
   - 检测 WorkBuddy 是否正在运行
   - 若未运行，启动程序：`Start-Process "D:\WorkBuddy\WorkBuddy.exe"`
   - 等待程序完全加载（建议等待 5 秒）

2. **执行签到脚本（推荐方式：Python ctypes）**
   - 脚本路径：`c:\Users\22915\WorkBuddy\20260405031040\checkin_py.py`
   - 运行命令：`C:\Users\22915\AppData\Local\Programs\Python\Python39-32\python.exe checkin_py.py`
   - 退出码 0 表示成功

3. **点击用户菜单**
   - 坐标：X=207, Y=983（窗口左下角用户头像区域）

4. **等待菜单展开**（3 秒）

5. **点击签到按钮**
   - 坐标：X=93, Y=566（展开菜单中的「立即领取 →」按钮）

## 签到坐标配置

通过实际测试验证的精确点击坐标（1920x1080 分辨率）：

| 步骤 | 坐标 | 说明 |
|------|------|------|
| 点击用户菜单 | X=207, Y=983 | 窗口左下角用户头像区域 |
| 点击签到按钮 | X=93, Y=566 | 展开菜单中的「立即领取 →」按钮（2026-05-20 更新） |

> ⚠️ 注意：这些坐标是在 1920x1080 分辨率下测得的。如果屏幕分辨率或窗口大小改变，坐标可能需要重新校准。

## 重要说明：推荐使用 Python 版签到脚本

PowerShell 原脚本（`scripts/checkin.ps1`）中的 `Add-Type` 因环境变量超长（实测 266693 字节 > 65535 字节限制）无法编译 C# Win32 API 代码，导致所有鼠标操作静默失败。

**推荐方案**：使用 Python ctypes 版本 `checkin_py.py`，直接调用 user32.dll，稳定可靠。

## WorkBuddy 安装信息

- **安装路径**：`D:\WorkBuddy\WorkBuddy.exe`
- **窗口查找**：通过 `FindWindowW(None, "WorkBuddy")` 动态获取句柄
- **窗口类名**：`Chrome_WidgetWin_1`
- **推荐分辨率**：1920x1080 或更高

## 自动化配置

本技能已配置自动化任务：

- **任务名称**：WorkBuddy每日签到
- **执行时间**：每天 00:05
- **工作目录**：`c:\Users\22915\WorkBuddy\20260405031040`
- **状态**：ACTIVE
- **推荐签到脚本**：`c:\Users\22915\WorkBuddy\20260405031040\checkin_py.py`

## 故障排除

| 问题 | 可能原因 | 解决方案 |
|------|----------|----------|
| Add-Type 报错（环境变量超长） | 系统环境变量总长度超 65535 字节 | 改用 Python ctypes 方式执行 |
| 找不到 WorkBuddy 窗口 | 程序未运行 | 先启动 WorkBuddy，等待 5 秒 |
| 点击无效 / 菜单未展开 | 坐标偏移或窗口位置变化 | 重新截图确认坐标 |
| 签到按钮不可见 | 菜单未展开 | 确保先点击用户菜单并等待 3 秒 |

## 注意事项

1. **时序控制**：每步操作之间建议有适当等待时间，确保界面渲染完成
2. **运行环境**：建议在无人值守环境下运行，避免鼠标键盘冲突
3. **坐标验证**：DOM 结构或窗口布局变化时需重新校准坐标
4. **多显示器**：确保 WorkBuddy 窗口在主显示器上可见