604 lines
60 KiB
Markdown
604 lines
60 KiB
Markdown
---
|
||
created_at: 2026-10-05 17:02:11 CST
|
||
type: 永远的蔚蓝星球页面地图、进入返回路径、识别规则与任务调度边界
|
||
revision: 第40次
|
||
revisions:
|
||
- time: 2026-10-05 17:02:11 CST
|
||
version: 第1次
|
||
author: GPT-6
|
||
content: 核对六个主要页面，整理现有工作流和未验证入口，建立程序可读地图、只读识别与候选路线规划。
|
||
- time: 2026-10-05 17:19:57 CST
|
||
version: 第2次
|
||
author: GPT-6
|
||
content: 根据用户确认补充活动四个底部页签、礼包三个内部页签、月卡会员可见条件，以及两项待实现的每日免费领取任务。
|
||
- time: 2026-10-05 17:24:00 CST
|
||
version: 第3次
|
||
author: GPT-6
|
||
content: 确认每日特惠第二次免费领取的免广告卡与观看广告分支；无卡时是否自动观看广告待用户决定。
|
||
- time: 2026-10-05 17:27:23 CST
|
||
version: 第4次
|
||
author: GPT-6
|
||
content: 用户确认无免广告卡时自动看完广告领取奖励，并将该分支记录为适用于多个任务的共用规则，运行流程尚未实现。
|
||
- time: 2026-10-05 17:29:01 CST
|
||
version: 第5次
|
||
author: GPT-6
|
||
content: 用户确认超值礼包的周礼包没有免费领取项目，免费领奖流程跳过周礼包。
|
||
- time: 2026-10-05 17:32:28 CST
|
||
version: 第6次
|
||
author: GPT-6
|
||
content: 确认月礼包没有免费项目，补充独立树形总览文档链接，并改为合并询问同一页面的相关问题。
|
||
- time: 2026-10-05 17:40:14 CST
|
||
version: 第7次
|
||
author: GPT-6
|
||
content: 确认日礼包两个免费项目的直接领取与广告分支、充值奖励红点领取及低优先级，补充每日充值6元和25元档及活动左下返回路径。
|
||
- time: 2026-10-05 17:47:39 CST
|
||
version: 第8次
|
||
author: GPT-6
|
||
content: 确认返利不定期出现且暂不处理，内部奖励、条件和返回问题暂缓；特惠页签尚未列全，优先补齐。
|
||
- time: 2026-10-05 18:00:38 CST
|
||
version: 第9次
|
||
author: GPT-6
|
||
content: 补齐特惠六个底部页签和各自领奖条件，增加四个页签节点及五项待实现任务，记录基金内部页签待确认与新页签返回路径待采集。
|
||
- time: 2026-10-05 18:09:35 CST
|
||
version: 第10次
|
||
author: GPT-6
|
||
content: 新增基金1、2、3三个内部页签，记录动态可见范围与未确认边界，确认月卡每天各领一次及价格按钮，两类战令以高亮和对号判断领奖状态。
|
||
- time: 2026-10-05 18:19:12 CST
|
||
version: 第11次
|
||
author: GPT-6
|
||
content: 确认周卡签到不要求购买且领完显示已领取，基金以小锁头、对号和灰色蒙版区分跳过状态；特惠六页签统一左下箭头返回，新增返回关系标为用户确认但未实机验证。
|
||
- time: 2026-10-05 18:24:13 CST
|
||
version: 第12次
|
||
author: GPT-6
|
||
content: 确认月卡领完的续费18元与续费30元按钮状态，两类战令不支持一键领取、采用上下滚动逐项领取，保留月卡可领文案与列表识别待采集。
|
||
- time: 2026-10-05 18:30:24 CST
|
||
version: 第13次
|
||
author: GPT-6
|
||
content: 记录观影单页每日5次、中间按钮领奖及免广告卡分支，新增右上关闭返回关系与延后实现任务；活动当前未出现，等再次出现后完善。
|
||
- time: 2026-10-05 18:36:51 CST
|
||
version: 第14次
|
||
author: GPT-6
|
||
content: 新增试炼三个页签及底部箭头返回关系，记录每日登录游戏1次奖励每日可领、其他奖励完成任务后领取，新增试炼任务奖励待实现任务。
|
||
- time: 2026-10-05 18:41:01 CST
|
||
version: 第15次
|
||
author: GPT-6
|
||
content: 根据最新范围取消试炼任务自动化并暂缓另两个页签，记录列表无需滚动；新增祈愿入口、相对位置及待确认范围。
|
||
- time: 2026-10-05 18:46:22 CST
|
||
version: 第16次
|
||
author: GPT-6
|
||
content: 新增祈愿三个页签和左下箭头返回关系，记录任务右侧领取及每日登录奖励、礼包顶部免费补给，新增两项待实现任务，免费补给刷新与祈愿操作仍待确认。
|
||
- time: 2026-10-05 18:52:33 CST
|
||
version: 第17次
|
||
author: GPT-6
|
||
content: 确认祈愿免费补给每日一次不看广告，任务领完已完成并自动移到列表底部、需要滚动；祈愿页签本身排除，记录重排后重新识别的执行要求。
|
||
- time: 2026-10-05 19:06:16 CST
|
||
version: 第18次
|
||
author: GPT-6
|
||
content: 新增三类冲刺、晶矿与招募页签及星珀商城节点，记录7天轮换、每日免费礼包和任务状态；增加五项待实现任务，招募礼包入口和星珀商城返回待确认。
|
||
- time: 2026-10-05 19:16:55 CST
|
||
version: 第19次
|
||
author: GPT-6
|
||
content: 确认招募冲刺四个底部页签及礼包入口，排除目标和排名自动化；星珀商城改为弹框，周一刷新整周一次，右上X关闭返回冲刺并保留上下文。
|
||
- time: 2026-10-05 19:20:31 CST
|
||
version: 第20次
|
||
author: GPT-6
|
||
content: 确认冲刺首项礼包每日一次不看广告、星珀金币领完显示已售罄，记录任务领后重排仍待确认与领取后重新识别要求。
|
||
- time: 2026-10-05 19:30:33 CST
|
||
version: 第21次
|
||
author: GPT-6
|
||
content: 新增寻宝三个页签及左下返回，更新等级开放后连续9至10天换期；记录任务领后重排、免费礼包每期一次及已售罄，新增两项待实现任务。
|
||
- time: 2026-10-05 19:33:35 CST
|
||
version: 第22次
|
||
author: GPT-6
|
||
content: 标记宝藏兑换不需要自动处理，冒险免费礼包无需广告、每期直接领取一次，清除已确认的范围和广告问题。
|
||
- time: 2026-10-05 19:39:44 CST
|
||
version: 第23次
|
||
author: GPT-6
|
||
content: 好友列表改为弹框，新增领取赠礼子弹框及两层关闭关系，记录每日一键赠送和领取赠礼红点条件，增加两项待实现任务。
|
||
- time: 2026-10-05 19:47:09 CST
|
||
version: 第24次
|
||
author: GPT-6
|
||
content: 确认好友赠送和领取按钮操作后不变且仍可点击，记录空赠礼提示及待实现的每日限次和防重复领取规则。
|
||
- time: 2026-10-05 20:09:15 CST
|
||
version: 第25次
|
||
author: GPT-6
|
||
content: 补齐金沙游记六个分活动、两个签到页签及返回关系，确认驿站密使名称、来信跳过已领取和翻牌显示状态，记录三项待实现任务与共用流程，新增关系未实机验证。
|
||
- time: 2026-10-05 20:17:23 CST
|
||
version: 第26次
|
||
author: GPT-6
|
||
content: 补充流沙赠礼已领取完成标志，记录法老遗珍当前账号有免广告卡及无卡界面延期确认，节点与关系数量不变。
|
||
- time: 2026-10-05 20:28:58 CST
|
||
version: 第27次
|
||
author: GPT-6
|
||
content: 英雄集结新增四个节点及六条关系，确认岁岁平安14天、寻珍金币为活动抽奖次数，新增两项待实现任务，记录签到卡片定位、跳过动画和剩余次数参与规则。
|
||
- time: 2026-10-05 21:12:15 CST
|
||
version: 第28次
|
||
author: GPT-6
|
||
content: 商城新增图腾免费、商店免费券和金币免费三项待实现任务及一项规则未完善的金币购券候选；确认次数、广告、领完标志和刷新状态，栏目节点数量不变。
|
||
- time: 2026-10-05 21:18:49 CST
|
||
version: 第29次
|
||
author: GPT-6
|
||
content: 领地图鉴与排行榜标记为用户暂缓且不参与自动化，保留节点和入口关系，已有星球矿场排行榜流程保持原范围。
|
||
- time: 2026-10-05 21:27:01 CST
|
||
version: 第30次
|
||
author: GPT-6
|
||
content: 新增城墙两个页签、四条页签关系、三条返回领地关系与两项待实现任务，确认免费广告分支、额外次数待确认及≥10批量打造规则，打造只响应独立命令。
|
||
- time: 2026-10-05 21:57:28 CST
|
||
version: 第31次
|
||
author: GPT-6
|
||
content: 新增领地11个节点20条关系8项任务并启用排行榜，确认宠物券每周一次、两商店各自货币够价才买及只买红色3200碎片，额度周边界与返回待确认。
|
||
- time: 2026-10-05 22:05:01 CST
|
||
version: 第32次
|
||
author: GPT-6
|
||
content: 新增六条合作及宠物返回关系；按最新说明改宠物券每日0点刷新、商店免费金币每周一0点刷新及红色碎片按余额买完可售数量，模板与执行待完善。
|
||
- time: 2026-10-05 22:14:33 CST
|
||
version: 第33次
|
||
author: GPT-6
|
||
content: 巅峰商店新增节点、进入与两条返回关系及购买任务，确认顶部专用货币、右上X关闭和主页左下回领地，按三项优先级最大数量购买。
|
||
- time: 2026-10-05 22:31:15 CST
|
||
version: 第34次
|
||
author: GPT-6
|
||
content: 补充公会商城双页签购买优先级、公会任务列表重排和进度宝箱领奖，以及右上关闭回公会；确认顶部专用货币、罗盘每日2/10限额、合作券周一刷新整周最多7个及龙晶龙血按优先级买完。
|
||
- time: 2026-10-05 22:37:57 CST
|
||
version: 第35次
|
||
author: GPT-6
|
||
content: 确认贡献商城购买顺序为合作券、黄金罗盘、白银罗盘，保留每周7个及每日2/10个限额。
|
||
- time: 2026-10-05 22:49:51 CST
|
||
version: 第36次
|
||
author: GPT-6
|
||
content: 补充远征大厅、公会对决任务领奖、公会祝福材料升级及左下返回、公会Boss财宝和已助威完成状态；迷宫寻宝暂缓。
|
||
- time: 2026-10-05 22:54:16 CST
|
||
version: 第37次
|
||
author: GPT-6
|
||
content: 用户确认成员大厅不需要自动化，保留入口，排除内部流程确认与执行。
|
||
- time: 2026-10-06 01:09:48 CST
|
||
version: 第38次
|
||
author: GPT-6
|
||
content: 同步本轮页面核实差异与识别修正，增加只读任务预览和后续公共执行器开发顺序，保留未验证状态。
|
||
- time: 2026-10-06 01:13:31 CST
|
||
version: 第39次
|
||
author: GPT-6
|
||
content: 补充领地巅峰决斗竞技场领取竞技券任务，具体流程后续确认，暂不实现或纳入默认预览。
|
||
- time: 2026-10-06 01:14:17 CST
|
||
version: 第40次
|
||
author: GPT-6
|
||
content: 补充战令一键领取后可能出现幸运星，需额外点击领取，分支标记后续完善，未修改执行脚本。
|
||
summary: 地图134个节点、239条关系、17个已有任务、49个待实现或延期任务；78个节点有识别模板。本轮修正冲刺卡片、弹框返回和共用商店来源，加入只读分组预览；领奖、广告和购买结果尚待实测。 新增领取竞技券，流程待确认。 战令幸运星额外点击领取分支待完善。
|
||
---
|
||
|
||
# 页面地图与导航规则
|
||
|
||
快速查看页面层级：[树形页面地图](261005_1732-树形页面地图.md)。该图覆盖本地图全部节点，并区分已有流程、用户确认结构和待确认入口。
|
||
|
||
这份地图由现有脚本、功能梳理文档、用户给出的入口说明和本次游戏画面整理。**六个主要页面已本次实机核对；其余页面不能据此声称全部重新验证。** 当前地图记录134个节点，其中78个有识别规则，其余56个为滚动栏目、用户确认结构或待核实状态；本轮52个节点附布局记录。进入与返回关系239条，64条保留原有验证状态，另175条为结构记录或待验证路径。本轮导航观察另存 audit_verification，不等于已接入自动导航执行。
|
||
|
||
本次只查看页面和验证导航，没有运行领取、购买、强化、抽取、雇佣或战斗任务。最后已确认回到首页。
|
||
|
||
程序配置为 [page_map.json](../workflows/page_map.json)，只读识别和路线查询入口为 [inspect_page.py](../inspect_page.py)，原始任务说明见 [首页功能与日常任务梳理](261004_1607-首页功能与日常任务梳理.md)。
|
||
|
||
## 如何使用
|
||
|
||
在项目目录运行下列命令。第一条只截取当前游戏画面并识别，不激活窗口、不点击、不切换页面；游戏需要完整可见，截图权限沿用现有项目权限。截图导入必须只有游戏内容，不含标题栏和桌面。
|
||
|
||
```bash
|
||
.venv/bin/python inspect_page.py
|
||
.venv/bin/python inspect_page.py --image local/page-map/current.png
|
||
.venv/bin/python inspect_page.py --from-page territory --to-page recruit.lamp
|
||
```
|
||
|
||
识别结果为 `identified`（唯一页面）、`unknown`（证据不足）或 `ambiguous`（多个候选）。`unknown` 只表示无法识别，不能直接解释为游戏正在加载。遮挡、通知、跨屏、窗口比例改变和新活动外观都可能产生未知结果。
|
||
|
||
路线查询只输出候选动作与条件，**不会执行鼠标动作**。例如领地到神灯召唤为 `territory → home → shop → recruit.lamp`。末步需要运行时滚动定位限时 UP 的任务按钮，并确认红点；没有卡片或没有红点时应报告跳过，而不能强制进入。
|
||
|
||
## 六个主要页面
|
||
|
||
以下进入与返回已本次实机核对。底部各位置使用当前窗口布局，后续执行仍须重新读取窗口、识别页面再操作。
|
||
|
||
| 页面 ID | 页面 | 从首页进入 | 回到首页 | 当前识别标识 |
|
||
| --- | --- | --- | --- | --- |
|
||
| home | 首页 | 根页面 | 已在首页 | 开始挑战区域的固定模板 |
|
||
| shop | 商城 | 底部第 1 个入口 | 底部第 1 个位置“返回” | 店面与列表之间的固定分隔装饰；不使用资源数字或动画 |
|
||
| heroes | 英雄 | 底部第 2 个入口 | 底部第 2 个位置“返回” | 英雄总览固定伤害说明文字 |
|
||
| king | 国王 | 底部第 3 个入口 | 底部第 3 个位置“返回” | 当前装备页签与分解文字；其他页签待采集 |
|
||
| territory | 领地 | 底部第 4 个入口 | 底部第 4 个位置“返回” | 狂鼠之家固定文字 |
|
||
| guild | 公会 | 底部第 5 个入口 | 底部第 5 个位置“返回” | 公会商城固定文字，避开顶部通知区域 |
|
||
|
||
商城会保留上次滚动位置，英雄页与国王页也存在内部页签或队伍选择。一级页面识别成功不代表它内部已经停在任务所需位置。
|
||
|
||
## 子页面与弹层
|
||
|
||
这些页面的进入与返回从现有流程和此前实机记录整理。本次没有逐项重测。识别优先使用页面身份标识，而不是依赖“当前是否可领取”：同一个页面的可领取与已领取应属于状态差异。
|
||
|
||
| 页面 ID | 页面／弹层 | 所属页面 | 已记录进入方式 | 已记录返回方式 |
|
||
| --- | --- | --- | --- | --- |
|
||
| offer.monthcard | 特惠／超值月卡 | 首页 | 特惠（可能默认月卡） | 返回 → 首页 |
|
||
| offer.battlepass | 特惠／赏金战令 | 首页 | 特惠（可能默认战令）；底部战令 | 返回 → 首页 |
|
||
| idle | 挂机奖励 | 首页 | 小金猪 | 空白处关闭 → 首页 |
|
||
| tasks.daily | 日常任务 | 首页 | 右侧任务（默认页需识别）；日常页签 | 关闭任务 → 首页 |
|
||
| tasks.weekly | 周常任务 | 首页 | 右侧任务（默认页需识别）；周常页签 | 关闭任务 → 首页 |
|
||
| mail | 邮件 | 首页 | 右侧邮件 | 关闭邮件 → 首页 |
|
||
| rally | 英雄集结 | 首页 | 右侧英雄集结 | 关闭活动 → 首页 |
|
||
| rally.sword | 剑来献礼 | 英雄集结 | 剑来献礼 | 返回 → 英雄集结 |
|
||
| rally.lizhu | 骊珠画卷 | 英雄集结 | 骊珠画卷 | 返回 → 英雄集结 |
|
||
| rally.lizhu.tasks | 骊珠画卷任务 | 骊珠画卷 | 底部任务 | 关闭任务 → 骊珠画卷 |
|
||
| recruit.lamp | 神灯召唤 | 商城 | 滚动定位限时 UP 卡片，点击带红点的任务按钮 | 关闭神灯召唤 → 商城 |
|
||
| rat | 狂鼠之家 | 领地 | 狂鼠之家 | 返回 → 领地 |
|
||
| rat.friends | 狂鼠之家好友列表 | 狂鼠之家 | 底部好友 | 关闭好友列表 → 狂鼠之家 |
|
||
| rat.friend | 好友矿场 | 狂鼠之家好友列表 | 定位首位喂矿鼠按钮 | 左下回家 → 狂鼠之家 |
|
||
| canteen | 食堂 | 领地 | 食堂 | 关闭食堂 → 领地 |
|
||
| coop.selection | 合作模式选择 | 领地 | 合作模式入口 | 返回关系尚未独立采集 |
|
||
| coop | 合作模式 | 合作模式选择 | 左侧合作模式 | 左下返回 → 领地（现有工作流） |
|
||
| arena.selection | 巅峰决斗模式选择 | 领地 | 巅峰决斗入口 | 返回关系尚未独立采集 |
|
||
| arena | 竞技场 | 巅峰决斗模式选择 | 左侧竞技场 | 返回关系尚未独立采集 |
|
||
| play_hall | 玩法大厅 | 领地 | 玩法大厅；返回 | 关闭玩法大厅 → 领地 |
|
||
| planet | 星球矿场 | 玩法大厅 | 星球矿场；返回 | 返回 → 玩法大厅 |
|
||
| planet.rank | 星球矿场排行榜 | 星球矿场 | 右上排行榜；关闭 | 返回 → 星球矿场 |
|
||
| planet.progress | 星球矿场进度奖励 | 星球矿场排行榜 | 进度奖励 | 关闭 → 星球矿场排行榜 |
|
||
| planet.sweep | 星球矿场扫荡弹框 | 星球矿场 | 打开扫荡弹框 | 返回关系尚未独立采集 |
|
||
| guild.altar | 红珍珠祭坛 | 公会 | 右下红珍珠祭坛 | 返回 → 公会 |
|
||
| guild.donation | 每日捐献弹框 | 公会 | 每日捐献 | 关闭捐献 → 公会 |
|
||
| rat.hire | 一键雇佣弹框 | 狂鼠之家 | 打开一键雇佣 | 关闭雇佣 → 狂鼠之家 |
|
||
|
||
以下情形需要保留额外状态：
|
||
|
||
- 特惠六个底部页签已由用户确认。已有流程可能默认打开月卡或战令，当前其他默认状态待采集；点击入口后必须重新识别。
|
||
- 日常／周常任务的默认面板可能不同，导航不能假定固定默认页。
|
||
- 神灯召唤是一类共用弹层；不同卡片必须保留活动实例，任务／礼包为页签状态。
|
||
- 星球矿场排行榜与领地排行榜是不同页面，不能共用父页面和返回动作。
|
||
- 共同“恭喜获得”装饰只能识别奖励弹层，不能推断奖励来自哪个任务。返回时需使用当前任务历史。
|
||
- 一键雇佣和扫荡弹框仅可由对应任务按执行条件打开，不用于普通导航或探索。
|
||
- 合作模式选择、巅峰决斗模式选择的独立关闭路径尚未记录；不能把进入另一种玩法作为返回办法。
|
||
- 砍价页面目前用砍价按钮识别，按钮消失后的页面身份识别仍需补充。骊珠每日任务规则也需进一步验证页签模板的独特性。
|
||
|
||
## 商城栏目
|
||
|
||
商城内的英雄招募、图腾寻宝、关卡礼包、每日商店、钻石、金币属于同一滚动列表中的栏目。地图将其标为 `section`，避免把每一次列表滚动当成切换页面。当前神灯卡片入口依赖动态定位任务按钮及红点；商城可能保留上次滚动位置，须先定位栏目；关卡礼包和钻石仍按用户说明暂不处理。
|
||
|
||
| 栏目 ID | 用户确认的日常规则 | 完成与当前状态 |
|
||
| --- | --- | --- |
|
||
| shop.recruit | 除已有神灯任务和免费神灯外，没有新增日常领奖内容 | 沿用现有脚本 |
|
||
| shop.totem | 两张卡片每日各免费领取一次，有免广告卡直接领，否则看视频 | 对应免费按钮消失并确认领奖结果，任务待实现 |
|
||
| shop.daily | 六张卡片；首格免费招募券每日一次，无广告，领取后已售罄，600金币刷新后不再出现免费券 | 免费任务待实现；仅金币标价招募券的购买及刷新策略延期完善 |
|
||
| shop.coins | 三张卡片，只领取首张每日两次免费奖励，首次直接领，第二次有免广告卡直接领，否则看视频 | 两次领完已售罄；按本日进度处理，任务待实现 |
|
||
|
||
每日商店保留“每日商城”别名。`paid_ticket_purchase` 仅记录金币招募券的候选规则，状态为 `user_confirmed_deferred_rules_incomplete`；其他物品与钻石价格跳过。`refresh_control` 记录右下600金币刷新、多次刷新及次数用完黑色蒙版、今日刷新次数已用完提示，不表示已允许按未知预算自动刷新。首格免费券不因刷新重新出现，免费任务不包含付费刷新。
|
||
|
||
三个免费任务加入 `planned_tasks`，另加一个规则未完善的金币购券候选；共用广告执行模块及这些新任务尚未实现；栏目已截图巡视，免费与结果控件定位仍需实现。这些商品和卡片仅作栏目内部控件配置，不新增独立页面或可执行导航边。
|
||
|
||
## 首页特惠：六个页签与领奖条件
|
||
|
||
用户确认底部顺序为超值月卡、战令、特惠周卡、钻石基金、遗迹战令、宠物战令。程序以 `offer_tab_group` 记录入口与顺序；现有月卡和战令节点及路径保持原有 ID。新增页签仍标记为 `documented`；本轮已补部分识别模板，但尚未实现自动导航。
|
||
|
||
| 页面 ID | 页签 | 领取规则 |
|
||
| --- | --- | --- |
|
||
| offer.monthcard | 超值月卡 | 两项奖励每日各一次，00:00刷新，位置固定；未购买分别显示“18 元”“30 元”，领完分别显示“续费：18 元”“续费：30 元”，均跳过；可领文案待采集 |
|
||
| offer.battlepass | 战令 | 消耗一定体力产生奖励，沿用已有赏金战令一键领取流程 |
|
||
| offer.weekcard | 特惠周卡 | 无需购买即可签到；每日 00:00 刷新，点击列表“签到”，领完显示“已领取” |
|
||
| offer.diamond_fund | 钻石基金 | 内部页签随进度显示；解锁且达到关卡后点最后一列钻石。小锁头表示未解锁，对号表示已领，灰色蒙版表示未达关卡，均跳过 |
|
||
| offer.diamond_fund.tier1 | 钻石基金 1 | 未到100关显示；进度增加时保留，与其他已显示基金一起处理 |
|
||
| offer.diamond_fund.tier2 | 钻石基金 2 | 超过100关、未到200关时新增；恰好100关的边界待确认 |
|
||
| offer.diamond_fund.tier3 | 钻石基金 3 | 超过200关、未到260关时新增；恰好200关及260关以后规则待确认 |
|
||
| offer.relic_pass | 遗迹战令 | 遗迹夺宝产生奖励；无一键领取，上下滚动逐项点第一列高亮且无对号图标，有对号已领 |
|
||
| offer.pet_pass | 宠物战令 | 本轮观察到灰色一键领取，优先一键策略待用户确认；原逐项高亮图标领奖规则保留 |
|
||
|
||
基金前三个内部页签名称及范围已由用户确认；`internal_tabs` 保存动态可见范围、实际页签发现规则与未知边界。100、200关的精确边界和260关以后规则暂未确定。后续以当前实际显示的页签逐个处理，不从已知阈值推算后续基金页签。三个子节点复用基金领奖规则，不增加独立任务。可领取钻石没有对号；已领有对号，未达关卡覆盖灰色蒙版。领取需同时确认解锁、达到关卡，排除锁头、对号和灰色蒙版；不把单独“无对号”或未经确认的高亮作为可领证据。图像模板仍待实机采集。
|
||
|
||
两类战令奖励为小正方形图标，列位置固定，可滚动逐项领取。遗迹战令暂按原无一键规则；宠物战令实机发现一键领取，已记录 has_bulk_claim 为 true，优先使用策略仍待用户确认。第一列高亮且无对号时可领，已领后的对号用于验证和跳过；滚动后重新定位可见奖励项。图像模板、未达成状态、滚动边界和领取弹框仍待采集。钻石基金保留用户原称“砖石基金”；宠物战令保留规则描述中的“宠物战力”称呼供后续核对。
|
||
|
||
月卡两项奖励领完后分别显示“续费：18 元”“续费：30 元”，记录在各奖励的 `claimed_button` 及任务的 `claimed_button_texts`；未购买价格按钮与领完续费按钮均跳过。可领取时的文案用户尚未确认，`claim_button_text` 保持空值，不能直接作为可执行匹配规则。
|
||
|
||
月卡、周卡、基金、遗迹战令和宠物战令共五项待实现任务已加入 `planned_tasks`；战令沿用现有任务。月卡和基金以购买解锁为领取资格，周卡签到不要求购买；玩法参与仅记录为奖励来源。
|
||
|
||
用户确认特惠六个页签均点击左下角箭头样式返回按钮回到首页，记录在 `offer_tab_group.exit_to_home` 及各页签节点。月卡和战令保留已有验证路径，新增四个页签的返回关系从 `pending` 改为 `documented`；按钮模板、坐标及实际返回仍待采集，未加入可执行导航。
|
||
|
||
### 战令一键领取后的幸运星分支
|
||
|
||
战令一键领取后可能获得幸运星；幸运星需要再点击才能领取。此分支按用户要求后续完善，现有 claim_offer.py 尚未处理。具体出现界面、点击目标、领奖成功标志和关闭／返回流程待采集，不因一键领取按钮变灰就认定幸运星已领取。
|
||
|
||
## 首页活动：用户确认的页签与免费领取规则
|
||
|
||
入口为首页左侧“活动”。用户确认底部按顺序有以下四个页签；其中“超值礼包”内另有日、周、月三个页签。页签切换属于同一活动页面内部状态变化，以 `tab` 节点记录。
|
||
|
||
| 页面 ID | 页签 | 所属页面 | 已确认规则 |
|
||
| --- | --- | --- | --- |
|
||
| activity.pack | 超值礼包 | 活动 | 包含日礼包、周礼包、月礼包 |
|
||
| activity.daily_offer | 每日特惠 | 活动 | 有一个免费项目，每日可领取 2 次；第二次有免广告卡可直接领取，否则需观看广告 |
|
||
| activity.daily_recharge | 每日充值 | 活动 | 包含 6 元档、25 元档，两档都可能有奖励；入口有红点时进入领取，低优先级后续完善 |
|
||
| activity.daily_recharge.tier6 | 6 元档 | 每日充值 | 可能存在已达成的充值奖励；只记录领奖，具体状态待后续采集 |
|
||
| activity.daily_recharge.tier25 | 25 元档 | 每日充值 | 可能存在已达成的充值奖励；只记录领奖，具体状态待后续采集 |
|
||
| activity.cumulative_recharge | 累充豪礼 | 活动 | 有红点时进入领取已达成奖励；低优先级后续完善；名称暂按用户原称呼记录 |
|
||
| activity.pack.daily | 日礼包 | 超值礼包 | 每日领取 2 个免费项目：原说明为第一项直接、第二项广告；本轮上方免费带视频标志、下方普通免费，广告判定待确认 |
|
||
| activity.pack.weekly | 周礼包 | 超值礼包 | 用户确认没有免费领取项目；免费领奖流程跳过 |
|
||
| activity.pack.monthly | 月礼包 | 超值礼包 | 只有充值月卡会员才可见；用户确认没有免费领取项目，免费领奖流程跳过 |
|
||
|
||
地图中的 `planned_tasks` 包含活动四项、特惠五项、观影一项、祈愿两项、冲刺五项、寻宝两项、好友两项、金沙游记三项、英雄集结两项、商城四项、城墙两项、领地新增八项、巅峰商店一项及公会新增七项，另补充竞技场领取竞技券一项，共 49 项待实现或延期完善任务，未加入已实现脚本汇总。领地新增包含遗迹扫荡、排行榜进度奖励、友情商店签到购买、保卫宠物领券与商店签到购买及挑战奖励。城墙两项区分每日免费领取和独立命令打造；商城金币购券与刷新策略待完善。活动充值奖励为低优先级后续完善，不是自动充值指令；试炼任务保留在 `excluded_tasks`。
|
||
|
||
每日特惠第二次领取分支已由用户确认：有免广告卡时直接点击领取，没有时由程序自动看完广告后领取。该任务引用地图中的通用 `reward_ad_policy`，策略记录为 `watch_to_completion_then_claim`。
|
||
|
||
用户确认活动各页签均从左下“返回”回到首页。地图已记录 `home.activity → home` 的返回规则，各页签沿用活动出口；具体按钮模板和坐标仍待采集。
|
||
|
||
本轮已采集活动日礼包、每日特惠、充值6元档、累充页面标题和布局，并观察左下回首页；领取后状态、25元档奖励和广告返回尚未验证。因此这些节点标记为 `documented`，不会因为结构已确认就成为自动导航路径。
|
||
|
||
## 观影：活动再次出现后完善
|
||
|
||
用户确认观影不定期出现，一般连续签到 5 天；进入后只有一个页面，点击中间按钮，每天领取 5 次。有免广告卡直接领取，没有则自动看完广告再领取，引用 `reward_ad_policy`。点击右上角关闭按钮返回首页，返回关系标记为 `documented`，尚未采集识别模板。
|
||
|
||
当前入口未出现，`home.movie.observed_availability` 记录用户说明的可见状态及时间，作为本次记录而非永久不可见判定。`planned_tasks.movie_daily_rewards` 标为 `user_confirmed_deferred`，等观影入口再次出现后采集按钮、剩余次数、领完状态与广告返回流程，再完善自动化。每天5次的规则已确认，“一般连续5天”只记录为常见活动周期。
|
||
|
||
## 试炼：三个页签与任务奖励
|
||
|
||
用户确认当前试炼入口存在，内部按顺序为 **英雄试炼、特训、试炼任务** 三个页签。入口仍属于不定期活动，当前可见状态按用户说明及时间记录，后续执行重新确认。三个页签标记为 `documented`，内部识别模板尚未采集。
|
||
|
||
| 页面 ID | 页签 | 已确认规则 |
|
||
| --- | --- | --- |
|
||
| trial.heroes | 英雄试炼 | 页签存在，用户要求暂不处理，后续补充 |
|
||
| trial.training | 特训 | 页签存在，用户要求暂不处理，后续补充 |
|
||
| trial.tasks | 试炼任务 | 已完成任务显示“领取”，每日登录奖励每日可领；列表无需滚动，用户最新确认不需要自动化 |
|
||
|
||
用户确认点击底部箭头样式返回按钮回到首页，地图记录活动与各页签的返回关系，尚未加入自动导航。最新范围为英雄试炼和特训暂缓、试炼任务不需要自动化；`trial_task_rewards` 已从 `planned_tasks` 移到 `excluded_tasks`，页面规则保留，不继续确认它的执行细节。列表记录为 `scroll_required: false`，表示不需要滚动，不推断界面是否支持滚动。
|
||
|
||
## 祈愿：三页签、任务奖励与免费补给
|
||
|
||
用户确认祈愿位于首页左侧**试炼下方、冲刺上方**，不定期出现。`home.wish` 以相邻入口记录位置，不假定固定坐标。进入后底部左下箭头返回按钮右侧，依次为祈愿、任务、礼包三个页签；本轮已切换并观察左下返回首页，领奖后重排与结果仍待实测。
|
||
|
||
| 页面 ID | 页签 | 已确认规则 |
|
||
| --- | --- | --- |
|
||
| wish.main | 祈愿 | 用户确认本页不需要自动化，保留结构 |
|
||
| wish.tasks | 任务 | 需上下滚动，右侧点“领取”，每日有登录奖励；领完显示“已完成”并自动移到列表底部 |
|
||
| wish.pack | 礼包 | 免费补给每日1次无需广告，已售罄条目可能排在付费补给之后，不固定首行 |
|
||
|
||
`planned_tasks` 保留 `wish_task_rewards` 和 `wish_free_supply` 两项。免费补给记录为 `frequency: daily`、`claims_per_day: 1`、`ad_requirement: none`；任务列表记录 `scrollable: true`、`claimed_button_text: 已完成` 和领取后移至列表底部的重排规则。祈愿页签本身由用户明确排除，以 `automation.enabled: false` 标记，不新增对应任务。
|
||
|
||
领取任务后列表会重排，执行设计须重新识别可领条目，不能沿用原序号和坐标。按钮模板、列表边界、领奖弹框与免费补给领完状态仍待实机采集；规则确认不代表脚本已经实现。
|
||
|
||
## 冲刺：活动类型、页签与星珀商城
|
||
|
||
用户确认三类冲刺轮换，每期7天。本轮实际进入限时冲刺列表弹框，晶矿展示期与招募进行期卡片同时显示；先识别实际可见卡片，再定位进入，不把逻辑变体识别当作已经切页。招募页签已补识别，图腾样式仍待出现。
|
||
|
||
| 页面 ID | 类型或页签 | 已确认规则 |
|
||
| --- | --- | --- |
|
||
| sprint.crystal | 晶矿冲刺 | 本轮卡片展示期，内部四页签未复测 |
|
||
| sprint.crystal.targets | 冲刺目标 | 页签已记录，用户确认不需要自动化 |
|
||
| sprint.crystal.rank | 冲刺排名 | 页签已记录，用户确认不需要自动化 |
|
||
| sprint.crystal.pack | 冲刺礼包 | 首项免费每日一次无需广告，领完已售罄；兑换列表可滚动 |
|
||
| sprint.crystal.tasks | 冲刺任务 | 列表可滚动，可领奖励显示领取，领完显示已完成 |
|
||
| sprint.recruit | 招募冲刺 | 目标、排名、礼包、任务四页签；切换页签时底部导航不变，左侧返回直接回首页 |
|
||
| sprint.recruit.targets | 冲刺目标 | 页签已记录，用户确认不需要自动化 |
|
||
| sprint.recruit.rank | 冲刺排名 | 页签已记录，用户确认不需要自动化 |
|
||
| sprint.recruit.tasks | 冲刺任务 | 列表可滚动，可领奖励显示领取，领完显示已完成 |
|
||
| sprint.recruit.pack | 冲刺礼包 | 底部页签入口已确认，首项免费每日一次无需广告、领完已售罄；导航保持不变 |
|
||
| sprint.totem | 图腾冲刺 | 等活动出现后确认内部页签与流程 |
|
||
| sprint.star_store | 星珀商城（兑换商店弹框） | 右下兑换商店打开；周一刷新、整周首项免费金币可领一次，领后已售罄；右上X关闭回冲刺 |
|
||
|
||
各冲刺活动页左下箭头返回首页，本轮招募已观察；冲刺列表本身右上X关闭，落点待实测。返回关系仍为 `documented`。招募礼包节点修正为 `tab`，入口关系从待确认改为用户已确认结构。目标与排名页签分别标记 `automation.enabled: false`。
|
||
|
||
星珀商城节点改为 `overlay`；点击弹框右上X后返回打开前的冲刺面板，保留当前冲刺类型及页签。`sprint.star_store → home.sprint` 改为用户确认的关闭关系，逻辑父节点为共用冲刺入口，具体类型与页签依赖打开前历史；模板尚未采集，不用于自动导航。
|
||
|
||
五项待实现任务为晶矿和招募各自的免费礼包、任务奖励，以及星珀商城免费金币。两类礼包首项使用 `claims_per_day: 1`、`ad_requirement: none` 和 `claim_method: direct_claim`，领完已售罄。任务列表可滚动、领完已完成，用户确认重排行为待核实，以 `after_claim_reorder: pending` 标记；每次领奖后重新识别条目。
|
||
|
||
商城使用 `refresh_weekday: monday`、`claim_window: whole_week_after_refresh`、`claims_per_week: 1` 和 `claimed_button_text: 已售罄`。商城金币的广告条件与模板仍待采集，不能将礼包无需广告的规则直接套用到金币。图腾冲刺未新增具体任务。
|
||
|
||
## 寻宝：等级开放与连续周期
|
||
|
||
用户确认当前寻宝入口位于首页左侧冲刺下方，达到一定等级后出现；每期约9～10天，一期结束后开始下一期。`home.treasure` 保留动态活动节点，以 `unlock_condition` 记录等级阈值待确认，`activity_cycle` 记录连续换期。当前存在性来自用户说明，并未实机采集。
|
||
|
||
| 页面 ID | 页签 | 已确认规则 |
|
||
| --- | --- | --- |
|
||
| treasure.exchange | 宝藏兑换 | 用户确认不需要自动化，保留页签结构 |
|
||
| treasure.tasks | 冒险任务 | 列表可上下滚动，可领时显示领取；领后已完成，条目排到下面 |
|
||
| treasure.pack | 冒险礼包 | 矿石兑换列表可滚动，每期直接领一次免费项目，无需广告；领后已售罄，排到最底下 |
|
||
|
||
底部左下箭头返回首页，活动与各页签出口均记为 `documented`，尚未加入自动导航。新增 `treasure_adventure_task_rewards` 和 `treasure_adventure_free_pack` 两项待实现任务。
|
||
|
||
礼包使用 `frequency: per_activity_period`、`claims_per_period: 1`、`reset_on_new_period: true`，并记录 `ad_requirement: none` 和 `claim_method: direct_claim`；位置需滚动定位，不假定为第一项。宝藏兑换以 `automation.enabled: false` 标记，不增加对应任务。任务和礼包领后会重排，执行设计每次领取后重新识别。周期与领奖识别模板待采集；任务页是否有每日登录奖励尚未获说明，不直接套用其他活动任务规则。
|
||
|
||
## 首页好友：两层弹框与两个任务
|
||
|
||
首页右侧好友打开好友列表弹框，底部有一键赠送、领取赠礼。`home.friends` 修正为 `overlay`，新增 `friends.gifts` 作为领取赠礼子弹框。
|
||
|
||
| 节点或任务 | 已确认规则 |
|
||
| --- | --- |
|
||
| home.friends | 好友列表弹框；点击弹框外关闭回首页 |
|
||
| friends.gifts | 好友列表中领取赠礼有红点时打开；一键领取，点击子弹框外或右上X关闭回好友列表 |
|
||
| friends_daily_send | 每日登录后点击一次一键赠送，无需先检查领取赠礼红点 |
|
||
| friends_gift_rewards | 领取赠礼有红点时打开子弹框领取，关闭子弹框后关闭好友列表回首页 |
|
||
|
||
一键赠送与赠礼一键领取操作后，按钮均不变且仍可点击。空赠礼重复领取会提示 **暂无可收取的礼物**，表示无奖励，应停止并退出，不能计为领取成功。
|
||
|
||
两项任务加入 `planned_tasks`，尚未实现。后续赠送按账号与游戏日记录执行结果，每日最多一次；赠礼每次红点触发进入后点击一次、确认结果并退出，不按按钮仍可点击反复领取，不主动追加空点击验证成功。执行记录、结果识别和弹框模板尚未实现或采集，赠送刷新时间待补齐。
|
||
|
||
不能把子弹框关闭当作回到首页，也不能将首页好友与狂鼠之家好友列表的返回动作混用。所有新增关系仍为 `documented`，不参与可执行导航。
|
||
|
||
## 金沙游记：六个入口与三类可复用流程
|
||
|
||
`home.gold_trip` 显示名称统一为金沙游记，首页左上角进入；活动左下箭头返回首页。所有新增节点和关系来自用户说明，未采集识别模板，不参与可执行导航。
|
||
|
||
| 页面 ID | 页面或弹框 | 本期处理范围与返回 |
|
||
| --- | --- | --- |
|
||
| gold_trip.treasure | 金顶夺宝 | 仅登记入口，暂不处理 |
|
||
| gold_trip.letters | 驿站密使来信弹框 | 名称已确认，驿站密信保留为别名；入口有红点时打开，滚动跳过已领取、点击未领取来信；弹框外或右上X关闭回金沙游记 |
|
||
| gold_trip.roam | 圣迹漫游 | 仅登记入口，暂不处理 |
|
||
| gold_trip.cards | 法老遗珍 | 通常每日3张，无卡直接1张、广告2张，有卡直接3张；优先第一排，跳过显示奖励的已翻牌、点未翻牌的点我翻牌；当前账号有免广告卡，首翻后显示免费，无卡样式后续确认；至剩余次数不足停止；左下回金沙游记 |
|
||
| gold_trip.sign_in | 流沙赠礼 | 游戏按活动进度自动选中签到页签，找到当天节点的可领取按钮，领取后变已领取；左下箭头回金沙游记 |
|
||
| gold_trip.sign_in.day15 | 15天页签 | 不固定节点坐标，优先使用游戏自动选中的页签 |
|
||
| gold_trip.sign_in.day23 | 23天页签 | 第20天自动选此页签仅为规则示例，未记为当前观测 |
|
||
| gold_trip.supply | 驼铃补给 | 仅登记入口，暂不处理 |
|
||
|
||
流沙赠礼的两个自动显示分支用 `observe_auto_selected_tab` 记录，表示进入后识别游戏选中的页签，不发送点击。页签切换关系仅描述结构，签到任务不默认遍历两页。分活动返回金沙游记，活动再返回首页，不能把一次分活动返回当作已回首页。
|
||
|
||
三项新任务加入 `planned_tasks`；`reusable_reward_patterns` 描述签到、翻牌、来信送礼三个共用流程，均为 `not_implemented`。共用部分分别处理动态可领取节点、翻牌已翻状态与广告次数、滚动未领取来信；各活动配置页面样式、状态标志、结果验证和返回控件。流沙赠礼以当前节点从可领取变为已领取作为完成标志。法老遗珍已翻牌显示奖励内容，未翻牌显示点我翻牌；当天翻过一部分时继续处理仍可翻牌子，到剩余次数不足停止，不能假定每次进入都是三张未翻牌。每日重置方式仍待补充；当前账号有免广告卡，无卡按钮文案和广告界面标为延期确认，等以后出现无卡情况再补齐，不从免费文案推断其无卡样式。广告沿用 `reward_ad_policy`，共用运行模块尚未实现。
|
||
|
||
## 英雄集结：签到与按余额参与
|
||
|
||
剑来献礼和骊珠画卷沿用已有工作流。新增四个入口仅由用户说明记录，未采集页面模板；槐萌祈缘、剑守长城标记 `automation.enabled: false`，暂不处理。
|
||
|
||
| 页面 ID | 分活动 | 规则与返回 |
|
||
| --- | --- | --- |
|
||
| rally.huai | 槐萌祈缘 | 仅记录入口，暂不处理 |
|
||
| rally.sign_in | 岁岁平安 | 14天签到；已签卡片有对号；当前可签的“可领取”提示位于卡片左上方，点击提示左下方对应卡片；右上关闭回英雄集结 |
|
||
| rally.search | 骊珠寻珍 | 红点进入；确认跳过动画已勾选，存在免费按钮时领取；活动金币表示剩余抽奖次数，≥5参与5次、剩1～4参与1次，每次重读直到0；左下箭头回英雄集结 |
|
||
| rally.wall | 剑守长城 | 仅记录入口，暂不处理 |
|
||
|
||
两项新任务加入 `planned_tasks`，岁岁平安引用签到共用流程，其点击目标和对号完成标志独立配置。骊珠寻珍与已有骊珠画卷分开记录；只在跳过动画未勾选时点击，免费或参与后确认结果并重读剩余数，不能按首次读数固定循环。金币类型为活动专用抽奖次数，地图记录 `cost_per_single: 1`、`cost_per_batch: 5`；状态和余额模板待采集，规则不代表已经实现自动参与。
|
||
|
||
新增进入与返回边均为 `documented`，不参与可执行导航。英雄集结关闭回首页沿用 `rally → home` 的现有工作流记录，本次未复测；新分活动的一次返回仅回到英雄集结。
|
||
|
||
## 领地城墙：默认页签与独立命令打造
|
||
|
||
`territory.wall` 记录模块，两个底部页签为打造、城墙，默认 `territory.wall.overview`。`observe_default_tab` 表示进入后观察默认页签，不发送点击；本轮已采集城墙和机关打造识别模板，打造实机为弹框而非普通全屏页签。
|
||
|
||
| 页面 ID | 页签 | 规则 |
|
||
| --- | --- | --- |
|
||
| territory.wall.craft | 打造（机关打造） | 顶部钻石和机关次数；每日先免费1次，其余无免广告卡看广告、有卡直接领，额外次数待确认；机关次数打造仅按独立命令，≥10选10次、1至9选1次、0停止 |
|
||
| territory.wall.overview | 城墙 | 模块默认显示的页签，内部功能尚未说明 |
|
||
|
||
`wall_free_mechanisms` 先直接领取每日1次，额外次数无免广告卡看广告、有卡直接领，广告次数待确认；以免费按钮消失结束，不转入使用机关次数的打造。`wall_command_build` 使用 `trigger: explicit_user_command`、`scheduled: false`，不会作为每日任务执行；可用机关次数≥10选10次、1至9选1次、0停止。命令计数单位与最后一批处理待完善。执行设计逐次确认结果与剩余机关次数，不默认改用页面显示的钻石。
|
||
|
||
城墙页左下返回领地。实机机关打造为弹框，需右上X关闭回城墙，再左下回领地；原打造直接回领地关系改为 pending。两个页面已补识别，免费按钮本次未出现，打造执行未实现。
|
||
|
||
## 领地新增扫荡、排行与合作商店任务
|
||
|
||
领地排行榜按最新要求重新启用，覆盖此前暂缓；它与 `planet.rank` 星球矿场排行榜独立。所有本次新增关系均为 `documented`，未采集模板，不参与可执行导航。
|
||
|
||
| 节点 | 用户确认结构与返回 |
|
||
| --- | --- |
|
||
| relic | 玩法大厅进入遗迹夺宝，每日首次提示关闭后扫荡，遇不战而逃提示点确定，左下直接回领地 |
|
||
| relic.notice／relic.sweep_warning | 首次提示及不战而逃两个弹框；首次关闭控件待采集，后者确定关闭回遗迹夺宝 |
|
||
| territory.rank.board | 默认排行榜页签，下方进度奖励入口；左下返回领地，其他页签名称未说明 |
|
||
| territory.rank.progress | 进度奖励弹框，只点最顶行右侧宝锤，右上关闭回排行榜 |
|
||
| coop.friend_store | 合作模式左上友情商店；首张免费金币每周一0点刷新，每周首次登录领一次、领完已售罄；每日洗练石1个、体力2个，每周首次进入星愿币2个，顶部专用货币余额≥价格时购买 |
|
||
| coop.pet | 保卫宠物，别称保卫动物；左上领券每天0点刷新、每日一次、领完已领完；右侧商城、右上红点挑战入口 |
|
||
| coop.pet.buff | 可选本周buff弹框，点知道了关闭 |
|
||
| coop.pet.store | 首张免费金币每周一0点刷新，每周首次登录领一次、已售罄完成；红色随机宠物碎片3200余额够就买完可售数量，跳过黄色2400，每次重读余额和库存 |
|
||
| coop.pet.challenge | 挑战入口有红点才进入，每周和成就两个页签，只处理有红点页签的领取按钮 |
|
||
| coop.pet.challenge.weekly／coop.pet.challenge.achievements | 每周／成就页签；无默认页签假设，领取反馈和是否滚动待采集 |
|
||
|
||
本次八项待实现任务不修改已有合作券或星球矿场脚本。商店免费与购买分任务：友情商店按每日／每周目标记录已购量，仅补剩余目标；宠物商店红色碎片按余额买完当前可售数量，每次确认结果并重读余额与库存。两个商店分别记录自己的专用货币，实际货币名称未知，顶部显示余额，支付门槛为余额≥价格。宠物碎片匹配名称、红色和3200，黄色2400排除。最新明确保卫宠物券每天0点刷新，覆盖先前每周一次描述；两个商店免费金币每周一0点刷新，免费周期不推断为其他商品的库存刷新周期。
|
||
|
||
用户确认友情商店右上角关闭回实际打开来源；本轮合作模式及保卫宠物来源均已观察，宠物商店、挑战及挑战两个页签右上角关闭回保卫宠物，保卫宠物主页面左下角返回领地。六条对应返回边均标为 `documented`，控件模板未采集，不参与可执行导航。遗迹夺宝直接回领地、排行榜左下回领地已确认；首次提示、buff和进度奖励关闭分别保留各自父页面。
|
||
|
||
## 竞技场：领取竞技券（待后续确认）
|
||
|
||
已加入 planned_tasks，ID为 arena_ticket_claim，任务执行页为 arena，入口为领地 → 巅峰决斗 → 竞技场。领取入口、条件、频率、次数、资源或广告要求、完成状态及返回步骤均待确认。标为延期且规则未完善，默认分组预览排除；已有竞技积分脚本保持原行为。
|
||
|
||
## 巅峰商店：优先级最大数量购买
|
||
|
||
`arena.peak` 对应模式选择中的巅峰决斗，右侧商店新增 `arena.peak.store`。与左侧竞技场及其积分领取任务分别记录，不修改已有竞技积分脚本。
|
||
|
||
购买目标依次为 **随机藏品碎片 → 洗练石 → 超凡宝锤**，采用 `maximum_affordable_available_per_priority`：先处理最高优先级，按可购买份数、当前价格和余额选择最大数量，每次确认结果并重读余额与库存。当前项不可售或无法支付后才检查下一项；全部目标不可售或余额不足时停止。
|
||
|
||
任务 `peak_store_priority_purchases` 为待实现，频率按有库存及余额时处理，不预设日周固定额度。专用货币以巅峰商店归属记录，余额在顶部；右上X关闭回 `arena.peak`，主页面左下返回 `territory`。商品价格、库存、余额、购买结果与返回控件模板待采集；新增进入和两条返回边均为 `documented`，不参与可执行导航。
|
||
|
||
## 广告领奖共用规则
|
||
|
||
用户确认：多个日常任务在没有免广告卡时，都需要看完广告才能领取奖励；程序应自动完成这一步。该规则适用于已配置的领奖任务，并由统一广告流程复用。
|
||
|
||
1. 保存当前任务、页面及奖励来源。
|
||
2. 有免广告卡可直接领取时，走直接领取分支。
|
||
3. 需要广告时，打开广告并等待播放完成。
|
||
4. 识别完成后的关闭或返回控件，返回来源页面。
|
||
5. 按游戏实际状态领取奖励，确认到账或已领完，再继续原任务。
|
||
|
||
地图以 `reward_ad_policy` 记录这项通用策略。当前尚未采集广告界面、播放完成标志、关闭入口和自动发奖状态，也尚未实现共用广告运行流程；确认策略不代表现有脚本已经具备该能力。
|
||
|
||
## 公会商城与公会任务（用户确认，待实现）
|
||
|
||
公会商城共用一个入口，包含贡献商城、龙鳞商城两个页签，默认页签待采集。两页签分别使用专用货币，余额在页面顶部显示；点击右上角关闭按钮返回公会。
|
||
|
||
- **贡献商店任务**：按 **合作券 → 黄金罗盘 → 白银罗盘** 的优先级购买。合作券每周一刷新，整周均可按余额补购，本周最多7个，卖光显示“已售罄”；合作券不可售或当前余额无法支付时，再买黄金罗盘每日最多2个，最后白银罗盘每日最多10个，各项按余额和剩余可售数量尽量购买。周一具体刷新时刻尚未确认；每次确认购买结果并重读余额、库存及本日／本周剩余额度。
|
||
- **龙鳞商店任务**：按随机职业龙晶、随机职业龙血的顺序，购买当前余额允许的最大可售数量。先处理高优先级商品，该项不可售或无法支付后再处理下一项，不预设每日或每周固定数量。
|
||
- **公会任务领奖**：任务列表可上下滚动，可领取行右侧为“领取”，未完成为“前往”，领过为“已完成”并移到列表末尾。只点击领取，每次确认结果后重新识别列表，跳过前往和已完成。
|
||
- **公会任务进度宝箱**：任务领奖后，上方进度条达到的小宝箱会出现红点，点击宝箱领奖，领完显示小对号。每次任务领取后及列表处理结束时重新检查红点宝箱，跳过已显示对号的宝箱。右上关闭公会任务回到公会。
|
||
|
||
购买后确认结果并重读余额、可售数量及本日／本周剩余额度，不能每次进入都重新购买完整限额。商品价格、库存、购买确认与结果、任务列表和宝箱状态模板尚未采集；上述三个任务仅加入待实现清单，不修改已有脚本汇总，也未实际购买或领奖。
|
||
|
||
## 远征大厅、公会祝福与公会Boss（用户确认，待实现）
|
||
|
||
远征大厅包含迷宫寻宝、公会对决。**迷宫寻宝先搁置**，仅保留入口，不继续补内部步骤。公会对决进入后，点击下方有红点的“奖励”，默认停留“任务奖励”页签：任务列表可上下滚动，可领取任务集中在上方，右侧显示“领取”；未完成显示“前往”，已领显示“已完成”并移到末尾。逐次领取后确认结果并重新识别列表，不点击前往。奖励右上角关闭回公会对决，再点击左下角返回直接回公会。奖励其他页签未说明，不扩大任务范围；远征大厅实际右上X关闭回公会，本轮已观察。
|
||
|
||
**公会祝福升级**：升级消耗材料，红点表示材料充足。进入后只有“升级”按钮存在且按钮上有红点时，才点击升级一次；完成后点击左下角返回公会，不会自动返回。材料和升级结果识别模板待采集。
|
||
|
||
公会Boss每周一、三、五、日出现，任务仅在入口实际可用时处理，不通过日历推断页面一定存在。
|
||
|
||
- **领取公会boss奖励**：右侧“财宝”图标左上角有数字时打开财宝弹框，点击可用的“全部领取”；领取后按钮变成灰色“领取”，确认奖励结果并跳过灰色按钮。弹框右上角关闭回Boss页面，Boss左下角返回公会。数字的具体含义未知，不把数字当作点击次数。
|
||
- **公会助威**：当天首次进入可用的Boss页面，助威按钮有红点时点击一次，每天最多一次；之后可按本日记录跳过，不循环点击。用户确认点击后按钮变成“已助威”，不可重复点击，后续看到已助威直接跳过；完成状态识别和执行记录尚未实现。
|
||
|
||
新增四项待实现任务，迷宫寻宝只标记暂缓。页面标题和当前布局已采集，财宝数字、灰色按钮、升级与助威操作结果仍待验证；本次仅补规则，未实际升级、助威或领取奖励。
|
||
|
||
## 待验证入口
|
||
|
||
下表已保留页面名称和归属。内部布局、可靠身份标识、返回位置或活动存在性未采集，路线规划不会使用这些入口。
|
||
|
||
| 页面 ID | 入口 | 所属页面 | 已知情况 |
|
||
| --- | --- | --- | --- |
|
||
| home.gold_trip | 金沙游记 | 首页 | 六个分活动已登记，仅处理签到、翻牌、驿站密使来信；活动左下回首页、分活动回活动层级已确认，页面和状态模板待采集。 |
|
||
| home.activity | 活动 | 首页 | 页签结构、免费和充值奖励规则、左下返回已确认；页面及按钮识别待采集。 |
|
||
| home.rebate | 返利 | 首页 | 左侧不定期出现；用户明确暂不处理，内部奖励、条件和返回问题暂缓，不参与自动导航。 |
|
||
| home.movie | 观影 | 首页 | 不定期出现，一般连续签到5天；单页中间按钮每日5次，按免广告卡分支领奖、右上关闭返回；当前未出现，自动化待再次出现后完善。 |
|
||
| home.trial | 试炼 | 首页 | 三页签及底部箭头返回已记录；英雄试炼与特训后续补充，试炼任务不需要自动化。 |
|
||
| home.wish | 祈愿 | 首页 | 试炼下方冲刺上方、不定期；祈愿、任务、礼包三页签，任务点右侧领取，礼包点顶部免费；左下箭头返回首页，识别待采集。 |
|
||
| home.sprint | 冲刺（轮换三类） | 首页 | 三类每期7天，本轮晶矿展示期与招募进行期同时可见；晶矿和招募四页签，仅处理礼包任务，左下返回；右下兑换商店弹框周一刷新整周领一次金币，右上X关闭；页面布局已核实，执行与结果控件待实现。 |
|
||
| home.treasure | 寻宝活动 | 首页 | 冲刺下方，等级开放后连续9～10天换期；三页签、任务和每期免费礼包领后重排、左下箭头返回已记录，模板待采集。 |
|
||
| home.friends | 好友列表 | 首页 | 右侧入口打开弹框，底部每日一键赠送、红点领取赠礼；关闭赠礼后点好友列表外回首页，识别模板待采集。 |
|
||
| heroes.detail | 英雄详情 | 英雄 | 已知入口：英雄卡片；内部页面与返回方式未采集，不参与自动识别或导航。 |
|
||
| heroes.pet | 宠物 | 英雄 | 已知入口：右下宠物；内部页面与返回方式未采集，不参与自动识别或导航。 |
|
||
| king.other | 国王其他页签与功能 | 国王 | 已知入口：武器、披风、皮肤、城墙、藏品、图腾、材料等；内部页面与返回方式未采集，不参与自动识别或导航。 |
|
||
| territory.atlas | 图鉴 | 领地 | 右下入口保留；用户最新确认暂不处理，内部与返回规则暂缓，automation.enabled为false。 |
|
||
| territory.rank | 排行榜 | 领地 | 最新要求启用，入口红点时进入默认排行榜页签，进度奖励只点顶行宝锤，关闭后左下回领地；页面布局已核实，执行与结果控件待实现。 |
|
||
| territory.wall | 城墙 | 领地 | 打造、城墙两个页签，默认城墙，左下回领地；每日免费与独立命令打造分开，广告额外次数与模板待完善。 |
|
||
| coop.pet | 保卫宠物 | 合作模式选择 | buff点知道了关闭，左上领券每日0点刷新，商店免费金币每周一0点刷新；主页左下回领地、商店挑战右上关闭，模板未采集。 |
|
||
| arena.peak | 巅峰决斗 | 巅峰决斗模式选择 | 右侧巅峰商店三项优先级购买，顶部专用货币余额，商店右上X关闭、主页左下回领地；页面布局已核实，执行与结果控件待实现。 |
|
||
| guild.store | 公会商城 | 公会 | 贡献商城、龙鳞商城两个页签，顶部专用货币余额，购买规则已记录；右上关闭回公会，页面布局已核实，执行与结果控件待实现。 |
|
||
| guild.expedition | 远征大厅 | 公会 | 迷宫寻宝暂缓，公会对决奖励红点进入默认任务奖励，关闭后左下直接回公会；本页返回待确认。 |
|
||
| guild.tasks | 公会任务 | 公会 | 滚动逐项领取，已完成移末尾；上方红点进度宝箱领取后显示对号，右上关闭回公会，页面布局已核实，执行与结果控件待实现。 |
|
||
| guild.blessing | 公会祝福 | 公会 | 升级按钮有红点时点击一次，消耗材料，红点表示材料充足；升级后左下返回公会，页面布局已核实，执行与结果控件待实现。 |
|
||
| guild.members | 成员大厅 | 公会 | 右上塔楼入口保留；用户明确不需要自动化，automation.enabled为false，内部流程和返回规则不再确认。 |
|
||
| guild.boss | 公会 Boss | 公会 | 周一三五日出现，财宝左上数字时全部领取；助威红点每天一次；左下回公会，助威后已助威不可重复，页面布局已核实，执行与结果控件待实现。 |
|
||
|
||
## 已有任务与页面归属
|
||
|
||
“任务执行页”描述任务真正操作奖励的地方；“现有脚本启动页”说明目前代码的实际要求。现有大多数脚本仍要求首页并自带进入、返回逻辑，**此次建立地图没有重构这些脚本或接入统一调度**。
|
||
|
||
| 任务 | 分组页面 | 任务执行页 | 现有脚本 | 现有启动要求 |
|
||
| --- | --- | --- | --- | --- |
|
||
| 战令领取 | 首页 | 特惠／赏金战令 | `claim_offer.py` | 首页 |
|
||
| 挂机奖励 | 首页 | 挂机奖励 | `claim_idle.py` | 首页 |
|
||
| 快速扫荡 | 首页 | 挂机奖励 | `claim_sweep.py` | 首页 |
|
||
| 任务奖励 | 首页 | 日常任务 | `claim_tasks.py` | 首页 |
|
||
| 收取邮件 | 首页 | 邮件 | `claim_mail.py` | 首页 |
|
||
| 剑来积分奖励 | 首页 | 剑来献礼 | `claim_sword_gift_points.py` | 首页 |
|
||
| 骊珠任务奖励 | 首页 | 骊珠画卷任务 | `claim_lizhu_task_rewards.py` | 首页 |
|
||
| 英雄招募签到 | 商城 | 神灯召唤 | `claim_recruit_signin.py` | 首页 |
|
||
| 收矿与雇佣 | 领地 | 狂鼠之家 | `claim_mining.py` | 首页 |
|
||
| 喂养狂鼠 | 领地 | 好友矿场 | `claim_feed_mice.py` | 首页 |
|
||
| 领取体力 | 领地 | 食堂 | `claim_stamina.py` | 首页 |
|
||
| 合作券 | 领地 | 合作模式 | `claim_cooperation_ticket.py` | 首页 |
|
||
| 竞技积分 | 领地 | 竞技场 | `claim_arena_points.py` | 首页 |
|
||
| 星球矿场金币 | 领地 | 星球矿场 | `claim_planet_mine.py` | 首页 |
|
||
| 公会互助 | 任意一级页面 | 底部公会按钮上方握手入口 | `claim_guild_help.py` | 任意一级页面 |
|
||
| 公会砍价 | 公会 | 红珍珠祭坛 | `claim_guild_bargain.py` | 首页 |
|
||
| 每日免费捐献 | 公会 | 每日捐献弹框 | `claim_guild_donation.py` | 首页 |
|
||
|
||
## 调度与导航的接口约定
|
||
|
||
后续按“识别当前页 → 导航到任务执行页 → 执行任务 → 识别实际落点 → 规划下一任务”的顺序工作。固定任务只操作本页；导航负责进入和返回；调度负责选任务、按页面排序、记录结果及资源策略。
|
||
|
||
任务结果应至少包含：任务 ID、已完成／已领完／条件不满足／失败、完成后的页面 ID 和必要的活动实例。单项失败后，只有确认可以恢复到已知页面时才继续下一项；若仍在未知或有歧义的画面，应停止相关导航并保存现场。
|
||
|
||
正常情况下按首页、商城、领地、公会分组，可减少往返。现有脚本迁移前先沿用其首页启动要求，避免调度把任务送到子页面后旧脚本反而失败。之后逐项抽出本页任务，再让地图负责导航；不应一次改变所有已验证流程。
|
||
|
||
活动名称变化可触发人工检查或之后的模型识别补充。当前地图与识别器仍使用本地模板，没有接入模型 API。Windows 的窗口定位、输入和缩放需要另外实机验证。
|
||
|
||
## 本次验证记录
|
||
|
||
- 主要页面：本次验证领地返回首页、首页进入商城与返回、首页进入英雄与返回、首页进入国王与返回、首页进入公会与返回；最后停留首页。
|
||
- 识别：8 张本次截图全部识别正确，其中包括通知遮挡商城顶部的截图。神灯任务、礼包和奖励展示的 4 张既有截图用于补充检查，识别结果符合预期。
|
||
- 自动化测试：6 项页面识别与路线测试通过，覆盖主要页区分、未知与暗背景、弹层优先、歧义、候选路线与排除未验证路径。
|
||
- 限制：本次未穷尽每个入口内部页面，未验证新活动、不同国王页签、跨日变化或 Windows，也未接入自动导航和调度。
|
||
|
||
## 本轮页面核实与优化（2026-10-05至06）
|
||
|
||
当前地图134个节点、239条关系、17个已有脚本任务、49个待实现或延期任务；78个节点有识别模板，52个节点附本轮布局记录。新增只读任务分组预览，仍未接入统一导航执行。这里只核实布局、进入和关闭，未领取、购买、升级、打造或扫荡；已回到首页。
|
||
|
||
详细差异、未验证状态和按优先级的开发计划见 [页面核实与自动化优化计划](261006_0109-页面核实与自动化优化计划.md)。当前可用的原有路线与本轮结构记录分别保留，新关系不直接自动执行。
|