模板:曲目列表.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 數組