465 lines
42 KiB
Markdown
465 lines
42 KiB
Markdown
---
|
||
created_at: 2026-10-04 16:07:56 CST
|
||
type: 永远的蔚蓝星球首页、商城、领地与公会入口、日常任务与自动化适配记录
|
||
revision: 第23次
|
||
revisions:
|
||
- time: 2026-10-04 16:07:56 CST
|
||
version: 第1次
|
||
author: GPT-6
|
||
content: 根据用户说明和两张截图整理页面功能（初版称为国王页面，第2次修订更正为首页），记录活动变化规律及挂机奖励弹框，列出待验证流程。
|
||
- time: 2026-10-04 16:10:44 CST
|
||
version: 第2次
|
||
author: GPT-6
|
||
content: 根据用户更正，将记录对象统一改为首页，并区分底部国王入口。
|
||
- time: 2026-10-04 16:20:27 CST
|
||
version: 第3次
|
||
author: GPT-6
|
||
content: 补充商城六个区域及截图可见内容，记录关卡礼包和钻石暂不处理，其余区域的自动化方式后续确定。
|
||
- time: 2026-10-04 16:21:34 CST
|
||
version: 第4次
|
||
author: GPT-6
|
||
content: 补充领地八个栏目及截图中的入口位置，记录用户确认各栏目都有固定自动化流程，详细步骤待后续完善。
|
||
- time: 2026-10-04 16:32:12 CST
|
||
version: 第5次
|
||
author: GPT-6
|
||
content: 补充公会八个入口及位置，右下角红色角色入口暂标名称待确认，记录用户确认各入口均有固定自动化流程。
|
||
- time: 2026-10-04 16:47:04 CST
|
||
version: 第6次
|
||
author: GPT-6
|
||
content: 补充用户确认的入口红点规则，并记录先本地实现流程、验证后再打包为独立程序的开发顺序。
|
||
- time: 2026-10-04 17:45:37 CST
|
||
version: 第7次
|
||
author: GPT-6
|
||
content: 实机完成特惠赏金战令一键领取及返回首页，新增脚本、奖励结果和已领取状态的识别逻辑。
|
||
- time: 2026-10-04 18:17:58 CST
|
||
version: 第8次
|
||
author: gpt-5
|
||
content: 补充狂鼠之家一键收矿与优先罗盘雇佣的实机验证流程、脚本、无可收矿分支和测试状态。
|
||
- time: 2026-10-04 18:25:52 CST
|
||
version: 第9次
|
||
author: gpt-5
|
||
content: 在文档末尾新增已实现脚本汇总表，按首页、商城、领地、公会的入口页面顺序整理入口、功能和更新时间。
|
||
- time: 2026-10-04 18:32:57 CST
|
||
version: 第10次
|
||
author: gpt-5
|
||
content: 补充食堂一键领取体力的实机验证流程、无可领取分支、脚本和汇总表条目。
|
||
- time: 2026-10-04 18:48:40 CST
|
||
version: 第11次
|
||
author: gpt-5
|
||
content: 补充小金猪挂机奖励的实机领取与灰色跳过分支，新增独立脚本及汇总表条目。
|
||
- time: 2026-10-04 18:56:33 CST
|
||
version: 第12次
|
||
author: gpt-5
|
||
content: 补充小金猪快速扫荡的单次实机验证、5 次间隔执行规则、脚本和汇总表条目。
|
||
- time: 2026-10-04 19:11:50 CST
|
||
version: 第13次
|
||
author: gpt-5
|
||
content: 补充任务红点驱动的日常与周常领奖流程、无红点跳过分支、脚本和汇总表条目。
|
||
- time: 2026-10-04 20:25:59 CST
|
||
version: 第14次
|
||
author: gpt-5
|
||
content: 补充合作模式合作券领取的实机验证、已领完跳过分支、脚本和汇总表条目。
|
||
- time: 2026-10-04 20:56:07 CST
|
||
version: 第15次
|
||
author: gpt-5
|
||
content: 补充巅峰决斗竞技场积分领取的实机验证、脚本和汇总表条目。
|
||
- time: 2026-10-04 22:19:36 CST
|
||
version: 第16次
|
||
author: gpt-5
|
||
content: 补充英雄集结内剑来献礼积分奖励、骊珠画卷任务奖励的脚本、实机结果和汇总表条目。
|
||
- time: 2026-10-04 22:32:52 CST
|
||
version: 第17次
|
||
author: gpt-5
|
||
content: 按入口页面重新排序已实现脚本汇总表，并更新序号。
|
||
- time: 2026-10-04 23:32:36 CST
|
||
version: 第18次
|
||
author: gpt-5
|
||
content: 补充邮件一键领取和任意一级页面公会互助的脚本、实机结果与汇总表条目。
|
||
- time: 2026-10-05 01:29:24 CST
|
||
version: 第19次
|
||
author: gpt-5
|
||
content: 补充狂鼠之家好友矿鼠循环喂养的实机结果、停止条件、脚本和汇总表条目。
|
||
- time: 2026-10-05 02:06:08 CST
|
||
version: 第20次
|
||
author: gpt-5
|
||
content: 补充公会右下红珍珠祭坛砍价的实机结果、脚本和汇总表条目。
|
||
- time: 2026-10-05 02:40:01 CST
|
||
version: 第21次
|
||
author: gpt-5
|
||
content: 补充公会每日免费捐献的实机结果、脚本和汇总表条目。
|
||
- time: 2026-10-05 03:25:28 CST
|
||
version: 第22次
|
||
author: gpt-5
|
||
content: 补充玩法大厅星球矿场的排行榜进度奖励、扫荡上一层循环、脚本和汇总表条目。
|
||
- time: 2026-10-05 04:18:08 CST
|
||
version: 第23次
|
||
author: GPT-6
|
||
content: 补充商城英雄招募限时 UP 卡片的神灯任务与免费神灯领取流程、实机验证结果、脚本和汇总表条目。
|
||
summary: 记录首页、商城、领地和公会的日常任务入口、待完善流程及已实现脚本汇总。入口红点表示内部有奖励可以领取；特惠赏金战令、小金猪领取与扫荡、任务奖励、邮件、英雄招募神灯任务和免费神灯、狂鼠之家收矿雇佣与好友喂养、食堂领体力、合作模式合作券、竞技场积分、星球矿场、英雄集结内剑来献礼与骊珠画卷任务，以及公会互助、砍价和每日免费捐献均已实现脚本。
|
||
---
|
||
|
||
# 首页、商城、领地与公会功能及日常任务梳理
|
||
|
||
## 记录范围与依据
|
||
|
||
本记录针对《永远的蔚蓝星球》的首页、商城、领地与公会，依据用户对高级账号的说明、两张首页截图、八张商城截图、一张领地截图及一张公会截图。当前已开始本地自动化原型开发；各活动内部流程继续逐项补充和实机验证。
|
||
|
||
主界面截图显示账号等级 95，当前关卡为“144. 寒霜之径”，底部导航包括商城、英雄、国王、领地、公会。这里描述的页面统一称为“首页”；底部“国王”是独立入口，其内部功能待后续梳理。此前低等级账号的功能锁定情况不代表当前账号。
|
||
|
||
下文区分三类信息：**用户确认**的规律、**截图可见**的内容，以及**待验证**的内部流程。
|
||
|
||
## 通用规则与开发顺序
|
||
|
||
用户确认：**当某个按钮进入的页面内有奖励可以领取时，按钮右上角会出现红点。** 红点可作为进入该页面领取奖励的依据；进入后仍需识别具体奖励按钮与领取条件，领取成功通过内部状态变化确认。红点消失可以作为观察线索，但页面内仍可能存在其他奖励，不能只凭一次点击判定整页任务完成。没有红点时是否能跳过整页，需结合具体栏目流程确认。
|
||
|
||
用户确定的开发顺序：**先在本地实现部分自动化流程，逐项验证后再打包成独立程序**，最终目标仍是 macOS 与 Windows。模型 Key 由用户以后在程序设置中填写。
|
||
|
||
小金猪、特惠战令、狂鼠之家、食堂均已有实机验证脚本，使用局部截图模板识别并在关键状态变化后确认结果。当前不执行快速扫荡，也尚未加入红点检测或模型 API。Windows 双平台操作仍需实机验证；页面不匹配或超时会停止，不重复领取。启动方法与验证命令见项目 README。
|
||
|
||
## 首页
|
||
|
||
### 左侧入口
|
||
|
||
| 入口 | 出现规律（用户确认） | 功能和日常逻辑（用户确认） | 后续需要核实 |
|
||
| --- | --- | --- | --- |
|
||
| 金沙游记 | 季节性大活动，不定期出现；每次名称可能不同；可有两个大活动同时出现，入口都在左上角 | 进入后包含多个分活动 | 分活动清单、各任务入口、签到与领奖步骤、完成标志 |
|
||
| 特惠 | 固定入口 | 内部有每天按固定流程领取的奖励；当前赏金战令一键领取已实机验证 | 其他子页面、跨日重置规律及活动更换后的样式 |
|
||
| 活动 | 固定入口 | 内部有每天按固定流程领取的奖励 | 子页面结构、领取顺序、领取后状态、跨日重置规律 |
|
||
| 返利 | 当前左侧存在，是否固定尚未说明 | 内部功能尚未说明 | 领取条件、是否与充值相关、是否存在日常免费内容 |
|
||
| 观影 | 不定期出现 | 出现后流程固定，按按钮操作即可 | 按钮顺序、是否涉及广告播放、等待时间、领奖和结束状态 |
|
||
| 试炼 | 不定期出现 | 每次页面样式略有不同，但领奖页面逻辑相同 | 样式变化范围、任务条件、领奖路径、完成标志 |
|
||
| 冲刺 | 不定期出现，三个冲刺活动轮流出现 | 三种活动基本逻辑相同 | 三种活动名称、共用步骤、差异条件、奖励领取状态 |
|
||
| 寻宝 | 不定期出现 | 每次签到逻辑相同 | 签到入口、签到条件、是否有补签消耗、签到完成状态 |
|
||
|
||
截图中左侧入口为纵向排列，较下方按钮部分受折叠区域影响。后续需要确认列表的展开、收起或滚动方式，不能假定所有入口始终同时可见或保持同一位置。
|
||
|
||
### 特惠战令一键领取（已实机验证）
|
||
|
||
2026-10-04 在当前账号实际执行并观察到完整流程：**首页 → 左侧特惠 → 赏金战令 → 一键领取 → 恭喜获得弹框 → 点击空白处关闭 → 一键领取按钮变灰、已领奖励出现绿色勾选 → 左下角返回 → 首页**。
|
||
|
||
对应脚本为项目根目录的 `claim_offer.py`，步骤与页面模板配置保存在 `workflows/offer_claim.json`。在项目目录运行：
|
||
|
||
```bash
|
||
.venv/bin/python claim_offer.py
|
||
```
|
||
|
||
脚本连续两次识别预期页面后才点击。领取后必须识别奖励弹框和灰色领取按钮，最后确认首页。如果进入时按钮已经变灰，则跳过领取并返回首页；页面不匹配或超时会停止，不重复尝试领取。可用 `--dry-run` 只验证首页并显示计划。
|
||
|
||
特惠也可能默认打开“超值月卡”；脚本识别该页后点击底部“战令”，再进入领取流程。完整脚本复跑已验证从月卡切换战令、识别已领取并返回首页，16 项自动化测试通过。
|
||
|
||
当前流程只覆盖本次“赏金战令”奖励，不购买付费战令，也不遍历其他特惠子页面。macOS 使用 PyAutoGUI 系统鼠标事件，读取微信游戏窗口位置，排除标题栏并处理 Retina 缩放；窗口在识别后移动会停止。Windows 的校准区域入口已提供，仍需在 Windows 实机验证。跨日刷新、活动更换和不同尺寸下的模板适配后续完善。
|
||
|
||
### 右侧与右上方入口
|
||
|
||
| 区域 | 入口 | 出现规律与用途 | 当前记录状态 |
|
||
| --- | --- | --- | --- |
|
||
| 右侧 | 任务 | 固定入口 | 已验证脚本：根据首页和日常/周常标签红点领取任务奖励并返回首页；滚动后隐藏任务的领取规则待继续确认 |
|
||
| 右侧 | 好友 | 固定入口 | 是否包含每日互动或免费奖励待查看 |
|
||
| 右侧 | 邮件 | 固定入口 | 已实现红点触发的一键领取与返回首页脚本；无红点时跳过 |
|
||
| 右侧 | 英雄集结 | 不定期出现的大活动，与金沙游记属于类似类型 | 剑来献礼积分奖励、骊珠画卷任务奖励已实现脚本；其他分活动待查看 |
|
||
| 右上方 | 小游戏、问题反馈、游戏圈、客服 | 用户明确暂时不用处理 | 暂不纳入本轮任务梳理 |
|
||
|
||
### 任务奖励：日常与周常（已实机验证）
|
||
|
||
2026-10-04 实机执行时，首页任务按钮存在红点。进入默认日常面板后发现 3 个“领取”按钮，已逐个领取并确认对应“恭喜获得”弹框。日常面板没有可领奖励后，检查周常面板；周常没有“领取”按钮，因此关闭任务并返回首页。之后重新运行脚本时，首页任务红点已消失，脚本未进入任务面板。
|
||
|
||
对应脚本为项目根目录的 `claim_tasks.py`，配置在 `workflows/task_claim.json`。运行方式：
|
||
|
||
```bash
|
||
.venv/bin/python claim_tasks.py
|
||
```
|
||
|
||
脚本先检查首页任务红点，没有红点时直接结束。进入后处理当前日常或周常面板中全部可见的“领取”按钮，每领取一次都确认奖励弹框并关闭。当前面板没有领取按钮时，脚本仅检查另一个标签自身右上角的红点；有红点才切换并继续领取，没有则关闭任务回到首页。单个面板的领取次数上限为 20 次，达到上限会停止，避免页面异常时重复点击。
|
||
|
||
### 英雄集结：剑来献礼积分奖励与骊珠画卷任务奖励
|
||
|
||
2026-10-04 实机进入英雄集结后，剑来献礼入口存在红点。进入页面后点击“一键领取”，确认“恭喜获得”弹框并领取 2 点活动积分。对应脚本为 `claim_sword_gift_points.py`，配置在 `workflows/sword_gift_claim.json`；脚本仅在剑来献礼入口有红点时进入，已领完或无红点时退出英雄集结并回到首页。
|
||
|
||
同次实机中骊珠画卷入口存在红点。进入底部“任务”面板后，活动任务有红点并领取 1 项奖励；每日任务标签没有红点，按规则未进入。对应脚本为 `claim_lizhu_task_rewards.py`，配置在 `workflows/lizhu_task_claim.json`。脚本按活动任务、每日任务顺序检查标签红点，在每个有红点的面板中逐个点击可见“领取”按钮、确认奖励弹框后继续；单个面板最多处理 20 次，最后关闭任务、骊珠画卷和英雄集结，返回首页。
|
||
|
||
### 中间区域：小金猪与挂机奖励
|
||
|
||
用户确认：点击小金猪会打开奖励弹框，里面可以领取奖励。
|
||
|
||
截图确认弹框标题为“挂机奖励”，显示当前关卡、每小时产出、挂机时间、奖励列表和操作按钮。截图中的按钮实际名称为“快速扫荡”（用户描述为“快速扫描”）和“领取”。
|
||
|
||
| 操作 | 截图与用户说明支持的信息 | 尚需验证的信息 |
|
||
| --- | --- | --- |
|
||
| 点击小金猪 | 打开挂机奖励弹框 | 不同窗口大小下的识别方式 |
|
||
| 查看挂机奖励 | 当前截图提示“已达到最长时间”，最大挂机 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 秒长按；必须识别“恭喜获得”弹框和变灰按钮才判定成功。按钮已灰时跳过领取，直接关闭弹框并回到首页。左侧“快速扫荡”消耗体力，不在脚本范围内。
|
||
|
||
### 小金猪快速扫荡（已实机验证）
|
||
|
||
2026-10-04 已在当前账号完成一次：**首页 → 小金猪 → 快速扫荡 → 恭喜获得弹框 → 关闭弹框 → 关闭挂机奖励 → 首页**。单次快速扫荡按钮显示消耗 10 体力，实机领取结果弹框中包含金币、经验、装备和其他资源。
|
||
|
||
对应脚本为项目根目录的 `claim_sweep.py`，配置在 `workflows/sweep_claim.json`。默认扫荡 1 次：
|
||
|
||
```bash
|
||
.venv/bin/python claim_sweep.py
|
||
```
|
||
|
||
执行 5 次时使用：
|
||
|
||
```bash
|
||
.venv/bin/python claim_sweep.py --times 5
|
||
```
|
||
|
||
脚本每次扫荡均以 0.8 秒长按点击，确认奖励弹框后关闭；多次执行时在关闭上一次奖励后严格等待 2 秒，再进行下一次。最后关闭挂机奖励弹框并返回首页。当前单次消耗为 10 体力，`--times 5` 预计消耗 50 体力；脚本限制单次运行 1 至 20 次，避免意外的大量消耗。
|
||
|
||
### 主界面其他可见内容
|
||
|
||
截图还显示关卡列表入口、关卡挑战按钮、宝箱和队伍展示。“开始挑战”标注消耗 10 体力。这些内容尚未由用户展开说明，后续再梳理其是否关联日常任务。
|
||
|
||
本记录不以进入下一关或消耗体力为探索前提。
|
||
|
||
## 商城页面
|
||
|
||
### 入口与区域顺序
|
||
|
||
用户确认：从底部“商城”按钮进入，页面包含日常签到、打卡相关内容。根据用户说明及连续截图，页面内容纵向排列，从上到下依次为：**英雄招募 → 图腾寻宝 → 关卡礼包 → 每日商店 → 钻石 → 金币**。其中“钻石”使用截图中的正式名称（用户描述为“砖石”）。
|
||
|
||
商城打开后，截图中的底部左侧按钮显示为“返回”。具体滚动距离、返回后的页面状态和各区域定位方式待后续走查。
|
||
|
||
| 顺序 | 区域 | 截图可见内容 | 本阶段范围 |
|
||
| --- | --- | --- | --- |
|
||
| 1 | 英雄招募 | 英雄兑换、快速招募选项、插鼓招募、星愿招募；下方多个限时 UP 神灯许愿卡片，带倒计时与任务入口 | 已实现限时 UP 卡片中的神灯任务奖励和免费神灯领取；不执行任何招募 |
|
||
| 2 | 图腾寻宝 | 蓝色与橙色两类宝箱；每类有“寻宝1次”“寻宝10次”、概率入口和保底次数提示 | 保留为后续日常任务适配对象，具体操作与自动化方式待定 |
|
||
| 3 | 关卡礼包 | 关卡礼包卡片，显示奖励、限购次数与价格；截图示例为第40关礼包 | 用户明确暂不处理 |
|
||
| 4 | 每日商店 | 商品网格，显示商品名称、数量、金币或钻石价格、“已售罄”状态；底部有刷新倒计时和付费刷新按钮 | 保留为后续日常任务适配对象，具体购买或领取规则待定 |
|
||
| 5 | 钻石 | 多档人民币充值商品，带钻石数量和赠送标记 | 用户明确暂不处理 |
|
||
| 6 | 金币 | 一袋金币、一箱金币、一车金币；有已售罄状态及钻石兑换价格 | 保留为后续日常任务适配对象，具体操作与自动化方式待定 |
|
||
|
||
### 截图支持的状态与待确认事项
|
||
|
||
- **英雄招募**：截图有招募资源数量与单次或多次所需数量显示；限时 UP 卡片不止一个。后续需明确日常要执行哪种招募、次数、资源限制，以及卡片中的“任务”是否有独立奖励。
|
||
- **图腾寻宝**：两类宝箱的资源图标和保底提示不同。后续需明确是否执行寻宝、选择哪类宝箱、单次或十次及每日执行条件。
|
||
- **每日商店**：截图可见招募券、游侠碎片、骑士碎片、靴子锻造书、洗炼石、随机职业经验。部分商品已售罄；刷新按钮标注消耗 600 金币。后续需明确每天处理哪些商品，以及是否允许手动刷新。
|
||
- **金币**：截图中的“一袋金币”显示 500 金币且已售罄，不能据此认定它原本免费；“一箱金币”显示 10000 金币、价格 450 钻石，“一车金币”显示 30000 金币、价格 1200 钻石。具体日常目标与消耗规则后续由用户说明。
|
||
|
||
以上数值仅为本次截图示例，不作为长期固定配置。“已售罄”可以作为后续状态识别线索，但具体每日重置与完成判定尚未验证。
|
||
|
||
### 英雄招募：限时 UP 神灯任务与免费神灯（已实机验证）
|
||
|
||
2026-10-05 已完成该流程走查：商城停在图腾寻宝区域时，向下拖动列表可进入限时 UP 卡片区域。点击卡片右下“任务”后会打开“神灯召唤”弹层；底部包含“神灯任务”和“神灯礼包”两个页签。任务页仅处理黄色“领取”，每次均出现“恭喜获得”展示，关闭后继续检查；礼包页仅处理绿色“免费”，不会点击带钻石、人民币或折扣标识的商品。完成后关闭神灯召唤并从商城返回首页。
|
||
|
||
对应脚本为项目根目录的 `claim_recruit_signin.py`，配置为 `workflows/recruit_signin.json`：
|
||
|
||
```bash
|
||
.venv/bin/python claim_recruit_signin.py
|
||
```
|
||
|
||
脚本从首页进入商城，定位限时 UP 卡片的“任务”按钮；只在该按钮有红点时进入。它按“神灯任务 → 神灯礼包”的顺序检查页签红点，在任务页逐项领取可见奖励并关闭每个奖励展示，在礼包页识别绿色“免费”并领取。处理当前卡片后继续向上查看其他卡片，最多处理 12 张；没有带红点的卡片时直接返回首页。本次实机中，双英雄 UP 卡片的任务与礼包显示为共通；领取一张卡片的免费神灯后，其余卡片未再显示红点，脚本确认无待领项后返回首页。
|
||
|
||
页面列表、红点、领取与免费按钮均使用本地截图模板识别。脚本不点击“前往”、招募、寻宝、钻石或人民币购买按钮；页面不匹配、窗口移动或超时会停止。macOS 已实机验证，Windows 仍需校准和验证。
|
||
|
||
### 本轮结论
|
||
|
||
本轮已实现英雄招募限时 UP 的神灯任务与免费神灯；**关卡礼包、钻石暂不处理；图腾寻宝、每日商店、金币如何自动化，后续再具体确定。** 页面归入日常打卡范围不代表其中所有按钮都需要执行，招募、寻宝、购买、兑换和刷新各自的规则仍待确认。
|
||
|
||
## 领地页面
|
||
|
||
### 入口与栏目
|
||
|
||
从底部“领地”按钮进入。截图显示领地为地图式布局，各栏目通过场景中的建筑或标签进入；打开后底部原“领地”位置显示“返回”。用户确认：以下八个栏目**每个都有固定的自动化流程**，本轮先记录入口，详细流程后续完善。
|
||
|
||
| 栏目 | 截图中的大致位置 | 自动化流程状态 |
|
||
| --- | --- | --- |
|
||
| 狂鼠之家 | 左侧中下部，矿洞建筑 | 一键收矿与优先罗盘一键雇佣已实机验证并有脚本；其他内部功能待补充 |
|
||
| 玩法大厅 | 下方偏左，带喇叭的建筑 | 星球矿场的排行榜奖励与扫荡已实机验证并有脚本；其他玩法待补充 |
|
||
| 图鉴 | 下方偏右，书本建筑 | 用户确认有固定流程，具体步骤待补充 |
|
||
| 食堂 | 中部，带食物的建筑 | 一键领取体力已实机验证并有脚本；其他内部功能待补充 |
|
||
| 排行榜 | 右侧中部，石制台座区域 | 用户确认有固定流程，具体步骤待补充 |
|
||
| 巅峰决斗 | 左上部，旗帜建筑 | 竞技场积分领取已实机验证并有脚本；巅峰决斗模式及其他内部功能待补充 |
|
||
| 合作模式 | 上方中部，紫色传送门区域 | 合作券领取已实机验证并有脚本；保卫宠物及其他内部功能待补充 |
|
||
| 城墙 | 右上部，城门建筑 | 用户确认有固定流程，具体步骤待补充 |
|
||
|
||
位置仅描述本次截图，不作为固定点击坐标。各栏目排列为地图布局，上表顺序沿用用户的说明，不代表执行顺序。
|
||
|
||
### 当前可见信息与待完善内容
|
||
|
||
截图中的巅峰决斗入口带“拥有”数量及决斗倒计时，合作模式入口带两种资源的“拥有”数量。这些是当前页面状态，资源含义、参与条件及重置规律尚未确认。
|
||
|
||
后续逐栏目补充日常目标、进入与返回路径、操作顺序、执行次数、奖励领取、资源消耗，以及已完成、条件不足等状态的识别方式。目前尚未确认任一栏目的内部按钮和完成标志，也未据此确定脚本或 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` 只检查首页和执行计划，不点击游戏内容。
|
||
|
||
### 狂鼠之家：好友矿鼠循环喂养（已实机验证）
|
||
|
||
2026-10-05 已在当前账号完成：**首页 → 领地 → 狂鼠之家 → 好友 → 列表首位“喂矿鼠” → 一键喂养 → 确认奖励弹框 → 左下“回家” → 自己的狂鼠之家 → 重复进入好友列表**。本次连续完成 5 位好友的喂养；第 6 位好友的矿场不再显示“一键喂养”，脚本停止循环并返回首页。
|
||
|
||
对应脚本为项目根目录的 `claim_feed_mice.py`，配置在 `workflows/feed_mice.json`。脚本每一轮重新读取好友列表，以列表首位可喂好友为目标；每次都必须确认“一键喂养”与奖励弹框后才继续。找不到好友按钮或一键喂养按钮时停止；最多处理 20 位好友，防止异常页面无限循环。macOS 已实机验证；Windows 仍需校准和验证。
|
||
|
||
### 玩法大厅：星球矿场收金币（已实机验证）
|
||
|
||
2026-10-05 已在当前账号完成：**首页 → 领地 → 玩法大厅 → 星球矿场 → 右上排行榜 → 进度奖励 → 领取带红点的奖励 → 返回星球矿场 → 扫荡 → 扫荡上一层 → 确认奖励 → 重复至剩余次数 0/2 → 关闭玩法大厅 → 返回首页**。本次排行榜获得 5 张道具券；扫荡两次，各获得 7500 金币，剩余次数由 2/2 变为 0/2。
|
||
|
||
对应脚本为项目根目录的 `claim_planet_mine.py`，配置在 `workflows/planet_mine.json`。排行榜入口有红点时才进入，脚本打开进度奖励并领取带红点的项目；星球矿场剩余次数非零且扫荡按钮可用时，依次打开扫荡弹框并点击“扫荡上一层”，每次确认奖励弹框后继续，最多两次。没有排行榜红点或扫荡按钮不可用时跳过相应部分，最后返回首页。macOS 已实机验证；Windows 仍需校准和验证。
|
||
|
||
### 食堂：一键领取体力（已实机验证）
|
||
|
||
2026-10-04 已在当前账号完成：**首页 → 领地 → 食堂 → 一键领取 → 确认奖励弹框 → 关闭弹框 → 关闭食堂 → 返回首页**。本次领取 30 体力，首页体力由 1042/80 变为 1072/80。领取后食堂显示烤肉库存 0/60，并出现下次领取倒计时。
|
||
|
||
对应脚本为项目根目录的 `claim_stamina.py`，配置在 `workflows/stamina_claim.json`。运行方式：
|
||
|
||
```bash
|
||
.venv/bin/python claim_stamina.py
|
||
```
|
||
|
||
脚本先确认食堂内有可领取烤肉，才点击“一键领取”；随后必须识别“恭喜获得”奖励弹框和烤肉库存 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 仍需校准和验证。
|
||
|
||
### 巅峰决斗：竞技场积分领取（已实机验证）
|
||
|
||
2026-10-04 已在当前账号完成：**首页 → 领地 → 巅峰决斗 → 模式选择中的左侧“竞技场” → 左下角带时分秒进度条的积分累积区域 → 确认奖励弹框 → 返回领地 → 返回首页**。首次点击获得 3886 竞技积分；脚本随后完成一次实机回归，确认可自动关闭奖励弹框并返回首页。
|
||
|
||
对应脚本为项目根目录的 `claim_arena_points.py`，配置在 `workflows/arena_points.json`。运行方式：
|
||
|
||
```bash
|
||
.venv/bin/python claim_arena_points.py
|
||
```
|
||
|
||
竞技积分会持续累积，该区域可领取时显示“恭喜获得”弹框。脚本确认竞技场页面后点击左下积分累积区域，必须识别奖励弹框才能继续关闭和返回；无法识别时安全停止。脚本只选择左侧“竞技场”，不会进入右侧“巅峰决斗”。可使用 `--dry-run` 只验证首页和执行计划，不点击游戏内容。macOS 已实机验证；Windows 仍需校准和验证。
|
||
|
||
## 公会页面
|
||
|
||
### 入口与栏目
|
||
|
||
从底部“公会”按钮进入。截图显示公会采用地图式布局，各入口分布在场景中的建筑或交互对象上；进入后底部原“公会”位置显示“返回”。用户确认：以下八个入口**均有固定的自动化流程**，本轮先记录栏目与位置，内部流程后续完善。
|
||
|
||
| 栏目或入口 | 截图中的大致位置 | 自动化流程状态 |
|
||
| --- | --- | --- |
|
||
| 公会商城 | 左侧中下部，带蓝色钻石标志的建筑 | 用户确认有固定流程，具体步骤待补充 |
|
||
| 远征大厅 | 下方偏左，紫色传送门区域 | 用户确认有固定流程，具体步骤待补充 |
|
||
| 公会任务 | 左侧中部，卷轴建筑 | 用户确认有固定流程，具体步骤待补充 |
|
||
| 公会祝福 | 中部，蓝色球体建筑 | 用户确认有固定流程，具体步骤待补充 |
|
||
| 每日捐献 | 右侧中部，发光的祭坛区域 | 免费捐献已实机验证并有脚本；付费捐献和次数规则待补充 |
|
||
| 成员大厅 | 右上部，高塔建筑 | 用户确认有固定流程，具体步骤待补充 |
|
||
| 公会 Boss | 左上部，巨龙区域；截图标签为“公会Boss” | 用户确认有固定流程，参与条件、次数及奖励步骤待补充 |
|
||
| 右下角红珍珠祭坛 | 右下部，红色角色与紫色台座，附近显示倒计时和对话气泡 | 砍价已实机验证并有脚本；其他内部功能待补充 |
|
||
|
||
位置仅描述本次截图，不作为固定点击坐标。最后一项指场景内的红色珍珠祭坛入口，不是底部红色“返回”按钮。
|
||
|
||
### 当前可见信息与待完善内容
|
||
|
||
截图顶部显示公会等级、名称、排名以及“排行”入口；右侧另有聊天气泡按钮。这些属于截图可见信息，用户本轮未将其列入上述固定流程，具体用途和是否需要处理待后续说明。
|
||
|
||
后续逐入口补充日常目标、进入与返回路径、操作顺序、执行次数、消耗与奖励，以及已完成、条件不足等状态的识别方式。右下角红色珍珠祭坛附近的倒计时仅记录为当前界面状态，其含义和出现规律待确认。
|
||
|
||
### 右下红珍珠祭坛：砍价（已实机验证）
|
||
|
||
2026-10-05 已在当前账号完成：**首页 → 公会 → 右下红珍珠祭坛 → 砍价 → 确认“恭喜获得”奖励弹框 → 退出祭坛 → 退出公会 → 首页**。本次砍价获得 20 钻石。
|
||
|
||
对应脚本为项目根目录的 `claim_guild_bargain.py`，配置在 `workflows/guild_bargain.json`。脚本进入祭坛后点击一次砍价，必须确认奖励弹框才继续关闭并返回首页；页面不匹配或超时时安全停止。可使用 `--dry-run` 从首页只验证执行计划，不点击游戏内容。macOS 已实机验证；Windows 仍需校准和验证。
|
||
|
||
### 每日捐献：免费捐献（已实机验证）
|
||
|
||
2026-10-05 已在当前账号完成：**首页 → 公会 → 每日捐献 → 左侧免费 → 确认“恭喜获得”奖励弹框 → 关闭捐献弹框 → 退出公会 → 首页**。本次获得 20 公会贡献和 100 公会经验，免费剩余次数由 5 变为 4。
|
||
|
||
对应脚本为项目根目录的 `claim_guild_donation.py`，配置在 `workflows/guild_donation.json`。脚本只点击左侧免费按钮，不会点击右侧消耗钻石的捐献按钮；免费次数已经使用时识别灰色按钮，跳过捐献并返回首页。可使用 `--dry-run` 从首页只验证执行计划，不点击游戏内容。macOS 已实机验证；Windows 仍需校准和验证。
|
||
|
||
## 自动化方案的初步判断
|
||
|
||
以下为设计候选，需内部流程走查后确认。
|
||
|
||
| 功能类型 | 候选实现方式 | 原因 |
|
||
| --- | --- | --- |
|
||
| 特惠、活动中的固定每日领奖 | 脚本组织流程，图像或文字识别确认每步状态 | 入口固定、步骤重复，可复用明确的操作和完成判定 |
|
||
| 观影、寻宝 | 先识别活动是否出现，再执行固定流程 | 活动不一定存在，但用户确认出现后的流程稳定 |
|
||
| 试炼、三类冲刺 | 共用流程，并为不同页面设置识别规则；必要时由 AI 辅助判断 | 基本逻辑一致，页面外观或活动条件会变化 |
|
||
| 金沙游记等左上角大活动、英雄集结 | 先识别活动名称与分活动，再逐项评估 | 活动名称、数量和内部结构可能变化，当前缺少完整流程 |
|
||
| 小金猪挂机奖励 | 已验证脚本：金色领取按钮时领取、验证奖励弹框与灰色按钮、返回首页 | 领取频率和 Windows 适配待验证 |
|
||
| 小金猪快速扫荡 | 已验证脚本：单次或指定次数扫荡，每次确认并关闭奖励，间隔 2 秒，返回首页 | 每次消耗 10 体力；体力不足时的按钮状态和 Windows 适配待验证 |
|
||
| 好友、返利 | 暂不确定 | 尚未查看内部内容和日常规则 |
|
||
| 商城：英雄招募、图腾寻宝、每日商店、金币 | 后续确定 | 已记录区域结构，日常目标、执行次数、资源消耗与完成判定尚未明确 |
|
||
| 商城：关卡礼包、钻石 | 暂不处理 | 用户明确排除 |
|
||
| 领地：狂鼠之家 | 已验证脚本：一键收矿、等待 10 秒、按白银/黄金/彩虹顺序一键雇佣、返回首页 | 当前仅覆盖该日常流程；其他内部功能、重置规律和 Windows 适配待验证 |
|
||
| 领地：食堂 | 已验证脚本：发现一键领取时领体力、确认奖励和库存清空、返回首页 | 当前仅覆盖体力领取；其他内部功能、重置规律和 Windows 适配待验证 |
|
||
| 领地：合作模式 | 已验证脚本：只选择左侧合作模式，发现左上可领取时领取合作券、确认已领完、返回首页 | 保卫宠物及其他内部功能、重置规律和 Windows 适配待验证 |
|
||
| 领地：巅峰决斗 | 已验证脚本：只选择左侧竞技场，领取左下积分累积区域的竞技积分、确认奖励后返回首页 | 右侧巅峰决斗及其他内部功能、重置规律和 Windows 适配待验证 |
|
||
| 领地：玩法大厅（星球矿场） | 已验证脚本：领取排行榜进度奖励，并将扫荡上一层执行至剩余次数为 0 | 其他玩法大厅项目、排行榜奖励刷新规律和 Windows 适配待验证 |
|
||
| 领地：图鉴、排行榜、城墙 | 待完善固定流程后确定 | 用户确认各栏目均有固定自动化流程，具体步骤、执行条件、消耗和完成判定尚未补充 |
|
||
| 公会：右下红珍珠祭坛 | 已验证脚本：砍价一次、确认奖励弹框、返回首页 | 砍价刷新规律、次数和 Windows 适配待验证 |
|
||
| 公会：每日捐献 | 已验证脚本：仅执行左侧免费捐献、确认奖励、返回首页 | 付费捐献、次数刷新规律和 Windows 适配待验证 |
|
||
| 公会：公会商城、远征大厅、公会任务、公会祝福、成员大厅、公会 Boss | 待完善固定流程后确定 | 用户确认各入口均有固定自动化流程，具体步骤、执行条件、消耗和完成判定尚未补充 |
|
||
|
||
初步方向是让脚本执行已验证的重复步骤，让 AI 辅助识别变化页面或异常。是否每次调用 AI、调用到哪一步，待明确任务完成标志与变化范围后再决定。
|
||
|
||
## 后续逐页记录模板
|
||
|
||
每个入口继续按以下字段补充：
|
||
|
||
1. **入口与出现条件**：位置、名称变化、解锁条件、是否限时。
|
||
2. **内部页面**：标签、子活动、按钮、返回和关闭方式。
|
||
3. **日常目标**：签到、领奖或完成任务的具体条件。
|
||
4. **操作步骤**：按顺序记录点击、等待及分支。
|
||
5. **完成标志**：已领取、已签到、按钮变灰或奖励结果等可观察证据。
|
||
6. **消耗与次数**：体力、钻石、道具、广告、次数上限及每日重置。
|
||
7. **异常情况**：活动缺席、已完成、条件不足、加载延迟或弹窗。
|
||
8. **适配方式**：固定脚本、识别规则或 AI 辅助及其适用范围。
|
||
|
||
下一阶段继续熟悉各入口内部流程和其他底部页面，补齐上述字段后再确定第一批自动化任务。
|
||
|
||
## 已实现脚本汇总
|
||
|
||
按入口页面顺序排列。
|
||
|
||
| 序号 | 脚本名字 | 入口页面 | 入口位置 | 实现功能简介 | 脚本更新时间 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| 1 | 战令领取（`claim_offer.py`） | 首页 | 首页 → 左侧特惠 → 战令 | 识别“超值月卡”时先切换战令；领取赏金战令奖励，确认奖励弹框和按钮变灰后返回首页；已领取时跳过。 | 2026-10-04 17:45 CST |
|
||
| 2 | 挂机奖励领取（`claim_idle.py`） | 首页 | 首页 → 小金猪 | 仅在右侧领取按钮为金色时长按领取，确认“恭喜获得”弹框和按钮变灰后关闭；灰色时跳过，最终返回首页。 | 2026-10-04 18:48 CST |
|
||
| 3 | 快速扫荡（`claim_sweep.py`） | 首页 | 首页 → 小金猪 → 左侧快速扫荡 | 默认扫荡 1 次；指定 5 次时每次确认并关闭奖励后等待 2 秒再继续，最后返回首页。每次消耗 10 体力。 | 2026-10-04 18:56 CST |
|
||
| 4 | 任务奖励领取（`claim_tasks.py`） | 首页 | 首页 → 右侧任务 → 日常/周常 | 仅在任务红点存在时进入；领取当前面板的可见奖励，另一个标签有自身红点时才切换处理，最后返回首页。 | 2026-10-04 19:11 CST |
|
||
| 5 | 收取邮件（`claim_mail.py`） | 首页 | 首页 → 右侧邮件 | 仅在邮件按钮有红点时进入并一键领取，确认奖励弹框后返回首页；无红点时跳过。 | 2026-10-04 23:32 CST |
|
||
| 6 | 领取剑来-积分奖励（`claim_sword_gift_points.py`） | 首页 | 首页 → 右侧英雄集结 → 剑来献礼 | 入口有红点时进入并一键领取积分奖励，确认奖励弹框后返回首页；无红点或已领完时跳过。 | 2026-10-04 22:19 CST |
|
||
| 7 | 领取骊珠画卷任务奖励（`claim_lizhu_task_rewards.py`） | 首页 | 首页 → 右侧英雄集结 → 骊珠画卷 → 底部任务 | 入口有红点时进入；活动任务、每日任务有各自红点时，逐个领取可见奖励并确认弹框，最后返回首页。 | 2026-10-04 22:19 CST |
|
||
| 8 | 英雄招募签到（`claim_recruit_signin.py`） | 商城 | 首页 → 底部商城 → 英雄招募 → 限时 UP → 任务 | 仅处理任务红点卡片：领取神灯任务中的黄色“领取”和礼包中的绿色“免费”，遍历其他限时 UP 卡片后返回首页；不点击招募、前往或付费商品。 | 2026-10-05 04:18 CST |
|
||
| 9 | 收矿与雇佣（`claim_mining.py`） | 领地 | 首页 → 底部领地 → 狂鼠之家 | 发现“一键收矿”后收矿、关闭奖励弹框、等待 10 秒；按白银罗盘、黄金罗盘、彩虹探测仪顺序一键雇佣，无可用道具时关闭弹框，最后返回首页。 | 2026-10-04 18:17 CST |
|
||
| 10 | 喂养狂鼠（`claim_feed_mice.py`） | 领地 | 首页 → 底部领地 → 狂鼠之家 → 好友 → 首位喂矿鼠 | 循环进入首位好友矿场，一键喂养、确认奖励、点击回家；无一键喂养时结束并返回首页，最多 20 位。 | 2026-10-05 01:29 CST |
|
||
| 11 | 领体力（`claim_stamina.py`） | 领地 | 首页 → 底部领地 → 食堂 | 发现“一键领取”时领取体力，确认“恭喜获得”弹框和烤肉库存 0/60 后返回首页；无可领体力时跳过。 | 2026-10-04 18:32 CST |
|
||
| 12 | 领取合作券（`claim_cooperation_ticket.py`） | 领地 | 首页 → 底部领地 → 合作模式 → 左侧合作模式 | 左上显示“可领取”时领取合作券，确认奖励和“已领完”后返回首页；已领完时跳过；不会进入保卫宠物。 | 2026-10-04 20:25 CST |
|
||
| 13 | 获取竞技积分（`claim_arena_points.py`） | 领地 | 首页 → 底部领地 → 巅峰决斗 → 左侧竞技场 → 左下积分累积区域 | 领取当前累积的竞技积分，确认“恭喜获得”弹框后返回首页；不会进入右侧巅峰决斗。 | 2026-10-04 20:56 CST |
|
||
| 14 | 收取星球矿场金币（`claim_planet_mine.py`） | 领地 | 首页 → 底部领地 → 玩法大厅 → 星球矿场 | 排行榜有红点时领取进度奖励；剩余扫荡次数非零时循环扫荡上一层，确认奖励后继续至 0 次，最后返回首页。 | 2026-10-05 03:25 CST |
|
||
| 15 | 公会互助（`claim_guild_help.py`） | 任意一级页面 | 底部公会按钮上方的握手入口 | 发现握手入口时点击互助，确认奖励弹框后关闭；入口不存在时跳过。 | 2026-10-04 23:32 CST |
|
||
| 16 | 公会砍价（`claim_guild_bargain.py`） | 公会 | 首页 → 底部公会 → 右下红珍珠祭坛 | 点击一次砍价，确认“恭喜获得”奖励弹框后退出祭坛和公会并返回首页。 | 2026-10-05 02:06 CST |
|
||
| 17 | 每日免费捐献（`claim_guild_donation.py`） | 公会 | 首页 → 底部公会 → 每日捐献 → 左侧免费 | 仅点击左侧免费捐献，确认奖励弹框后返回首页；免费次数已用时跳过，不点击右侧钻石捐献。 | 2026-10-05 02:40 CST |
|