[wt159]

背景

doc/player-state-contract.md §10.4 登记的唯一残留技术缺口：C1 的 error→state 顺序、C5 的「设备错误不跳轨」缺端到端判据。用户 2026-11-08 拍板「启动补齐 effort」，按一次性批量授权选最保守方案：#109 先重审 §8「不新造接缝」并批准一次限定例外、#110 实现，两票设原生阻塞边。

实现（只加一个默认关闭的注入点）

• AudioDevice::open() 包装层加文件级 std::atomic<bool>（默认 false，release/acquire），命中时直接 return -1，不进 Impl::open()、不碰 SDL；播放链走的是生产里真实存在的设备失败分支（MusicPlayer.cpp:326-330 → onMusicPlayListError:707），sdk/MusicPlayer.cpp 播放逻辑零改动。
• 读点只在控制线程调用 open() 时，绝不落解码线程 / 10 ms 消费主循环 / 判据主循环（O1 -j4 假红教训）。AudioDevice 是 SDK 内部类型，钩子不进入 soundbridge::Player 公开 API；七个 void 控制入口、三态、回调契约一字未动。
• 一条 AudioDeviceOpenFailed（StopPlayback）序列同时覆盖 C1（onError 早于 onStateChanged(Stopped)、发且仅发一次、错误码正确）与 C5（默认 autoSkip 开启也不跳到第二首、不触发第二次播放尝试）。双曲目列表 + 队列稳定窗口做屏障，RAII guard 保证异常时也恢复开关。

证据

项目	结果
单用例	12 / 12 断言绿
变异：去掉 SkipTrack 检查	6 条断言红（含 C5「索引不变」「只报一次 error」）
变异：onError 挪到 state 之后	errAt < stAt 精确红
变异还原	12 / 12 绿，MusicPlayer.cpp 零改动
ctest -j4 集成分支	10 / 10 轮全绿 14/14（56.65–59.17 s）
ctest -j4 master 基线	9 / 10 轮全绿（第 9 轮 sdk_interaction_tests 既有低概率 flake，与本用例无关）

分支假红率不高于基线 → O1 稳定性闸门通过。逐轮耗时与反悔通道见规格 §10.4。

零改动声明

sdk/MusicPlayer.cpp、sdk/include/soundbridge/、.github/、sdk/test/CMakeLists.txt 全部零改动；不新增 add_test 分组，不改 14 个 sdk_* 目标 / 7 组 TIMEOUT / BadInput 55 例 / 覆盖度 15 行矩阵 / 任何既有判据数值；#104「不设数值阈值」与 §3.2 第 5 步永久生效不变。

待验证（合并条件）

本地 Windows 全绿按 AGENTS.md 不算完成：须等 Linux sdk-coverage 与 Windows sdk-windows 双绿；之后关闭 #110 并留完整 resolution，规格里「落地」措辞才升级为「已收口」。一次两轴 code-review 提出的问题已在 fix 提交里全部修完（Standards 0 硬违规）。

票正文两处偏差（目标名 sdk_interaction_tests → 实际 sdk_unit_tests；C5 判据形态按实测调整）已在 #110 comment 更正，票正文不改。

Closes #110