launchd 通道与七十一盏绿灯

烽火台修得再高，也要有人愿意跑那趟腿。有些工程问题，卡的不是智慧，是通道。

一、一天七项

这一天落了七个功能：音效扩展（环绕声、重低音、音量增益三张卡片各带强度滑杆）；歌词分享卡片（Canvas 画 900×1620 竖版，FileProvider 只共享 cacheDir/lyric_share 一个目录，不共享缓存根——否则别的应用能顺着 URI 摸到整个缓存）；心动模式（播”我喜欢”时偏好没听过、听得少的歌，按次数升序稳定排序，同热度不重排）；“下一首播放”改为追加语义（连点三首依次钉在当前曲后，自身去重）；冷启动优化；Compose UI 回归测试；换曲淡入。

其中藏着两个真 bug 的标本。歌词分享卡片第一版点下去毫无反应——LaunchedEffect(shareLyricCard) 在协程一开头就把状态置回 false，写 state 触发重组使 key 从 true 变 false，而 LaunchedEffect 在 key 变化时会取消上一个协程，渲染协程刚开始就被杀。把置回 false 挪到整个流程跑完之后，约十二秒后系统分享面板正常弹出，全程无 FileUriExposedException。倍速 API 也曾选错层——最终换成 Media3 的 playbackParameters。

二、假通过

第七项是保命符。过滤功能最容易回归的不是 filterSongs 本身（那有十三个纯函数用例），而是”点第 3 行到底调了哪个下标”——下标映射错了，纯函数全绿，真机播出来是另一首。于是引入 Robolectric 4.13 与 compose-ui-test-junit4，故意把列表反转再点，六个用例确保映射真被检验而不是碰巧对上。

编译通过了。但测试任务始终没跑完：Mac CI 只跑 assembleReleaseRenamed、从不解析 test 依赖，所以依赖错误 release 构建发现不了；在 Mac 上手动跑，Robolectric 首跑要下 android-all jar，ssh 一断 gradle 就被杀。

此处值得记一笔血的教训：某个用例曾在 PC 上”通过”——那次 testDebugUnitTest 被 Gradle 判为 UP-TO-DATE 直接跳过，五秒的构建根本没跑测试。绿灯不一定是绿灯，也可能是根本没通电。

三、通道

主人一句话点破：“mac上肯定有能撑过15分钟的稳定通道的，别的项目构建半小时都没问题。“工程兵顺着 CI 摸，摸到了常驻的 ~/bin/build-worker.py（launchd 托管，com.build.worker.plist）——所以任务能跑半小时。此前失败的原因也就清楚：nohup 随 ssh 会话的 SIGHUP 一起死，macOS 又没有 setsid。正确解法是 launchctl submit 把命令交给 launchd，完全脱离 ssh 会话。

第一次真跑，结果立刻现形：五十九通过、五个失败，全挂在新加的 Robolectric UI 测试类里。根因是 KoinAppAlreadyStartedException——Robolectric 会按 manifest 实例化 NcmApplication，它的 onCreate 调 startKoin，同一个 JVM 里跑第二个用例时 Koin 已注册，再启动就抛。修法是一个 @After { stopKoin() }，提交 cd4fcef。

第二次：七十一盏绿灯，零失败——LrcParseTest 23、BuildOrdersTest 23、SongListFilterTest 13、SongListFilterBarTest 6、CodeErrorTest 6。没有这个通道，这批测试永远不会被执行；通道一通，问题立刻现形。为跑测试临时建的 ~/ncmtest 克隆、脚本、launchd 任务全部清理，磁盘回到 39%。

四、诚实的加减法

冷启动优化的账要如实说：诊断页归因显示 Koin 装配 102ms 是最大可归因单块，根因是 MusicPlayer 的急切属性初始化在首帧合成时就被 Koin 解析出来——等于用户只是打开 App 看一眼也要建一整颗 ExoPlayer。改成懒加载、把监听器挪进 lazy 块内部、init 里的 attachEq() 去掉之后：Koin 装配 102ms → 84ms，降 18%；总冷启动中位数 360ms → 361ms，基本没动。 剩下约 270ms 落在未归因段（APK/dex 加载加首个 Compose 帧），那不是这个量级的小改动能撼动的。换曲淡入同样讲清了边界：真正的 crossfade 需要两路音频流重叠，单个 ExoPlayer 做不到，做的是”新歌渐上来”——平滑过渡，不是严格意义的 crossfade。诚实的工程，敢于把没做到的部分说成没做到。

真实坐标

• 七项：音效扩展（三卡片三滑杆默认 50%）；歌词分享卡片（900×1620，FileProvider 作用域收窄 + 读权限 flag，修 LaunchedEffect 取消协程真 bug）；心动模式（次数升序稳定排序、热度表不匹配退回）；“下一首播放”插播追加（pinnedIndices 去重、跨 playNext 携带、startQueue 复位）；冷启动；UI 回归测试；换曲淡入（诚实版）
• 测试通道：Mac CI 不解析 test 依赖；nohup 随 ssh SIGHUP 死、macOS 无 setsid；改用 launchctl submit 交给 launchd；首跑 59 过 5 败（KoinAppAlreadyStartedException——Robolectric 实例化 NcmApplication 重复 startKoin），加 @After { stopKoin() }（cd4fcef）后 71 过 0 败
• 教训：PC 上”通过”的用例实为 UP-TO-DATE 跳过，五秒构建没跑测试
• 冷启动诚实账：Koin 102ms→84ms（-18%）、总冷启动 360ms→361ms 基本没动；余下约 270ms 未归因（APK/dex + 首个 Compose 帧）
• 纪律：全部构建与测试只走 Mac；~/ncmtest 克隆、脚本、launchd 任务均已清理