mcpField
T
tts

tts

github.com/alsk1992创意与媒体3.0k76 次安装7 周前更新
代码仓库

关于 tts

tts 是 Clodds 的文本转语音技能和 TypeScript API，可将文本转换为语音音频。它支持 ElevenLabs、macOS say 和 espeak，并提供语音选择、流式合成与队列播放。

主要功能

  1. 01三种语音合成提供方
  2. 02语音列表与试听
  3. 03流式语音合成
  4. 04消息队列播放
  5. 05语速、音量和输出控制

适用场景

  1. 01朗读成交信息和市场提醒
  2. 02试听语音并设置默认项
  3. 03将多条通知加入队列播放

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alsk1992/cloddsbot --skill tts

安装后在 Claude Code 中输入/tts确认已加载。

附带文件index.ts

详细介绍

TTS（文本转语音）- 完整 API 参考

使用 ElevenLabs、macOS say 或 espeak 将文本转换为自然流畅的语音。

聊天命令

合成语音
/speak "Your order has been filled"         Speak text aloud
/speak "Market alert" --voice rachel        Use specific voice
/speak "Portfolio up 5%" --speed 1.2        Adjust speed
语音管理
/voices                                     List available voices
/voices preview rachel                      Preview a voice
/voice set rachel                           Set default voice
设置
/tts status                                 Check TTS status
/tts provider elevenlabs                    Set provider
/tts speed 1.0                              Set default speed
/tts volume 0.8                             Set volume (0-1)

TypeScript API 参考

创建 TTS 服务
import { createTTSService } from 'clodds/tts';

const tts = createTTSService({
  provider: 'elevenlabs',
  apiKey: process.env.ELEVENLABS_API_KEY,

  // Defaults
  defaultVoice: 'rachel',
  defaultSpeed: 1.0,
  defaultPitch: 1.0,
});
合成语音
// Basic synthesis
const audio = await tts.synthesize('Hello, your trade was executed.');

// Play immediately
await tts.speak('Portfolio value is $10,000');

// With options
await tts.speak('Market alert: BTC crossed $100k', {
  voice: 'josh',
  speed: 1.2,
  pitch: 1.0,
  volume: 0.8,
});
流式合成
// Stream for long text (lower latency)
const stream = await tts.streamSynthesize(longText, {
  voice: 'rachel',
});

stream.on('data', (chunk) => {
  // Play audio chunks as they arrive
  audioPlayer.write(chunk);
});

stream.on('end', () => {
  console.log('Synthesis complete');
});
列出语音
// Get available voices
const voices = await tts.listVoices();

for (const voice of voices) {
  console.log(`${voice.id}: ${voice.name}`);
  console.log(`  Gender: ${voice.gender}`);
  console.log(`  Accent: ${voice.accent}`);
  console.log(`  Use case: ${voice.useCase}`);
}
语音预览
// Preview a voice
await tts.preview('rachel', 'This is a preview of the Rachel voice.');
队列管理
// Queue multiple messages
tts.queue('First message');
tts.queue('Second message');
tts.queue('Third message');

// Messages play in order

// Clear queue
tts.clearQueue();

// Skip current
tts.skip();

ElevenLabs 语音

语音 ID名称性别口音适用场景
rachelRachel女美式旁白
domiDomi女美式对话
bellaBella女美式柔和、温婉
antoniAntoni男美式旁白
joshJosh男美式低沉、威严
arnoldArnold男美式粗哑、有特色
adamAdam男美式低沉、旁白
samSam男美式沙哑、有特色

提供方

提供方质量延迟费用设置
ElevenLabs高级~500ms$5/100k 字符API 密钥
say（macOS）良好~100ms免费内置
espeak基础~50ms免费安装
提供方配置
// ElevenLabs (best quality)
const tts = createTTSService({
  provider: 'elevenlabs',
  apiKey: process.env.ELEVENLABS_API_KEY,
});

// macOS say (free, local)
const tts = createTTSService({
  provider: 'say',
  defaultVoice: 'Samantha',  // macOS voice
});

// espeak (cross-platform, free)
const tts = createTTSService({
  provider: 'espeak',
  defaultVoice: 'en-us',
});

音频输出

// Set output device
tts.setOutputDevice('Built-in Speakers');

// Get available devices
const devices = await tts.listOutputDevices();

SSML 支持（ElevenLabs）

// Use SSML for advanced control
await tts.speak(`
  <speak>
    <prosody rate="slow">Important alert:</prosody>
    <break time="500ms"/>
    Your stop loss was triggered.
  </speak>
`, { ssml: true });

最佳实践

  1. 使用流式处理 — 对于较长文本，可缩短首段音频的生成时间
  2. 缓存常用短语 — “订单已成交”“已触发警报”
  3. 调整语速 — 警报内容可加快语速，详情内容可放慢语速
  4. 队列管理 — 不要让重要消息相互重叠
  5. 备用提供方 — 如果 ElevenLabs 不可用，则使用 say/espeak

评论

支持 Markdown