排行榜与全服首通奖励
本页于 2026-10-15 整合现有功能稿、飞书内容及客户端 origin/develop@7f0636c9 的功能资料。原 draft/unknown 不因整理自动变为批准；设计规则、源配置与运行结果分别说明。本次只做文档及源码审阅，没有执行游戏功能测试。
入口、前提与状态
从主界面排行榜入口查看主线排行榜及进度奖励；BOSS、竞技榜各自随玩法开放显示。排行类型由RankType与配置控制，RoleRankingData含列表及我的排名，客户端缓存每类已加载分页。
完整规则、配置与界面
Sheet1
排行榜概述
展示各个功能的排名情况
具体规则
-
排行榜分为多种类型：主线关卡排行榜（需要支持后续扩展其他类型的排行榜）
-
主线关卡排行榜根据玩家通关的最高主线关卡进度来排名
-
若存在多个玩家的主线关卡进度一致，则按照时间先后进行排名
-
主线关卡排名最多记录999名玩家
每个主线关卡，都将记录首个通关的玩家
- 只要该主线关卡在全服内有玩家通关了，全服的玩家都可领取一份对应的奖励
配置结构示例
全服首通主线关卡奖励表
全服首通奖励示例
| 关卡ID | 奖励 |
|---|---|
| 1001 | 钻石*200 |
| 1002 | 钻石*300 |
| 1003 | 钻石*1000 |
红点需求
排行榜红点
| 模块 | 触发条件 | 红点位置 | 消失条件 |
|---|---|---|---|
| 排行榜 | 有可领取的进度奖励（该主线关卡在全服内有玩家通关） | 主界面排行榜图标（红点）---排行榜界面进度奖励图标（红点）-进度奖励界面物品图标（红点） | 领取所有进度奖励 |
- 图示
入口图示
-
主界面右侧图标列表，图鉴图标下方
-
功能解锁后才显示此入口图标
排行榜界面
-
目前只有一个主线关卡排行榜，有多个时，通过界面底部页签切换
-
前三名展示区
-
显示该排行榜中前三名玩家信息、进度奖励入口
-
若存在多个玩家的主线关卡进度一致，则按照时间先后进行排名
-
1.1
-
前三玩家信息
-
显示玩家的名次、形象立绘、名称、最近通关的主线关卡（序号+名称）
-
如果没有玩家获得某个名次（如第三名），则对应名次位置显示通用立绘剪影，不显示其他信息（左图）
-
1.2
-
进度奖励入口
-
点击可进入进度奖励界面
-
后续排名展示
-
显示从第4名到最多999名的所有玩家排行信息、玩家自己的排名信息
-
2.1
-
玩家信息
-
显示玩家的名次、头像、名称、最近通关的主线关卡（序号+名称）
-
如果全服玩家不足999人，则只排名对应人数，后续条目不显示
-
举例：服务器玩家只有30人，则第30名玩家之后不显示条目
-
如果第3名之后没有玩家信息，界面显示【暂无排行信息】（左图）
-
2.2
-
显示玩家自己排行信息
-
显示玩家的名次、头像、名称、最近通关的主线关卡（序号+名称）
-
玩家排名的条目始终固定在图示位置，不随拖动操作移动
-
如果玩家当前排行在999名之外，排名处显示【无】
进度奖励界面
-
只要有人通关，全服玩家都可获得进度奖励
-
显示主线关卡每一关的首通玩家情况、进度奖励领取情况、奖励物品的图标&品质&数量
-
每一个条目代表一个主线关卡，条目标题显示关卡名称，如果没有玩家通关，标题显示【未有玩家通过XXXX】
-
条目内容显示首通玩家的头像、名称、末尾显示进度奖励物品图标
-
如果当前关卡还未有人通关，条目显示【虚位以待】，头像显示通用无头像图标，尾部奖励物品图标暗化，有锁头标志
-
奖励图标显示类型
-
图示
-
不可领取
-
可领取
-
已领取
-
【260703补充优化】
-
玩家可以通过点击任意一个可领取奖励，一次性领取所有进度奖励（当前可领取的）
-
此界面所有条目按关卡ID排序，ID越大越靠上显示
-
本弹窗点击空白处关闭
实现证据、差异与未知
功能归属与边界
主线榜按最高通关进度、达成时间先后排序，最多999名，个人不在榜显示“无”；这是主线榜口径，不覆盖竞技前1000/BOSS奖励前50等另一玩法规则。全服首通奖励只要任何玩家打通该关，全服玩家都可领取个人一次性奖励；点击任意可领项按7月3日补充领取全部可领，不是玩家个人首通奖励。奖励须服务端去重。
周期性主线排名奖励来源未定义，不能仿照BOSS/竞技补造。进度奖励业务由排行榜展示，关卡记录提供首通事实；此整理不另建可编辑的第二份关卡奖励定义。
原型与图示
来源
旧ranking；飞书Vs9LbKXF0o9dvTxLMR2c2LCTnte的正文、表格、图示与UI标注；客户端HomeMain/frontend-brief.md。当前源码边界不等同运行验收。
后端实现证据（88b24abe）
handler/ranking/ranking.go当前newRankQuery仅支持MissionRank与BOSS榜，其他类型报错；BOSS读自然日同key并解码难度+伤害，主线自己无分时显示主线pass。这是源码调用核实，不代表运行验收。