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