模板:曲目列表.json/Docs

本页为模板:曲目列表.json的文档（数据页，JSON 内容模型）。

用途

全站曲目数据的唯一数据源，供以下页面读取： 模块:曲目列表（曲目列表页）、模块:曲包列表（曲包列表页）、 模块:定数表（定数表页）、模块:曲目页面（单曲页信息框）。

结构

• 顶层: songs(普通曲目数组) / special(石墩子模式数组)
• 每项字段: 曲绘 / 曲名 / 曲师 / 难度 / 定数 / 曲包 / 谱师 / 时长 / BPM / lang

更新方式（定期）

本地 `曲目列表.json` 编辑后执行：

python3 jsonpipeline/update.py           # 全量
python3 jsonpipeline/update.py --songs-only   # 仅本页

• 定数/谱师等来自游戏解包 `song_constants.json`，字段缺失时才注入（不覆盖手工值）
• 曲名以游戏内为准；lang 标注日文曲目
• 注意：MediaWiki 保存时会用 PHP json_encode 重排（4.0 会存成 4），数值不变

约定

• 不在列表中出现的曲目（如测试遗留页）请从 songs 移除
• 特殊曲目（石墩子）放 special 数组