254 lines
21 KiB
Markdown
254 lines
21 KiB
Markdown
---
|
|
created_at: 2026-10-04 16:07:56 CST
|
|
type: 永远的蔚蓝星球首页、商城、领地与公会入口、日常任务与自动化适配记录
|
|
revision: 第8次
|
|
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: 补充狂鼠之家一键收矿与优先罗盘雇佣的实机验证流程、脚本、无可收矿分支和测试状态。
|
|
summary: 记录首页、商城、领地和公会的日常任务入口及待完善流程。入口红点表示内部有奖励可领取。特惠赏金战令领取、狂鼠之家收矿与优先罗盘雇佣均已实机验证并写成脚本；开发先验证本地流程，再打包独立程序，商城关卡礼包和钻石暂不处理。
|
|
---
|
|
|
|
# 首页、商城、领地与公会功能及日常任务梳理
|
|
|
|
## 记录范围与依据
|
|
|
|
本记录针对《永远的蔚蓝星球》的首页、商城、领地与公会，依据用户对高级账号的说明、两张首页截图、八张商城截图、一张领地截图及一张公会截图。当前已开始本地自动化原型开发；各活动内部流程继续逐项补充和实机验证。
|
|
|
|
主界面截图显示账号等级 95，当前关卡为“144. 寒霜之径”，底部导航包括商城、英雄、国王、领地、公会。这里描述的页面统一称为“首页”；底部“国王”是独立入口，其内部功能待后续梳理。此前低等级账号的功能锁定情况不代表当前账号。
|
|
|
|
下文区分三类信息：**用户确认**的规律、**截图可见**的内容，以及**待验证**的内部流程。
|
|
|
|
## 通用规则与开发顺序
|
|
|
|
用户确认：**当某个按钮进入的页面内有奖励可以领取时，按钮右上角会出现红点。** 红点可作为进入该页面领取奖励的依据；进入后仍需识别具体奖励按钮与领取条件，领取成功通过内部状态变化确认。红点消失可以作为观察线索，但页面内仍可能存在其他奖励，不能只凭一次点击判定整页任务完成。没有红点时是否能跳过整页，需结合具体栏目流程确认。
|
|
|
|
用户确定的开发顺序：**先在本地实现部分自动化流程，逐项验证后再打包成独立程序**，最终目标仍是 macOS 与 Windows。模型 Key 由用户以后在程序设置中填写。
|
|
|
|
第一条本地原型流程为“小金猪 → 挂机奖励 → 领取 → 返回首页”，使用局部截图模板识别，执行前校准游戏区域，提供预览、日志和停止功能。当前不执行快速扫荡，也尚未加入红点检测或模型 API。奖励到账数量、领取后弹框和双平台操作需实机验证；超时停止，不重复领取。启动方法与验证命令见项目 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 实机验证。跨日刷新、活动更换和不同尺寸下的模板适配后续完善。
|
|
|
|
### 右侧与右上方入口
|
|
|
|
| 区域 | 入口 | 出现规律与用途 | 当前记录状态 |
|
|
| --- | --- | --- | --- |
|
|
| 右侧 | 任务 | 固定入口 | 任务列表、跳转路径、完成条件和领奖逻辑待查看 |
|
|
| 右侧 | 好友 | 固定入口 | 是否包含每日互动或免费奖励待查看 |
|
|
| 右侧 | 邮件 | 固定入口 | 邮件读取、奖励领取及已领取状态待查看 |
|
|
| 右侧 | 英雄集结 | 不定期出现的大活动，与金沙游记属于类似类型 | 当前截图有该入口；内部结构及分活动待查看 |
|
|
| 右上方 | 小游戏、问题反馈、游戏圈、客服 | 用户明确暂时不用处理 | 暂不纳入本轮任务梳理 |
|
|
|
|
### 中间区域：小金猪与挂机奖励
|
|
|
|
用户确认：点击小金猪会打开奖励弹框，里面可以领取奖励。
|
|
|
|
截图确认弹框标题为“挂机奖励”，显示当前关卡、每小时产出、挂机时间、奖励列表和操作按钮。截图中的按钮实际名称为“快速扫荡”（用户描述为“快速扫描”）和“领取”。
|
|
|
|
| 操作 | 截图与用户说明支持的信息 | 尚需验证的信息 |
|
|
| --- | --- | --- |
|
|
| 点击小金猪 | 打开挂机奖励弹框 | 不同窗口大小下的识别方式 |
|
|
| 查看挂机奖励 | 当前截图提示“已达到最长时间”，最大挂机 12 小时 | 未满 12 小时时的显示、领取后的计时变化 |
|
|
| 快速扫荡 | 按钮标注消耗 10 体力 | 每日次数、后续次数的消耗、确认弹框、奖励与完成状态 |
|
|
| 领取 | 可领取挂机奖励，按钮未显示消耗 | 实际领取结果、是否有二次确认、领取成功标志 |
|
|
| 点击空白处关闭 | 截图底部明确显示该提示 | 关闭后是否稳定回到首页 |
|
|
|
|
“快速扫荡”和“领取”应作为两个独立操作记录。前者有明确的体力消耗，后续自动化需要可配置是否执行及次数；后者仍需实际走查确认成功判定。
|
|
|
|
建议走查路径：**首页 → 小金猪 → 挂机奖励 → 查看领取条件 → 执行指定操作 → 确认奖励结果 → 返回首页**。目前仅确认入口和弹框，不代表已完成领取验证。
|
|
|
|
### 主界面其他可见内容
|
|
|
|
截图还显示关卡列表入口、关卡挑战按钮、宝箱和队伍展示。“开始挑战”标注消耗 10 体力。这些内容尚未由用户展开说明，后续再梳理其是否关联日常任务。
|
|
|
|
本记录不以进入下一关或消耗体力为探索前提。
|
|
|
|
## 商城页面
|
|
|
|
### 入口与区域顺序
|
|
|
|
用户确认：从底部“商城”按钮进入，页面包含日常签到、打卡相关内容。根据用户说明及连续截图，页面内容纵向排列，从上到下依次为：**英雄招募 → 图腾寻宝 → 关卡礼包 → 每日商店 → 钻石 → 金币**。其中“钻石”使用截图中的正式名称（用户描述为“砖石”）。
|
|
|
|
商城打开后，截图中的底部左侧按钮显示为“返回”。具体滚动距离、返回后的页面状态和各区域定位方式待后续走查。
|
|
|
|
| 顺序 | 区域 | 截图可见内容 | 本阶段范围 |
|
|
| --- | --- | --- | --- |
|
|
| 1 | 英雄招募 | 英雄兑换、快速招募选项、插鼓招募、星愿招募；下方多个限时 UP 神灯许愿卡片，带倒计时与任务入口 | 保留为后续日常任务适配对象，具体操作与自动化方式待定 |
|
|
| 2 | 图腾寻宝 | 蓝色与橙色两类宝箱；每类有“寻宝1次”“寻宝10次”、概率入口和保底次数提示 | 保留为后续日常任务适配对象，具体操作与自动化方式待定 |
|
|
| 3 | 关卡礼包 | 关卡礼包卡片，显示奖励、限购次数与价格；截图示例为第40关礼包 | 用户明确暂不处理 |
|
|
| 4 | 每日商店 | 商品网格，显示商品名称、数量、金币或钻石价格、“已售罄”状态；底部有刷新倒计时和付费刷新按钮 | 保留为后续日常任务适配对象，具体购买或领取规则待定 |
|
|
| 5 | 钻石 | 多档人民币充值商品，带钻石数量和赠送标记 | 用户明确暂不处理 |
|
|
| 6 | 金币 | 一袋金币、一箱金币、一车金币；有已售罄状态及钻石兑换价格 | 保留为后续日常任务适配对象，具体操作与自动化方式待定 |
|
|
|
|
### 截图支持的状态与待确认事项
|
|
|
|
- **英雄招募**：截图有招募资源数量与单次或多次所需数量显示；限时 UP 卡片不止一个。后续需明确日常要执行哪种招募、次数、资源限制，以及卡片中的“任务”是否有独立奖励。
|
|
- **图腾寻宝**：两类宝箱的资源图标和保底提示不同。后续需明确是否执行寻宝、选择哪类宝箱、单次或十次及每日执行条件。
|
|
- **每日商店**：截图可见招募券、游侠碎片、骑士碎片、靴子锻造书、洗炼石、随机职业经验。部分商品已售罄；刷新按钮标注消耗 600 金币。后续需明确每天处理哪些商品，以及是否允许手动刷新。
|
|
- **金币**：截图中的“一袋金币”显示 500 金币且已售罄，不能据此认定它原本免费；“一箱金币”显示 10000 金币、价格 450 钻石，“一车金币”显示 30000 金币、价格 1200 钻石。具体日常目标与消耗规则后续由用户说明。
|
|
|
|
以上数值仅为本次截图示例，不作为长期固定配置。“已售罄”可以作为后续状态识别线索，但具体每日重置与完成判定尚未验证。
|
|
|
|
### 本轮结论
|
|
|
|
本轮仅补充商城结构和处理范围。**关卡礼包、钻石暂不处理；英雄招募、图腾寻宝、每日商店、金币如何自动化，后续再具体确定。** 页面归入日常打卡范围不代表其中所有按钮都需要执行，招募、寻宝、购买、兑换和刷新各自的规则仍待确认。
|
|
|
|
## 领地页面
|
|
|
|
### 入口与栏目
|
|
|
|
从底部“领地”按钮进入。截图显示领地为地图式布局，各栏目通过场景中的建筑或标签进入；打开后底部原“领地”位置显示“返回”。用户确认：以下八个栏目**每个都有固定的自动化流程**，本轮先记录入口，详细流程后续完善。
|
|
|
|
| 栏目 | 截图中的大致位置 | 自动化流程状态 |
|
|
| --- | --- | --- |
|
|
| 狂鼠之家 | 左侧中下部，矿洞建筑 | 一键收矿与优先罗盘一键雇佣已实机验证并有脚本；其他内部功能待补充 |
|
|
| 玩法大厅 | 下方偏左，带喇叭的建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 图鉴 | 下方偏右，书本建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 食堂 | 中部，带食物的建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 排行榜 | 右侧中部，石制台座区域 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 巅峰决斗 | 左上部，旗帜建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 合作模式 | 上方中部，紫色传送门区域 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 城墙 | 右上部，城门建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
|
|
位置仅描述本次截图，不作为固定点击坐标。各栏目排列为地图布局，上表顺序沿用用户的说明，不代表执行顺序。
|
|
|
|
### 当前可见信息与待完善内容
|
|
|
|
截图中的巅峰决斗入口带“拥有”数量及决斗倒计时，合作模式入口带两种资源的“拥有”数量。这些是当前页面状态，资源含义、参与条件及重置规律尚未确认。
|
|
|
|
后续逐栏目补充日常目标、进入与返回路径、操作顺序、执行次数、奖励领取、资源消耗，以及已完成、条件不足等状态的识别方式。目前尚未确认任一栏目的内部按钮和完成标志，也未据此确定脚本或 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` 只检查首页和执行计划，不点击游戏内容。
|
|
|
|
## 公会页面
|
|
|
|
### 入口与栏目
|
|
|
|
从底部“公会”按钮进入。截图显示公会采用地图式布局，各入口分布在场景中的建筑或交互对象上；进入后底部原“公会”位置显示“返回”。用户确认：以下八个入口**均有固定的自动化流程**，本轮先记录栏目与位置，内部流程后续完善。
|
|
|
|
| 栏目或入口 | 截图中的大致位置 | 自动化流程状态 |
|
|
| --- | --- | --- |
|
|
| 公会商城 | 左侧中下部，带蓝色钻石标志的建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 远征大厅 | 下方偏左，紫色传送门区域 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 公会任务 | 左侧中部，卷轴建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 公会祝福 | 中部，蓝色球体建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 每日捐献 | 右侧中部，发光的祭坛区域 | 用户确认有固定流程，捐献方式、次数和消耗待补充 |
|
|
| 成员大厅 | 右上部，高塔建筑 | 用户确认有固定流程，具体步骤待补充 |
|
|
| 公会 Boss | 左上部，巨龙区域；截图标签为“公会Boss” | 用户确认有固定流程，参与条件、次数及奖励步骤待补充 |
|
|
| 右下角红色角色入口（名称待确认） | 右下部，红色角色与紫色台座，附近显示倒计时和对话气泡 | 用户确认有固定流程，正式名称、功能和具体步骤待补充 |
|
|
|
|
位置仅描述本次截图，不作为固定点击坐标。最后一项指场景内的红色角色入口，不是底部红色“返回”按钮；截图未显示该入口的明确栏目名称，暂不推断其名称或玩法。
|
|
|
|
### 当前可见信息与待完善内容
|
|
|
|
截图顶部显示公会等级、名称、排名以及“排行”入口；右侧另有聊天气泡按钮。这些属于截图可见信息，用户本轮未将其列入上述固定流程，具体用途和是否需要处理待后续说明。
|
|
|
|
后续逐入口补充日常目标、进入与返回路径、操作顺序、执行次数、消耗与奖励，以及已完成、条件不足等状态的识别方式。右下角红色角色附近的倒计时仅记录为当前界面状态，其含义和出现规律待确认。
|
|
|
|
## 自动化方案的初步判断
|
|
|
|
以下为设计候选，需内部流程走查后确认。
|
|
|
|
| 功能类型 | 候选实现方式 | 原因 |
|
|
| --- | --- | --- |
|
|
| 特惠、活动中的固定每日领奖 | 脚本组织流程，图像或文字识别确认每步状态 | 入口固定、步骤重复，可复用明确的操作和完成判定 |
|
|
| 观影、寻宝 | 先识别活动是否出现，再执行固定流程 | 活动不一定存在，但用户确认出现后的流程稳定 |
|
|
| 试炼、三类冲刺 | 共用流程，并为不同页面设置识别规则；必要时由 AI 辅助判断 | 基本逻辑一致，页面外观或活动条件会变化 |
|
|
| 金沙游记等左上角大活动、英雄集结 | 先识别活动名称与分活动，再逐项评估 | 活动名称、数量和内部结构可能变化，当前缺少完整流程 |
|
|
| 小金猪挂机奖励 | 固定流程与结果识别；快速扫荡另设资源配置 | 入口和弹框清晰，但领取与体力消耗操作需要区分 |
|
|
| 任务、好友、邮件、返利 | 暂不确定 | 尚未查看内部内容和日常规则 |
|
|
| 商城：英雄招募、图腾寻宝、每日商店、金币 | 后续确定 | 已记录区域结构，日常目标、执行次数、资源消耗与完成判定尚未明确 |
|
|
| 商城：关卡礼包、钻石 | 暂不处理 | 用户明确排除 |
|
|
| 领地：狂鼠之家 | 已验证脚本：一键收矿、等待 10 秒、按白银/黄金/彩虹顺序一键雇佣、返回首页 | 当前仅覆盖该日常流程；其他内部功能、重置规律和 Windows 适配待验证 |
|
|
| 领地：玩法大厅、图鉴、食堂、排行榜、巅峰决斗、合作模式、城墙 | 待完善固定流程后确定 | 用户确认各栏目均有固定自动化流程，具体步骤、执行条件、消耗和完成判定尚未补充 |
|
|
| 公会：公会商城、远征大厅、公会任务、公会祝福、每日捐献、成员大厅、公会 Boss、右下角红色角色入口 | 待完善固定流程后确定 | 用户确认八个入口均有固定自动化流程；右下角入口名称及各流程的具体步骤、消耗和完成判定待补充 |
|
|
|
|
初步方向是让脚本执行已验证的重复步骤，让 AI 辅助识别变化页面或异常。是否每次调用 AI、调用到哪一步，待明确任务完成标志与变化范围后再决定。
|
|
|
|
## 后续逐页记录模板
|
|
|
|
每个入口继续按以下字段补充：
|
|
|
|
1. **入口与出现条件**：位置、名称变化、解锁条件、是否限时。
|
|
2. **内部页面**：标签、子活动、按钮、返回和关闭方式。
|
|
3. **日常目标**：签到、领奖或完成任务的具体条件。
|
|
4. **操作步骤**：按顺序记录点击、等待及分支。
|
|
5. **完成标志**：已领取、已签到、按钮变灰或奖励结果等可观察证据。
|
|
6. **消耗与次数**：体力、钻石、道具、广告、次数上限及每日重置。
|
|
7. **异常情况**：活动缺席、已完成、条件不足、加载延迟或弹窗。
|
|
8. **适配方式**：固定脚本、识别规则或 AI 辅助及其适用范围。
|
|
|
|
下一阶段继续熟悉各入口内部流程和其他底部页面，补齐上述字段后再确定第一批自动化任务。
|