语音覆盖层生命周期（macOS）

目标读者：macOS 应用贡献者。目标：当唤醒词和按住说话重叠时，保持语音覆盖层行为可预测。

当前意图

如果覆盖层已经因唤醒词而可见，而用户此时按下热键，则热键会话会_接管_现有文本，而不是重置它。只要用户持续按住热键，覆盖层就会保持显示。用户松开时：若存在去除首尾空白后的文本，则发送；否则关闭。
仅使用唤醒词时，静音后仍会自动发送；按住说话则在松开时立即发送。

覆盖层会话现在为每次捕获（唤醒词或按住说话）携带一个 token。当 partial / final / send / dismiss / level 更新的 token 不匹配时，这些更新会被丢弃，从而避免过期回调。
按住说话会将任何当前可见的覆盖层文本作为前缀接管（因此当唤醒覆盖层可见时按下热键，会保留文本并附加新的语音）。它最多等待 1.5 秒以获取最终转录，否则回退到当前文本。
铃声 / 覆盖层日志现在会在类别 voicewake.overlay、voicewake.ptt 和 voicewake.chime 下以 info 级别输出（会话开始、partial、final、send、dismiss、铃声原因）。

VoiceSessionCoordinator（actor）
- 一次只拥有一个 VoiceSession。
- API（基于 token）：beginWakeCapture、beginPushToTalk、updatePartial、endCapture、cancel、applyCooldown。
- 丢弃携带过期 token 的回调（防止旧识别器重新打开覆盖层）。
VoiceSession（模型）
- 字段：token、source（wakeWord | pushToTalk）、已提交 / 易变文本、铃声标志、计时器（自动发送、空闲）、overlayMode（display | editing | sending）、冷却截止时间。
覆盖层绑定
- VoiceSessionPublisher（ObservableObject）将活动会话镜像到 SwiftUI 中。
- VoiceWakeOverlayView 仅通过 publisher 进行渲染；它绝不直接修改全局单例。
- 覆盖层用户操作（sendNow、dismiss、edit）会携带会话 token 回调到 coordinator。
统一发送路径
- 在 endCapture 时：如果去除首尾空白后的文本为空 → 关闭；否则执行 performSend(session:)（只播放一次发送铃声、转发、关闭）。
- 按住说话：无延迟；唤醒词：可选延迟后自动发送。
- 在按住说话结束后，对唤醒运行时应用一个短暂冷却期，以避免唤醒词立即再次触发。
日志
- Coordinator 在子系统 ai.openclaw 的类别 voicewake.overlay 和 voicewake.chime 下输出 .info 日志。
- 关键事件：session_started、adopted_by_push_to_talk、partial、finalized、send、dismiss、cancel、cooldown。

在复现粘滞覆盖层问题时流式查看日志：

sudo log stream --predicate 'subsystem == "ai.openclaw" AND category CONTAINS "voicewake"' --level info --style compact

添加 VoiceSessionCoordinator、VoiceSession 和 VoiceSessionPublisher。
重构 VoiceWakeRuntime，使其通过创建 / 更新 / 结束会话来工作，而不是直接操作 VoiceWakeOverlayController。
重构 VoicePushToTalk，使其接管现有会话，并在释放时调用 endCapture；同时应用运行时冷却。
将 VoiceWakeOverlayController 连接到 publisher；移除来自 runtime / PTT 的直接调用。
为会话接管、冷却和空文本关闭添加集成测试。