feat: add cooperation ticket claim automation

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

@@ -1,7 +1,7 @@
 ---
 created_at: 2026-10-04 16:07:56 CST
 type: 永远的蔚蓝星球首页、商城、领地与公会入口、日常任务与自动化适配记录
-revision: 第13次
+revision: 第14次
 revisions:
   - time: 2026-10-04 16:07:56 CST
     version: 第1次
@@ -55,7 +55,11 @@ revisions:
     version: 第13次
     author: gpt-5
     content: 补充任务红点驱动的日常与周常领奖流程、无红点跳过分支、脚本和汇总表条目。
-summary: 记录首页、商城、领地和公会的日常任务入口、待完善流程及已实现脚本汇总。入口红点表示内部有奖励可领取；特惠赏金战令、小金猪领取与扫荡、任务奖励、狂鼠之家收矿与雇佣、食堂领体力均已实机验证并写成脚本。
+  - time: 2026-10-04 20:25:59 CST
+    version: 第14次
+    author: gpt-5
+    content: 补充合作模式合作券领取的实机验证、已领完跳过分支、脚本和汇总表条目。
+summary: 记录首页、商城、领地和公会的日常任务入口、待完善流程及已实现脚本汇总。入口红点表示内部有奖励可领取；特惠赏金战令、小金猪领取与扫荡、任务奖励、狂鼠之家收矿与雇佣、食堂领体力、合作模式合作券均已实机验证并写成脚本。
 ---
 
 # 首页、商城、领地与公会功能及日常任务梳理
@@ -227,7 +231,7 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 | 食堂 | 中部，带食物的建筑 | 一键领取体力已实机验证并有脚本；其他内部功能待补充 |
 | 排行榜 | 右侧中部，石制台座区域 | 用户确认有固定流程，具体步骤待补充 |
 | 巅峰决斗 | 左上部，旗帜建筑 | 用户确认有固定流程，具体步骤待补充 |
-| 合作模式 | 上方中部，紫色传送门区域 | 用户确认有固定流程，具体步骤待补充 |
+| 合作模式 | 上方中部，紫色传送门区域 | 合作券领取已实机验证并有脚本；保卫宠物及其他内部功能待补充 |
 | 城墙 | 右上部，城门建筑 | 用户确认有固定流程，具体步骤待补充 |
 
 位置仅描述本次截图，不作为固定点击坐标。各栏目排列为地图布局，上表顺序沿用用户的说明，不代表执行顺序。
@@ -264,6 +268,18 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 
 脚本先确认食堂内有可领取烤肉，才点击“一键领取”；随后必须识别“恭喜获得”奖励弹框和烤肉库存 0/60，最后关闭食堂并返回首页。没有可领取体力时，会跳过领取并直接返回首页。macOS 已实机验证；Windows 仍需校准和验证。
 
+### 合作模式：合作券领取（已实机验证）
+
+2026-10-04 已在当前账号完成：**首页 → 领地 → 合作模式入口 → 模式选择中的左侧“合作模式” → 左上角“可领取” → 确认奖励弹框 → 确认状态变为“已领完” → 返回领地 → 返回首页**。本次合作券由 17/30 增至 18/30。
+
+对应脚本为项目根目录的 `claim_cooperation_ticket.py`，配置在 `workflows/cooperation_ticket.json`。运行方式：
+
+```bash
+.venv/bin/python claim_cooperation_ticket.py
+```
+
+脚本只选择模式选择页左侧的“合作模式”，不会进入右侧“保卫宠物”。左上角显示“可领取”时才点击并等待奖励弹框；若已显示“已领完”，则跳过领取并依次退出到首页。可使用 `--dry-run` 只验证首页和执行计划，不点击游戏内容。macOS 已实机验证；Windows 仍需校准和验证。
+
 ## 公会页面
 
 ### 入口与栏目
@@ -306,7 +322,8 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 | 商城：关卡礼包、钻石 | 暂不处理 | 用户明确排除 |
 | 领地：狂鼠之家 | 已验证脚本：一键收矿、等待 10 秒、按白银/黄金/彩虹顺序一键雇佣、返回首页 | 当前仅覆盖该日常流程；其他内部功能、重置规律和 Windows 适配待验证 |
 | 领地：食堂 | 已验证脚本：发现一键领取时领体力、确认奖励和库存清空、返回首页 | 当前仅覆盖体力领取；其他内部功能、重置规律和 Windows 适配待验证 |
-| 领地：玩法大厅、图鉴、排行榜、巅峰决斗、合作模式、城墙 | 待完善固定流程后确定 | 用户确认各栏目均有固定自动化流程，具体步骤、执行条件、消耗和完成判定尚未补充 |
+| 领地：合作模式 | 已验证脚本：只选择左侧合作模式，发现左上可领取时领取合作券、确认已领完、返回首页 | 保卫宠物及其他内部功能、重置规律和 Windows 适配待验证 |
+| 领地：玩法大厅、图鉴、排行榜、巅峰决斗、城墙 | 待完善固定流程后确定 | 用户确认各栏目均有固定自动化流程，具体步骤、执行条件、消耗和完成判定尚未补充 |
 | 公会：公会商城、远征大厅、公会任务、公会祝福、每日捐献、成员大厅、公会 Boss、右下角红色角色入口 | 待完善固定流程后确定 | 用户确认八个入口均有固定自动化流程；右下角入口名称及各流程的具体步骤、消耗和完成判定待补充 |
 
 初步方向是让脚本执行已验证的重复步骤，让 AI 辅助识别变化页面或异常。是否每次调用 AI、调用到哪一步，待明确任务完成标志与变化范围后再决定。
@@ -338,3 +355,4 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
 | 4 | 任务奖励领取（`claim_tasks.py`） | 首页 | 首页 → 右侧任务 → 日常/周常 | 仅在任务红点存在时进入；领取当前面板的可见奖励，另一个标签有自身红点时才切换处理，最后返回首页。 | 2026-10-04 19:11 CST |
 | 5 | 收矿与雇佣（`claim_mining.py`） | 领地 | 首页 → 底部领地 → 狂鼠之家 | 发现“一键收矿”后收矿、关闭奖励弹框、等待 10 秒；按白银罗盘、黄金罗盘、彩虹探测仪顺序一键雇佣，无可用道具时关闭弹框，最后返回首页。 | 2026-10-04 18:17 CST |
 | 6 | 领体力（`claim_stamina.py`） | 领地 | 首页 → 底部领地 → 食堂 | 发现“一键领取”时领取体力，确认“恭喜获得”弹框和烤肉库存 0/60 后返回首页；无可领体力时跳过。 | 2026-10-04 18:32 CST |
+| 7 | 领取合作券（`claim_cooperation_ticket.py`） | 领地 | 首页 → 底部领地 → 合作模式 → 左侧合作模式 | 左上显示“可领取”时领取合作券，确认奖励和“已领完”后返回首页；已领完时跳过；不会进入保卫宠物。 | 2026-10-04 20:25 CST |