用途：在 SwiftUI 应用中实现语音优先的智能体聊天交互。命令坞以语音为主：按住麦克风胶囊说话，玻璃球随语音膨胀并产生边缘涟漪，弯曲的“Listening…”标签下实时显示字幕，松手后转写文本直接作为已发送消息进入全屏聊天并流式接收回复；键盘按钮为次要入口，两条路径落到同一聊天界面。
主要能力：包含四份参考实现——speech-engine.md 提供双后端语音门面（iOS 26 的 SpeechAnalyzer/SpeechTranscriber 与 SFSpeechRecognizer 回退）、麦克风电平、音频会话 actor 与快速点击竞态修复；listening-orb.md 提供语音响应覆盖层（玻璃球、电平驱动涟漪、弯曲状态文字、遮罩与按压延迟规则）；chat-layer.md 提供全屏聊天呈现（卡片式背景、拖拽关闭、屏幕高度过渡、坞模式输入栏变形）；agent-wiring.md 负责将各入口统一路由到同一聊天界面（ChatRequest）、松手即发送、流式智能体接入与错误边界。
使用方式：按参考文件复制实现，而非重新推导。建议构建顺序为：语音门面与坞胶囊按住手势（在真机验证转写与电平）、由 speech.level 驱动的聆听覆盖层、聊天层呈现、松手发送与智能体流式、聊天内坞模式输入栏、最后加错误边界与权限提示。
限制与注意：按住说话无法在模拟器驱动，SpeechTranscriber 模型在模拟器上不受支持，需真机测试；iOS 26 转写需先调用 AssetInventory.reserve，否则静默失败；麦克风权限被拒或引擎失败时应退出聆听界面并提供设置入口，不能假装在听。相关技能：swiftui-sheet-keyboard-animations、convex-streaming-agents、ios-clerk-auth。