Phigros Rank Query

Phigros 查分服务，提供网页预览、成绩图导出与 HTTP API。

功能

• TapTap 扫码登录或使用 sessionToken 查分。
• 展示 P3+B27，默认附加 12 条溢出成绩，支持调整数量。
• 对比上一版云存档，高亮新增与提升成绩。
• 导出标清、高清 PNG，支持 API Key 鉴权和请求限流。
• 从 APK 同步曲目信息、定数、曲绘与字体。

结构

server.js                 HTTP 服务与配置加载
src/                      登录、存档解析、历史对比、图片渲染
public/                   网页与静态素材
data/phigros/             曲目信息与定数
data/runtime/             运行时历史记录
scripts/                  APK 提取工具及依赖
config.example.json       配置模板
API.md                    接口参考

安装

准备 Node.js 18+；提取 APK 素材另需 Python 3.10+。

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

编辑 config.json，将 apiKeys[].key 替换为随机密钥。顶层 rpm 设置默认接口额度，各 Key 的 rpm 可单独覆盖。

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

python -m pip install -r scripts/requirements-phigros-extract.txt
python scripts/extract_phigros_apk.py --apk 'C:\path\to\base.apk'
npm start

访问 http://localhost:3000。使用 session:test 可预览样例成绩；修改端口可在启动前设置 $env:PORT = 3000。

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

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

接口说明见 API.md。