feat: add mining collection automation

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

@@ -1,7 +1,7 @@
 ---
 created_at: 2026-10-04 16:07:56 CST
 type: 永远的蔚蓝星球首页、商城、领地与公会入口、日常任务与自动化适配记录
-revision: 第7次
+revision: 第8次
 revisions:
   - time: 2026-10-04 16:07:56 CST
     version: 第1次
@@ -31,7 +31,11 @@ revisions:
     version: 第7次
     author: GPT-6
     content: 实机完成特惠赏金战令一键领取及返回首页，新增脚本、奖励结果和已领取状态的识别逻辑。
-summary: 记录首页、商城、领地和公会的日常任务入口及待完善流程。入口红点表示内部有奖励可领取。特惠赏金战令一键领取已实机验证并写成脚本；开发先验证本地流程，再打包独立程序，商城关卡礼包和钻石暂不处理。
+  - time: 2026-10-04 18:17:58 CST
+    version: 第8次
+    author: gpt-5
+    content: 补充狂鼠之家一键收矿与优先罗盘雇佣的实机验证流程、脚本、无可收矿分支和测试状态。
+summary: 记录首页、商城、领地和公会的日常任务入口及待完善流程。入口红点表示内部有奖励可领取。特惠赏金战令领取、狂鼠之家收矿与优先罗盘雇佣均已实机验证并写成脚本；开发先验证本地流程，再打包独立程序，商城关卡礼包和钻石暂不处理。
 ---
 
 # 首页、商城、领地与公会功能及日常任务梳理
@@ -157,7 +161,7 @@ summary: 记录首页、商城、领地和公会的日常任务入口及待完
 
 | 栏目 | 截图中的大致位置 | 自动化流程状态 |
 | --- | --- | --- |
-| 狂鼠之家 | 左侧中下部，矿洞建筑 | 用户确认有固定流程，具体步骤待补充 |
+| 狂鼠之家 | 左侧中下部，矿洞建筑 | 一键收矿与优先罗盘一键雇佣已实机验证并有脚本；其他内部功能待补充 |
 | 玩法大厅 | 下方偏左，带喇叭的建筑 | 用户确认有固定流程，具体步骤待补充 |
 | 图鉴 | 下方偏右，书本建筑 | 用户确认有固定流程，具体步骤待补充 |
 | 食堂 | 中部，带食物的建筑 | 用户确认有固定流程，具体步骤待补充 |
@@ -174,6 +178,20 @@ summary: 记录首页、商城、领地和公会的日常任务入口及待完
 
 后续逐栏目补充日常目标、进入与返回路径、操作顺序、执行次数、奖励领取、资源消耗，以及已完成、条件不足等状态的识别方式。目前尚未确认任一栏目的内部按钮和完成标志，也未据此确定脚本或 AI 的具体实现方式。
 
+### 狂鼠之家：一键收矿与一键雇佣（已实机验证）
+
+2026-10-04 已在当前账号完成：**首页 → 领地 → 狂鼠之家 → 一键收矿 → 确认收矿奖励弹框 → 关闭弹框 → 等待 10 秒 → 一键雇佣 → 返回首页**。本次收矿获得 930 矿石；雇佣弹框中白银罗盘数量为 59，脚本优先选择白银罗盘并完成一键雇佣，完成后数量变为 53。
+
+对应脚本为项目根目录的 `claim_mining.py`，配置在 `workflows/mining_claim.json`。运行方式：
+
+```bash
+.venv/bin/python claim_mining.py
+```
+
+脚本仅在识别到“一键收矿”时收矿，识别奖励弹框后才关闭；随后严格等待 10 秒。雇佣弹框按 **白银罗盘 → 黄金罗盘 → 彩虹探测仪** 的优先级选择第一个可用项，三者均不可用时关闭弹框。若未发现“一键收矿”，本次跳过雇佣并返回首页。每次关键点击前后都会识别页面状态；不匹配、超时或窗口移动时停止，不重复执行不确定的领取操作。
+
+该流程使用截图模板识别与相对坐标点击，macOS 已实机验证；Windows 仍需在对应环境校准并验证。可使用 `--dry-run` 只检查首页和执行计划，不点击游戏内容。
+
 ## 公会页面
 
 ### 入口与栏目
@@ -213,7 +231,8 @@ summary: 记录首页、商城、领地和公会的日常任务入口及待完
 | 任务、好友、邮件、返利 | 暂不确定 | 尚未查看内部内容和日常规则 |
 | 商城：英雄招募、图腾寻宝、每日商店、金币 | 后续确定 | 已记录区域结构，日常目标、执行次数、资源消耗与完成判定尚未明确 |
 | 商城：关卡礼包、钻石 | 暂不处理 | 用户明确排除 |
-| 领地：狂鼠之家、玩法大厅、图鉴、食堂、排行榜、巅峰决斗、合作模式、城墙 | 待完善固定流程后确定 | 用户确认八个栏目均有固定自动化流程，具体步骤、执行条件、消耗和完成判定尚未补充 |
+| 领地：狂鼠之家 | 已验证脚本：一键收矿、等待 10 秒、按白银/黄金/彩虹顺序一键雇佣、返回首页 | 当前仅覆盖该日常流程；其他内部功能、重置规律和 Windows 适配待验证 |
+| 领地：玩法大厅、图鉴、食堂、排行榜、巅峰决斗、合作模式、城墙 | 待完善固定流程后确定 | 用户确认各栏目均有固定自动化流程，具体步骤、执行条件、消耗和完成判定尚未补充 |
 | 公会：公会商城、远征大厅、公会任务、公会祝福、每日捐献、成员大厅、公会 Boss、右下角红色角色入口 | 待完善固定流程后确定 | 用户确认八个入口均有固定自动化流程；右下角入口名称及各流程的具体步骤、消耗和完成判定待补充 |
 
 初步方向是让脚本执行已验证的重复步骤，让 AI 辅助识别变化页面或异常。是否每次调用 AI、调用到哪一步，待明确任务完成标志与变化范围后再决定。