用途
tts 用于生成语音旁白，适用于文本转语音、音频样本、配音，或让 Junior 以特定声音说话。它通过 Gemini TTS 经 Vercel AI Gateway 完成合成。
主要能力
- 使用随附的 scripts/speech.mjs 脚本进行语音生成。
- 提供默认的 junior-v1 预设音色：明亮、温暖、带点调皮与冷幽默的成年助手声音。
- 支持 --delivery plain 选项，用于严肃或敏感文本，去除调侃语气。
- 可生成内置的 Junior 声音样本，也可生成指定文本的旁白。
- 结果以 JSON 返回，包含 path、bytes、MIME 类型、model、voice、profile、delivery 以及 synthetic 状态。
使用方式
需要 Node.js 以及已安装插件宿主托管的 Gateway 密钥。不要安装 SDK，也不要在聊天中索取密钥。
将旁白文本写入 UTF-8 文件，每段控制在 1–5000 字符。生成到新的 .wav 路径；重试前先检查已有文件。不要自动重试超时或失败，因为生成可能已经消耗了额度。
命令示例：
- 本地查看可复用音色预设（不调用 API）：
node scripts/speech.mjs --profile - 付费生成内置 Junior 样本：
node scripts/speech.mjs --sample --output /tmp/junior-sample.wav - 付费生成指定旁白：
node scripts/speech.mjs --text-file /tmp/narration.txt --output /tmp/narration.wav - 付费使用同一音色但去除调侃：
node scripts/speech.mjs --text-file /tmp/incident.txt --output /tmp/incident.wav --delivery plain
使用 sendFiles 将返回路径以 audio/wav 交付，并说明这是合成旁白。若用于视频，需测量新音频并传入渲染工作流；仅生成语音不会更新视频。
用户询问音色如何定义时，读取 assets/junior-v1.json；预览样本脚本时读取 assets/sample.txt。脚本会将语气指令与文本分开发送，不要把这些指令前置到旁白中。使用 --help 查看命令界面。不接受密钥参数。
适用场景
- 为内容生成朗读旁白或配音。
- 生成 Junior 声音样本用于预览。
- 为视频制作准备音频（需另行传入渲染工作流）。
限制
- 需要 Node.js 和宿主托管的 Gateway 密钥；Sandbox 中缺少密钥属于预期情况。
- 生成会消耗 Gateway 额度，不要在没有请求的情况下生成额外变体。
- 单段文本限制 1–5000 字符。
- 不要将无关的私密上下文或完整人设发送给提供方。
- 不要将其呈现为对真实表演者的模仿或录音。
- 失败处理：缺少宿主密钥或 HTTP 401/403 时，请操作员检查
AI_GATEWAY_API_KEY、插件注册和团队语音访问权限后重新部署；HTTP 402 时检查额度与支出限制；HTTP 404 时报告所请求的 Gemini 模型对团队不可用，不要静默更换模型或提供方；超时、提供方警告或音频异常时，先停止并检查 Gateway 用量，再经用户授权重试，不要声称已创建或已试听音频文件；缺少脚本或 Node.js 时报告插件设置失败，不要临时拼凑带令牌的命令；缺少凭据时，可将预设与脚本作为配方分享，并明确标注并非生成的音频。