字数
719 字
阅读时间
3 分钟
牛牛唱歌 sing
智能翻唱、续唱、点歌与查歌名。
安装方式
可在控制台插件商店安装，或执行 uv run pallas ext install pallas-plugin-ai-media。使用前还需要部署 Pallas-Bot-AI。
怎么使用
| 口令 / 触发 | 场景 | 说明 |
|---|---|---|
牛牛唱歌 歌曲名 [key=±N] | 群内 | 让牛牛翻唱指定歌曲，可附带升降调参数。 |
牛牛继续唱 / 牛牛接着唱 | 群内 | 续唱上一首歌。 |
牛牛点歌 歌曲名 | 群内 | 播放网易云原曲。 |
牛牛什么歌 / 牛牛哪首歌 | 群内 | 查询当前播放曲目。 |
网易云登录 / 网易云登出 | 私聊 | 维护网易云账号登录状态。 |
详细用法、限制条件和可用范围以帮助为主。
命令权限
| 命令 ID | 默认等级 | 说明 |
|---|---|---|
sing.sing | 所有人 | 牛牛唱歌 / 牛牛继续唱 |
sing.play | 所有人 | 牛牛唱歌（随机，无歌名） |
sing.request_song | 所有人 | 牛牛点歌 |
sing.song_title | 所有人 | 牛牛什么歌 |
sing.ncm_login | 仅超管 | 网易云登录 |
sing.ncm_logout | 仅超管 | 网易云登出 |
配置项
可在控制台对应插件页中修改。
主要在控制台的插件页和 通用配置 → 外部服务地址 中配置唱歌服务地址。
排障
| 现象 | 处理 |
|---|---|
| 没有返回语音 | 先确认 AI 服务在线，再发送 牛牛连通 测唱歌服务。 |
| 点歌失败 | 检查网易云账号是否已登录。 |
实现
源码位置：pallas-plugin-ai-media 扩展仓中的 sing 插件目录
关键文件：
- 扩展仓
sing插件的__init__.py：注册命令、权限和帮助文案。 - 扩展仓
sing相关命令处理文件：负责翻唱、续唱、点歌和查歌名流程。 - 主仓 AI 服务连通性相关文档与能力：用于定位服务地址、检查接口是否可用。
实现要点：
- 翻唱与续唱依赖外部 AI 服务生成语音，Bot 侧主要负责收集口令参数并回传音频结果。
点歌与查歌名依赖网易云侧能力，所以服务在线不代表一定能点歌，还要看登录状态。- 这个插件和
chat共用pallas-plugin-ai-media扩展包，但命令权限、触发方式和故障定位要分别看。
