用途：oma-voice 让支持 MCP 的智能体借助本地 Voicebox 应用说话（TTS）或听写（STT），无需调用云端语音服务，可用于旁白、语音资产、听写与会议转写，也可在长任务完成或受阻时生成语音通知。
主要能力：TTS 每次最多 5000 字符（2000 字符时提示），输出 wav（mp3 需本地 ffmpeg 转码），结果存于 .agents/results/voice/{timestamp}-{shortid}/ 并附 manifest.json；STT 支持 mp3、wav、m4a、webm、flac，单次上限 30 分钟，输出 transcript.md 与 manifest.json；通知模式默认不落盘，经 Voicebox 播放。
使用方式：先安装并运行 Voicebox 桌面应用，注册 MCP：claude mcp add --transport http voicebox http://127.0.0.1:17493/mcp。TTS 需在 Voicebox 界面创建至少一个语音配置。技能通过 MCP 调用 voicebox_speak、voicebox_transcribe、voicebox_list_profiles，并用 GET http://127.0.0.1:17493/health 做健康检查；持久化音频需通过 GET http://127.0.0.1:17493/audio/{generation_id} 获取。示例：/oma-voice "build succeeded, 4 minor warnings"、/oma-voice transcribe ~/Downloads/standup.m4a。
限制：仅限回环地址 127.0.0.1:17493，不使用云端语音，无声音克隆 UI、录音归档、故事编辑器、终端实时麦克风听写与音乐音效合成；v1 不自动分块或切分；Voicebox 不可达时只提示安装或启动，不重试或自动重启；输出目录默认须在 $PWD 内。官方称 Voicebox 免费，无费用限制。其余细节以资料所述为限。