feat: add idle reward claim automation

docs/261004_1607-首页功能与日常任务梳理.md

@@ -1,7 +1,7 @@
 ---
 created_at: 2026-10-04 16:07:56 CST
 type: 永远的蔚蓝星球首页、商城、领地与公会入口、日常任务与自动化适配记录
-revision: 第10次
+revision: 第11次
 revisions:
   - time: 2026-10-04 16:07:56 CST
     version: 第1次
@@ -43,7 +43,11 @@ revisions:
     version: 第10次
     author: gpt-5
     content: 补充食堂一键领取体力的实机验证流程、无可领取分支、脚本和汇总表条目。
-summary: 记录首页、商城、领地和公会的日常任务入口、待完善流程及已实现脚本汇总。入口红点表示内部有奖励可领取；特惠赏金战令领取、狂鼠之家收矿与雇佣、食堂领体力均已实机验证并写成脚本。
+  - time: 2026-10-04 18:48:40 CST
+    version: 第11次
+    author: gpt-5
+    content: 补充小金猪挂机奖励的实机领取与灰色跳过分支，新增独立脚本及汇总表条目。
+summary: 记录首页、商城、领地和公会的日常任务入口、待完善流程及已实现脚本汇总。入口红点表示内部有奖励可领取；特惠赏金战令领取、小金猪挂机奖励、狂鼠之家收矿与雇佣、食堂领体力均已实机验证并写成脚本。
 ---
 
 # 首页、商城、领地与公会功能及日常任务梳理
@@ -62,7 +66,7 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 
 用户确定的开发顺序：**先在本地实现部分自动化流程，逐项验证后再打包成独立程序**，最终目标仍是 macOS 与 Windows。模型 Key 由用户以后在程序设置中填写。
 
-第一条本地原型流程为“小金猪 → 挂机奖励 → 领取 → 返回首页”，使用局部截图模板识别，执行前校准游戏区域，提供预览、日志和停止功能。当前不执行快速扫荡，也尚未加入红点检测或模型 API。奖励到账数量、领取后弹框和双平台操作需实机验证；超时停止，不重复领取。启动方法与验证命令见项目 README。
+小金猪、特惠战令、狂鼠之家、食堂均已有实机验证脚本，使用局部截图模板识别并在关键状态变化后确认结果。当前不执行快速扫荡，也尚未加入红点检测或模型 API。Windows 双平台操作仍需实机验证；页面不匹配或超时会停止，不重复领取。启动方法与验证命令见项目 README。
 
 ## 首页
 
@@ -118,12 +122,22 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 | 点击小金猪 | 打开挂机奖励弹框 | 不同窗口大小下的识别方式 |
 | 查看挂机奖励 | 当前截图提示“已达到最长时间”，最大挂机 12 小时 | 未满 12 小时时的显示、领取后的计时变化 |
 | 快速扫荡 | 按钮标注消耗 10 体力 | 每日次数、后续次数的消耗、确认弹框、奖励与完成状态 |
-| 领取 | 可领取挂机奖励，按钮未显示消耗 | 实际领取结果、是否有二次确认、领取成功标志 |
+| 领取 | 金色按钮时可领取挂机奖励，按钮未显示消耗；灰色时不可领取 | 领取频率和跨日重置规律 |
 | 点击空白处关闭 | 截图底部明确显示该提示 | 关闭后是否稳定回到首页 |
 
 “快速扫荡”和“领取”应作为两个独立操作记录。前者有明确的体力消耗，后续自动化需要可配置是否执行及次数；后者仍需实际走查确认成功判定。
 
-建议走查路径：**首页 → 小金猪 → 挂机奖励 → 查看领取条件 → 执行指定操作 → 确认奖励结果 → 返回首页**。目前仅确认入口和弹框，不代表已完成领取验证。
+### 小金猪挂机奖励领取（已实机验证）
+
+2026-10-04 已在当前账号完成：**首页 → 小金猪 → 右侧领取 → 恭喜获得弹框 → 领取按钮变灰 → 关闭弹框 → 首页**。领取前挂机时间已达最长 12 小时；领取后按钮变灰，挂机时间重置为 00:00:00，随后开始重新累积。实机观察到钻石从 2392 变为 2423、金币从 49964 变为 56626。
+
+对应脚本为项目根目录的 `claim_idle.py`，配置在 `workflows/idle_claim.json`。运行方式：
+
+```bash
+.venv/bin/python claim_idle.py
+```
+
+脚本仅在右侧领取按钮识别为金色时执行 0.8 秒长按；必须识别“恭喜获得”弹框和变灰按钮才判定成功。按钮已灰时跳过领取，直接关闭弹框并回到首页。左侧“快速扫荡”消耗体力，不在脚本范围内。
 
 ### 主界面其他可见内容
 
@@ -247,7 +261,7 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 | 观影、寻宝 | 先识别活动是否出现，再执行固定流程 | 活动不一定存在，但用户确认出现后的流程稳定 |
 | 试炼、三类冲刺 | 共用流程，并为不同页面设置识别规则；必要时由 AI 辅助判断 | 基本逻辑一致，页面外观或活动条件会变化 |
 | 金沙游记等左上角大活动、英雄集结 | 先识别活动名称与分活动，再逐项评估 | 活动名称、数量和内部结构可能变化，当前缺少完整流程 |
-| 小金猪挂机奖励 | 固定流程与结果识别；快速扫荡另设资源配置 | 入口和弹框清晰，但领取与体力消耗操作需要区分 |
+| 小金猪挂机奖励 | 已验证脚本：金色领取按钮时领取、验证奖励弹框与灰色按钮、返回首页 | 不执行快速扫荡；领取频率和 Windows 适配待验证 |
 | 任务、好友、邮件、返利 | 暂不确定 | 尚未查看内部内容和日常规则 |
 | 商城：英雄招募、图腾寻宝、每日商店、金币 | 后续确定 | 已记录区域结构，日常目标、执行次数、资源消耗与完成判定尚未明确 |
 | 商城：关卡礼包、钻石 | 暂不处理 | 用户明确排除 |
@@ -280,5 +294,6 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 | 序号 | 脚本名字 | 入口页面 | 入口位置 | 实现功能简介 | 脚本更新时间 |
 | --- | --- | --- | --- | --- | --- |
 | 1 | 战令领取（`claim_offer.py`） | 首页 | 首页 → 左侧特惠 → 战令 | 识别“超值月卡”时先切换战令；领取赏金战令奖励，确认奖励弹框和按钮变灰后返回首页；已领取时跳过。 | 2026-10-04 17:45 CST |
-| 2 | 收矿与雇佣（`claim_mining.py`） | 领地 | 首页 → 底部领地 → 狂鼠之家 | 发现“一键收矿”后收矿、关闭奖励弹框、等待 10 秒；按白银罗盘、黄金罗盘、彩虹探测仪顺序一键雇佣，无可用道具时关闭弹框，最后返回首页。 | 2026-10-04 18:17 CST |
-| 3 | 领体力（`claim_stamina.py`） | 领地 | 首页 → 底部领地 → 食堂 | 发现“一键领取”时领取体力，确认“恭喜获得”弹框和烤肉库存 0/60 后返回首页；无可领体力时跳过。 | 2026-10-04 18:32 CST |
+| 2 | 挂机奖励领取（`claim_idle.py`） | 首页 | 首页 → 小金猪 | 仅在右侧领取按钮为金色时长按领取，确认“恭喜获得”弹框和按钮变灰后关闭；灰色时跳过，最终返回首页。 | 2026-10-04 18:48 CST |
+| 3 | 收矿与雇佣（`claim_mining.py`） | 领地 | 首页 → 底部领地 → 狂鼠之家 | 发现“一键收矿”后收矿、关闭奖励弹框、等待 10 秒；按白银罗盘、黄金罗盘、彩虹探测仪顺序一键雇佣，无可用道具时关闭弹框，最后返回首页。 | 2026-10-04 18:17 CST |
+| 4 | 领体力（`claim_stamina.py`） | 领地 | 首页 → 底部领地 → 食堂 | 发现“一键领取”时领取体力，确认“恭喜获得”弹框和烤肉库存 0/60 后返回首页；无可领体力时跳过。 | 2026-10-04 18:32 CST |