牛牛唱歌 / 牛牛说 pallas-plugin-ai-media

提供牛牛唱歌与文字转语音（TTS），依赖 Pallas-Bot-AI 媒体服务。

安装方式

需已安装 Pallas-Bot ≥ 4.0，并部署 Pallas-Bot-AI。

推荐直接在控制台插件商店安装，或在本体项目中执行：

uv run pallas ext install pallas-plugin-ai-media

也可单独安装本包：

uv pip install pallas-plugin-ai-media

酒后对话由本体 llm_chat 承接（纯文字）。语音请用本包「牛牛说」。

怎么使用

牛牛唱歌（sing）

AI 翻唱、续唱、点歌与查歌名；依赖 AI 仓与本体 callback 回传音频。

口令 / 触发	场景	说明
牛牛唱歌 歌曲名 [key=±N]	群内	AI 翻唱
牛牛继续唱 / 牛牛接着唱	群内	续唱上一首
牛牛点歌 歌曲名	群内	网易云原曲
牛牛什么歌 / 牛牛哪首歌	群内	查询当前曲目
网易云登录 / 网易云登出	私聊	超管维护 Cookie

命令 ID	默认等级
sing.ncm_login	仅超管
sing.ncm_logout	仅超管

牛牛说（tts）

口令 / 触发	场景	说明
牛牛说 〈文本〉	群内	侧车 TTS 合成语音

命令 ID	默认等级
tts.speak	所有人

详细用法、限制条件和可用范围以帮助为主。

配置项

推荐在控制台 AI 配置 · 媒体：服务地址与 Bearer 在「媒体服务」连接里配置；音色映射 / 启停等在「唱歌」「TTS」面板（与插件页同源）。

• 唱歌：src/pallas_plugin_sing/config.py
• TTS：src/pallas_plugin_tts/config.py

自备唱歌音色放到 AI 仓 resource/sing/models/<音色名>/。

排障

现象	处理
唱歌无语音	查 AI 服务、/callback 可达；牛牛连通 测唱歌网关
「牛牛说」无语音	确认已启用 TTS；媒体服务 Bearer 与 AI 侧 PALLAS_AI_API_TOKEN 一致；音色默认已配置

实现

• src/pallas_plugin_sing/
• src/pallas_plugin_tts/

相关链接

说明	链接
唱歌	文档站 · sing
智能对话 / 酒后	文档站 · llm_chat
Pallas-Bot-AI	GitHub