claude-speak

Claude Speak 是一个使用高质量文本转语音（TTS）将文本朗读出来的工具，底层在 Apple Silicon 上使用 Kokoro TTS，默认声音为英式男声 bm_george。它支持通过进程池进行并发音频生成。

用途当用户要求“把这段读出来”“朗读这段”“语音反馈”，或使用 /speak 命令、请求对内容进行语音化时，可以调用该工具。

主要能力

文本朗读：将给定文本合成为语音并播放。
声音选择：默认 bm_george（英式男声，庄重），可选 af_heart（美式女声，温暖）、am_adam（美式男声，低沉）、bf_emma（英式女声，优雅）。
语速调整：默认 1.0，可通过 -s 参数调整。
静默模式：通过 -q 抑制错误输出。
自定义超时：默认 300 秒（5 分钟），可通过 -t 参数设置。
并发生成：守护进程通过 ProcessPoolExecutor 支持并发音频生成。

使用方式核心命令： ~/Projects/claude-speak/.venv/bin/claude-speak-client "Text to speak" 守护进程通过 launchd 在后台运行，响应即时。

常用选项：

不同声音：~/Projects/claude-speak/.venv/bin/claude-speak-client -v af_heart "Warm female voice"
调整语速：~/Projects/claude-speak/.venv/bin/claude-speak-client -s 1.2 "Speaking faster"
静默模式：~/Projects/claude-speak/.venv/bin/claude-speak-client -q "Silent on success"
自定义超时：~/Projects/claude-speak/.venv/bin/claude-speak-client -t 600 "Very long text..."

长文本（3 句以上）：使用 shell 后台运行实现“发射后不管”： ~/Projects/claude-speak/.venv/bin/claude-speak-client "Your longer text here..." & 末尾的 & 在 shell 层面将命令放入后台，Claude Code 不会将其作为任务跟踪，音频在对话继续时播放，避免超时错误或误报“失败”。

并发：守护进程支持两条请求路径：

speak（朗读播放）：通过单一播放队列串行化，防止音频重叠。
generate_file（返回 WAV 字节）：在工作进程中并行化，每个进程拥有自己的模型副本。

守护进程池配置：

启动并指定工作进程数（默认根据 CPU 数量自动）：~/Projects/claude-speak/.venv/bin/claude-speak-daemon start --workers 3
查看池状态：python3 -c "from claude_speak_daemon import send_command; print(send_command({'command': 'ping'}))"，返回示例：{"success": true, "status": "ready", "num_workers": 3, "playback_queue_depth": 0}

编程式文件生成（用于并发）： from claude_speak_daemon import send_command result = send_command({ "command": "generate_file", "text": "Generate audio without playing", "voice": "bm_george", "speed": 1.0 }, timeout=120.0) 返回示例：{"success": true, "audio_base64": "...", "duration": 2.7, "format": "wav"}

适用场景

短文本（1-2 句）：正常直接运行。
长文本（段落）：使用 & 后台运行。
批量或并发生成：以编程方式使用 generate_file 命令。
出现问题时检查守护进程状态，并使用 --workers N 调整池大小以适应工作负载。

限制与故障排查

若出现“Daemon not running”错误，运行：~/Projects/claude-speak/.venv/bin/claude-speak-daemon start
代码更新后需重启守护进程以应用更改：~/Projects/claude-speak/.venv/bin/claude-speak-daemon restart
该工具依赖 Apple Silicon 上的 Kokoro TTS，其他平台支持情况暂未提供。
安装方式、收费与价格信息暂未提供。

技能介绍