只读视图、场景、音频与文本

本章覆盖 com.seecmd.mod.api 下四个包：context（游玩 / HUD / 结算只读视图）、scene（场景与输入抽象）、audio（音频类别与播放快照）、text（输入框组件与两个静态挂载点）。这些类型本身都不提供「注册」入口，模组通过事件、能力接口（如 GameplayHud、SceneHost）或 ModContext 拿到实例后读取或使用。

阅读时请注意两条贯穿全章的约定：

• 「只读视图」一律是宿主在投递点构造的快照，模组只读不写；需要更高频的游玩过程数据请改用对应能力接口。宿主在构造期用不可变包装固定列表，模组误写会立即抛 UnsupportedOperationException。
• 部分访问器（pendingNotes() / lanes() / coverImage() 等）带有明确性能警告，务必按其约定缓存。