使用说明
ICode排行榜查询系统前台功能介绍与操作指引
1. 系统简介
本系统提供 ICode 各赛事排行榜数据的查询服务，支持：
- 多赛事独立排行榜查询
- 个人榜与学校榜两种视图
- 按姓名、年级、学校、组别多维筛选
- 年份筛选，快速定位历史赛事
- 浅色/深色主题切换，跟随系统偏好并自动记忆
2. 选择赛事
页面顶部提供赛事选择区域，包含三个控件：
- 年份：下拉筛选某一年份的赛事，选择"全部"可查看所有年份
- 赛事：选择具体赛事，选中后自动加载排行榜数据
- 官方榜单：选中赛事后出现，点击可在新标签页打开 ICode 官方榜单
操作步骤
- 在"年份"下拉框中选择目标年份（或保持"全部"）
- 在"赛事"下拉框中选择一个赛事
- 系统自动加载该赛事的排行榜数据
3. 个人排行榜
选择赛事后默认进入"个人排行榜"标签页，展示以下统计信息：
- 上榜总人数：该赛事上榜选手总数
- 最高分：该赛事最高分数
- 组别数：该赛事包含的组别数量
组别视图
默认显示"全部组别"，此时有两种展示模式：
- 无搜索条件：显示各组别概览卡片，点击任一组别卡片可进入该组别明细
- 有搜索条件：按组别分组显示明细表格，每个组别独立分页
点击组别标签（如"全部组别"、具体组别名）可切换视图。点击"清空"可重置所有筛选条件。
排名标识
排行榜前三名使用专属奖牌图标标识，第四名及以后显示数字排名：
4
5
同时，前三名所在行会以高亮底色突出显示，便于快速定位。
4. 学校排行榜
点击"学校排行榜"标签可切换到学校榜视图，展示：
- 上榜总校数：上榜学校总数
- 上榜学校总成绩：所有上榜学校累计成绩
- 上榜总人数：所有上榜学校人数合计
学校榜表格列：排名、学校、总成绩、上榜人数。
5. 搜索与筛选
个人榜筛选
个人榜提供三个筛选条件，可组合使用：
- 姓名：输入姓名关键词，模糊匹配
- 年级：下拉选择具体年级
- 学校：输入学校名称关键词，模糊匹配
在"全部组别"视图下输入搜索条件，会自动切换为按组别分组的明细展示。
学校榜筛选
学校榜提供"学校名称"搜索框，输入关键词即可模糊匹配学校。
6. 分页与跳转
当数据量超过单页容量（每页 10 条）时，底部会出现分页控件：
«跳转到第一页‹上一页›下一页»跳转到最后一页- 页码输入框：输入页码后按回车键直接跳转
分页信息显示格式：第 X / Y 页 (共 Z 条)。
7. 查看官方榜单
选择赛事后，赛事选择栏右侧会出现"官方榜单"按钮。
- 先在"赛事"下拉框中选择一个赛事
- 点击"官方榜单"按钮
- 系统会在新标签页打开 ICode 官方排行榜页面
icode.org.cn，需要网络可访问该域名。8. 主题切换
本站支持浅色与深色两种主题，可在任意页面切换，全站生效。
- 切换按钮：页面右上角的圆形按钮，显示
☾表示当前为浅色主题（点击切换到深色），显示☀表示当前为深色主题（点击切换回浅色） - 自动记忆：选择的主题会保存在浏览器本地，下次访问自动沿用
- 跟随系统：首次访问时，若未手动设置过偏好，将自动跟随操作系统的浅色/深色模式
9. 常见问题
Q：为什么选择赛事后没有数据？
A：可能该赛事数据管理员尚未人工导入，请尝试选择其他赛事，或联系管理员补充数据。
Q：搜索框输入后没有反应？
A：筛选为实时模糊匹配，请确认输入的关键词正确。若仍无结果，说明无匹配数据。
Q：学校榜的上榜人数与实际参赛人数不符？
A：学校榜展示的是上榜人数，等于或小于实际参赛人数。数据基于个人榜单统计，仅供参考，实际人数以官方数据为准。
Q：数据多久更新一次？
A：数据由管理员人工导入，更新频率取决于管理员操作。如需最新数据，请查看"官方榜单"。
Q：如何查看历史赛事？
A：在"年份"下拉框中选择对应年份，再从"赛事"下拉框中选择该年份的赛事即可。
Q：切换主题后刷新页面又变回去了？
A：主题偏好保存在浏览器本地存储中，若浏览器禁用了 localStorage 或清理了站点数据，则无法记忆。请允许本站使用本地存储即可。