主界面、功能入口与红点
覆盖登录后主界面结构、功能解锁、导航和红点聚合。各玩法的条件、奖励和购买由各自功能页负责;这里记录玩家如何发现和进入功能。来源批准状态 unknown;代码审计不等于界面运行验收。
主界面信息与入口

图中 1–7 分别为资源、玩家资料、活动礼包、基础功能、召唤/任务、挂机、底部导航。旧图用于解释区域关系;最新家园入口及活动配置以当前实现为准。
| 区域 | 方案中的具体行为 |
|---|---|
| 顶部资源 | 从左到右钻石、金币、体力;体力同时显示当前/上限。钻石跳充值商店、金币跳金币购买、体力打开体力购买;原表又注明钻石商店未做,不能视为当时已可用 |
| 玩家资料 | 头像、昵称、等级、升级进度条;旧主界面表写点击无响应,但当前已进入玩家资料 |
| 活动与礼包 | 按解锁顺序竖向排列;未开启隐藏。超过 4 个可折叠,默认前 4 个,展开视窗 4 个并滚动余项;原表注明折叠为后续优化,不代表已实现 |
| 基础入口 | 设置、任务、邮件、图鉴、排行;未开放隐藏;超过 4 个的折叠规则同上 |
| 召唤与任务 | 开放后显示。当前主线任务按 ID 推进;全部主线完成后按日常、周常、成就顺序选择。未完成点任务跳目标,已完成点领取并切下一任务 |
| 挂机 | 未开放隐藏;已开放进入挂机领取,具体规则见家园与挂机 |
| 底部导航 | 旧图为商店、英雄、主角、副本、公会;锁定时图标灰+锁、隐藏名称,点击给开启条件,未实现提示稍后开放;选中页入口变为返回 |
当前家园聚合领地、材料副本与 Boss 等入口;不继续用旧底栏“领地/副本”的位置作为当前导航契约。家园内部规则见对应功能页。
解锁与跳转
配置可以默认开放、通关指定主线或达到主角等级;解锁前可按入口规则隐藏或显示锁定态。提示应展示玩家能理解的关卡序号/等级。达到条件返回主界面后先展示功能开启动画,再接该功能新手引导。功能入口是否开放、活动是否有效、是否有可领取内容是三个不同状态。
任务“前往”和道具“获取途径”经统一导航定位到目标页、页签或物品;导航必须尊重目标入口的开启条件。导航只改变展示,不直接扣资源、发奖励或完成任务;回包/model 变化才能改变业务状态。
红点规则
红点由具体功能可行动状态产生,再沿树向父入口聚合;打开页面是否消点由功能规则决定,不能对所有红点一律“看过即清”。数据初始化、新增、领取、删除、时间变化等事件应使所属节点重算。
| 功能 | 已有来源明确的红点依据 |
|---|---|
| 邮件 | 未读或附件未领取;详情见邮件 |
| 领地 | 可升级、免费刷新、日志、运输、抢夺等子节点聚合,具体条件归领地 |
| 活动 | 七日登录、主线冲刺等可领奖状态,由活动数据驱动 |
| 社交 | 方案为申请、未读私聊、可收赠礼聚合;当前代码只有申请和私聊,见好友 |
当前实现事实
frontend 7f0636c9 的 Infrastructure/UGUI/Entry/Model/EntryModel.cs 已注册商店、英雄、主角、家园领地/材料、挑战、设置、任务、邮件、排行、图鉴、社交、召唤、挂机、体力购买及活动礼包命令。规则支持等级、主线、创号天数、时间范围、维护、功能开关和自定义条件;任一隐藏条件失败即隐藏,其余失败显示但不可交互。语言切换重算锁提示。
- 公会显式
FeatureNotImplemented、不隐藏,提示功能未开启;不是可玩公会。 - 主线自动战斗有主线 ID 1006 的隐藏条件;这不是人类可读“第 1006 关”。
- 七日签到、主线冲刺、七日目标、英雄试炼的显隐来自 ActivityModel;英雄试炼不是唯一已登记活动。
- 首充仅在可购买或已买待领时显示;次充按礼包模型条件;礼包数据变化重新计算入口。
- 活动总入口在任一开放页签存在时显示;超值总入口在任一礼包页存在时显示;日/周礼包均卖空可隐藏页签及总入口。
- 特权卡的主界面独立入口仍占位隐藏,但活动页内月卡有独立开放判定。
FeatureNotEnabled的通用开关检查目前返回 true,不能把该分支当作已接入服务端功能开关。
Infrastructure/Navigation/README.md 的产品语义为带开启检查的定位跳转;Infrastructure/RedDot/README.md 的产品语义为功能 Handler/事件驱动节点和父子聚合。技术接口与注册示例保留在 frontend。
关卡外展示边界
飞书关卡外主功能规定默认展示最新未通关关卡,全部通关时展示最后一关;左右箭头有边界。界面展示关卡标题/背景、怪物、上阵英雄、宝箱、挑战入口;怪物顺序 Boss→精英→普通,点击模型看详情,显示抗性/类型,奖励道具可查看说明。挑战开放、体力消耗、首次/重复奖励与三星宝箱领取归主线关卡,不由主界面红点决定。
来源、差异与现有测试入口
整合旧 main-entry-red-dot.md;飞书 Qk2dsZLKshaVlJtDTtNcDga9nCb 主界面全部区域与解锁规则、H5NebnnfNo402fxc2MrcVJmknYf 关卡外入口/图示结构(2026-10-13 阅读件);frontend 上述 Entry/Navigation/RedDot 文件及 Docs/WorkPackages/HomeMain/frontend-brief.md 的导航变更。
折叠动画、精确排列、任务优先序和全部红点在实机上的一致性尚无本次观察;旧资料点击无响应、旧底栏以及“仅单条件解锁”已被当前代码扩展或替换。当前入口也是后续 GUI 覆盖的实际起点;未在本次执行现有测试、未新增或扩写测试。本地验证:根据项目策略禁止执行。