song

@mai-kit/utils/song — 谱面查找、稳定 key 与曲目索引构建。

用于关联成绩与曲目数据。Rating、达成率和 DX 分等常用公式从 @mai-kit/utils 包根导入。

接口

接口	描述
DifficultyLists	供 findSongDifficulty 使用的曲目难度列表形状
DifficultyMeta	单谱面物量 / 定数最小字段
SongDifficultiesMeta	曲目难度分组最小字段
SongMeta	曲目最小字段（与 database Song 结构化兼容）。

函数

函数	描述
buildSongDxMaxMap	构建 songId:type:difficulty → DX 满分 映射。
buildSongLevelMap	构建 songId:type:difficulty → level_value 映射。
chartMapKey	从离散字段拼 key（与 scoreMapKey 结果一致）。
findSongDifficulty	按谱面类型与难度索引查找曲目难度，保留各类型的具体难度结构。
scoreMapKey	从成绩对象拼 key（字段名与 prober Score 一致）。