SuperAPI AI 工具集

sag-voice

通用与其它

查看项目

更新于 10-15 21:36

技能介绍

用途:sag-voice 技能让 Claude 通过 sag CLI(ElevenLabs 文本转语音)直接朗读文本,并在关键时机发出语音通知(sag-notify),播报当前项目名称与状态。

主要能力:支持直接朗读文本、管道输入、列出可用语音(sag voices)与查看提示技巧(sag prompting);支持多种模型,如 eleven_v3(默认、富有表现力)、eleven_multilingual_v2、eleven_flash_v2_5(快速、多语言,通知默认)、eleven_turbo_v2_5。eleven_flash_v2_5 可用任意语音朗读非英语,仅带口音。

使用方式:该技能由 Claude 主动调用,而非钩子驱动。在向用户提问前或完成实质工作后,用 Bash 直接运行 sag speak,例如:sag speak --model-id eleven_flash_v2_5 --voice-id nPczCjzI2devNBz1zQrb "Hi, this is Claude. Project $PROJECT is done. <summary>" 2>>~/.claude/.sag-error.log &。需始终后台运行并重定向错误,避免阻塞。默认语音为 Brian(nPczCjzI2devNBz1zQrb,premade/免费)。可读取 ~/.config/sag-notify/config.json 中的 voice_id、model_id、self_name、language 等配置。

适用场景:在需要用户确认或输入时播报“needs you”,在完成代码修改、任务或构建验证后播报“done”,每轮最多一次。

限制:需要 ELEVENLABS_API_KEY(或 --api-key);未安装 sag、enabled 为 false 或无密钥时应静默跳过。免费套餐使用 library/professional 语音会返回 402,需改用 premade 语音或升级。若无声,可检查 ~/.claude/.sag-error.log、密钥与配置 JSON。安装与认证细节见 references/sag-cli.md。