zijunchiang
fad2599e63
V1.5.1: 修复"点歌最后一首按切歌→播完卡死"，并按要求改为转入公放
现象: 点歌清单只剩最后一首且正在播放时按一下「切歌」，那首歌播完后 App 直接卡死
（之后按切歌/播放都没反应）。
根因（advancePlayback 的出口语义 + 僵尸态）:
- orderQueue 是"已点清单"，正在播的那首**仍在队列里**；按切歌时才移除。
- 旧逻辑: 显式切歌移除最后一首后队列已空 → 落到"清空到空闲态"分支，
该分支把 currentSong 置空、playWhenPrepared=false，**却没有停播放器**。
- 于是那首歌继续播到结束；而 onCompletion 第一行是
`if (generation != playbackGeneration || currentSong?.equals(song) != true) return`
→ currentSong 已为 null，回调被**直接吞掉**，再也不推进。
- 结果就是"音频结束 / currentSong 为空 / 播放中标志为 false"的僵尸态：
再按切歌或播放都没有任何反应（用户看到的卡死）。
修复（完全按用户要求的状态机）:
- 显式切歌且点歌清单已空（= 在最后一首上按切歌）→ **转入公放**（playRandomLocalSong(skipped)），
不再清空到空闲态。公放清单与点歌清单互不影响：随机歌曲不入 orderQueue；
用户一点歌，挂起的随机请求会被 orderQueue.isNotEmpty() 守卫取消。
- 其它出口保持原逻辑不变（队列还有歌→下一首；自然播完+autoNext+队列空→公放；
手动模式自然播完→空闲）。
- 僵尸态兜底: 所有"清空播放状态"的出口都补上 `player.stopPlayback()` + currentMediaPlayer = null
（空闲态分支、公放库为空的兜底分支）。唯一例外是马上 play() 下一首的路径——
故意不停，避免切歌瞬间因曲库扫描而静音。
AGENTS.md 增补「切歌/续播状态机」四条出口 + 僵尸态的成因与强制约定。
版本 1.5.0(31) → 1.5.1(32)；签名证书不变。测试 8 例全通过。
2026-09-26 21:47:12 +08:00
..
2026-09-04 21:23:21 +08:00
2026-09-26 21:47:12 +08:00
2026-09-26 21:47:12 +08:00
2026-09-04 21:23:21 +08:00