feat: add offer reward claim workflow
This commit is contained in:
admin committed
1 parent
870ca82e8a
commit
b6bd78dc66
25 files changed
+1028
-5
No files matched your search
@@ -1,7 +1,7 @@
|
||||
---
|
||||
created_at: 2026-10-04 16:07:56 CST
|
||||
type: 永远的蔚蓝星球首页、商城、领地与公会入口、日常任务与自动化适配记录
|
||||
revision: 第5次
|
||||
revision: 第7次
|
||||
revisions:
|
||||
- time: 2026-10-04 16:07:56 CST
|
||||
version: 第1次
|
||||
@@ -23,18 +23,34 @@ revisions:
|
||||
version: 第5次
|
||||
author: GPT-6
|
||||
content: 补充公会八个入口及位置，右下角红色角色入口暂标名称待确认，记录用户确认各入口均有固定自动化流程。
|
||||
summary: 记录首页日常入口、商城六个区域、领地八个栏目及公会八个入口。商城关卡礼包与钻石暂不处理；领地和公会各入口均有用户确认的固定流程，具体步骤、消耗和完成判定待完善，公会右下角红色角色入口名称待确认。
|
||||
- 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: 实机完成特惠赏金战令一键领取及返回首页，新增脚本、奖励结果和已领取状态的识别逻辑。
|
||||
summary: 记录首页、商城、领地和公会的日常任务入口及待完善流程。入口红点表示内部有奖励可领取。特惠赏金战令一键领取已实机验证并写成脚本；开发先验证本地流程，再打包独立程序，商城关卡礼包和钻石暂不处理。
|
||||
---
|
||||
|
||||
# 首页、商城、领地与公会功能及日常任务梳理
|
||||
|
||||
## 记录范围与依据
|
||||
|
||||
本记录针对《永远的蔚蓝星球》的首页、商城、领地与公会，依据用户对高级账号的说明、两张首页截图、八张商城截图、一张领地截图及一张公会截图。当前阶段先熟悉页面和任务流程，再决定自动化方案；尚未编写程序，也未验证各活动内部操作。
|
||||
本记录针对《永远的蔚蓝星球》的首页、商城、领地与公会，依据用户对高级账号的说明、两张首页截图、八张商城截图、一张领地截图及一张公会截图。当前已开始本地自动化原型开发；各活动内部流程继续逐项补充和实机验证。
|
||||
|
||||
主界面截图显示账号等级 95，当前关卡为“144. 寒霜之径”，底部导航包括商城、英雄、国王、领地、公会。这里描述的页面统一称为“首页”；底部“国王”是独立入口，其内部功能待后续梳理。此前低等级账号的功能锁定情况不代表当前账号。
|
||||
|
||||
下文区分三类信息：**用户确认**的规律、**截图可见**的内容，以及**待验证**的内部流程。入口带红点只能作为检查线索，目前不能直接判定为可领取奖励。
|
||||
下文区分三类信息：**用户确认**的规律、**截图可见**的内容，以及**待验证**的内部流程。
|
||||
|
||||
## 通用规则与开发顺序
|
||||
|
||||
用户确认：**当某个按钮进入的页面内有奖励可以领取时，按钮右上角会出现红点。** 红点可作为进入该页面领取奖励的依据；进入后仍需识别具体奖励按钮与领取条件，领取成功通过内部状态变化确认。红点消失可以作为观察线索，但页面内仍可能存在其他奖励，不能只凭一次点击判定整页任务完成。没有红点时是否能跳过整页，需结合具体栏目流程确认。
|
||||
|
||||
用户确定的开发顺序：**先在本地实现部分自动化流程，逐项验证后再打包成独立程序**，最终目标仍是 macOS 与 Windows。模型 Key 由用户以后在程序设置中填写。
|
||||
|
||||
第一条本地原型流程为“小金猪 → 挂机奖励 → 领取 → 返回首页”，使用局部截图模板识别，执行前校准游戏区域，提供预览、日志和停止功能。当前不执行快速扫荡，也尚未加入红点检测或模型 API。奖励到账数量、领取后弹框和双平台操作需实机验证；超时停止，不重复领取。启动方法与验证命令见项目 README。
|
||||
|
||||
## 首页
|
||||
|
||||
@@ -43,7 +59,7 @@ summary: 记录首页日常入口、商城六个区域、领地八个栏目及
|
||||
| 入口 | 出现规律（用户确认） | 功能和日常逻辑（用户确认） | 后续需要核实 |
|
||||
| --- | --- | --- | --- |
|
||||
| 金沙游记 | 季节性大活动，不定期出现；每次名称可能不同；可有两个大活动同时出现，入口都在左上角 | 进入后包含多个分活动 | 分活动清单、各任务入口、签到与领奖步骤、完成标志 |
|
||||
| 特惠 | 固定入口 | 内部有每天按固定流程领取的奖励 | 免费奖励位置、领取顺序、领取后状态、跨日重置规律 |
|
||||
| 特惠 | 固定入口 | 内部有每天按固定流程领取的奖励；当前赏金战令一键领取已实机验证 | 其他子页面、跨日重置规律及活动更换后的样式 |
|
||||
| 活动 | 固定入口 | 内部有每天按固定流程领取的奖励 | 子页面结构、领取顺序、领取后状态、跨日重置规律 |
|
||||
| 返利 | 当前左侧存在，是否固定尚未说明 | 内部功能尚未说明 | 领取条件、是否与充值相关、是否存在日常免费内容 |
|
||||
| 观影 | 不定期出现 | 出现后流程固定，按按钮操作即可 | 按钮顺序、是否涉及广告播放、等待时间、领奖和结束状态 |
|
||||
@@ -53,6 +69,22 @@ summary: 记录首页日常入口、商城六个区域、领地八个栏目及
|
||||
|
||||
截图中左侧入口为纵向排列，较下方按钮部分受折叠区域影响。后续需要确认列表的展开、收起或滚动方式，不能假定所有入口始终同时可见或保持同一位置。
|
||||
|
||||
### 特惠战令一键领取（已实机验证）
|
||||
|
||||
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 实机验证。跨日刷新、活动更换和不同尺寸下的模板适配后续完善。
|
||||
|
||||
### 右侧与右上方入口
|
||||
|
||||
| 区域 | 入口 | 出现规律与用途 | 当前记录状态 |
|
||||
|
||||
Reference in new issue
Block a user