coderzc/open-xiaoai-bridge/xiaoai-tts

Claude Code and agent skill by coderzc/open-xiaoai-bridge

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Control Xiaoai speaker via OpenXiaoAI Voice API for high-quality TTS playback. Use when the user wants to play voice notifications, announcements, or TTS through the Xiaoai speaker using the OpenXiaoAI HTTP API. Supports Doubao (ByteDance) TTS with emotions, voice types, and speed control. Triggers on queries like "小爱播报", "语音播报", "让小爱说", "读出来", "播报"， "xiaoai-tts"，"tts", "TTS", "小爱音箱语音播报".

Install

npx vskill@latest install coderzc/open-xiaoai-bridge/xiaoai-tts

SKILL.md

XiaoAI TTS

通过 XiaoAI HTTP API 控制小爱音箱播放语音，支持火山引擎豆包 TTS 多情感、多音色、语速调整等高级功能。

前置配置

在 env 中添加：

bash
OPENXIAOAI_BASE_URL="http://192.168.x.x:9092"  # OpenXiaoAI 服务地址

使用方法

bash
# 语音播报（优先 Doubao TTS，失败自动回退小爱自带 TTS）
xiaoai-tts tts "你好，我是小爱语音助手"
 
# 指定音色
xiaoai-tts tts "你好" -s zh_female_vv_uranus_bigtts
 
# 调整语速（0.8-2.0）
xiaoai-tts tts "你好" --speed 1.2
 
# 指定情感（仅多情感音色支持）
xiaoai-tts tts "你怎么能这样！" -s zh_male_lengkugege_emo_v2_mars_bigtts -m angry
 
# 2.0 音色 + 上下文指令
xiaoai-tts tts "这是一个很长的句子" -s zh_female_vv_uranus_bigtts -c "你可以说慢一点吗？"
 
# 强制使用小爱自带 TTS
xiaoai-tts text "你好"
 
# 唤醒小爱
xiaoai-tts wakeup
xiaoai-tts wakeup --silent   # 静默唤醒
 
# 状态 / 健康检查
xiaoai-tts status
xiaoai-tts health
 
# 播放音频
xiaoai-tts file /path/to/audio.mp3
xiaoai-tts url "http://example.com/audio.mp3"
 
# 查看可用音色
xiaoai-tts voices            # 所有音色
xiaoai-tts voices -v 2.0     # 仅 2.0 音色
xiaoai-tts voices -v 1.0     # 仅 1.0 音色

常用音色推荐

用户自定义声音复刻（S_ 前缀）

如果用户想使用自定义复刻音色，引导用户前往 火山引擎声音复刻控制台 上传声音训练专属音色，训练完成后在 音色库 的「我的音色」中复制音色 ID（格式为 S_xxxxxxxx），填入 -s 参数即可使用。

bash
xiaoai-tts tts "你好，我是你的专属语音助手" -s S_xxxxxxxx
注意：声音复刻音色 ID 通常以 S_ 开头，传入时无需通过 xiaoai-tts voices 列表验证，直接使用即可。

工作流：

  1. 用户想使用自定义复刻音色时，引导用户前往火山引擎完成声音训练并获取音色 ID
  2. 用户拿到音色 ID 后，引导用户将音色昵称和 ID 填入下方表格
  3. 后续用户提到音色昵称时，直接从表格中查找对应 ID 使用
用户已保存的自定义音色
音色名称speaker_id特点
（暂无，引导用户添加）--
2.0 音色（推荐）
音色名称speaker_id特点
Vivi 2.0zh_female_vv_uranus_bigtts通用场景，情感变化
小何 2.0zh_female_xiaohe_uranus_bigtts通用场景
云舟 2.0zh_male_m191_uranus_bigtts通用场景
小天 2.0zh_male_taocheng_uranus_bigtts通用场景
1.0 音色（多情感）
音色名称speaker_id特点
冷酷哥哥zh_male_lengkugege_emo_v2_mars_bigtts支持 emotion 参数
高冷御姐zh_female_gaolengyujie_emo_v2_mars_bigtts支持 emotion 参数
灿灿zh_female_cancan_mars_bigtts通用场景
爽快思思zh_female_shuangkuaisisi_moon_bigtts通用场景

情感参数（仅多情感音色）

中文情感英文参数说明
开心happy愉快语气
悲伤sad悲伤语气
生气angry愤怒语气
惊讶surprised惊讶语气
撒娇lovey-dovey撒娇语气
温柔tender温柔语气
讲故事storytelling讲故事语气
新闻播报news新闻播报语气
广告营销advertising广告营销语气
磁性magnetic磁性声音

完整情感列表参考：xiaoai-tts voices

API 端点

  • Base URL: http://{host}:9092
  • Content-Type: application/json
Security
  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed
See the full security report
Quality evaluation
  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
See evaluation results
Source
Popularity
Repository stars
256
Repository forks
38
7-day trend score
28
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/coderzc/open-xiaoai-bridge/xiaoai-tts/badge)](https://verified-skill.com/skills/coderzc/open-xiaoai-bridge/xiaoai-tts)
Something wrong with this skill or its page? Tell us.