Rizline Rank Query

Rizline 国服查分服务，提供网页登录、FC5+B35 成绩图与 HTTP API。

功能

• 手机号密码或短信验证码登录，支持通过 rizToken 查分。
• 使用云存档的精确 RKS 展示 FC5+B35，共 40 个槽位。
• 绘制玩家名片、曲绘和完成率，高亮新增与提升成绩。
• 网页预览及标清、高清 PNG 导出。
• API Key 鉴权、接口限流、短信发送限制与短时存档缓存。
• 从客户端 CDN 同步曲库、定数和素材。

结构

server.js                 HTTP 服务、登录会话与限流
src/rizline/              账号、凭证、存档解密与 RKS 分组
src/                      报告、历史对比和图片渲染
public/                   网页与静态素材
data/rizline/             曲库、定数、本地化与计分规则
data/runtime/             登录会话、存档与历史记录
data/cache/               资源下载缓存
scripts/                  CLI 登录、资源同步与检查工具
config.example.json       配置模板
API.md                    接口参考

安装

准备 Node.js 18+，推荐 Node.js 24；同步素材另需 Python 3.10+。

git clone https://github.com/0x000005/RizlineRankQuery.git
cd RizlineRankQuery
npm ci
Copy-Item config.example.json config.json

编辑 config.json，将 apiKeys[].key 替换为随机密钥。顶层 rpm 设置默认接口额度，各 Key 的 rpm 可单独覆盖；sms 设置短信额度。需要 API 登录时，将 rizline.allowApiLogin 设为 true。

仓库包含曲库及素材清单。首次部署时同步曲绘和字体，也可复制已有素材：

python -m pip install -r scripts/requirements-rizline-sync.txt
python scripts/sync_rizline_assets.py
npm start

访问 http://localhost:3000。输入 test 可预览样例成绩；修改端口可在启动前设置 $env:PORT = 3100。命令行登录使用 npm run login。

Linux 下使用 cp config.example.json config.json 复制配置。Docker 部署时将项目挂载到 /app，在容器内执行 npm ci，以 node server.js 启动，并持久保留 config.json 与 data/runtime/。

支持 /rizline/ 子路径部署：反代转发时去掉前缀，由网站提供 HTTPS。更新曲库时重新运行同步脚本并重启服务；脚本选项通过 --help 查看。

接口说明见 API.md。