BetterSort 在 Muse Dash 选曲界面加一组浏览增强：底部排序按钮条（10 种排序模式，点同一个按钮翻转升降序）、左下角难度档位条（萌新/高手/大触/隐藏/弹幕）、右侧侧边选歌器（F9 展开，13 列表格 + 曲绘预览，点击跳歌）、左侧歌曲信息窗（达成率 / md·moe 定数与分数 / 排名 / BPM）。接 musedash.moe 真实排名（含 999+ 名次），自动计算 b50 位次；打完歌回选曲界面时，列表自动对准刚打的那首歌。
底部排序条 + 难度档位条 + 左侧信息窗（无侧边栏）：
右侧侧边选歌器窗口（13 列）—— 三种典型排序模式下的实际效果（左侧信息窗跟随 hover 同步）：
| md 分数 ↓ | BPM ↓ | 达成率 ↓ |
|---|---|---|
 |
 |
 |
- Windows 版 Muse Dash（Steam）——支持全部游戏版本
- MelonLoader 0.7.3（必需）
- MuseDashMirror（必需，v0.6.35 起为外置 mod 依赖，不再内嵌）——发版 zip 里已附带编译对应版本（当前 3.4.2）；单独获取走最新版直链：MuseDashMirror.dll (latest)
- 从 Releases 下载最新的
BetterSort-vX.Y.Z.zip - 退出 Muse Dash
- 解压，把里面的
BetterSort.dll和MuseDashMirror.dll两个文件都放进游戏根目录的Mods/文件夹- 如果
Mods/里已经有MuseDashMirror.dll（其他 mod 带的）：保留一份即可，优先保留更新的那份
- 如果
- 启动 Muse Dash，MelonLoader 控制台应出现
[BetterSort] vX.Y.Z 已初始化；进入选曲界面后，右下角出现排序按钮条、左下角难度档位条、左侧信息窗
每个 release zip 对应一个 .sha256 校验和文件：sha256sum -c BetterSort-vX.Y.Z.zip.sha256。
export MD_DIRECTORY="E:/Game/Steam/steamapps/common/Muse Dash" # 指向 Muse Dash 安装目录
dotnet build -c Release -p:BS_DEPLOY=1 # 把两个 DLL 拷进 Mods/（先退出游戏；不带此参数只编译不部署）构建细节、部署验证清单见 docs/DEV_NOTES.md。
- 底部按钮条（选曲界面右下角）横向 10 模式：默认 / 达成率 / md分数 / md定数 / moe分数 / moe定数 / 分数 / 首字母 / 曲包时间 / BPM
- 当前模式橙色高亮并带 ↑/↓ 方向箭头；点同一个按钮 = 翻转升降序；"默认"恢复游戏官方顺序
- F8 循环切换排序模式（游戏本体与侧边栏同步重排）
- 排序只对当前列表原地重排，不碰游戏的等级/标签筛选；详情页/主菜单自动隐藏面板
- 方向约定：左（前）= 高/新/好；随机占位条（"?"）固定在列表最末
- F9（或底部"展开"）打开 990 px 宽的选歌器：13 列（编号 / 曲名 / 档位 / 难度 / md / moe / md分 / moe分 / 达成率 / 分数 / 排名 / FC·AP / BPM），行带曲绘预览
- hover 任意行，左侧信息窗即时跟随显示该曲数据
- 点击一行 → 面板关闭，游戏列表按当前排序重排并跳到那一首
- 左下角难度档位条（默认大触）：只决定信息窗显示哪个难度的数据，不影响排序与游戏列表；该档无谱面时数据区显示 "—"
- R 键（或点信息窗本身）在萌新/高手/大触/隐藏/弹幕间轮换；轮换含"隐藏窗"态（信息窗整个隐藏，原位置留淡提示热区，点一下回萌新）
- 信息窗显示：曲师·谱师 / 曲包 / 档位·等级 / md·moe 定数与分数 / 达成率 / 分数 / 全球排名 / FC·AP / BPM，带曲绘背景水印
设置自动持久化到 %MuseDash%/UserData/BetterSort.cfg，直接编辑 + 重启游戏生效：
| 键 | 默认 | 说明 |
|---|---|---|
SortMode |
Default |
启动时恢复的排序模式 |
SortAscending |
false |
排序方向（false = 降序） |
NextSortKey |
F8 |
循环切换排序模式的热键 |
OpenWindowKey |
F9 |
打开/关闭侧边选歌器的热键 |
CycleDifficultyKey |
R |
轮换信息窗难度档的热键 |
ShowIndicator |
true |
是否显示底部排序按钮条 |
UseFilterBucket |
true |
信息窗难度档跟随游戏等级筛选（false = 固定大触档） |
RefreshDifficultyData |
false |
启动时刷新 moe 定数数据 |
UseSelectorWindow |
true |
false = 旧行为：按 F8 直接原地重排游戏列表，不开窗口 |
排序模式 / 升降序改动采用脏标记，正常退出游戏时才写盘——游戏崩溃会丢最近一次按键的设置（避免长按 F8 卡顿的取舍）。
- AP 判定：游戏日志没有
isPerfect字段，以运行时达成率 ≥99.995% 判 AP。 - 首字母排序的中文部分只覆盖 ~800 个常见汉字，未覆盖到的字按 Unicode 码点排序。
- 排行榜名次：moe 玩家接口为主来源；游戏日志被清（账号 ID 提取不到）时只剩运行时缓存兜底，名次会大量显示 "—"。
- 滚动性能：侧边选歌器直挂所有行（~600 首 × 10 列），低端机可能 30 fps。
- 侧边选歌器无法筛选（只展示 + 排序 + 点击跳转）；筛选请用游戏本体自带的。
- 完整变更历史：docs/CHANGELOG.md（各版本发布说明另见 Releases）
- 排序数据源与算法、界面语义、Hook 原理、目录结构、部署验证清单：docs/DEV_NOTES.md
- 维护者发版流程：docs/RELEASING.md
GPL-3.0