Skip to main content

排行榜

0. 本篇结论​

本功能定义排行榜的功能定位、玩家流程、核心规则、UI 状态、配置与系统边界；本次整理状态为 draft；原声明为 producer_review_needed / canonical_candidate，不提升为批准规则。

整理来源与事实层级（WEN-12 draft）​

  • 固定来源：project2-docs@ec43be0e13c8624cfafd36c0fd803f3b89733fff 的 features/ranking.md、feature-map.md、manifest.yaml；原审核状态均为 producer_review_needed / canonical_candidate。
  • §5.1 的数据类型和缓存是历史线索；同进度按达成时间、Top999、名外显示无、全服可领首通进度奖励是候选。周期结算奖励仍在当前范围外，需用户另行确定。
  • 已确认基线仅指固定文档路径、原声明及既有规则编号；原件与逐条产品批准记录缺证，不能将其转成“已确认产品规则”。本轮未读取游戏实现、配置或运行版本，当前版本是否上线全部待定。
  • 边界：排行拥有类型、排序、分页、Top3/个人排名展示候选。§5.3 的主线全服首通进度奖励仅作为历史需求入口，不能据展示位置认定排行是首通判定、状态持久化或发奖 owner。主线完成事件引用 战斗关卡（B1-D）；副本与竞技场均不自动继承主线首通规则。
  • 来源登记、两侧证据、影响与用户决定点见 玩法整理台账，对应 B1E-Q06、Q09。后文验收为候选检查项，本轮未执行游戏验收。

1. 功能定位​

排行榜展示玩家在指定排行类型下的名次、分数、前三名和个人排名，支撑竞争目标和可能的奖励领取。

2. 范围​

In Scope：排行榜类型、分页、前三展示、个人排名、排行榜 UI 和刷新；首通进度奖励候选的展示入口与归属问题记录。

Out of Scope：排行榜周期结算奖励，除非另有需求明确。

3. 玩家入口、解锁与提示​

入口位于主界面或战斗结算相关入口。初始类型默认为 MissionRank。

4. 核心玩家流程​

  1. 玩家打开排行榜。
  2. 选择排行类型。
  3. 客户端请求对应页数据。
  4. 展示前三、列表、个人排名和分页状态。
  5. 翻页或切换类型刷新数据。

5. 核心规则​

5.1 排行数据与分页​

  • RANKING-R-001：排行类型由 RankType 和 排行榜配置 控制。
  • RANKING-R-002：RoleRankingData 包含排行榜列表和我的排名。
  • RANKING-R-003：客户端缓存已加载页，切换类型时读取对应分页。

5.2 主线排行榜排序​

  • RANKING-R-004：当前候选主排行榜为主线关卡排行榜，按玩家已通关最高主线关卡进度排名。
  • RANKING-R-005：多个玩家主线关卡进度一致时，按达成时间先后排序。
  • RANKING-R-006：主线关卡排行榜最多记录 999 名玩家；服务器玩家不足 999 人时只展示实际人数。

5.3 首通进度奖励候选展示与个人排名（归属待裁定）​

  • RANKING-R-007：每个主线关卡记录全服首个通关玩家；只要关卡已有全服玩家通关，全服玩家即可领取该关卡对应进度奖励。
  • RANKING-R-008：玩家排名在 999 名之外时，个人排名显示为无。

5.4 操作矩阵​

N/A。当前不在策划案正文中复述核心玩家流程；进入 PLAN 时，仅对状态变化、消耗/产出、奖励发放、跨系统反馈或失败反馈补齐操作矩阵。

6. UI 状态与交互​

6.1 界面图与交互说明​

以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。

图 01：红点需求​

排行榜 - 红点需求

  • 图状态：仅参考
  • 关联页面 / 状态：红点需求
  • 关联交互 / 状态说明：红点需求；排行榜；有可领取的进度奖励（该主线关卡在全服内有玩家通关）；主界面排行榜图标（红点）---排行榜界面进度奖励图标（红点）-进度奖励界面物品图标（红点）；领取所有进度奖励；入口图示；主界面右侧图标列表，图鉴图标下方

图 02：入口图示​

排行榜 - 入口图示

  • 图状态：仅参考
  • 关联页面 / 状态：入口图示
  • 关联交互 / 状态说明：排行榜；有可领取的进度奖励（该主线关卡在全服内有玩家通关）；主界面排行榜图标（红点）---排行榜界面进度奖励图标（红点）-进度奖励界面物品图标（红点）；领取所有进度奖励；入口图示；主界面右侧图标列表，图鉴图标下方；功能解锁后才显示此入口图标

图 03：进度奖励界面​

排行榜 - 进度奖励界面

  • 图状态：仅参考
  • 关联页面 / 状态：进度奖励界面
  • 关联交互 / 状态说明：进度奖励界面；显示主线关卡每一关的首通玩家情况、进度奖励领取情况、奖励物品的图标&品质&数量；每一个条目代表一个主线关卡，条目标题显示关卡名称，如果没有玩家通关，标题显示【未有玩家通过XXXX】；条目内容显示首通玩家的头像、名称、末尾显示进度奖励物品图标；如果当前关卡还未有人通关，条目显示【虚位以待】，头像显示通用无头像图标，尾部奖励物品图标暗化，有锁头标志

图 04：不可领取​

排行榜 - 不可领取

  • 图状态：仅参考
  • 关联页面 / 状态：不可领取
  • 关联交互 / 状态说明：如果当前关卡还未有人通关，条目显示【虚位以待】，头像显示通用无头像图标，尾部奖励物品图标暗化，有锁头标志；奖励图标显示类型；不可领取；可领取；已领取

图 05：已领取​

排行榜 - 已领取

  • 图状态：仅参考
  • 关联页面 / 状态：已领取
  • 关联交互 / 状态说明：奖励图标显示类型；不可领取；可领取；已领取；本弹窗点击空白处关闭

图 06：可领取​

排行榜 - 可领取

  • 图状态：仅参考
  • 关联页面 / 状态：可领取
  • 关联交互 / 状态说明：奖励图标显示类型；不可领取；可领取；已领取；本弹窗点击空白处关闭

图 07：排行榜界面​

排行榜 - 排行榜界面

  • 图状态：仅参考
  • 关联页面 / 状态：排行榜界面
  • 关联交互 / 状态说明：排行榜界面；目前只有一个主线关卡排行榜，有多个时，通过界面底部页签切换；前三名展示区；显示该排行榜中前三名玩家信息、进度奖励入口；若存在多个玩家的主线关卡进度一致，则按照时间先后进行排名

6.2 页面结构与交互​

展示排行类型页签、前三名区域、列表条目、我的排名、翻页/加载更多、空状态。

入口位于主界面右侧图标列表，功能解锁后才显示。当前只有主线关卡排行榜时无需多页签；后续多排行类型通过底部页签切换。界面包含前三名展示区、进度奖励入口、第 4 至第 999 名列表和固定的玩家自己排名条目。没有玩家获得某个名次时显示通用剪影；第 3 名之后无排行数据时显示暂无排行信息。进度奖励界面按主线关卡展示首通玩家、奖励图标、品质、数量和领取状态。

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 和对应执行任务确认。

数据域逻辑字段 / 规则设计含义必填 / 边界产出责任
排行类型规则排行类型、名称、展示字段、分页数量、开放条件定义排行榜类型、展示字段和开放条件进入执行前补齐默认值、边界和可选性Planning
主线排行榜排序最高通关关卡、达成时间、最大展示人数、个人排名展示定义主线进度排行榜的排名规则进入执行前补齐默认值、边界和可选性Planning / Backend
全服首通奖励关卡目标、首通玩家、进度奖励、领取条件、防重复定义每个关卡首通玩家和可领取奖励进入执行前补齐默认值、边界和可选性Planning

7.2 运行时数据与接口需求​

Contract设计含义使用方说明
排行榜列表数据返回排行榜列表和我的排名服务端 / 客户端支持分页和切换类型缓存
排行数据来源按进度、时间或其他分数生成排名服务端排序和个人排名以状态权威为准
首通奖励状态保存全服首通和玩家奖励领取状态服务端 / 客户端需要防重复领取

7.3 跨部门 Contract 命名清单​

Contract 类型逻辑对象命名状态阻塞阶段说明
配置数据排行类型、展示字段、分页、奖励和首通规则待 PLAN 确认PLAN 前不预设物理配置表名
协议 / API排行榜列表、我的排名、首通奖励领取待 PLAN 确认执行前由服务端 / UI brief 确认
错误码排行未开放、分页越界、奖励不可领取、奖励已领取待 PLAN 确认执行前需要玩家提示
埋点事件排行榜打开、切换排行、领取首通奖励待 PLAN 确认PLAN 前由 analytics 方案确认

8. 系统边界​

方向负责内容备注
Planning逻辑数据、数值、文本需求、资源需求进入执行前由 PL 任务细化
服务端协议、校验、持久化、奖励发放、幂等与安全仅相关功能需要
客户端UI、交互、表现、本地状态、红点和跳转仅相关功能需要
美术图标、模型、特效、音频和导出资源仅相关功能需要
Ops / GM后台配置、运营投放、公告、补偿和数据看板仅相关功能需要

客户端与表现​

客户端侧只记录玩家可见界面、交互反馈、表现刷新和本地展示需求；具体目录、类名、命令和事件由 UI / 客户端 brief 确认。

美术与音频需求​

需要排行榜入口、前三名展示、名次徽章、头像框、列表背景。

9. 数值、经济与奖励​

排行榜分数来源需要具体功能确认；可能来自关卡、战力、活动或其他成长指标。若有奖励，必须新增奖励规则。

主线关卡排行榜需要配置全服首通进度奖励，奖励通过 item-resource 发放。进度奖励与排行榜周期奖励是不同概念；本候选稿只确认首通进度奖励，周期结算仍待确认。

10. 异常、安全与运营边界​

10.1 异常与安全​

排行数据必须以状态权威为准。空榜、网络失败、页码越界、玩家不在榜需要清晰显示。

10.2 埋点与运营​

记录排行榜打开、排行类型、翻页、个人排名曝光。

11. Feature Relations 与回归范围​

Feature Relations​

依赖 battle-mission、character-hero、main-entry-red-dot，可能与活动和奖励系统共享 contract。

红点与 main-entry-red-dot 共享：存在可领取进度奖励时，主界面排行榜入口、排行榜界面进度奖励入口和进度奖励条目均需显示红点；领取所有进度奖励后消失。

回归范围​

以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。

12. 验收标准​

12.1 关键验收结论​

类型切换、分页、Top3、个人排名、空状态和刷新事件正确。

补充验收：主线进度排序、同进度按时间排序、Top999、个人排名固定条、999 名外显示无、全服首通进度奖励、奖励可领取/不可领取/已领取三态和红点均需验证。

12.2 规则验收清单​

规则文本统一在§5维护；以下仅保留编号作为候选验收引用，不另存一份规则，也不代表验收已通过。

  • RANKING-R-001：核对§5同编号规则的候选行为与边界。
  • RANKING-R-002：核对§5同编号规则的候选行为与边界。
  • RANKING-R-003：核对§5同编号规则的候选行为与边界。
  • RANKING-R-004：核对§5同编号规则的候选行为与边界。
  • RANKING-R-005：核对§5同编号规则的候选行为与边界。
  • RANKING-R-006：核对§5同编号规则的候选行为与边界。
  • RANKING-R-007：核对§5同编号规则的候选行为与边界。
  • RANKING-R-008：核对§5同编号规则的候选行为与边界。

12.3 执行层验收​

  • 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
  • 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为 N/A。
  • Section 7 中标记为 PLAN 前或执行前阻塞的 contract 已在 contract-registry.yaml、execution brief 或执行任务中确认。
  • 相关 Feature Relations 回归通过。

13. 待澄清问题 / Open Questions​

  • 排行榜是否有周期结算奖励、结算邮件和防作弊规则仍需确认。
  • 全服首通进度奖励是否属于排行榜功能，还是应拆为关卡进度奖励，需要制作人确认。

14. 变更记录​

日期版本修改人变更摘要
2026-10-13WEN-12 draftAutoDev Symphony保留原审核声明；补充来源/层级/玩法边界及待定台账；规则验收改为编号引用，移除尾部重复空图段
2026-06-16v0.2Codex补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点
2026-06-16v0.1Codex按新版功能策划案模板重排章节；保留既有规则内容并映射参考图