speakturbo — 与你的 Claude 对话！

为你的智能体赋予实时语音交互能力。超低延迟（约 90ms）的文本转语音，内置 8 种语音。

快速开始

# 立即播放 —— 你将通过扬声器听到“Hello world”
speakturbo "Hello world"
# 输出： ⚡ 92ms → ▶ 93ms → ✓ 1245ms

# 通过保存为文件验证功能是否正常
speakturbo "Hello world" -o test.wav
ls -lh test.wav  # 应显示大小约为 50–100KB 的文件

输出说明：⚡ = 首帧音频接收完成，▶ = 播放已启动，✓ = 全部完成

首次运行

首次执行耗时约 2–5 秒，用于启动后台守护进程（daemon）并将模型加载至内存。后续调用首音延迟约 90ms。

# 首次运行（较慢 —— 守护进程正在启动）
speakturbo "Starting up"  # ~2–5 秒

# 第二次运行（较快 —— 守护进程已就绪）
speakturbo "Now I'm fast"  # ~90ms

使用方法

# 基础用法 —— 立即播放（默认语音：alba）
speakturbo "Hello world"

# 保存为音频文件（不播放）
speakturbo "Hello" -o output.wav

# 保存为指定文件名
speakturbo "Goodbye" -o goodbye.wav

# 静默模式（抑制状态信息输出，但仍会播放音频）
speakturbo "Hello" -q

# 列出所有可用语音
speakturbo --list-voices

可用语音

性能指标

架构设计

speakturbo (Rust CLI，2.2MB)
    │
    │ HTTP 流式传输（端口 7125）
    ▼
speakturbo-daemon (Python + pocket-tts)
    │
    │ 模型驻留内存，空闲 1 小时后自动退出
    ▼
音频播放（rodio）

文本输入

• 编码格式：UTF-8
• 文本中包含引号：需使用转义： speakturbo "She said "hello""
• 长文本支持：支持，边生成边流式输出

输出路径安全机制

-o 参数仅允许写入白名单内的目录。默认白名单包括：

• /tmp 及系统临时目录
• 当前工作目录
• ~/.speakturbo/

如需写入其他路径，请使用 --allow-dir 参数：

speakturbo "Hello" -o /custom/path/audio.wav --allow-dir /custom/path

如需永久添加允许目录，请将其写入 ~/.speakturbo/config：

mkdir -p ~/.speakturbo && echo "/custom/path" >> ~/.speakturbo/config

该配置文件每行一个目录路径；以 # 开头的行视为注释。

退出码

适用场景

建议使用 speakturbo 的情况：

• 需要极低延迟的语音反馈（约 90ms）
• 响应速度比语音多样性更重要
• 内置语音已满足需求

建议改用 speak 的情况：

• 需要自定义语音克隆（如 Morgan Freeman 等） → speak "text" --voice ~/.chatter/voices/morgan_freeman.wav
• 需要情感标签，例如 [laugh]、[sigh]
• 语音质量与多样性优先于响应速度

详见 speak 技能文档获取完整用法。

故障排查

无音频输出：

# 检查守护进程是否运行中
curl http://127.0.0.1:7125/health
# 预期返回： {"status":"ready","voices":["alba","marius",...]}

# 通过保存为文件并手动播放验证
speakturbo "test" -o /tmp/test.wav
afplay /tmp/test.wav  # macOS
aplay /tmp/test.wav   # Linux

守护进程无法启动：

# 检查端口占用情况
lsof -i :7125

# 手动终止并重启
pkill -f "daemon_streaming"
speakturbo "test"  # 自动重启守护进程

首次运行较慢： 此属正常现象。守护进程需将约 100MB 的模型加载至内存。后续调用将恢复高速响应（约 90ms）。

守护进程管理

守护进程在首次使用时自动启动，并在空闲 1 小时后自动关闭。

# 查看运行状态
curl http://127.0.0.1:7125/health

# 手动停止
pkill -f "daemon_streaming"

# 查看日志
cat /tmp/speakturbo.log

与 speak 的对比