SuperAPI AI 工具集

voice-wake-say

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:voice-wake-say 用于 macOS 环境,在对话来自 Voice Wake/语音识别时,把助手的回复用系统内置 say 命令朗读出来,避免使用会调用云端提供商的 tts 工具。

触发条件:需要逐条消息单独判断,上下文不延续。只有当最新用户或系统消息以“User talked via voice recognition”这一确切短语开头时,才触发朗读;短语必须位于消息最开头。若消息不以该短语开头,则不要使用 say,仅做纯文本回复。

使用方式:先判断语音唤醒场景;再基于最终回复文本准备朗读内容,去掉 Markdown 和代码块,内容较长或代码较多时只朗读简短摘要并说明细节在屏幕上;最后用命令 printf '%s' "$SPOKEN_TEXT" | say 朗读。如设置了变量可选用:printf '%s' "$SPOKEN_TEXT" | say -v "$SAY_VOICE" 或 printf '%s' "$SPOKEN_TEXT" | say -r "$SAY_RATE"。

流程建议:若消息来自语音唤醒,先用 say 确认已听到,再执行任务,完成后可视情况再次朗读。若消息要求“repeat prompt first”,需在回复中保留该行为。耗时任务应先确认,让用户知道正在处理。

失败处理:若 say 不可用或报错,仍要发送文本回复,并说明 TTS 失败。

限制:仅适用于 macOS;触发依赖特定消息前缀,不做跨消息上下文继承;不使用云端 tts;其余平台支持、收费或配置信息暂未提供。