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