feat: add page map recognition and grouped task planning

This commit is contained in:
admin committed 2026-10-06 13:24:25 +08:00
1 parent 386198e8e0
commit f7628ab41e
76 files changed
+12437 -49

No files matched your search

@@ -1,7 +1,7 @@
---
created_at: 2026-10-04 16:07:56 CST
type: 永远的蔚蓝星球首页、商城、领地与公会入口、日常任务与自动化适配记录
revision: 第23次
revision: 第63次
revisions:
- time: 2026-10-04 16:07:56 CST
version: 第1次
@@ -95,11 +95,175 @@ revisions:
version: 第23次
author: GPT-6
content: 补充商城英雄招募限时 UP 卡片的神灯任务与免费神灯领取流程、实机验证结果、脚本和汇总表条目。
summary: 记录首页、商城、领地和公会的日常任务入口、待完善流程及已实现脚本汇总。入口红点表示内部有奖励可以领取;特惠赏金战令、小金猪领取与扫荡、任务奖励、邮件、英雄招募神灯任务和免费神灯、狂鼠之家收矿雇佣与好友喂养、食堂领体力、合作模式合作券、竞技场积分、星球矿场、英雄集结内剑来献礼与骊珠画卷任务,以及公会互助、砍价和每日免费捐献均已实现脚本。
- time: 2026-10-05 17:05:33 CST
version: 第24次
author: GPT-6
content: 补充独立页面地图的链接及导航与任务分离的后续方向;现有任务脚本尚未接入地图调度。
- time: 2026-10-05 17:19:57 CST
version: 第25次
author: GPT-6
content: 补充首页活动四个底部页签与日周月礼包结构,记录月卡会员可见条件和两项每日免费领取规则,领取脚本尚未实现。
- time: 2026-10-05 17:24:00 CST
version: 第26次
author: GPT-6
content: 记录每日特惠第二次免费领取有免广告卡可直接领取、否则需看广告的规则,自动观看策略待确认。
- time: 2026-10-05 17:27:23 CST
version: 第27次
author: GPT-6
content: 用户确认没有免广告卡时由程序自动看完广告再领取,将该策略用于所有已配置且需要广告的领奖任务,共用流程待实现。
- time: 2026-10-05 17:29:01 CST
version: 第28次
author: GPT-6
content: 确认活动超值礼包的周礼包没有免费项目,免费领奖流程跳过,月礼包等奖励规则继续逐项确认。
- time: 2026-10-05 17:32:28 CST
version: 第29次
author: GPT-6
content: 确认月礼包也没有免费项目,补充树形页面地图链接,后续按用户要求合并确认相关问题。
- time: 2026-10-05 17:40:14 CST
version: 第30次
author: GPT-6
content: 确认日礼包第一项直接领、第二项无免广告卡看广告,每日充值两档及充值奖励红点领取低优先级,并记录活动左下返回。
- time: 2026-10-05 17:47:39 CST
version: 第31次
author: GPT-6
content: 确认返利不定期出现且暂不处理,内部奖励、条件和返回问题暂缓;特惠页签尚未列全,优先补齐。
- time: 2026-10-05 18:00:38 CST
version: 第32次
author: GPT-6
content: 补齐特惠六个底部页签,记录月卡与周卡零点刷新、战令进度领奖、基金解锁和关卡条件、遗迹及宠物战令第一列领奖,新增流程尚未实现。
- time: 2026-10-05 18:09:35 CST
version: 第33次
author: GPT-6
content: 确认月卡两项奖励每天各领一次、未购买显示18元和30元,补充基金前三个动态页签与关卡范围,以及遗迹和宠物战令的高亮可领、对号已领标志。
- time: 2026-10-05 18:19:12 CST
version: 第34次
author: GPT-6
content: 确认周卡无需购买即可签到、领完显示已领取,基金已领显示对号且未达关卡覆盖灰色蒙版,特惠六个页签均由左下箭头返回首页。
- time: 2026-10-05 18:24:13 CST
version: 第35次
author: GPT-6
content: 确认月卡两项奖励领完分别显示续费18元和续费30元,两类战令没有一键领取,需要上下滚动并逐项领取第一列奖励;可领取月卡按钮文案仍待采集。
- time: 2026-10-05 18:30:24 CST
version: 第36次
author: GPT-6
content: 记录观影活动不定期出现、一般连续签到5天、单页中间按钮每天领取5次及免广告卡分支,右上关闭返回首页;当前活动未出现,按用户要求延后完善。
- time: 2026-10-05 18:36:51 CST
version: 第37次
author: GPT-6
content: 确认当前试炼入口存在,补充英雄试炼、特训和试炼任务三个页签;任务完成后点击领取,每日登录游戏1次奖励每日可领,底部箭头返回首页,自动化待实现。
- time: 2026-10-05 18:41:01 CST
version: 第38次
author: GPT-6
content: 按用户最新说明暂缓英雄试炼和特训、取消试炼任务自动化,记录列表无需滚动;新增试炼下方冲刺上方的祈愿不定期入口,内部规则待确认。
- time: 2026-10-05 18:46:22 CST
version: 第39次
author: GPT-6
content: 补充祈愿、任务、礼包三个页签,记录任务右侧领取按钮和每日登录奖励、礼包顶部免费补给及左下箭头返回;新增两项待实现任务,祈愿页签操作与补给刷新待确认。
- time: 2026-10-05 18:52:33 CST
version: 第40次
author: GPT-6
content: 确认祈愿免费补给每日一次无需广告,任务列表需滚动、领完显示已完成并移至列表底部;祈愿页签本身不自动处理,保留两项领奖任务待实现。
- time: 2026-10-05 19:06:16 CST
version: 第41次
author: GPT-6
content: 记录三类冲刺每期7天及当前晶矿冲刺,补充晶矿和招募礼包与任务领奖、左下返回、右下星珀商城周一免费金币;招募礼包入口矛盾待确认,图腾冲刺出现后补充。
- time: 2026-10-05 19:16:55 CST
version: 第42次
author: GPT-6
content: 确认招募冲刺同样四个底部页签且切换时导航不变,目标和排名不自动处理;星珀商城由兑换商店打开弹框,周一刷新整周一次,右上X关闭回冲刺面板。
- time: 2026-10-05 19:20:31 CST
version: 第43次
author: GPT-6
content: 确认晶矿和招募首项免费礼包每日一次无需广告,星珀商城金币领后显示已售罄;冲刺任务领取后是否重排保留待确认。
- time: 2026-10-05 19:30:33 CST
version: 第44次
author: GPT-6
content: 更新寻宝为等级开放后连续9至10天换期,记录宝藏兑换、冒险任务、冒险礼包三页签及左下返回;任务领后已完成排到底部,免费礼包每期一次、领后已售罄排到底部,新增两项待实现任务。
- time: 2026-10-05 19:33:35 CST
version: 第45次
author: GPT-6
content: 确认寻宝宝藏兑换不需要自动化,冒险礼包每期免费项目不需要看广告、直接领取,保留两项领奖任务待实现。
- time: 2026-10-05 19:39:44 CST
version: 第46次
author: GPT-6
content: 记录首页好友列表底部每日登录后一键赠送一次、领取赠礼红点进入并一键领取;补齐赠礼弹框外部或右上X关闭、好友列表外部关闭回首页,新增两项待实现任务。
- time: 2026-10-05 19:47:09 CST
version: 第47次
author: GPT-6
content: 确认好友赠送和领取按钮操作后不变且仍可点击,记录空赠礼提示及待实现的每日限次和防重复领取规则。
- time: 2026-10-05 20:09:15 CST
version: 第48次
author: GPT-6
content: 补充金沙游记六个入口与三项任务,确认驿站密使名称、跳过已领取来信,以及翻牌跳过已翻牌、点我翻牌和剩余次数不足状态;三项任务及共用流程待实现。
- time: 2026-10-05 20:17:23 CST
version: 第49次
author: GPT-6
content: 确认流沙赠礼领取后按钮变成已领取;限定法老遗珍免费文案为当前有免广告卡账号的表现,无卡界面留待以后确认。
- time: 2026-10-05 20:28:58 CST
version: 第50次
author: GPT-6
content: 补充英雄集结四个新入口,仅处理签到与寻珍,确认岁岁平安14天、寻珍金币为活动抽奖次数,记录卡片定位、跳过动画、免费与按剩余次数参与,新增两项待实现任务。
- time: 2026-10-05 21:12:15 CST
version: 第51次
author: GPT-6
content: 确认商城图腾两卡每日各一次免费及广告、商店首格免费招募券无广告且刷新不再免费、金币首卡每日两次;记录金币购券与600刷新草案,三项免费任务待实现、购券刷新规则待完善。
- time: 2026-10-05 21:18:49 CST
version: 第52次
author: GPT-6
content: 按最新确认暂缓领地图鉴与排行榜,保留入口记录,不继续确认内部任务,城墙单独保留待补充。
- time: 2026-10-05 21:27:01 CST
version: 第53次
author: GPT-6
content: 补充城墙两页签与左下返回领地,确认每日先免费一次、额外广告次数待确认及免广告直接领取;机关次数达到10选10次打造,仅按单独命令执行,两项任务待实现。
- time: 2026-10-05 21:57:28 CST
version: 第54次
author: GPT-6
content: 补充领地八项任务并启用排行榜新范围,确认宠物券每周一次、商店各自顶部货币够价才买及只买红色3200随机宠物碎片,购买额度周边界与返回待确认。
- time: 2026-10-05 22:05:01 CST
version: 第55次
author: GPT-6
content: 补齐商店挑战与宠物返回路径,按最新说明改宠物券每日0点刷新,免费金币每周一0点刷新,红色3200随机宠物碎片余额够就买完可售数量,执行与模板待完善。
- time: 2026-10-05 22:14:33 CST
version: 第56次
author: GPT-6
content: 补充巅峰商店优先级最大数量购买,确认顶部专用货币、右上X关闭与主页左下返回领地,新增任务待实现,模板待采集。
- time: 2026-10-05 22:31:15 CST
version: 第57次
author: GPT-6
content: 补充公会商城双页签购买优先级、公会任务列表重排和进度宝箱领奖,以及右上关闭回公会;确认顶部专用货币、罗盘每日2/10限额、合作券周一刷新整周最多7个及龙晶龙血按优先级买完。
- time: 2026-10-05 22:37:57 CST
version: 第58次
author: GPT-6
content: 确认贡献商城购买顺序为合作券、黄金罗盘、白银罗盘,保留每周7个及每日2/10个限额。
- time: 2026-10-05 22:49:51 CST
version: 第59次
author: GPT-6
content: 补充远征大厅、公会对决任务领奖、公会祝福材料升级及左下返回、公会Boss财宝和已助威完成状态;迷宫寻宝暂缓。
- time: 2026-10-05 22:54:16 CST
version: 第60次
author: GPT-6
content: 用户确认成员大厅不需要自动化,保留入口,排除内部流程确认与执行。
- time: 2026-10-06 01:09:48 CST
version: 第61次
author: GPT-6
content: 同步本轮页面核实差异与识别修正,增加只读任务预览和后续公共执行器开发顺序,保留未验证状态。
- time: 2026-10-06 01:13:31 CST
version: 第62次
author: GPT-6
content: 补充领地巅峰决斗竞技场领取竞技券任务,具体流程后续确认,暂不实现或纳入默认预览。
- time: 2026-10-06 01:14:17 CST
version: 第63次
author: GPT-6
content: 补充战令一键领取后可能出现幸运星,需额外点击领取,分支标记后续完善,未修改执行脚本。
summary: 已实现17项脚本,另记录49项待实现或延期任务。本轮核实当前可见关键页面并回首页,修正弹框、返回、冲刺卡片与免费目标,新增只读任务预览;下一步先公共导航和领奖执行器,再广告与购买。 新增领取竞技券,流程待确认。 战令幸运星额外点击领取分支待完善。
---
# 首页、商城、领地与公会功能及日常任务梳理
页面层级快速总览:[树形页面地图](261005_1732-树形页面地图.md)。
页面之间的进入、返回、识别特征及待验证入口另见 [页面地图与导航规则](261005_1702-页面地图与导航规则.md)。对应程序配置为 `workflows/page_map.json`,可运行 `inspect_page.py` 只读识别当前页面或查询候选路线;现有任务脚本尚未接入统一导航与调度。
## 记录范围与依据
本记录针对《永远的蔚蓝星球》的首页、商城、领地与公会,依据用户对高级账号的说明、两张首页截图、八张商城截图、一张领地截图及一张公会截图。当前已开始本地自动化原型开发;各活动内部流程继续逐项补充和实机验证。
@@ -114,6 +278,8 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
用户确定的开发顺序:**先在本地实现部分自动化流程,逐项验证后再打包成独立程序**,最终目标仍是 macOS 与 Windows。模型 Key 由用户以后在程序设置中填写。
用户确认的通用广告领奖规则:已配置任务要求观看广告才能领取时,**有免广告卡则直接领取,没有则由程序自动看完广告后领取**。多个任务复用同一个广告流程,保留来源页面,广告结束后返回原任务并确认奖励结果。地图已记录策略,广告识别与执行模块尚未实现和验证。
小金猪、特惠战令、狂鼠之家、食堂均已有实机验证脚本,使用局部截图模板识别并在关键状态变化后确认结果。当前不执行快速扫荡,也尚未加入红点检测或模型 API。Windows 双平台操作仍需实机验证;页面不匹配或超时会停止,不重复领取。启动方法与验证命令见项目 README。
## 首页
@@ -122,17 +288,138 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
| 入口 | 出现规律(用户确认) | 功能和日常逻辑(用户确认) | 后续需要核实 |
| --- | --- | --- | --- |
| 金沙游记 | 季节性大活动,不定期出现;每次名称可能不同;可有两个大活动同时出现,入口都在左上角 | 进入后包含多个分活动 | 分活动清单、各任务入口、签到与领奖步骤、完成标志 |
| 特惠 | 固定入口 | 内部有每天按固定流程领取的奖励;当前赏金战令一键领取已实机验证 | 其他子页面、跨日重置规律及活动更换后的样式 |
| 活动 | 固定入口 | 内部有每天按固定流程领取的奖励 | 子页面结构、领取顺序、领取后状态、跨日重置规律 |
| 返利 | 当前左侧存在,是否固定尚未说明 | 内部功能尚未说明 | 领取条件、是否与充值相关、是否存在日常免费内容 |
| 观影 | 不定期出现 | 出现后流程固定,按按钮操作即可 | 按钮顺序、是否涉及广告播放、等待时间、领奖和结束状态 |
| 试炼 | 不定期出现 | 每次页面样式略有不同,但领奖页面逻辑相同 | 样式变化范围、任务条件、领奖路径、完成标志 |
| 冲刺 | 不定期出现,三个冲刺活动轮流出现 | 三种活动基本逻辑相同 | 三种活动名称、共用步骤、差异条件、奖励领取状态 |
| 寻宝 | 不定期出现 | 每次签到逻辑相同 | 签到入口、签到条件、是否有补签消耗、签到完成状态 |
| 金沙游记 | 季节性大活动,入口在左上角;其他期活动名称可能不同,可有两个大活动同时出现 | 六个分活动已记录;先处理流沙赠礼签到、法老遗珍翻牌、驿站密使来信领取;活动左下箭头回首页 | 翻牌每日重置方式、识别模板及结果验证;无免广告卡时的界面以后确认 |
| 特惠 | 固定入口 | 六个页签均需自动领奖、统一左下箭头返回首页;当前战令一键领取已实机验证 | 新增页签的识别模板、月卡按钮状态和基金后续进度规则 |
| 活动 | 固定入口 | 超值礼包、每日特惠、每日充值、累充豪礼四个页签;日礼包有两个每日免费项目,每日特惠一个免费项目每日可领两次,第二次有免广告卡直接领取,否则自动看完广告领取 | 页面识别、领取按钮和领完状态、广告运行流程、返回路径 |
| 返利 | 不定期出现 | 用户明确目前不处理 | 内部奖励、领取条件和返回方式暂不确认 |
| 观影 | 不定期出现,一般出现后可连续签到 5 天 | 单页中间按钮每天领取 5 次;有免广告卡直接领,否则看完广告再领;右上关闭返回首页 | 当前未出现,等再次出现后采集按钮、剩余次数及领完状态,完善自动化 |
| 试炼 | 不定期出现;当前存在(用户确认) | 三个页签及领奖、底部箭头返回规则已记录;英雄试炼与特训暂不处理,试炼任务无需滚动且不需要自动化 | 英雄试炼和特训后续补充;试炼任务不继续确认执行细节 |
| 祈愿 | 不定期出现;本次用户确认有该入口 | 三页签,仅处理任务领奖和每日一次无广告免费补给;任务需滚动,领完显示已完成并移到底部;左下箭头返回首页 | 按钮及列表模板、滚动边界、免费补给领完状态和领奖验证 |
| 冲刺 | 三类轮流进行,每期 7 天;当前晶矿冲刺 | 晶矿和招募首项礼包每日一次无广告、领完已售罄;任务领完已完成。右下星珀商城周一刷新、整周领一次金币、领完已售罄,右上X关闭回冲刺;左下回首页 | 任务领后重排待确认、模板与金币广告条件待采集;图腾出现后确认 |
| 寻宝 | 等级开放后每期约9~10天连续换期;当前有入口 | 冲刺下方入口,左下返回;仅领取冒险任务和每期一次无广告免费礼包,领后条目排到底部;宝藏兑换不处理 | 开放等级、任务刷新及识别模板 |
截图中左侧入口为纵向排列,较下方按钮部分受折叠区域影响。后续需要确认列表的展开、收起或滚动方式,不能假定所有入口始终同时可见或保持同一位置。
### 金沙游记:签到、翻牌与来信(规则已记录,待实现)
包含 **金顶夺宝、驿站密使、圣迹漫游、法老遗珍、流沙赠礼、驼铃补给** 六个入口。金沙游记左下角箭头返回 **首页**。当前仅处理流沙赠礼、法老遗珍和驿站来信;金顶夺宝、圣迹漫游、驼铃补给仅登记入口,暂不处理。
用户后续确认实际名称为 **驿站密使**;之前的“驿站密信”仅保留为别名,不创建两个活动。
| 分活动 | 用户确认的流程 | 返回方式 | 待补充 |
| --- | --- | --- | --- |
| 流沙赠礼 | 长周期签到,含15天、23天两个页签;游戏按活动天数自动选中当前页签,例如第20天自动选23天。找到当天节点的“可领取”按钮并点击,每天位置可能变化,领完变为“已领取” | 左下箭头回金沙游记 | 可领取与已领取按钮、动态节点和结果识别模板 |
| 法老遗珍 | 常规每日3张,无免广告卡时1张直接翻、另外2张看广告,有卡3张直接翻;优先第一排,跳过显示奖励内容的已翻牌,继续处理“点我翻牌”的未翻牌;当前有免广告卡账号首翻后牌子上显示“免费”;直到提示“剩余次数不足”停止 | 左下箭头回金沙游记 | 每日重置方式、牌子和结果模板;无卡按钮样式及广告界面以后确认 |
| 驿站密使来信 | 入口有红点时打开来信弹框,来信列表可上下滚动;跳过显示“已领取”的条目,点击其余未领取来信,无需额外红点或未领取文字 | 点击弹框外或右上角X回金沙游记 | 来信与已领取标志、领奖结果和滚动边界模板 |
签到任务优先使用游戏自动选中的页签,不主动把15天和23天两页都点一遍;识别“可领取”所在节点,不固定每日点击坐标,点击后以该节点变成“已领取”确认完成。翻牌按当天已翻状态继续,不能每次进入都再点三个或重复点已展示奖励的牌;停止依据为不能翻牌或“剩余次数不足”。当前账号有免广告卡,“免费”文案只记录本账号表现,不推断无卡样式;无卡按钮及广告界面等以后出现该情况再确认。第20天仅为签到规则示例,不记为当前实机观测。三项分活动完成后均先返回金沙游记,再从活动左下角返回首页。
新增 **金沙游记流沙赠礼签到、金沙游记法老遗珍翻牌、金沙游记驿站来信领取** 三项待实现任务。签到、翻牌、来信送礼分别记录为可复用流程,各季节活动配置自己的页面样式、可领取与已领取标志、广告分支和返回控件;不假定它们共享同一套图片模板。共用执行模块和新脚本尚未实现,未加入已实现脚本汇总。
### 特惠页签与领奖规则(用户确认)
底部从左到右依次为 **超值月卡、战令、特惠周卡、钻石基金、遗迹战令、宠物战令**,全部需要自动领取符合条件的奖励。用户原文“砖石基金”在文档中统一写作“钻石基金”;最后一项在规则描述中称为“宠物战力”,暂按页签清单记为“宠物战令”,界面文字待核对。
| 页签 | 领取条件与操作 | 刷新或奖励来源 | 当前状态 |
| --- | --- | --- | --- |
| 超值月卡 | 两项奖励每天各领一次,按钮位置固定;未购买分别显示“18 元”“30 元”;领完分别显示“续费:18 元”“续费:30 元”,这些按钮均跳过 | 每日 00:00 刷新 | 进入与返回已有流程,月卡领奖待实现;可领取时的按钮文案与识别模板待采集 |
| 战令 | 消耗一定体力产生奖励后领取 | 体力消耗进度 | 已实现一键领取,沿用赏金战令脚本 |
| 特惠周卡 | 未购买也可在列表中点击“签到”;签到后显示“已领取”,跳过已领项目 | 每日 00:00 刷新 | 资格和领完状态已确认,识别模板与执行待实现 |
| 钻石基金 | 遍历实际显示的内部页签;解锁且到达关卡后点击最后一列钻石。未解锁有小锁头;已领有对号;未达关卡有灰色蒙版,均跳过 | 解锁资格及关卡进度 | 基金 1、2、3 可见范围和领奖状态已记录,识别模板与执行待实现 |
| 遗迹战令 | 上下滚动列表,逐项点击第一列高亮且没有对号的小正方形奖励图标;有对号跳过 | 参与遗迹夺宝 | 没有一键领取,图标在各列位置固定;识别模板、列表边界及领取弹框待采集 |
| 宠物战令 | 原逐项奖励图标规则保留,实机发现灰色一键领取 | 参与保卫宠物 | 布局已采集;是否优先一键领取待用户确认,结果仍待实测 |
超值月卡领取后的两个“续费”按钮作为已完成当日领取的状态记录,均不再点击。用户尚未说明可领取时的确切按钮文案,因此不直接假定为“领取”;实现时需采集画面确认。两类战令逐项领取后需重新识别奖励状态,再继续滚动,避免重复点击已领图标。
钻石基金内部页签按关卡进度增加,用户目前确认以下范围。名称原文为“砖石基金 1/2/3”,文档统一为“钻石基金 1/2/3”。
| 当前关卡范围(按用户原说明) | 显示页签 |
| --- | --- |
| 未到 100 关 | 钻石基金 1 |
| 超过 100 关、未到 200 关 | 钻石基金 1、钻石基金 2 |
| 超过 200 关、未到 260 关 | 钻石基金 1、钻石基金 2、钻石基金 3 |
恰好达到 100、200 关时的显示边界尚未确认;260 关及后续未玩到,不推测页签数量和阈值。执行方案以实际可见页签为准,不能硬编码为只处理三个页签。基金可领取钻石没有对号;已领取显示对号,未达关卡覆盖灰色蒙版。**没有对号不能单独作为可领取依据**,还需确认解锁且排除灰色蒙版;基金可领图标是否高亮未获确认。
月卡、基金的购买和解锁作为现有权益的领取条件记录;周卡签到不要求购买。遗迹夺宝、保卫宠物只记录为奖励来源,尚未据此增加自动参与玩法的任务。用户已确认特惠六个页签均点击**左下角箭头样式的返回按钮**回到首页;新页签返回按钮模板与实际切换仍待采集验证。
程序地图保留已实现战令任务,新增月卡、周卡、基金、遗迹战令和宠物战令五项待实现任务。未实现流程不加入底部已实现脚本汇总。
### 活动页签与每日免费领取(用户确认,待实现)
进入首页左侧“活动”,底部按顺序有 **超值礼包、每日特惠、每日充值、累充豪礼** 四个页签;最后一项本轮实机标题为累充豪礼,旧称保留作别名。
“超值礼包”内部有 **日礼包、周礼包、月礼包** 三个页签。月礼包只有充值月卡会员才能看到;不可见时跳过,不以购买会员作为自动化前提。
| 入口路径 | 用户确认的免费领取规则 | 当前状态 |
| --- | --- | --- |
| 首页 → 活动 → 超值礼包 → 日礼包 | 2个免费项目,本轮上方体力免费带视频标志、下方金币普通免费;广告判定策略待确认 | 规则已确认,脚本待实现 |
| 首页 → 活动 → 每日特惠 | 1 个免费项目,每日可以领取 2 次;第二次有免广告卡直接领取,否则自动看完广告后领取 | 规则已确认,领取脚本与共用广告流程待实现 |
周礼包和月礼包均已确认没有免费领取项目,免费领奖流程跳过。
每日充值、累充豪礼需要自动领取已达成奖励:有红点时进入领取。每日充值内部有 **6 元档、25 元档** 两个页签,两档都可能存在奖励。充值相关流程优先级低,按用户要求以后有充值奖励时再完善;任务只领取已有奖励,不执行充值。
用户确认活动各页签均从**左下返回首页**。本次没有新增已实现脚本条目;页面结构与 4 项待实现任务已同步到 `workflows/page_map.json`,按钮模板和领取后状态仍需后续实机采集。
### 观影活动:规则已确认,等再次出现后完善
观影是不定期活动,一般出现后可以连续签到 **5 天**。进入后只有一个页面,点击**中间按钮**领取奖励,每天共 **5 次**。有免广告卡时直接领取,没有时自动看完广告后再领取,复用通用广告领奖策略。完成后点击**右上角关闭按钮**回到首页。
当前观影入口未出现(用户于 2026-10-05 确认)。用户要求等后续观影按钮再次出现后再完善这个自动化任务,地图已将其记录为待后续实现;本次不新增运行脚本,也不加入已实现脚本汇总。按钮模板、剩余次数、领完状态及广告返回流程届时采集。“一般连续签到5天”作为常见活动规律,不推定所有轮次的固定结束日期。
### 试炼:页面规则保留,暂不做自动化
当前首页左侧有试炼入口(用户于 2026-10-05 确认),内部按顺序有 **英雄试炼、特训、试炼任务** 三个页签。该活动不定期出现,各轮外观可能略有不同,执行时仍需识别当前入口及页面。
“试炼任务”内是任务列表,完成的任务会显示 **“领取”** 按钮。其中 **“每日登录游戏 1 次”** 奖励每天可领取一次;其他奖励只有完成对应任务后才可领取。用户最新确认列表**不需要滚动、不需要自动化**,这些规则仅作为页面说明保留。
试炼页面点击**底部箭头样式返回按钮**回到首页。三个页签及返回关系保留在地图中;英雄试炼和特训按用户要求暂缓,后续补充。“试炼任务奖励领取”已从待实现任务中移除,转入 `excluded_tasks` 记录当前不处理的决定,不继续追问它的执行细节。
### 祈愿:任务领奖与免费补给(规则已记录,待实现)
用户确认首页左侧**试炼下方、冲刺上方**的“祈愿”是不定期活动。进入后底部左下角为箭头返回按钮,右侧依次为 **祈愿、任务、礼包** 三个页签。点击左下箭头返回首页。
| 页签 | 已确认规则 | 待补充 |
| --- | --- | --- |
| 祈愿 | 用户确认本页不需要自动化 | 保留页签结构,暂不处理 |
| 任务 | 需上下滚动,点任务右侧“领取”;每日可领取登录奖励。领完显示“已完成”,该条目自动移到列表底部 | 列表边界、任务与领奖弹框的识别模板 |
| 礼包 | 顶部“免费”补给每天领取 1 次,无需广告,直接领取 | 免费补给领完状态、按钮与奖励弹框模板 |
地图保留三个页签节点及返回关系,“祈愿任务奖励领取”和“祈愿免费补给领取”两项任务仍待实现,未加入已实现脚本汇总。用户确认祈愿页签本身不需要自动化。
任务领取后列表会重排,因此执行设计需要每次领取后重新识别可领条目,再继续滚动,不能沿用原列表序号或原点击位置。以“已完成”及条目移到底部作为领奖后状态线索,具体模板和滚动终点仍需实机采集。
### 冲刺:轮换活动与免费领奖(规则已记录,待实现)
用户确认 **晶矿冲刺、招募冲刺、图腾冲刺** 三种活动轮流进行,**每期持续 7 天**;当前为晶矿冲刺。进入后显示冲刺列表,底部左下角为箭头返回按钮,点击回到首页。不同类型分别记录页签清单,不将尚未确认的页签当作共用入口。
| 活动 | 底部页签(从返回按钮右侧开始) | 已确认领奖规则 |
| --- | --- | --- |
| 晶矿冲刺 | 冲刺目标、冲刺排名、冲刺礼包、冲刺任务 | 礼包首项“免费”每日领一次,无需广告,领完“已售罄”;任务列表可上下滚动,可领时有“领取”,领完“已完成” |
| 招募冲刺 | 冲刺目标、冲刺排名、冲刺礼包、冲刺任务;切换页签时底部导航保持不变 | 从底部礼包页签进入,首项免费每日一次、无需广告,领完已售罄;任务列表可滚动领取、领完已完成;左侧返回直接回首页 |
| 图腾冲刺 | 等出现后确认 | 按用户要求后续活动出现时补充,不套用其他冲刺内部流程 |
冲刺面板**右下角“兑换商店”**按钮打开 **星珀商城弹框**。商城第一项金币**每周一刷新,整周可以免费领取一次**,领完显示 **“已售罄”**。弹框右上角有 **X 关闭按钮**,点击后回到冲刺面板,保留进入前的冲刺类型和页签。按钮图像模板与金币是否涉及广告尚未采集。
用户明确冲刺任务领完是否自动移到列表底部**待确认**。执行设计每次领取后重新识别可领条目,暂不依赖固定排序,也不将祈愿任务的重排行为视为冲刺已确认规则。
地图保留晶矿/招募每日免费礼包、晶矿/招募任务奖励、星珀商城免费金币共五项待实现任务。礼包仅领取首项免费项目,钻石兑换列表的其余项目未纳入当前任务。用户明确**冲刺目标、冲刺排名不需要自动化**,页签结构保留,图腾冲刺暂缓。新增任务未实现脚本,不加入底部脚本汇总。
### 寻宝:冒险任务与每期免费礼包(规则已记录,待实现)
寻宝入口位于首页左侧**冲刺下方**,用户确认当前存在。达到一定等级后出现,具体等级阈值尚未说明;每期约 **9~10 天**,一期结束后开始下一期。此处按最新说明记录为等级开放后的连续周期活动。
底部左下为箭头返回按钮,右侧依次为 **宝藏兑换、冒险任务、冒险礼包** 三个页签;点击左下箭头回到首页。
| 页签 | 已确认规则 | 待补充 |
| --- | --- | --- |
| 宝藏兑换 | 用户确认不需要自动化 | 保留页签结构,暂不处理 |
| 冒险任务 | 任务列表可上下滚动,可领奖励显示“领取”;领完显示“已完成”,条目排到列表下面 | 是否有每日刷新任务、列表边界和识别模板 |
| 冒险礼包 | 矿石兑换列表可上下滚动,其中一个“免费”项目**每期领一次,无需广告**;领完显示“已售罄”,并排到列表最底下 | 周期标识、按钮与领奖弹框模板 |
新增“寻宝冒险任务奖励”和“寻宝冒险免费礼包”两项待实现任务,尚未新增脚本或加入已实现脚本汇总。领取后列表会重排,应重新识别条目和按钮再继续滚动;免费礼包没有确认固定为第一项,不沿用冲刺礼包首项的位置规则。免费礼包按本期处理,周期更换后可再次领取,不记为每日奖励。
### 特惠战令一键领取(已实机验证)
2026-10-04 在当前账号实际执行并观察到完整流程:**首页 → 左侧特惠 → 赏金战令 → 一键领取 → 恭喜获得弹框 → 点击空白处关闭 → 一键领取按钮变灰、已领奖励出现绿色勾选 → 左下角返回 → 首页**。
@@ -154,9 +441,9 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
| 区域 | 入口 | 出现规律与用途 | 当前记录状态 |
| --- | --- | --- | --- |
| 右侧 | 任务 | 固定入口 | 已验证脚本:根据首页和日常/周常标签红点领取任务奖励并返回首页;滚动后隐藏任务的领取规则待继续确认 |
| 右侧 | 好友 | 固定入口 | 是否包含每日互动或免费奖励待查看 |
| 右侧 | 好友 | 固定入口 | 好友列表底部每日一键赠送一次,领取赠礼有红点时进入一键领取;弹框关闭规则已记录,脚本待实现 |
| 右侧 | 邮件 | 固定入口 | 已实现红点触发的一键领取与返回首页脚本;无红点时跳过 |
| 右侧 | 英雄集结 | 不定期出现的大活动,与金沙游记属于类似类型 | 剑来献礼积分奖励、骊珠画卷任务奖励已实现脚本;其他分活动待查看 |
| 右侧 | 英雄集结 | 不定期出现的大活动,与金沙游记属于类似类型 | 六个分活动已记录;剑来献礼、骊珠画卷已有脚本;岁岁平安、骊珠寻珍待实现;槐萌祈缘、剑守长城暂缓 |
| 右上方 | 小游戏、问题反馈、游戏圈、客服 | 用户明确暂时不用处理 | 暂不纳入本轮任务梳理 |
### 任务奖励:日常与周常(已实机验证)
@@ -171,12 +458,42 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
脚本先检查首页任务红点,没有红点时直接结束。进入后处理当前日常或周常面板中全部可见的“领取”按钮,每领取一次都确认奖励弹框并关闭。当前面板没有领取按钮时,脚本仅检查另一个标签自身右上角的红点;有红点才切换并继续领取,没有则关闭任务回到首页。单个面板的领取次数上限为 20 次,达到上限会停止,避免页面异常时重复点击。
### 英雄集结:剑来献礼积分奖励与骊珠画卷任务奖励
### 好友:每日赠送与赠礼领取(规则已记录,待实现)
首页右侧点击“好友”,打开好友列表弹框,底部有 **一键赠送、领取赠礼** 两个按钮。
1. **一键赠送**:每天登录后点击一次;此流程不以“领取赠礼”按钮是否有红点作为进入好友列表的条件。
2. **领取赠礼**:好友列表底部该按钮有红点时点击,打开“领取赠礼”子弹框,再点击 **一键领取**。
3. 领取后点击赠礼弹框外面,或点击其右上角 **X**,关闭赠礼弹框,回到好友列表。
4. 点击好友列表弹框外面,关闭列表,回到首页。
地图将好友列表与领取赠礼分别记录为两层 `overlay`,不能把关闭赠礼弹框当作已回到首页。本流程与领地狂鼠之家内的好友列表属于不同入口。
两个操作完成后,按钮均不变且仍可继续点击,不能用按钮变灰、改字或消失来判断完成。赠礼已领完时再点击,会提示 **暂无可收取的礼物**,表示当前没有奖励,不代表领取成功。
后续执行设计:一键赠送每日最多一次,按账号与游戏日记录执行结果,依据实际反馈确认完成;赠礼每次红点触发进入后点击一次一键领取,确认结果后关闭两层弹框,不因按钮仍可点击而重复领取,也不追加空点击验证成功。出现空奖励提示时停止并退出。执行记录与结果识别均待实现。
两项任务仍待实现,尚未新增脚本或加入已实现脚本汇总。结果反馈、弹框识别模板及赠送游戏日刷新时间待补齐。
### 英雄集结:已有领奖与新增签到、寻珍
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 次,最后关闭任务、骊珠画卷和英雄集结,返回首页。
新增入口 **槐萌祈缘、岁岁平安、骊珠寻珍、剑守长城**。槐萌祈缘、剑守长城先不处理;岁岁平安、骊珠寻珍规则来自用户说明,尚未采集模板或实现脚本。骊珠寻珍与骊珠画卷是不同活动,分别建节点。
| 分活动 | 用户确认流程 | 返回活动页 | 待确认或采集 |
| --- | --- | --- | --- |
| 岁岁平安 | 14天签到页;已签卡片显示对号,当前可签卡片左上方有“可领取”提示,点击提示左下方对应卡片 | 右上角关闭按钮回英雄集结 | 对号、卡片、提示及领奖结果模板 |
| 骊珠寻珍 | 入口有红点时进入,确认下方“跳过动画”已勾选;存在“免费”按钮时点击。之后左侧参与1次、右侧参与5次;按钮金币为活动专用抽奖次数,剩余≥5点参与5次,剩1~4点参与1次,直到0 | 左下返回箭头回英雄集结 | 活动金币余额、勾选状态、按钮与结果模板 |
岁岁平安复用签到流程,但可领取提示是定位线索,实际点击目标是对应卡片;已签对号条目跳过。不同活动的签到样式和完成标志分别配置,不把流沙赠礼的“已领取”文字直接套到这里。用户后续确认签到总天数为14天,纠正此前154天表述。
骊珠寻珍只在“跳过动画”未勾选时点击复选框,避免将已选状态取消。用户确认金币为活动专用金币,可理解为剩余抽奖次数:参与1次使用1次,参与5次使用5次。免费与每次参与后都需确认结果、重新读取剩余数,再选择下一次操作;不依赖首次读数连续点击,不点击补充资源的购买或兑换入口。当前只记录流程,页面模板与执行尚未实现。
新增“英雄集结岁岁平安签到”“英雄集结骊珠寻珍”两项待实现任务,未加入已实现脚本汇总。分活动返回英雄集结后,沿用现有关闭活动回首页的路径;该路径来源于现有工作流,本次未重新验证。
### 中间区域:小金猪与挂机奖励
用户确认:点击小金猪会打开奖励弹框,里面可以领取奖励。
@@ -239,21 +556,37 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
| 顺序 | 区域 | 截图可见内容 | 本阶段范围 |
| --- | --- | --- | --- |
| 1 | 英雄招募 | 英雄兑换、快速招募选项、插鼓招募、星愿招募;下方多个限时 UP 神灯许愿卡片,带倒计时与任务入口 | 已实现限时 UP 卡片中的神灯任务奖励和免费神灯领取;不执行任何招募 |
| 2 | 图腾寻宝 | 蓝色与橙色两类宝箱;每类有“寻宝1次”“寻宝10次”、概率入口和保底次数提示 | 保留为后续日常任务适配对象,具体操作与自动化方式待定 |
| 1 | 英雄招募 | 英雄兑换、快速招募选项、插鼓招募、星愿招募;下方多个限时 UP 神灯许愿卡片,带倒计时与任务入口 | 已实现神灯任务奖励和免费神灯领取;用户确认无其他日常领奖需求 |
| 2 | 图腾寻宝 | 蓝色与橙色两类宝箱;每类有“寻宝1次”“寻宝10次”、概率入口和保底次数提示 | 每张卡片每日领取一次免费奖励;无免广告卡需看视频,领完对应免费按钮消失;待实现 |
| 3 | 关卡礼包 | 关卡礼包卡片,显示奖励、限购次数与价格;截图示例为第40关礼包 | 用户明确暂不处理 |
| 4 | 每日商店 | 商品网格,显示商品名称、数量、金币或钻石价格、“已售罄”状态;底部有刷新倒计时和付费刷新按钮 | 保留为后续日常任务适配对象,具体购买或领取规则待定 |
| 4 | 每日商店 | 六张商品卡片,显示商品名称、数量、金币或钻石价格、“已售罄”状态;右下600金币刷新按钮 | 首格免费招募券每日一次,无广告,领完已售罄;刷新不再出现免费。金币购买招募券与刷新策略待完善 |
| 5 | 钻石 | 多档人民币充值商品,带钻石数量和赠送标记 | 用户明确暂不处理 |
| 6 | 金币 | 一袋金币、一箱金币、一车金币;有已售罄状态及钻石兑换价格 | 保留为后续日常任务适配对象,具体操作与自动化方式待定 |
| 6 | 金币 | 一袋金币、一箱金币、一车金币三张卡片 | 仅领取首张免费奖励,每日两次;第二次无免广告卡需视频、有卡直接领,全部领完已售罄;待实现 |
### 截图支持的状态与待确认事项
- **英雄招募**:截图有招募资源数量与单次或多次所需数量显示;限时 UP 卡片不止一个。后续需明确日常要执行哪种招募、次数、资源限制,以及卡片中的“任务”是否有独立奖励。
- **图腾寻宝**:两类宝箱的资源图标和保底提示不同。后续需明确是否执行寻宝、选择哪类宝箱、单次或十次及每日执行条件。
- **每日商店**:截图可见招募券、游侠碎片、骑士碎片、靴子锻造书、洗炼石、随机职业经验。部分商品已售罄;刷新按钮标注消耗 600 金币。后续需明确每天处理哪些商品,以及是否允许手动刷新。
- **金币**:截图中的“一袋金币”显示 500 金币且已售罄,不能据此认定它原本免费;“一箱金币”显示 10000 金币、价格 450 钻石,“一车金币”显示 30000 金币、价格 1200 钻石。具体日常目标与消耗规则后续由用户说明。
- **英雄招募**:限时UP卡片不止一个;已有神灯任务与免费神灯脚本,用户确认无其他日常领奖内容,不新增招募操作。
- **图腾寻宝**:两类宝箱资源和保底不同;仅处理每卡每日一次的免费按钮。免费领完按钮消失,不把寻宝1次、寻宝10次当作免费领奖入口。
- **每日商店**:六张商品卡片可出现各类锻造书、英雄碎片、随机职业经验书、宝锤、招募券等,物品随机且可能金币或钻石标价。首格免费券规则已确认;其他商品仅考虑金币售卖的招募券,购买与刷新策略待完善。
- **金币**:截图中的500金币、10000金币、30000金币以及450钻石、1200钻石均为当时示例。用户后续确认首张每日免费两次,其余两张兑换商品不属于当前免费任务范围。
以上数值仅为本次截图示例,不作为长期固定配置。“已售罄”可以作为后续状态识别线索,但具体每日重置与完成判定尚未验证。
截图中的奖励数量和兑换价格只作示例,不作为长期固定配置;右下600金币刷新成本由用户另行确认。免费领奖次数与领完标志已由用户说明,按钮、蒙版、领奖反馈和广告模板仍待采集。
### 商城免费领奖与商店刷新(用户确认,待实现)
| 栏目 | 次数与操作 | 广告规则 | 完成标志 |
| --- | --- | --- | --- |
| 图腾寻宝 | 两张卡片分别领取,每张每日一次 | 有免广告卡直接领,否则看完视频领取,引用共用广告策略 | 对应卡片免费按钮消失;仍需确认领奖反馈,不能只凭未找到按钮判成功 |
| 每日商店首格 | 每日一次免费招募券;刷新后不会再次出现免费券 | 不需要广告 | 已售罄 |
| 金币首张 | 每日免费两次 | 第一次直接领,第二次有免广告卡直接领,否则看完视频领取 | 两次领完已售罄 |
金币首张任务需结合当前免费/已售罄状态及本日执行结果判断剩余次数,不能每次进入都固定再点击两次。商城栏目处于同一个滚动页面,定位栏目不代表切换到另一个独立页面。
每日商店右下 **600刷新** 表示每次消耗 **600金币** 刷新六张卡片,可刷新多次。刷新次数用完时按钮出现 **黑色蒙版**;若点击会提示 **今日刷新次数已用完**。后续执行应识别蒙版后停止,不追加点击来验证次数已用完。刷新后不会再出现首格免费招募券,刷新不属于免费券任务。
金币购买招募券仅记录草案:只匹配 **招募券+金币标价**,其他物品和钻石标价跳过。每次购买数量、金币预算、刷新条件与每日刷新或支出限制尚未确定,用户明确规则待完善,购买和刷新均未实现。
新增三项免费待实现任务及一项延期完善的金币购券候选任务。共用广告运行模块尚未实现,未新增脚本或加入已实现脚本汇总。
### 英雄招募:限时 UP 神灯任务与免费神灯(已实机验证)
@@ -271,7 +604,7 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
### 本轮结论
本轮已实现英雄招募限时 UP 的神灯任务与免费神灯;**关卡礼包、钻石暂不处理;图腾寻宝、每日商店、金币如何自动化,后续再具体确定。** 页面归入日常打卡范围不代表其中所有按钮都需要执行,招募、寻宝、购买、兑换和刷新各自的规则仍待确认。
英雄招募神灯任务与免费神灯已有脚本,用户确认没有新增日常领奖内容。图腾寻宝、每日商店免费招募券和金币首卡三项免费流程规则已记录,执行与识别待实现;金币购券和刷新草案后续完善。关卡礼包、钻石继续暂不处理。
## 领地页面
@@ -282,21 +615,36 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
| 栏目 | 截图中的大致位置 | 自动化流程状态 |
| --- | --- | --- |
| 狂鼠之家 | 左侧中下部,矿洞建筑 | 一键收矿与优先罗盘一键雇佣已实机验证并有脚本;其他内部功能待补充 |
| 玩法大厅 | 下方偏左,带喇叭的建筑 | 星球矿场的排行榜奖励与扫荡已实机验证并有脚本;其他玩法待补充 |
| 图鉴 | 下方偏右,书本建筑 | 用户确认有固定流程,具体步骤待补充 |
| 玩法大厅 | 下方偏左,带喇叭的建筑 | 星球矿场已有脚本;新增遗迹夺宝每日扫荡规则,待实现 |
| 图鉴 | 下方偏右,书本建筑 | 用户最新确认暂不处理,内部流程与返回方式暂缓 |
| 食堂 | 中部,带食物的建筑 | 一键领取体力已实机验证并有脚本;其他内部功能待补充 |
| 排行榜 | 右侧中部,石制台座区域 | 用户确认有固定流程,具体步骤待补充 |
| 巅峰决斗 | 左上部,旗帜建筑 | 竞技场积分领取已实机验证并有脚本;巅峰决斗模式及其他内部功能待补充 |
| 合作模式 | 上方中部,紫色传送门区域 | 合作券领取已实机验证并有脚本;保卫宠物及其他内部功能待补充 |
| 城墙 | 右上部,城门建筑 | 用户确认有固定流程,具体步骤待补充 |
| 排行榜 | 右侧中部,石制台座区域 | 最新要求改为处理;入口红点时领取进度奖励最顶行宝锤,左下返回领地,待实现 |
| 巅峰决斗 | 左上部,旗帜建筑 | 竞技场积分已有脚本;选择巅峰决斗模式后右侧巅峰商店,优先级购买规则已记录,待实现 |
| 合作模式 | 上方中部,紫色传送门区域 | 合作券已有脚本;友情商店、保卫宠物领券与商店及挑战流程已记录,待实现 |
| 城墙 | 右上部,城门建筑 | 默认城墙,另有打造页签;每日免费机关与单独命令打造规则已记录,尚未实现 |
位置仅描述本次截图,不作为固定点击坐标。各栏目排列为地图布局,上表顺序沿用用户的说明,不代表执行顺序。
最新处理范围中,图鉴仍暂不处理。领地排行榜按本次新说明启用,覆盖此前暂缓要求;它与玩法大厅内星球矿场排行榜是不同入口和父页面,分别记录流程。
### 当前可见信息与待完善内容
截图中的巅峰决斗入口带“拥有”数量及决斗倒计时,合作模式入口带两种资源的“拥有”数量。这些是当前页面状态,资源含义、参与条件及重置规律尚未确认。
后续逐栏目补充日常目标、进入与返回路径、操作顺序、执行次数、奖励领取、资源消耗,以及已完成、条件不足等状态的识别方式。目前尚未确认任一栏目的内部按钮和完成标志,也未据此确定脚本或 AI 的具体实现方式。
已有脚本的步骤与验证结果见下文;其余栏目继续补充日常目标、进入与返回路径、操作顺序、执行次数、资源消耗,以及已完成、条件不足等状态的识别方式。新增城墙流程目前仅记录规则,尚未实现脚本。
### 城墙:免费机关与单独命令打造(用户确认,待实现)
城墙模块底部左侧返回按钮回到 **领地**,右侧两个页签依次为 **打造、城墙**,进入时默认显示 **城墙**。默认城墙页签内部功能暂未说明。
点击打造打开机关打造弹框,右上X关闭回城墙;城墙左下返回领地。顶部钻石和机关次数、打造1次/10次已见;免费按钮本轮未显示,出现后的领取逻辑沿用原规则。
| 任务 | 触发与执行规则 | 当前状态 |
| --- | --- | --- |
| 每日免费机关 | 每天先直接免费1次,其余无免广告卡需广告、有卡可直接免费,额外次数待确认;逐次确认奖励并重读状态,直到免费按钮消失,不固定总点击数 | 额外广告次数、免费与次数状态、广告和奖励模板待确认或采集 |
| 使用机关次数打造 | 仅响应单独命令,是否打造和执行次数由命令指定;可用机关次数≥10选打造10次,1~9选打造1次,0停止;每次确认结果、重新读机关次数与已完成量 | 命令次数计量与最后一批处理、机关次数及结果模板待完善 |
两项任务分别加入待实现任务。免费按钮消失后结束每日领取,不接着点打造1次或打造10次。命令打造标记 `trigger: explicit_user_command`、`scheduled: false`,不纳入每日调度;页面顶部钻石只记录为显示资源,使用机关次数打造不默认改用钻石。机关次数为0时停止,命令执行数量与最后一批的处理待具体实现时完善。
### 狂鼠之家:一键收矿与一键雇佣(已实机验证)
@@ -324,6 +672,18 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
对应脚本为项目根目录的 `claim_planet_mine.py`,配置在 `workflows/planet_mine.json`。排行榜入口有红点时才进入,脚本打开进度奖励并领取带红点的项目;星球矿场剩余次数非零且扫荡按钮可用时,依次打开扫荡弹框并点击“扫荡上一层”,每次确认奖励弹框后继续,最多两次。没有排行榜红点或扫荡按钮不可用时跳过相应部分,最后返回首页。macOS 已实机验证;Windows 仍需校准和验证。
### 玩法大厅:遗迹夺宝扫荡(用户确认,待实现)
从玩法大厅进入遗迹夺宝,每天第一次进入会出现提示弹框,关闭后点击下方 **扫荡**。若出现“国王势力过于强大,怪物不战而逃……”提示,点击 **确定**,然后点击左下返回按钮直接回到 **领地**。
新增遗迹夺宝扫荡任务,当前按一次扫荡记录,未要求循环扫荡至次数用完;首次提示关闭控件、扫荡次数与结果模板仍待采集。该任务不使用星球矿场的“扫荡上一层”弹框规则。
### 领地排行榜:进度奖励(用户确认,待实现)
领地直接入口的排行榜有红点时进入。页面底部有多个页签,默认停在 **排行榜**;其他页签名称和自动化范围未说明。点击下方 **进度奖励**,列表每行右侧有宝锤按钮,只点击 **最顶行右侧宝锤**,不遍历整列领取。
点击列表右上角关闭,回到排行榜;再点击排行榜页 **左下角** 返回领地。此流程是本次新增处理范围,覆盖此前“排行榜先不处理”,与星球矿场排行榜奖励独立。
### 食堂:一键领取体力(已实机验证)
2026-10-04 已在当前账号完成:**首页 → 领地 → 食堂 → 一键领取 → 确认奖励弹框 → 关闭弹框 → 关闭食堂 → 返回首页**。本次领取 30 体力,首页体力由 1042/80 变为 1072/80。领取后食堂显示烤肉库存 0/60,并出现下次领取倒计时。
@@ -348,6 +708,23 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
脚本只选择模式选择页左侧的“合作模式”,不会进入右侧“保卫宠物”。左上角显示“可领取”时才点击并等待奖励弹框;若已显示“已领完”,则跳过领取并依次退出到首页。可使用 `--dry-run` 只验证首页和执行计划,不点击游戏内容。macOS 已实机验证;Windows 仍需校准和验证。
### 合作与保卫宠物:商店、领券和挑战(用户确认,待实现)
合作模式入口先选择具体玩法,合作模式与保卫宠物分开记录。用户在后文称“保卫动物”,作为保卫宠物的别称保留。
| 新任务 | 入口与规则 | 频率或完成状态 |
| --- | --- | --- |
| 友情商店签到 | 选择合作模式,左上进入友情商店,领取第一张免费金币 | 每周一0点刷新,每周首次登录领取一次,领完已售罄 |
| 友情商店购买 | 读取顶部友情商店专用货币余额,足够商品价格时买洗练石1个、体力2个;星愿币买2个 | 洗练石与体力每日;星愿币每周首次进入 |
| 领保卫宠物券 | 选择保卫宠物,可能出现本周buff提示,点知道了关闭;左上可领取时点击 | 最新确认每天0点刷新、每日一次,覆盖之前每周一次说明;领完已领完 |
| 宠物商店签到 | 保卫宠物右侧商城,第一张免费金币 | 每周一0点刷新,每周首次登录领取一次,领完已售罄 |
| 宠物商店购买 | 读取顶部宠物商店专用货币,够3200时买红色随机宠物碎片;跳过黄色2400随机宠物碎片 | 余额够就买完当前可售数量;每次确认结果后重读余额与库存,余额不足或不可售时停止 |
| 保卫宠物挑战奖励 | 右侧上方挑战入口有红点时进入,每周、成就两个页签,哪个有红点就进入并点击领取 | 逐次确认结果、重新识别按钮;右上关闭回保卫宠物,是否需滚动及控件模板待补齐 |
两个商店的免费金币每周一0点刷新,每周首次登录领一次,免费是否涉及广告及模板尚未说明。两个商店各用自己的专用货币,顶部显示余额,购买条件为余额≥商品价格。友情商店按每日或每周目标记录已购数量,重复进入只补剩余目标;宠物商店红色碎片则按余额与可售数量持续购买,每次重新读取两者,直到余额不足3200或无可售商品。“洗练石”保留“洗炼石”别名;随机宠物碎片必须同时匹配红色和3200价格,黄色2400不购买。保卫宠物券以最新明确的每天0点刷新为准,覆盖之前每周领取的描述。
用户确认:友情商店点击右上角关闭回合作模式;宠物商店与挑战(含每周、成就页签)点击右上角关闭回保卫宠物;保卫宠物主页面点击左下角返回回到领地。地图已补齐对应返回关系,控件模板仍待采集。新增六项任务未实现;合作券仍沿用已有脚本。
### 巅峰决斗:竞技场积分领取(已实机验证)
2026-10-04 已在当前账号完成:**首页 → 领地 → 巅峰决斗 → 模式选择中的左侧“竞技场” → 左下角带时分秒进度条的积分累积区域 → 确认奖励弹框 → 返回领地 → 返回首页**。首次点击获得 3886 竞技积分;脚本随后完成一次实机回归,确认可自动关闭奖励弹框并返回首页。
@@ -360,6 +737,26 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
竞技积分会持续累积,该区域可领取时显示“恭喜获得”弹框。脚本确认竞技场页面后点击左下积分累积区域,必须识别奖励弹框才能继续关闭和返回;无法识别时安全停止。脚本只选择左侧“竞技场”,不会进入右侧“巅峰决斗”。可使用 `--dry-run` 只验证首页和执行计划,不点击游戏内容。macOS 已实机验证;Windows 仍需校准和验证。
### 竞技场:领取竞技券(待后续确认)
入口为领地 → 巅峰决斗 → 左侧竞技场。新增领取竞技券任务,与已有竞技积分脚本分别记录;竞技场内入口、领取条件、频率、次数、完成状态和返回步骤以后确认。当前不新增脚本,不加入已实现脚本汇总。
### 巅峰决斗:巅峰商店优先级购买(用户确认,待实现)
从领地巅峰决斗入口进入模式选择,选择 **巅峰决斗**,再点击页面右侧商店进入 **巅峰商店**。与左侧竞技场积分领取分别记录。
| 优先级 | 商品 | 购买规则 |
| --- | --- | --- |
| 1 | 随机藏品碎片 | 余额足以支付时,优先购买最大可售数量 |
| 2 | 洗练石(保留洗炼石别名) | 处理第一项后,用剩余余额购买最大可售数量 |
| 3 | 超凡宝锤 | 处理前两项后,用剩余余额购买最大可售数量 |
每次购买确认结果后重新读取余额、价格与库存。当前优先级无可售商品或无法支付时,再检查下一优先级;全部目标无库存或余额不足时结束。最大数量按商品可购买份数与余额共同决定,每份包含多少物品从当前卡片读取,不将购买份数当作固定碎片数。
巅峰商店使用自己的专用货币,余额显示在页面顶部。完成后点击右上角X关闭回巅峰决斗,主页面再点击左下角返回回到领地。
新增“巅峰商店优先级购买”待实现任务,按有可售商品且余额足够触发,不预设每日或每周固定额度。商品价格、库存、余额和购买结果及返回控件模板待采集;尚未新增脚本或加入已实现脚本汇总。
## 公会页面
### 入口与栏目
@@ -368,13 +765,13 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
| 栏目或入口 | 截图中的大致位置 | 自动化流程状态 |
| --- | --- | --- |
| 公会商城 | 左侧中下部,带蓝色钻石标志的建筑 | 用户确认有固定流程,具体步骤待补充 |
| 远征大厅 | 下方偏左,紫色传送门区域 | 用户确认有固定流程,具体步骤待补充 |
| 公会任务 | 左侧中部,卷轴建筑 | 用户确认有固定流程,具体步骤待补充 |
| 公会祝福 | 中部,蓝色球体建筑 | 用户确认有固定流程,具体步骤待补充 |
| 公会商城 | 左侧中下部,带蓝色钻石标志的建筑 | 贡献商城与龙鳞商城两页签,按各自顶部专用货币和购买优先级执行;右上关闭回公会,任务待实现 |
| 远征大厅 | 下方偏左,紫色传送门区域 | 迷宫寻宝暂缓;公会对决奖励红点进入任务领奖,关闭后左下回公会,任务待实现 |
| 公会任务 | 左侧中部,卷轴建筑 | 滚动点击右侧领取,已完成移末尾;领取上方红点进度宝箱,领完对号;右上关闭回公会,任务待实现 |
| 公会祝福 | 中部,蓝色球体建筑 | 升级按钮存在且有红点时点击一次,消耗材料、红点说明材料充足,完成后左下返回公会,任务待实现 |
| 每日捐献 | 右侧中部,发光的祭坛区域 | 免费捐献已实机验证并有脚本;付费捐献和次数规则待补充 |
| 成员大厅 | 右上部,高塔建筑 | 用户确认有固定流程,具体步骤待补充 |
| 公会 Boss | 左上部,巨龙区域;截图标签为“公会Boss” | 用户确认有固定流程,参与条件、次数及奖励步骤待补充 |
| 成员大厅 | 右上部,高塔建筑 | 用户最新明确不需要自动化,保留入口,内部规则不再确认 |
| 公会 Boss | 左上部,巨龙区域;截图标签为“公会Boss” | 周一三五日出现;财宝数字时全部领取,每日首次助威红点点击一次,左下回公会,两项任务待实现 |
| 右下角红珍珠祭坛 | 右下部,红色角色与紫色台座,附近显示倒计时和对话气泡 | 砍价已实机验证并有脚本;其他内部功能待补充 |
位置仅描述本次截图,不作为固定点击坐标。最后一项指场景内的红色珍珠祭坛入口,不是底部红色“返回”按钮。
@@ -397,6 +794,30 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
对应脚本为项目根目录的 `claim_guild_donation.py`,配置在 `workflows/guild_donation.json`。脚本只点击左侧免费按钮,不会点击右侧消耗钻石的捐献按钮;免费次数已经使用时识别灰色按钮,跳过捐献并返回首页。可使用 `--dry-run` 从首页只验证执行计划,不点击游戏内容。macOS 已实机验证;Windows 仍需校准和验证。
## 公会商城与公会任务(用户确认,待实现)
公会商城共用一个入口,包含贡献商城、龙鳞商城两个页签,默认页签待采集。两页签分别使用专用货币,余额在页面顶部显示;点击右上角关闭按钮返回公会。
- **贡献商店任务**:按 **合作券 → 黄金罗盘 → 白银罗盘** 的优先级购买。合作券每周一刷新,整周均可按余额补购,本周最多7个,卖光显示“已售罄”;合作券不可售或当前余额无法支付时,再买黄金罗盘每日最多2个,最后白银罗盘每日最多10个,各项按余额和剩余可售数量尽量购买。周一具体刷新时刻尚未确认;每次确认购买结果并重读余额、库存及本日/本周剩余额度。
- **龙鳞商店任务**:按随机职业龙晶、随机职业龙血的顺序,购买当前余额允许的最大可售数量。先处理高优先级商品,该项不可售或无法支付后再处理下一项,不预设每日或每周固定数量。
- **公会任务领奖**:任务列表可上下滚动,可领取行右侧为“领取”,未完成为“前往”,领过为“已完成”并移到列表末尾。只点击领取,每次确认结果后重新识别列表,跳过前往和已完成。
- **公会任务进度宝箱**:任务领奖后,上方进度条达到的小宝箱会出现红点,点击宝箱领奖,领完显示小对号。每次任务领取后及列表处理结束时重新检查红点宝箱,跳过已显示对号的宝箱。右上关闭公会任务回到公会。
购买后确认结果并重读余额、可售数量及本日/本周剩余额度,不能每次进入都重新购买完整限额。商品价格、库存、购买确认与结果、任务列表和宝箱状态模板尚未采集;上述三个任务仅加入待实现清单,不修改已有脚本汇总,也未实际购买或领奖。
## 远征大厅、公会祝福与公会Boss(用户确认,待实现)
远征大厅包含迷宫寻宝、公会对决。**迷宫寻宝先搁置**,仅保留入口,不继续补内部步骤。公会对决进入后,点击下方有红点的“奖励”,默认停留“任务奖励”页签:任务列表可上下滚动,可领取任务集中在上方,右侧显示“领取”;未完成显示“前往”,已领显示“已完成”并移到末尾。逐次领取后确认结果并重新识别列表,不点击前往。奖励右上角关闭回公会对决,再点击左下角返回直接回公会。奖励其他页签未说明,不扩大任务范围;远征大厅实际右上X关闭回公会,已观察。
**公会祝福升级**:升级消耗材料,红点表示材料充足。进入后只有“升级”按钮存在且按钮上有红点时,才点击升级一次;完成后点击左下角返回公会,不会自动返回。材料和升级结果识别模板待采集。
公会Boss每周一、三、五、日出现,任务仅在入口实际可用时处理,不通过日历推断页面一定存在。
- **领取公会boss奖励**:右侧“财宝”图标左上角有数字时打开财宝弹框,点击可用的“全部领取”;领取后按钮变成灰色“领取”,确认奖励结果并跳过灰色按钮。弹框右上角关闭回Boss页面,Boss左下角返回公会。数字的具体含义未知,不把数字当作点击次数。
- **公会助威**:当天首次进入可用的Boss页面,助威按钮有红点时点击一次,每天最多一次;之后可按本日记录跳过,不循环点击。用户确认点击后按钮变成“已助威”,不可重复点击,后续看到已助威直接跳过;完成状态识别和执行记录尚未实现。
新增四项待实现任务,迷宫寻宝只标记暂缓。页面标题及当前布局已采集,领取、升级与助威后的结果、灰色按钮等状态仍待验证;本次仅补规则,未实际升级、助威或领取奖励。
## 自动化方案的初步判断
以下为设计候选,需内部流程走查后确认。
@@ -404,23 +825,38 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
| 功能类型 | 候选实现方式 | 原因 |
| --- | --- | --- |
| 特惠、活动中的固定每日领奖 | 脚本组织流程,图像或文字识别确认每步状态 | 入口固定、步骤重复,可复用明确的操作和完成判定 |
| 观影、寻宝 | 先识别活动是否出现,再执行固定流程 | 活动不一定存在,但用户确认出现后的流程稳定 |
| 试炼、三类冲刺 | 共用流程,并为不同页面设置识别规则;必要时由 AI 辅助判断 | 基本逻辑一致,页面外观或活动条件会变化 |
| 金沙游记等左上角大活动、英雄集结 | 先识别活动名称与分活动,再逐项评估 | 活动名称、数量和内部结构可能变化,当前缺少完整流程 |
| 观影 | 活动再次出现后完善单页每日领取及广告流程 | 当前未出现,用户要求等后续出现再完善 |
| 寻宝 | 识别本期活动后滚动领取任务与每期免费礼包,领奖后重新识别列表 | 等级开放后连续换期,免费项目每期一次;两种列表领完都会重排 |
| 试炼 | 暂不做自动化 | 英雄试炼与特训后续补充,试炼任务由用户明确暂不自动化 |
| 祈愿 | 任务逐项领奖后重新识别列表;每日免费补给直接领取 | 次数、无广告及列表重排规则已确认,识别与执行待实现;祈愿页签本身不处理 |
| 冲刺 | 识别当前类型后处理礼包与任务领奖,并打开星珀商城领周奖励 | 四页签、商城弹框和返回规则已确认,模板待采集;目标排名不处理,图腾出现后补充 |
| 金沙游记 | 先处理签到、翻牌、来信三类流程;其余入口暂缓 | 六个入口及返回层级已记录,驿站密使名称和跳过状态已确认;三项任务待实现,模板待采集 |
| 英雄集结 | 已有剑来献礼与骊珠画卷任务,新增14天签到与按活动抽奖次数寻珍;另两入口暂缓 | 六个入口、签到天数和寻珍资源规则已记录,两项新流程待实现,模板待采集 |
| 小金猪挂机奖励 | 已验证脚本:金色领取按钮时领取、验证奖励弹框与灰色按钮、返回首页 | 领取频率和 Windows 适配待验证 |
| 小金猪快速扫荡 | 已验证脚本:单次或指定次数扫荡,每次确认并关闭奖励,间隔 2 秒,返回首页 | 每次消耗 10 体力;体力不足时的按钮状态和 Windows 适配待验证 |
| 好友、返利 | 暂不确定 | 尚未查看内部内容和日常规则 |
| 商城:英雄招募、图腾寻宝、每日商店、金币 | 后续确定 | 已记录区域结构,日常目标、执行次数、资源消耗与完成判定尚未明确 |
| 好友 | 每日一键赠送与红点触发赠礼领取,分别确认结果后关闭两层弹框 | 按钮操作后不变且可继续点;每日限次与空赠礼提示已记录,结果及弹框模板待采集 |
| 返利 | 暂不处理 | 用户确认入口不定期出现,目前排除;内部规则暂不确认 |
| 商城:英雄招募 | 沿用神灯任务与免费神灯脚本 | 用户确认没有新增日常领奖内容 |
| 商城:图腾寻宝、每日商店免费券、金币首卡 | 三项免费领奖任务待实现,按独立次数和广告分支处理 | 次数及免费消失/已售罄标志已确认,模板与执行待实现 |
| 商城:金币购买招募券与刷新 | 草案后续完善 | 仅考虑金币招募券;每次600金币刷新,次数用完黑色蒙版,预算和刷新策略尚未确定 |
| 商城:关卡礼包、钻石 | 暂不处理 | 用户明确排除 |
| 领地:狂鼠之家 | 已验证脚本:一键收矿、等待 10 秒、按白银/黄金/彩虹顺序一键雇佣、返回首页 | 当前仅覆盖该日常流程;其他内部功能、重置规律和 Windows 适配待验证 |
| 领地:食堂 | 已验证脚本:发现一键领取时领体力、确认奖励和库存清空、返回首页 | 当前仅覆盖体力领取;其他内部功能、重置规律和 Windows 适配待验证 |
| 领地:合作模式 | 已验证脚本:只选择左侧合作模式,发现左上可领取时领取合作券、确认已领完、返回首页 | 保卫宠物及其他内部功能、重置规律和 Windows 适配待验证 |
| 领地:巅峰决斗 | 已验证脚本:只选择左侧竞技场,领取左下积分累积区域的竞技积分、确认奖励后返回首页 | 右侧巅峰决斗及其他内部功能、重置规律和 Windows 适配待验证 |
| 领地:玩法大厅(星球矿场) | 已验证脚本:领取排行榜进度奖励,并将扫荡上一层执行至剩余次数为 0 | 其他玩法大厅项目、排行榜奖励刷新规律和 Windows 适配待验证 |
| 领地:图鉴、排行榜、城墙 | 待完善固定流程后确定 | 用户确认各栏目均有固定自动化流程,具体步骤、执行条件、消耗和完成判定尚未补充 |
| 领地:合作模式 | 合作券沿用已有脚本,新增友情商店签到购买规则 | 免费金币每周一0点刷新,洗练石体力每日、星愿币每周购买,顶部专用货币够价才买;商店右上关闭,任务待实现 |
| 领地:保卫宠物 | 新增每日0点刷新领券、每周一0点免费金币、红色3200碎片及挑战奖励 | 碎片余额够就买完可售数量;商店挑战右上关闭、主页左下回领地,模板与执行待完善 |
| 领地:巅峰决斗 | 竞技场积分沿用已有脚本,新增巅峰商店按藏品碎片、洗练石、超凡宝锤顺序购买 | 顶部专用货币按余额买最大可售数量,商店右上X关闭、主页左下回领地,新任务待实现 |
| 领地:玩法大厅 | 星球矿场已有脚本;遗迹夺宝每日首次提示关闭后扫荡,提示不战而逃点确定,左下回领地 | 遗迹夺宝任务待实现,其余项目后续补充 |
| 领地:排行榜 | 最新要求启用,入口红点时领取进度奖励最顶行宝锤,关闭后左下回领地 | 不同于星球矿场排行榜,模板待采集,任务待实现 |
| 领地:图鉴 | 暂不处理 | 用户确认暂缓,保留入口 |
| 领地:城墙 | 每日先免费一次再按广告分支领至免费消失;机关次数打造只响应独立命令 | 两页签、默认页、返回领地和≥10批量规则已确认;额外广告次数与模板待完善,两项任务待实现 |
| 公会:右下红珍珠祭坛 | 已验证脚本:砍价一次、确认奖励弹框、返回首页 | 砍价刷新规律、次数和 Windows 适配待验证 |
| 公会:每日捐献 | 已验证脚本:仅执行左侧免费捐献、确认奖励、返回首页 | 付费捐献、次数刷新规律和 Windows 适配待验证 |
| 公会:公会商城、远征大厅、公会任务、公会祝福、成员大厅、公会 Boss | 待完善固定流程后确定 | 用户确认各入口均有固定自动化流程,具体步骤、执行条件、消耗和完成判定尚未补充 |
| 公会:公会商城 | 贡献商城罗盘及合作券、龙鳞商城龙晶龙血按余额和限额购买 | 两个专用货币余额在顶部,统一右上关闭,模板与执行待实现 |
| 公会:公会任务 | 滚动逐项领取及进度宝箱领奖,领取后重新识别 | 已完成移到末尾,红点宝箱领取后对号,右上关闭回公会,任务待实现 |
| 公会:远征大厅 | 公会对决红点任务奖励滚动领取;迷宫寻宝暂缓 | 已完成重排,右上关闭奖励、左下回公会,任务待实现 |
| 公会:公会祝福 | 升级按钮有红点时点击一次 | 材料充足时有红点,左下返回公会,任务待实现 |
| 公会:公会 Boss | 财宝全部领取及每日一次助威 | 周一三五日出现,灰色领取跳过,左下回公会,两任务待实现 |
| 公会:成员大厅 | 不需要自动化 | 用户明确排除,保留页面入口 |
初步方向是让脚本执行已验证的重复步骤,让 AI 辅助识别变化页面或异常。是否每次调用 AI、调用到哪一步,待明确任务完成标志与变化范围后再决定。
@@ -439,6 +875,17 @@ summary: 记录首页、商城、领地和公会的日常任务入口、待完
下一阶段继续熟悉各入口内部流程和其他底部页面,补齐上述字段后再确定第一批自动化任务。
## 本轮页面核实与优化(2026-10-05至06)
当前地图134个节点、239条关系、17个已有脚本任务、49个待实现或延期任务;78个节点有识别模板,52个节点附本轮布局记录。新增只读任务分组预览,仍未接入统一导航执行。这里只核实布局、进入和关闭,未领取、购买、升级、打造或扫荡;已回到首页。
详细差异、未验证状态和按优先级的开发计划见 [页面核实与自动化优化计划](261006_0109-页面核实与自动化优化计划.md)。当前可用的原有路线与本轮结构记录分别保留,新关系不直接自动执行。
### 特惠战令:幸运星额外领取(后续完善)
战令一键领取后可能获得幸运星;幸运星需要再点击才能领取。此分支按用户要求后续完善,现有 claim_offer.py 尚未处理。具体出现界面、点击目标、领奖成功标志和关闭/返回流程待采集,不因一键领取按钮变灰就认定幸运星已领取。
## 已实现脚本汇总
按入口页面顺序排列。
@@ -0,0 +1,603 @@
---
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)。当前可用的原有路线与本轮结构记录分别保留,新关系不直接自动执行。
+330
View File
@@ -0,0 +1,330 @@
---
created_at: 2026-10-05 17:32:28 CST
type: 永远的蔚蓝星球页面入口、页签与领奖任务的树形总览
revision: 第38次
revisions:
- time: 2026-10-05 17:32:28 CST
version: 第1次
author: GPT-6
content: 依据程序页面地图生成覆盖 69 个节点的树形总览,并同步月礼包没有免费项目的用户确认。
- time: 2026-10-05 17:40:14 CST
version: 第2次
author: GPT-6
content: 补充每日充值6元和25元档,更新日礼包广告分支、充值奖励红点领取低优先级及活动左下返回规则。
- time: 2026-10-05 17:47:39 CST
version: 第3次
author: GPT-6
content: 确认返利不定期出现且暂不处理,内部奖励、条件和返回问题暂缓;特惠页签尚未列全,优先补齐。
- time: 2026-10-05 18:00:38 CST
version: 第4次
author: GPT-6
content: 补齐特惠六个底部页签及领奖规则,显示月卡周卡零点刷新、基金解锁关卡条件和两类战令第一列领奖,全部新增任务标为待实现。
- time: 2026-10-05 18:09:35 CST
version: 第5次
author: GPT-6
content: 显示基金1、2、3动态页签与已知关卡范围,补充月卡每天各一次和18元30元价格按钮,以及两类战令高亮可领对号已领规则。
- time: 2026-10-05 18:19:12 CST
version: 第6次
author: GPT-6
content: 补充周卡未购买也能签到与已领取标志,基金小锁头、已领对号及未达关卡灰色蒙版,并记录特惠全部页签左下箭头返回首页。
- time: 2026-10-05 18:24:13 CST
version: 第7次
author: GPT-6
content: 补充月卡领完显示续费18元或续费30元、两类战令没有一键领取且支持上下滚动逐项领取的规则。
- time: 2026-10-05 18:30:24 CST
version: 第8次
author: GPT-6
content: 补充观影一般连续签到5天、单页中间按钮每日5次及免广告卡分支、右上关闭规则,标记当前未出现且再次出现后完善。
- time: 2026-10-05 18:36:51 CST
version: 第9次
author: GPT-6
content: 补充试炼三个页签、每日登录任务奖励和其他任务完成后领取规则,记录底部箭头返回首页,英雄试炼与特训内部规则待补充。
- time: 2026-10-05 18:41:01 CST
version: 第10次
author: GPT-6
content: 暂缓英雄试炼和特训,标记试炼任务无需滚动且不需要自动化;新增祈愿不定期入口,位于试炼下方冲刺上方,内部规则待确认。
- time: 2026-10-05 18:46:22 CST
version: 第11次
author: GPT-6
content: 展示祈愿、任务、礼包三页签,补充任务右侧领取及每日登录奖励、礼包顶部免费补给和左下箭头返回,新增任务待实现。
- time: 2026-10-05 18:52:33 CST
version: 第12次
author: GPT-6
content: 补充祈愿任务需滚动、已完成条目移到底部、免费补给每日一次无需广告,并标记祈愿页签本身不需要自动化。
- time: 2026-10-05 19:06:16 CST
version: 第13次
author: GPT-6
content: 展示三类7天冲刺、晶矿与招募内部页签及星珀商城,记录每日免费礼包与任务领奖状态;招募礼包入口待确认,图腾冲刺后续补充。
- time: 2026-10-05 19:16:55 CST
version: 第14次
author: GPT-6
content: 确认招募冲刺四个底部页签及固定导航,目标排名不处理;星珀商城为弹框,周一刷新整周一次,右上X关闭回冲刺面板。
- time: 2026-10-05 19:20:31 CST
version: 第15次
author: GPT-6
content: 确认两类冲刺礼包每日一次无需广告、星珀金币领完已售罄,标记冲刺任务领后重排仍待确认。
- time: 2026-10-05 19:30:33 CST
version: 第16次
author: GPT-6
content: 补充寻宝等级开放后的9至10天连续周期、三个页签与左下返回,记录任务重排及免费礼包每期一次、领后已售罄排到底部。
- time: 2026-10-05 19:33:35 CST
version: 第17次
author: GPT-6
content: 标记宝藏兑换不自动化、冒险礼包每期免费领取一次无需广告,保留任务与礼包两项领奖流程待实现。
- time: 2026-10-05 19:39:44 CST
version: 第18次
author: GPT-6
content: 补充好友列表每日一键赠送、红点进入领取赠礼子弹框一键领取及两层关闭路径,两项任务待实现。
- time: 2026-10-05 19:47:09 CST
version: 第19次
author: GPT-6
content: 确认好友赠送和领取按钮操作后不变且仍可点击,记录空赠礼提示及待实现的每日限次和防重复领取规则。
- time: 2026-10-05 19:52:33 CST
version: 第20次
author: GPT-6
content: 将金沙游记等季节活动和英雄集结移到首页分支最末,位于挂机奖励之后,保留英雄集结的全部子页面。
- time: 2026-10-05 19:54:24 CST
version: 第21次
author: GPT-6
content: 将首页分支中的寻宝活动显示名称改为寻宝。
- time: 2026-10-05 19:55:02 CST
version: 第22次
author: GPT-6
content: 将首页分支中的金沙游记等季节活动显示名称改为金沙游记。
- time: 2026-10-05 20:09:15 CST
version: 第23次
author: GPT-6
content: 补齐金沙游记六个分活动及流沙赠礼两个页签,确认驿站密使名称及跳过已领取来信、法老遗珍跳过已翻牌并翻至剩余次数不足,三项任务待实现。
- time: 2026-10-05 20:17:23 CST
version: 第24次
author: GPT-6
content: 确认流沙赠礼领取后显示已领取;当前账号有免广告卡,法老遗珍无卡时的按钮样式和广告界面留待后续确认。
- time: 2026-10-05 20:28:58 CST
version: 第25次
author: GPT-6
content: 补齐英雄集结四个新入口,仅处理岁岁平安14天签到和骊珠寻珍;确认寻珍金币为活动抽奖次数,记录卡片定位、跳过动画、免费及按剩余次数参与,两项任务待实现。
- time: 2026-10-05 21:12:15 CST
version: 第26次
author: GPT-6
content: 确认英雄招募无新增日常内容,记录图腾两卡每日各一次免费、每日商店首格免费券无广告且刷新不再免费、金币首卡每日两次;金币购券与600刷新规则待完善。
- time: 2026-10-05 21:18:49 CST
version: 第27次
author: GPT-6
content: 将领地的图鉴与排行榜标记为暂不处理,保留入口节点,内部流程及返回方式暂缓确认。
- time: 2026-10-05 21:27:01 CST
version: 第28次
author: GPT-6
content: 城墙新增打造和城墙两个页签,默认城墙、左下返回领地;确认每日先免费一次再广告或免广告领取、额外次数待确认,达到10次可打造10次,仅按独立命令执行。
- time: 2026-10-05 21:57:28 CST
version: 第29次
author: GPT-6
content: 新增遗迹夺宝、领地排行榜、友情商店及保卫宠物商店挑战结构,补充八项任务;确认券每周一次、商店各自货币够价才买、仅买红色3200随机宠物碎片,额度与返回待确认。
- time: 2026-10-05 22:05:01 CST
version: 第30次
author: GPT-6
content: 补齐商店挑战右上关闭与宠物左下回领地,按最新说明将宠物券改为每天0点刷新;商店免费金币每周一0点刷新,红色3200碎片余额够就买完可售数量。
- time: 2026-10-05 22:14:33 CST
version: 第31次
author: GPT-6
content: 新增巅峰商店优先级购买任务,确认顶部专用货币余额、右上X关闭及主页左下回领地,按藏品碎片、洗练石、超凡宝锤顺序最大数量购买,任务未实现。
- time: 2026-10-05 22:31:15 CST
version: 第32次
author: GPT-6
content: 补充公会商城双页签购买优先级、公会任务列表重排和进度宝箱领奖,以及右上关闭回公会;确认顶部专用货币、罗盘每日2/10限额、合作券周一刷新整周最多7个及龙晶龙血按优先级买完。
- time: 2026-10-05 22:37:57 CST
version: 第33次
author: GPT-6
content: 确认贡献商城购买顺序为合作券、黄金罗盘、白银罗盘,保留每周7个及每日2/10个限额。
- time: 2026-10-05 22:49:51 CST
version: 第34次
author: GPT-6
content: 补充远征大厅、公会对决任务领奖、公会祝福材料升级及左下返回、公会Boss财宝和已助威完成状态;迷宫寻宝暂缓。
- time: 2026-10-05 22:54:16 CST
version: 第35次
author: GPT-6
content: 用户确认成员大厅不需要自动化,保留入口,排除内部流程确认与执行。
- time: 2026-10-06 01:09:48 CST
version: 第36次
author: GPT-6
content: 同步本轮页面核实差异与识别修正,增加只读任务预览和后续公共执行器开发顺序,保留未验证状态。
- time: 2026-10-06 01:13:31 CST
version: 第37次
author: GPT-6
content: 补充领地巅峰决斗竞技场领取竞技券任务,具体流程后续确认,暂不实现或纳入默认预览。
- time: 2026-10-06 01:14:17 CST
version: 第38次
author: GPT-6
content: 补充战令一键领取后可能出现幸运星,需额外点击领取,分支标记后续完善,未修改执行脚本。
summary: 树形展示134个节点,本轮记录实际冲刺卡片、特惠页签、机关打造弹框和共用商店来源,修正领地排行榜左下返回。统一执行尚未实现,已补只读任务分组预览。 新增领取竞技券,流程待确认。 战令幸运星额外点击领取分支待完善。
---
# 树形页面地图
这份文档用于快速查看页面层级;详细进入、返回、识别与执行边界见 [页面地图与导航规则](261005_1702-页面地图与导航规则.md),程序数据见 [page_map.json](../workflows/page_map.json)。
“主要页面已核对”表示已有主要页面实机识别和切换记录;“已有流程”表示从现有工作流整理,不代表本次逐页复测;“结构已记录”来自用户说明;“待确认”需要继续补充内部规则。
树中“特惠”和“任务”为方便查看添加的入口分组;神灯召唤归入英雄招募栏目。它们不改变程序地图中的导航路径。下列树覆盖程序地图全部 134 个节点,展示分组不额外计数。冲刺三类子节点表示活动类型;本轮列表同时显示晶矿展示期与招募进行期卡片,可从实际可见卡片进入。钻石基金按实际显示的动态页签遍历;100、200关的精确边界和260关以后的页签规则尚未确认。
```text
永远的蔚蓝星球
├── 首页【主要页面已核对】
│ ├── 特惠(入口分组;六个页签均需自动领奖;统一左下箭头返回首页)
│ │ ├── 超值月卡【进入返回已有流程;两项奖励每日各一次,00:00刷新;未购买18元/30元,领完“续费:18元/30元”,均跳过;领奖待实现】
│ │ ├── 战令(已有页面名:赏金战令)【已有流程;消耗体力产生奖励;脚本:战令领取;一键领取后可能获得幸运星,需再点击领取,此分支后续完善】
│ │ ├── 特权周卡(原称特惠周卡)【布局已核实;未购买也能签到;每日00:00刷新;签到后“已领取”;任务待实现】
│ │ ├── 钻石基金【结构已记录;遍历实际可见页签;解锁且达关卡时领最后一列钻石;锁头/已领对号/未达灰色蒙版跳过;任务待实现】
│ │ │ ├── 钻石基金 1【结构已记录;未到100关显示,后续已知范围保留】
│ │ │ ├── 钻石基金 2【结构已记录;超过100关、未到200关时新增】
│ │ │ └── 钻石基金 3【结构已记录;超过200关、未到260关时新增;后续未知】
│ │ ├── 遗迹战令【结构已记录;遗迹夺宝产生奖励;无一键领取,上下滚动逐项领第一列高亮且无对号图标;任务待实现】
│ │ └── 宠物战令【已核实布局,出现灰色一键领取;优先一键策略待确认,逐项领奖原规则保留;任务待实现】
│ ├── 活动【结构已记录;各页签左下返回首页】
│ │ ├── 超值礼包【结构已记录】
│ │ │ ├── 日礼包【布局已核实;上方体力免费带视频标志,下方金币普通免费;广告判定策略待确认;任务待实现】
│ │ │ ├── 周礼包【结构已记录;无免费项目,免费领奖时跳过】
│ │ │ └── 月礼包【结构已记录;月卡会员才可见;无免费项目,免费领奖时跳过】
│ │ ├── 每日特惠【结构已记录;1 个免费项目,每日领 2 次;第二次无免广告卡看广告;任务待实现】
│ │ ├── 每日充值【结构已记录;红点进入领取已达成奖励;低优先级,后续完善】
│ │ │ ├── 6 元档【结构已记录;可能有奖励】
│ │ │ └── 25 元档【结构已记录;可能有奖励】
│ │ └── 累充豪礼【标题已核实;红点进入领取;低优先级】
│ ├── 返利【不定期出现;暂不处理】
│ ├── 观影【不定期;一般连续签到5天;单页中间按钮每日5次,有免广告卡直接领否则看广告;右上关闭;当前未出现,再次出现后完善】
│ ├── 试炼【不定期;当前存在(用户确认);底部箭头返回首页;暂不做自动化】
│ │ ├── 英雄试炼【结构已记录;暂不处理,后续补充】
│ │ ├── 特训【结构已记录;暂不处理,后续补充】
│ │ └── 试炼任务【规则已记录;列表无需滚动;不需要自动化】
│ ├── 祈愿活动【不定期;试炼下方、冲刺上方;底部左下箭头返回首页】
│ │ ├── 祈愿【结构已记录;本页不需要自动化】
│ │ ├── 任务【结构已记录;需滚动,点右侧“领取”;领后“已完成”并移到底部;每日可领登录奖励;任务待实现】
│ │ └── 礼包【免费补给每日1次,无需广告;已售罄条目可能排到付费项目后,按状态寻找;任务待实现】
│ ├── 冲刺【限时冲刺列表弹框,晶矿展示期与招募进行期卡片同时可见;列表右上X关闭,各活动页左下返回首页】
│ │ ├── 晶矿冲刺【本轮卡片为展示期,内部页签未复测】
│ │ │ ├── 冲刺目标【结构已记录;不需要自动化】
│ │ │ ├── 冲刺排名【结构已记录;不需要自动化】
│ │ │ ├── 冲刺礼包【结构已记录;首项免费每日1次,无需广告;领完已售罄;任务待实现】
│ │ │ └── 冲刺任务【结构已记录;可滚动,领后已完成;是否重排待确认;任务待实现】
│ │ ├── 招募冲刺【结构已记录;四个底部页签,切换时导航不变;左侧返回首页】
│ │ │ ├── 冲刺目标【结构已记录;不需要自动化】
│ │ │ ├── 冲刺排名【结构已记录;不需要自动化】
│ │ │ ├── 冲刺礼包【底部页签已确认;首项免费每日1次,无需广告;领完已售罄;任务待实现】
│ │ │ └── 冲刺任务【结构已记录;可滚动,领后已完成;是否重排待确认;任务待实现】
│ │ ├── 图腾冲刺【轮换类型已记录;等出现后确认内部流程】
│ │ └── 星珀商城(兑换商店弹框)【结构已记录;周一刷新,整周首项免费金币1次;领后已售罄;右上X关闭回冲刺;任务待实现】
│ ├── 寻宝【冲刺下方;等级开放后每期约9~10天连续换期;当前有入口;左下箭头返回首页】
│ │ ├── 宝藏兑换【结构已记录;不需要自动化】
│ │ ├── 冒险任务【结构已记录;可滚动,领取后已完成并排到下面;任务待实现】
│ │ └── 冒险礼包【结构已记录;可滚动,每期直接领1次免费项目,无需广告;领后已售罄并排到最底下;任务待实现】
│ ├── 任务(入口分组)
│ │ ├── 日常任务【已有流程;脚本:任务奖励】
│ │ └── 周常任务【已有流程】
│ ├── 好友列表【弹框;底部每日一键赠送1次,按钮操作后不变且可继续点;赠送任务待实现;点弹框外关闭回首页】
│ │ └── 领取赠礼【子弹框;有红点时进入并一键领取,领取后按钮不变且可继续点,不重复点击;空提示:暂无可收取的礼物;点子弹框外或右上X关闭回好友列表;任务待实现】
│ ├── 邮件【已有流程;脚本:收取邮件】
│ ├── 挂机奖励【已有流程;脚本:挂机奖励、快速扫荡】
│ ├── 金沙游记【季节活动;六个分活动已记录;左下箭头返回首页】
│ │ ├── 金顶夺宝【入口已记录;暂不处理】
│ │ ├── 驿站密使【来信弹框;入口红点时进入,可滚动;点未领取来信,跳过已领取;点弹框外或右上X回金沙游记;任务待实现】
│ │ ├── 圣迹漫游【入口已记录;暂不处理】
│ │ ├── 法老遗珍【通常每日3张,无卡直接1张、广告2张,有卡直接3张;优先第一排,跳过显示奖励的已翻牌,点“点我翻牌”;当前有免广告卡,首翻后显示“免费”,无卡界面后续确认;至“剩余次数不足”停止;左下回金沙游记;任务待实现】
│ │ ├── 流沙赠礼【每日签到;游戏按进度自动选页签;识别当天节点“可领取”,位置随天数变化,领完变“已领取”;左下箭头回金沙游记;任务待实现】
│ │ │ ├── 15天【结构已记录;按当前节点领取】
│ │ │ └── 23天【结构已记录;例如第20天游戏自动选此页签】
│ │ └── 驼铃补给【入口已记录;暂不处理】
│ └── 英雄集结【已有流程】
│ ├── 剑来献礼【已有流程;脚本:剑来积分奖励】
│ ├── 骊珠画卷【已有流程】
│ │ └── 骊珠画卷任务【已有流程;脚本:骊珠任务奖励】
│ ├── 槐萌祈缘【入口已记录;暂不处理】
│ ├── 岁岁平安【14天签到;已签卡片有对号;可领取提示在卡片左上方,点提示左下方对应卡片;右上关闭回英雄集结;任务待实现】
│ ├── 骊珠寻珍【红点进入;确认跳过动画已勾选,见免费则领取;活动金币代表抽奖次数,剩余≥5参与5次,1~4参与1次,逐次重读至0;左下箭头回英雄集结;任务待实现】
│ └── 剑守长城【入口已记录;暂不处理】
├── 商城【主要页面已核对】
│ ├── 英雄招募【结构已记录;除已有神灯流程外,无其他日常领奖需求】
│ │ └── 神灯召唤【已有流程;脚本:英雄招募签到;英雄招募内限时 UP 卡片的任务入口】
│ ├── 图腾寻宝【两张卡片每日各免费1次;有免广告卡直接领,否则看视频;领完对应免费按钮消失;任务待实现】
│ ├── 关卡礼包【结构已记录;暂不处理】
│ ├── 每日商店【6张卡片;首格免费招募券每日1次,无广告,领完已售罄,刷新不再免费;只考虑金币招募券,购买和600金币刷新策略待完善;刷新用完有黑色蒙版;任务待实现】
│ ├── 钻石【结构已记录;暂不处理】
│ └── 金币【3张卡片;首张每日免费2次,第一次直接领,第二次无免广告卡看视频、有卡直接领;全部领完已售罄;任务待实现】
├── 英雄【主要页面已核对】
│ ├── 英雄详情【待确认】
│ └── 宠物【待确认】
├── 国王【主要页面已核对】
│ └── 国王其他页签与功能【待确认;武器、披风、皮肤、城墙、藏品、图腾、材料等】
├── 领地【主要页面已核对】
│ ├── 狂鼠之家【已有流程;脚本:收矿与雇佣】
│ │ ├── 狂鼠之家好友列表【已有流程】
│ │ │ └── 好友矿场【已有流程;脚本:喂养狂鼠】
│ │ └── 一键雇佣弹框【已有流程】
│ ├── 玩法大厅【已有流程】
│ │ ├── 星球矿场【已有流程;脚本:星球矿场金币】
│ │ │ ├── 星球矿场排行榜【已有流程】
│ │ │ │ └── 星球矿场进度奖励【已有流程】
│ │ │ └── 星球矿场扫荡弹框【已有流程】
│ │ └── 遗迹夺宝【每日首次提示关闭后点扫荡;出现不战而逃提示点确定;左下直接返回领地;任务待实现】
│ │ ├── 遗迹夺宝首次提示【弹框;关闭后继续,关闭控件待采集】
│ │ └── 怪物不战而逃提示【弹框;点击确定回遗迹夺宝】
│ ├── 图鉴【入口保留;暂不处理】
│ ├── 食堂【已有流程;脚本:领取体力】
│ ├── 排行榜【最新范围改为处理;领地入口红点时进入,默认排行榜页签;左下返回领地;任务待实现】
│ │ └── 排行榜页签【默认页签;下方进度奖励入口】
│ │ └── 领地排行榜进度奖励【弹框;只点最顶行右侧宝锤;右上关闭回排行榜】
│ ├── 巅峰决斗模式选择【已有流程】
│ │ ├── 竞技场【已有流程;脚本:竞技积分;新增领取竞技券任务,流程后续确认,暂不实现】
│ │ └── 巅峰决斗【选择该模式;右侧巅峰商店;左下返回领地】
│ │ └── 巅峰商店【随机藏品碎片→洗练石→超凡宝锤;顶部专用货币够价时买每项最大可售数量,逐次重读余额和库存;右上X关闭回巅峰决斗;任务待实现】
│ ├── 合作模式选择【已有流程】
│ │ ├── 合作模式【已有流程;脚本:合作券】
│ │ │ └── 友情商店【左上入口;首格免费金币每周一0点刷新,每周首次登录领1次,领完已售罄;每日买洗练石1个、体力2个,每周首次进入买星愿币2个,顶部专用货币够价才买;右上关闭回打开来源;也能从保卫宠物商城页签切入,需保留来源;签到购买任务待实现】
│ │ └── 保卫宠物【别称保卫动物;左上领券每天0点刷新,每日1次,领完已领完;左下返回领地;任务待实现】
│ │ ├── 本周buff提示【存在时点知道了关闭】
│ │ ├── 宠物商店【右侧商城入口;首格免费金币每周一0点刷新,每周首次登录领1次,领完已售罄;红色随机宠物碎片3200余额够就买完可售数量,跳过黄色2400;右上关闭回保卫宠物;签到购买任务待实现】
│ │ └── 挑战【右上红点时进入;只处理有红点页签的领取按钮;右上关闭回保卫宠物;任务待实现】
│ │ ├── 每周【页签有红点时进入领取】
│ │ └── 成就【页签有红点时进入领取】
│ └── 城墙【默认城墙页签;底部左侧返回领地;右侧打造、城墙两页签】
│ ├── 打造(机关打造)【实机为弹框,右上X关闭回城墙;每日先免费1次,其余无免广告卡看广告、有卡直接免费,额外次数待确认,领至免费消失;使用机关次数打造仅按单独命令,≥10选10次、1~9选1次、0停止;任务待实现】
│ └── 城墙【默认页签;内部功能后续补充】
├── 公会【主要页面已核对】
│ ├── 公会商城【共用入口;贡献商城、龙鳞商城两个页签;顶部各自专用货币余额;右上关闭回公会】
│ │ ├── 贡献商城【合作券→黄金罗盘→白银罗盘;合作券周一刷新整周最多7个,黄金每日最多2个、白银每日最多10个,按余额和剩余库存尽量买,卖光已售罄;贡献商店任务待实现】
│ │ └── 龙鳞商城【随机职业龙晶→随机职业龙血,按余额买最大可售数量;龙鳞商店任务待实现】
│ ├── 远征大厅【实机为弹框,右上X关闭回公会;迷宫寻宝、公会对决两个入口】
│ │ ├── 迷宫寻宝【先搁置】
│ │ └── 公会对决【下方奖励有红点时进入;左下直接回公会】
│ │ └── 公会对决奖励【默认任务奖励;右上关闭回公会对决】
│ │ └── 任务奖励【可滚动;领取集中上方,跳过前往;已完成移末尾,逐次重读;任务待实现】
│ ├── 公会任务【列表可滚动;点右侧领取,跳过前往和已完成;领取后已完成移到末尾;上方进度宝箱有红点时点击,领完显示对号;右上关闭回公会;任务待实现】
│ ├── 公会祝福【升级消耗材料,红点表示材料充足;升级按钮有红点时点一次;左下返回公会;任务待实现】
│ ├── 每日捐献弹框【已有流程;脚本:每日免费捐献】
│ ├── 成员大厅【不需要自动化;保留入口】
│ ├── 公会 Boss【周一三五日出现;当日首次进入助威红点点一次,领完已助威且不可重复;右侧财宝左上有数字时进入;左下回公会;两项任务待实现】
│ │ └── 公会Boss财宝【全部领取后灰色领取,灰色跳过;右上关闭回Boss】
│ └── 红珍珠祭坛【已有流程;脚本:公会砍价】
└── 通用恭喜获得展示【已有流程;父页面由任务历史确定】
```
## 通用领奖规则
- 按钮右上角红点表示内部有奖励可以领取,进入后仍需确认具体按钮和结果。
- 已配置任务有免广告卡时直接领取;没有时自动看完广告后领取。共用广告模块尚未实现。
- 活动日礼包:每日领取两个免费项目,原行序与本轮视频标志排列不同,广告判定待确认;每日特惠:同一个免费项目每日领两次,第二次走同样的广告分支。
- 每日充值含6元和25元档,和累充奖励一样按红点进入领取;这些任务低优先级,未来有充值奖励时再完善。活动各页签均左下返回首页。
- 活动周礼包、月礼包:没有免费项目,免费领奖流程跳过。月礼包另需月卡会员才可见。
- 商城关卡礼包和钻石栏目按用户要求暂不处理。
- 公会互助为跨页面任务:任意一级页面底部公会按钮上方出现握手入口时执行,树中不另建同名页面。
- 季节活动的签到、翻牌和来信领取可分别复用流程;各活动配置自己的页面样式、状态标志和返回控件。当前只记录设计,尚未实现共用执行模块。
## 后续确认方式
按首页、商城、领地、公会的顺序补充。同一页面内的相关问题合并询问,已确认规则不重复提问。每次答复同步到程序地图和详细文档;涉及树中结构或规则标记时也更新本树。
当前尚未接入自动导航和统一调度;现有任务脚本仍沿用原启动页面要求。
## 本轮页面核实与优化(2026-10-05至06)
当前地图134个节点、239条关系、17个已有脚本任务、49个待实现或延期任务;78个节点有识别模板,52个节点附本轮布局记录。新增只读任务分组预览,仍未接入统一导航执行。这里只核实布局、进入和关闭,未领取、购买、升级、打造或扫荡;已回到首页。
详细差异、未验证状态和按优先级的开发计划见 [页面核实与自动化优化计划](261006_0109-页面核实与自动化优化计划.md)。当前可用的原有路线与本轮结构记录分别保留,新关系不直接自动执行。
@@ -0,0 +1,119 @@
---
created_at: 2026-10-06 01:09:48 CST
type: 永远的蔚蓝星球页面实机核实、识别修正与自动化开发顺序
revision: 第3次
revisions:
- time: 2026-10-06 01:09:48 CST
version: 第1次
author: GPT-6
content: 汇总只读巡视差异,记录识别与任务预览优化,安排公共导航、领奖、广告、购买和双平台验证顺序。
- time: 2026-10-06 01:13:31 CST
version: 第2次
author: GPT-6
content: 补充领地巅峰决斗竞技场领取竞技券任务,具体流程后续确认,暂不实现或纳入默认预览。
- time: 2026-10-06 01:14:17 CST
version: 第3次
author: GPT-6
content: 补充战令一键领取后可能出现幸运星,需额外点击领取,分支标记后续完善,未修改执行脚本。
summary: 当前可见关键页面已导航和截图核实并返回首页,修正弹框、返回位置、冲刺卡片和任务页误识别;新增只读分组预览,尚未接入统一执行调度,奖励和购买结果待实测。 新增领取竞技券,流程待确认。 战令幸运星额外点击领取分支待完善。
---
# 页面核实与自动化优化计划
本轮根据补充说明巡视了当前可见的首页活动、商城栏目、领地玩法和公会页面。只执行进入、切换页签、滚动和关闭,未领取奖励、购买、升级、打造或扫荡;最后确认回到首页。旧脚本过去的实测记录保留,本轮没有重新执行全部17个任务。
地图现有134个节点、239条关系、17个已实现任务、49个待实现或延期任务。78个节点有识别模板;52个节点附有本轮布局记录。节点包含页签和滚动栏目,这些数量不表示已经实现78项自动化。64条原有验证关系仍可用于只读路线规划;本轮新增关系暂为结构记录,不直接交给鼠标执行。
## 核实结果与修正
| 页面 | 本轮实际观察 | 已调整的设计 |
| --- | --- | --- |
| 首页左侧入口 | 图标列表可滚动,显示位置随当前活动数量变化;下方金猪还可能覆盖附近点击区域 | 每次定位入口文字/图标和可见区域,不沿用首页固定坐标 |
| 特惠 | 当前周卡实际名称为特权周卡;横向导航可滚动,入口保留上次页签;月卡当前显示18元、30元 | 保留旧名称别名;实际识别选中页签。价格按钮跳过,不能当作可领奖 |
| 宠物战令 | 实际存在一键领取,本次灰色 | 已记录该按钮存在;是否优先一键领取等待用户确认,尚未点击 |
| 活动日礼包 | 上方体力免费按钮带视频标志,下方金币免费按钮没有视频标志,与此前按第一、第二项描述不同 | 已记录实际排列;广告判定策略等待用户确认,不把行号当作永久规则 |
| 活动、祈愿、寻宝 | 活动实际名称为累充豪礼;祈愿补给已售罄项目排在付费项目后;寻宝冒险福利礼按钮写领取,未显示价格 | 按物品、免费资格、状态和价格联合定位,不仅搜索免费文字,不固定首行 |
| 冲刺 | 限时冲刺先打开列表弹框,晶矿展示期和招募进行期卡片同时出现;本轮进入招募,四个底部页签均存在 | 先定位活动实例与状态,再进入卡片。目标和排名继续排除;招募页左下直接回首页 |
| 星珀商城 | 实际标题星珀兑换,从冲刺列表右下进入,右上关闭回列表 | 保留旧称,记录打开来源,不凭逻辑父级猜返回页 |
| 城墙 | 默认城墙页;点击打造打开机关打造弹框,本次没有免费按钮 | 打造弹框右上关闭回城墙,再左下返回领地;无免费时跳过,不自动使用机关次数 |
| 领地排行榜 | 默认主线榜,另有竞技榜、合作榜、金币榜;返回按钮在左下 | 修正原右下返回说明;进度奖励弹框与星球矿场同外观,靠已确认的进入来源区分 |
| 合作模式/巅峰决斗选择 | 两个弹框都写模式选择,仅标题不够区分 | 加入合作模式/竞技场卡片文字作为不同的识别证据 |
| 保卫宠物挑战 | 每周挑战标题曾误匹配为首页周常任务;成就页还显示顶部进度宝箱 | 首页任务增加选中的日常/周常导航标志。顶部宝箱是否纳入领取范围仍待确认 |
| 友情商店 | 可以从合作模式打开,也能从保卫宠物商城的友情商店页签进入;关闭回原玩法 | 复用同一商店节点,保留主页面来源,避免固定返回合作模式 |
| 公会商城 | 实际页签贡献商店、龙鳞商店,使用各自顶部余额;商品每份产出与可购买份数不同 | 先读价格、剩余份数和每份产出,再按优先级购买。截图中的数量只作为样例 |
| 远征、公会对决、Boss | 远征大厅为弹框,右上关闭回公会;对决奖励另有胜负奖励页签;Boss财宝弹框叫击杀宝箱 | 补齐返回关系;只处理已要求的任务奖励和全部领取,不扩展其他页签、升级上限 |
| 公会祝福 | 底部有升级操作按钮,底部导航也有升级页签 | 区分操作按钮与页签,材料和操作结果另行验证 |
商城仍是一张长滚动页面,进入后可能停在之前滚动的位置。英雄招募、图腾寻宝、每日商店和金币应由栏目定位器负责;不能把同屏两栏都显示理解为两个独立页面。图腾两卡的免费按钮带视频图标,每日商店首格免费招募券、600金币刷新及金币首张免费入口均已看到,本轮没有领取或刷新。
## 本次已经完成的程序优化
- 页面识别支持更具体页签覆盖其容器、弹框内页签优先于后方主页面;对无关页面的多个匹配仍返回歧义。
- 外观相同的进度奖励弹框只有在确认进入来源后才区分。仅有上一页猜测,或未知来源,不能消除无关页面的歧义。
- 补充当前活动标题、选中页签和稳定标签模板;避免使用动画、临时通知作为唯一识别证据。
- 新增只读地图核查和按入口分组的任务预览。检查重复ID、缺失父节点/模板/脚本、循环层级、任务落入禁用分支;展示尚未实现的执行器、缺失识别和资源规则。
- 保留17个既有脚本。预览明确标注它们自行从首页导航;迁移完成前,不能先把它们送到子页再调用。
配置和入口:`workflows/page_map.json`、`automation/pages.py`、`automation/planning.py`、`inspect_page.py`、`plan_tasks.py`。
```bash
# 只核查配置,不截图、不点鼠标
.venv/bin/python plan_tasks.py --audit
# 按首页、商城、领地、公会分组列出任务及缺口
.venv/bin/python plan_tasks.py
.venv/bin/python plan_tasks.py --page guild
# 仅查看延期或按命令执行的任务,不执行这些任务
.venv/bin/python plan_tasks.py --include-deferred --include-manual
# 已保存截图的页面识别;相同弹框需要已经确认的进入来源
.venv/bin/python inspect_page.py --image local/page_audit/territory_rank_progress.png --previous-page territory.rank.board
```
默认预览中的任务是开发清单,不是每日一键执行清单。列表中待实现任务即使已有页面模板,也不能实际领奖。
## 后续开发顺序与验收
| 优先级 | 工作 | 验收标准 |
| --- | --- | --- |
| P0 | 公共导航:页面确认、入口/返回定位、来源历史、动态活动实例、弹框关闭 | 从已知页正确进入和返回;未知、遮挡或窗口移动时停止;相同弹框与商店不返回错误主页面 |
| P1 | 公共任务执行器:滚动领取列表、免费商品、签到、图标奖励列表 | 每次操作后重新识别,适应已领项重排;只点可领目标;确认奖励或完成状态;列表边界和无进展时结束 |
| P1首批 | 祈愿任务与免费补给、招募冲刺礼包和任务、寻宝任务和免费礼包、公会任务与对决任务奖励 | 同一入口集中处理,逐项测试可领取、已领完、无红点分支;不处理前往、付费兑换及排除的页签 |
| P2 | 共用广告流程和日/周/活动期记录 | 有免广告卡直接领;无卡等待视频真实结束并正确返回;失败不能记为成功,重启不重复赠送或领奖 |
| P3 | 专用货币购买执行器,再接祝福升级 | 区分余额、价格、购买份数和每份产出;确认购买结果并重读库存和余额;不足不买,按已确认优先级执行 |
| P4 | 季节活动适配与补齐未出现状态,然后独立程序设置和打包 | 活动实例更换后次数记录正确;Mac与Windows分别完成窗口、缩放、输入实测;模型Key在设置中填写 |
P0完成后,先把一个已验证脚本拆成本页任务并接入导航,确认行为相同,再迁移其余脚本。列表、免费和签到做成共用执行器,各任务配置入口、状态、次数和返回方式,避免为49个新任务分别复制一套点击逻辑。
调度按首页→商城→领地→公会分组。同一入口的页签连做,例如特惠六页、公会商城两页;同一商店免费和购买分成两个任务,但共用一次进入。奖励、购买、扫荡和独立打造分别记录;手动扫荡和机关打造只响应命令。
购买规则继续按已确认内容执行:贡献商店合作券→黄金罗盘→白银罗盘,最多7份/周、2份/日、10份/日;龙鳞商店龙晶→龙血;巅峰商店藏品碎片→洗炼石→超凡宝锤;宠物商店只买红色3200随机宠物碎片。友情商店每日洗炼石1份、体力2份,每周星愿币2份。所有限额从剩余库存和记录补差,不能每次进来从头购买。
现有收矿后10秒、快速扫荡之间2秒属于用户指定规则,保留。其他页面等待改为轮询确认状态并设置超时,减少不必要固定等待;一次截图用于本次页面的多个检测,点击改变状态后重新截图。
当前采用本地截图和OpenCV模板识别,没有调用AI图片解析或模型API。后续可加入本地文字识别读取商品价格、余额和剩余次数;AI仅用于未知活动或样式变化的辅助分析,常规固定流程仍由已验证规则执行。
## 验证记录
- 46项自动化测试通过;补充任务分组错误检测后,5项规划测试再次通过。测试不操作游戏。
- 51张本轮保存截图回放全部匹配预期页面,包括弹框、页签和商城滚动状态。外观相同的进度奖励另由来源历史测试验证,缺失来源时保留歧义。
- 地图结构核查通过,无重复ID、缺失模板/脚本、循环层级或禁用分支任务;默认只读预览包含59项任务、30个入口分组,另7项延期或命令任务排除。
- 差异格式检查通过。完整截图回放结果保存在忽略版本管理的 local/page_audit/replay_result.json。
- 这些结果证明当前样式下的识别和配置一致性;本轮新任务的领奖、购买、广告实际执行仍未验证。
## 竞技场补充任务
新增领取竞技券,位于领地 → 巅峰决斗 → 竞技场,与已有竞技积分任务独立。用户要求实现流程后面确认;入口控件、资格、次数、周期、广告或资源要求、领取结果及返回步骤均暂留空,不纳入当前实现顺序或默认任务预览。
## 战令幸运星分支(后续完善)
战令一键领取后可能获得幸运星;幸运星需要再点击才能领取。此分支按用户要求后续完善,现有 claim_offer.py 尚未处理。具体出现界面、点击目标、领奖成功标志和关闭/返回流程待采集,不因一键领取按钮变灰就认定幸运星已领取。
## 仍需核实的状态
1. 宠物战令是否优先一键领取;活动日礼包是否按视频标志区分广告分支。已经询问,确认前不运行这两个新增流程。
2. 新任务领取后的弹框、按钮变化和列表重排;本轮只看到当前状态,没有点击验证。
3. 无免广告卡的广告进入、结束、返回和领奖;机关额外广告次数。
4. 未出现或本轮未巡视的观影、图腾冲刺、金沙游记、英雄集结新分活动,以及基金后续页签与月卡已购可领状态。
5. 商品购买确认、每份数量、扣款、库存与限额变化;祝福升级结果;保卫宠物挑战顶部宝箱是否要领取。
6. Windows端窗口与输入实测。不能从Mac成功推断跨平台已经完成。
本轮完整截图保存在忽略版本管理的 `local/page_audit/`,识别用裁剪模板在 `assets/map_audit_*.png`;测试保留最小的真实挑战页识别夹具,不依赖本地完整截图。静态截图回放和模拟测试无法替代领奖、视频或购买的实机结果验证。