主界面、入口与红点
0. 本篇结论与阅读边界（WEN-8 draft）
本篇是 B1-A 文档整理草稿。固定文档来源为 ec43be0e13c8624cfafd36c0fd803f3b89733fff 的 features/main-entry-red-dot.md；原审核声明为 producer_review_needed / canonical_candidate，保留为历史事实，整理稿状态为 draft。原规则、参考图和验收清单是候选要求，不能视为已批准规则或已执行验证。
先由基础系统入口查看初始化、入口、红点和开放规则归属，以及来源、合并追溯和待裁定问题。本文负责自己的功能规则；引用其他功能的共用规则时不再复制。代码/配置与游戏运行现状未在本批重新核对，缺证见系统入口。
1. 功能定位
主界面是玩家进入各系统的导航中心；红点系统负责把可领取、可升级、可处理、可查看的即时操作聚合成视觉提示。它提升系统发现率和日常操作效率。
2. 范围
In Scope：主界面入口、功能跳转、入口开放提示、红点聚合、各功能红点 处理逻辑、主界面资源状态。
Out of Scope：各功能内部详细规则、活动弹窗、公告内容、战斗 UI。
3. 玩家入口、解锁与提示
玩家登录后进入主界面。入口开放可能依赖玩家等级、关卡、任务、活动、引导和配置。红点由各功能模型和服务端通知驱动。
4. 核心玩家流程
- 玩家进入主界面。
- 客户端根据角色快照和配置显示入口。
- 各功能上报红点数量。
- 玩家点击入口进入目标功能。
- 完成操作后红点刷新或消失。
5. 核心规则
5.1 入口与红点通用规则
MAIN-ENTRY-RED-DOT-R-001：红点只表示可操作提示，不替代功能状态。MAIN-ENTRY-RED-DOT-R-002：红点数量应可聚合到主入口。MAIN-ENTRY-RED-DOT-R-003：功能关闭或未开放时不应展示可点击入口，或应展示锁定态。MAIN-ENTRY-RED-DOT-R-004：入口跳转必须能处理目标功能资源未加载、模型未初始化和网络失败。MAIN-ENTRY-RED-DOT-R-005：功能入口开放条件候选包括默认开放、通关指定关卡、主角等级达到指定等级；当前候选只使用单条件，复合条件未确认。入口未开放时可隐藏，也可锁定并显示解锁条件；通关类提示使用关卡名，等级类提示使用主角等级。具体入口的隐藏/锁定选择仍需逐功能确认。MAIN-ENTRY-RED-DOT-R-006：解锁后入口候选表现为隐藏入口直接显示、锁定入口解除锁定、或播放解锁动画后显示。若播放解锁动画，应在玩家回到主界面后进行，且早于新手引导任务开始；引导章节与完成进度归 引导设置。
共用规则消费边界
登录快照完成的前置条件归 账号初始化 ACCOUNT-SERVER-LOGIN-R-004；本篇只消费快照建立入口/红点初态，不定义各模型数据或额外初始化顺序。邮件未读与未领取附件的判断归 邮件，本篇只负责聚合和显示；领地、活动等红点触发仍由对应功能决定。功能开放表、等级/关卡数值归 planning，不能从本篇候选生成新字段或默认值。
5.2 红点聚合规则
MAIN-ENTRY-RED-DOT-R-007：领地入口红点需要聚合领地升级、免费刷新、日志、搬运成功和掠夺成功等状态。MAIN-ENTRY-RED-DOT-R-008：活动入口红点需要聚合七日登录、通关冲刺等子活动的可领取奖励状态。
5.3 主界面结构与资源栏
MAIN-ENTRY-RED-DOT-R-009：主界面承担重要系统入口、基础资源展示、常用功能入口、当前关卡信息、礼包和活动入口展示。MAIN-ENTRY-RED-DOT-R-010：主界面入口开放统一由功能开启表控制，支持开启、解锁、隐藏和敬请期待态。MAIN-ENTRY-RED-DOT-R-011：顶部资源栏从左到右展示钻石、金币和体力。钻石栏点击跳转商店钻石充值位置；金币栏点击跳转商店金币位置；体力栏点击打开体力购买界面。MAIN-ENTRY-RED-DOT-R-012：主角信息区展示头像、名称、当前等级和距离下一等级的经验进度条；默认名称来自服务器用户名，默认头像为指定初始英雄头像。
5.4 活动、任务与基础入口
MAIN-ENTRY-RED-DOT-R-013：活动/礼包入口按解锁顺序从上到下排列；超过 4 个图标时出现收纳箭头，收起展示前 4 个，展开后最多显示 4 个并支持滑动查看更多。未开放活动或礼包不显示入口。MAIN-ENTRY-RED-DOT-R-014：基础功能入口包括设置、任务、邮件、图鉴、排行榜等；未解锁时不显示入口图标。MAIN-ENTRY-RED-DOT-R-015：英雄召唤和主线任务入口需要受功能开启表控制。主线任务入口优先展示当前正在进行的主线任务；所有主线任务完成后，按每日任务、周任务、成就的顺序展示。MAIN-ENTRY-RED-DOT-R-016：点击未完成任务可跳转到对应界面并提示完成；点击已完成任务可直接领取奖励并展示下一个任务。
5.5 挂机收益与底部系统入口
MAIN-ENTRY-RED-DOT-R-017：挂机收益入口未解锁时隐藏，解锁后点击打开挂机收益界面。MAIN-ENTRY-RED-DOT-R-018：底部系统入口候选为商店、英雄、主角、副本、公会。未解锁系统不显示名称，图标暗化并显示锁头，点击提示解锁条件；尚未开发系统提示敬请期待。MAIN-ENTRY-RED-DOT-R-019：玩家进入某系统界面后，对应底部入口图标可切换为返回按钮，点击回到主界面。
5.6 操作矩阵
N/A。当前不在策划案正文中复述核心玩家流程；进入 PLAN 时，仅对状态变化、消耗/产出、奖励发放、跨系统反馈或失败反馈补齐操作矩阵。
6. UI 状态与交互
6.1 界面图与交互说明
以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。
图 01：功能规则 / 主界面布局
- 图状态：仅参考
- 关联页面 / 状态：功能规则 / 主界面布局
- 关联交互 / 状态说明：统一用功能开启表，控制功能的开启、解锁/隐藏（沿用领主的表）；主界面布局；从左往右依次为，钻石（显示当前拥有钻石数量）、金币（显示当前拥有金币数量）、体力（显示当前拥有体力数量/体力上限）；点击钻石栏，打开商店界面，跳转到钻石充值位置（见商店系统文档）【只展示钻石栏，暂不制作其商店部分】；点击金币栏，打开商店界面，跳转到金币位置（见商店系统文档）
1 张 EMF 格式草稿图因浏览器不可直接显示，暂未映射；如需保留，需先转成 PNG/JPEG。
6.2 页面结构与交互
主界面应展示核心入口、二级入口、资源栏、体力加号、玩家头像名称等级、经验进度、任务入口、活动/礼包收纳区、底部系统入口、功能提示、红点数量、锁定态、解锁动画、加载态和失败提示。红点清除应及时且可解释。
6.3 UI 页面状态表
N/A。当前仅保留已绑定页面/状态的参考图和页面结构说明；具体可执行状态在 UI 评审或 UI brief 中确认。
7. 配置、数据与 Contract
本节只记录策划案需要的逻辑数据与跨部门 contract，不预设物理配置表、协议文件、service 文件或 仓库落点。正式命名、字段名、接口名、协议对象名、文件名和仓库落点进入执行前由 Work Package 的 contract-registry.yaml、execution brief 和对应执行任务确认。
7.1 策划数据需求
策划数据需求只描述逻辑数据域、逻辑字段或规则语义，不等同于配置表字段名、协议字段名或数据库字段名。正式字段命名进入 contract-registry.yaml、execution brief 和对应执行任务确认。
| 数据域 | 逻辑字段 / 规则 | 设计含义 | 必填 / 边界 | 产出责任 |
|---|---|---|---|---|
| 主界面入口配置 | 入口 ID、名称、图标、开放条件、锁定态、敬请期待态、跳转目标 | 定义主界面系统入口、开放条件和跳转目标 | 进入执行前补齐默认值、边界和可选性 | Planning / Frontend |
| 资源栏规则 | 资源类型、展示顺序、点击目标、购买入口、刷新规则 | 定义钻石、金币、体力等顶部资源展示和点击行为 | 进入执行前补齐默认值、边界和可选性 | Planning |
| 红点聚合规则 | 红点 key、来源功能、聚合层级、隐藏条件、刷新触发 | 定义主入口和子入口的可操作提示聚合 | 进入执行前补齐默认值、边界和可选性 | Planning / 服务端 / 客户端 |
| 活动和任务入口 | 展示数量、收纳、滑动、任务优先级、返回按钮切换 | 定义礼包活动入口、任务入口和底部系统入口表现 | 进入执行前补齐默认值、边界和可选性 | Planning / Frontend |
7.2 运行时数据与接口需求
| Contract | 设计含义 | 使用方 | 说明 |
|---|---|---|---|
| 入口开放状态 | 根据功能开启、等级和关卡进度控制入口展示 | 服务端 / 客户端 | 未开放可隐藏或锁定并显示解锁条件 |
| 红点状态同步 | 后端推送和客户端计算共同刷新红点 | 服务端 / 客户端 | 每个功能需声明红点来源 |
| 主界面跳转 | 处理入口跳转、资源未加载、模型未初始化和网络失败 | 客户端 | 跳转失败需有兜底提示 |
7.3 跨部门 Contract 命名清单
| Contract 类型 | 逻辑对象 | 命名状态 | 阻塞阶段 | 说明 |
|---|---|---|---|---|
| 配置数据 | 入口、开放条件、图标、跳转、红点 key、任务入口优先级 | 待 PLAN 确认 | PLAN 前 | 不预设物理配置表名 |
| 协议 / API | 红点列表、入口状态、必要的资源状态同步 | 待 PLAN 确认 | 执行前 | 由服务端 / UI brief 确认 |
| 错误码 | 功能未开放、资源未加载、跳转失败、网络失败 | 待 PLAN 确认 | 执行前 | 需要玩家提示 |
| 资源引用 | 主界面图标、锁头、红点、入口动效、返回按钮 | 待 PLAN 确认 | 执行前 | 由美术 / UI brief 确认 |
8. 系统边界
| 方向 | 负责内容 | 备注 |
|---|---|---|
| Planning | 逻辑数据、数值、文本需求、资源需求 | 进入执行前由 PL 任务细化 |
| 服务端 | 协议、校验、持久化、奖励发放、幂等与安全 | 仅相关功能需要 |
| 客户端 | UI、交互、表现、本地状态、红点和跳转 | 仅相关功能需要 |
| 美术 | 图标、模型、特效、音频和导出资源 | 仅相关功能需要 |
| Ops / GM | 后台配置、运营投放、公告、补偿和数据看板 | 仅相关功能需要 |
客户端与表现
- 各功能
RedDot目录：Mail、Shop、Equip、Rune、Task、GiftPack、Manual、Master 等。
美术与音频需求
需要入口图标、锁定态、红点数字、可领取动效、入口高亮。红点通常不需要音效，除非有强提示规则。
9. 数值、经济与奖励
本功能不直接发放奖励，但入口和红点会曝光所有经济系统。主界面资源显示必须与 item-resource 保持一致。
10. 异常、安全与运营边界
10.1 异常与安全
红点不能驱动奖励发放，只能提示。入口未开放但服务端状态可操作时，应以后端状态和开放配置共同判定。
10.2 埋点与运营
记录主界面曝光、入口点击、锁定入口点击、红点曝光、红点点击转化。
11. Feature Relations 与回归范围
Feature Relations
依赖所有可入口功能。红点共享 contract 应由 RedTipType 或功能本地 处理逻辑 统一管理。
回归范围
以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。
12. 验收标准
12.1 关键验收结论
登录后入口展示正确；各功能红点随状态变化；资源栏跳转、任务跳转/领奖、活动礼包收纳、底部入口锁定/敬请期待、入口锁定、解锁动画、跳转、返回、网络失败和重登恢复正确。
12.2 规则验收清单
-
MAIN-ENTRY-RED-DOT-R-001：红点只表示可操作提示，不替代功能状态。 -
MAIN-ENTRY-RED-DOT-R-002：红点数量应可聚合到主入口。 -
MAIN-ENTRY-RED-DOT-R-003：功能关闭或未开放时不应展示可点击入口，或应展示锁定态。 -
MAIN-ENTRY-RED-DOT-R-004：入口跳转必须能处理目标功能资源未加载、模型未初始化和网络失败。 -
MAIN-ENTRY-RED-DOT-R-005：功能入口开放条件候选包括默认开放、通关指定关卡、主角等级达到指定等级；当前候选只使用单条件，复合条件未确认。入口未开放时可隐藏，也可锁定并显示解锁条件；通关类提示使用关卡名，等级类提示使用主角等级。具体入口的隐藏/锁定选择仍需逐功能确认。 -
MAIN-ENTRY-RED-DOT-R-006：解锁后入口候选表现为隐藏入口直接显示、锁定入口解除锁定、或播放解锁动画后显示。若播放解锁动画，应在玩家回到主界面后进行，且早于新手引导任务开始；引导章节与完成进度归 引导设置。 -
MAIN-ENTRY-RED-DOT-R-007：领地入口红点需要聚合领地升级、免费刷新、日志、搬运成功和掠夺成功等状态。 -
MAIN-ENTRY-RED-DOT-R-008：活动入口红点需要聚合七日登录、通关冲刺等子活动的可领取奖励状态。 -
MAIN-ENTRY-RED-DOT-R-009：主界面承担重要系统入口、基础资源展示、常用功能入口、当前关卡信息、礼包和活动入口展示。 -
MAIN-ENTRY-RED-DOT-R-010：主界面入口开放统一由功能开启表控制，支持开启、解锁、隐藏和敬请期待态。 -
MAIN-ENTRY-RED-DOT-R-011：顶部资源栏从左到右展示钻石、金币和体力。钻石栏点击跳转商店钻石充值位置；金币栏点击跳转商店金币位置；体力栏点击打开体力购买界面。 -
MAIN-ENTRY-RED-DOT-R-012：主角信息区展示头像、名称、当前等级和距离下一等级的经验进度条；默认名称来自服务器用户名，默认头像为指定初始英雄头像。 -
MAIN-ENTRY-RED-DOT-R-013：活动/礼包入口按解锁顺序从上到下排列；超过 4 个图标时出现收纳箭头，收起展示前 4 个，展开后最多显示 4 个并支持滑动查看更多。未开放活动或礼包不显示入口。 -
MAIN-ENTRY-RED-DOT-R-014：基础功能入口包括设置、任务、邮件、图鉴、排行榜等；未解锁时不显示入口图标。 -
MAIN-ENTRY-RED-DOT-R-015：英雄召唤和主线任务入口需要受功能开启表控制。主线任务入口优先展示当前正在进行的主线任务；所有主线任务完成后，按每日任务、周任务、成就的顺序展示。 -
MAIN-ENTRY-RED-DOT-R-016：点击未完成任务可跳转到对应界面并提示完成；点击已完成任务可直接领取奖励并展示下一个任务。 -
MAIN-ENTRY-RED-DOT-R-017：挂机收益入口未解锁时隐藏，解锁后点击打开挂机收益界面。 -
MAIN-ENTRY-RED-DOT-R-018：底部系统入口候选为商店、英雄、主角、副本、公会。未解锁系统不显示名称，图标暗化并显示锁头，点击提示解锁条件；尚未开发系统提示敬请期待。 -
MAIN-ENTRY-RED-DOT-R-019：玩家进入某系统界面后，对应底部入口图标可切换为返回按钮，点击回到主界面。
12.3 执行层验收
- 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
- 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为
N/A。 - Section 7 中标记为 PLAN 前或执行前阻塞的 contract 已在
contract-registry.yaml、execution brief 或执行任务中确认。 - 相关 Feature Relations 回归通过。
13. 待澄清问题 / Open Questions
- 是否存在统一入口配置表。
- 红点是全后端、全客户端还是混合模式，需要逐功能确认。
- 关卡通关、主角等级和活动时间开放之间是否存在统一功能开放配置，需要 planning 相关负责人 确认。
14. 变更记录
| 日期 | 版本 | 修改人 | 变更摘要 |
|---|---|---|---|
| 2026-10-13 | B1-A draft | AutoDev Symphony | WEN-8 整理规则归属、来源状态与待裁定项；原审核事实保留，不修改游戏行为或发布 SDK brief。 |
| 2026-06-16 | v0.2 | Codex | 补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点 |
| 2026-06-16 | v0.1 | Codex | 按新版功能策划案模板重排章节；保留既有规则内容并映射参考图 |
7.1 界面图与交互说明
暂无