QQ点歌台 ENDDREAM-ZM/dsh-qq-sing

dsh-qq-sing

给 DSH 用的 QQ 点歌插件 · QQ音乐 / 酷狗 / 网易云三源，列表选歌，语音条 + 原文件双发

⚠️ 风险提示：本插件通过 NapCat / Lagrange 等第三方 QQ 协议端与 QQ 通信，不符合腾讯《QQ 软件许可及服务协议》，相关 QQ 账号可能被限制或永久封禁，请仅用小号测试；点歌依赖各音乐平台未公开接口，音频版权归原权利人，请勿二次分发或商业使用。完整条款见文末「许可与免责声明」。

群友说「点歌 晴天」→ 选音源 → 选歌 → 收歌。不需要模型参与，零延迟、不会答非所问。

在 QQ 里说「点歌 晴天」，机器人先问你用哪个音源，再列候选，你回个序号就把歌发过来（语音条 + 原文件双发）。

- 三音源：QQ音乐 / 酷狗音乐 / 网易云音乐
- 音质优先：按未登录/登录状态自动挑最高的那档（无损 → 320k → 128k），超体积自动降档
- 平台顺序不改：平台给什么顺序就什么顺序，插件只做「屏蔽词 / 时长 / 必须包含搜索词」剔除
- 会员歌也展示：取不到就直说「这首歌需要会员」

指令

| 你说 | 它做什么 |
| 点歌 晴天 | 列音源菜单（1 QQ音乐 / 2 酷狗 / 3 网易云） |
| 1 / 第二首 / 0 取消 | 选音源 / 选歌 / 取消 |
| @机器人 点歌 起风了 | 群里默认要 @，见 allowGroupWithoutAt |

支持的前缀：点歌 点一首 点首 唱一首 唱个 唱 来一首 来首 放一首 放首 想听 （冒号、逗号可有可无，中英文都行）

搜索是包含式的：搜 远航星 能出来 远航星的告别；搜 EZ4ENCE 能出来 EZ4ENCE (kannatuslaulu)。

设置

| 字段 | 默认 | 说明 |
| onebotHttpUrl | http://127.0.0.1:3000 | OneBot HTTP API |
| onebotWsUrl | ws://127.0.0.1:3001 | OneBot 正向 WebSocket |
| onebotToken | "" | HTTP token |
| onebotWsToken | "" | WS token，留空 = 同 HTTP（SnowLuma 两者不同） |
| selfId | "" | 机器人自己的 QQ 号 |
| ownerQQ | "" | 主人 QQ（登录态过期时私聊提醒用，可空） |
| qqMusicCookie | "" | QQ音乐登录态，见下 |
| kugouCookie | "" | 酷狗登录态 |
| neteaseCookie | "" | 网易云登录态 |
| topN | 6 | 候选表最多几条 |
| minSeconds | 20 | 短于此的当片段剔除 |
| maxSeconds | 480 | 长于此的剔除 |
| maxMB | 14 | 单个文件上限，超了自动降档 |
| sendMode | voice | voice 语音条+文件 / file 只发文件 / voiceOnly 只发语音条 |
| chooseTtlSeconds | 300 | 候选表几分钟内有效 |
| allowGroupWithoutAt | false | 群里不 @ 也响应 |
| banWords | 29 条 | 搜索屏蔽词，见下 |

banWords 怎么写

一行一个，或者用 , ， ; | 、 空格分隔都行，留空 = 不屏蔽：

banWords: |
dj
混音伴奏纯音乐

默认屏蔽：dj 混音 电音 慢摇 车载 串烧 鬼畜 电摇 摇摆 蹦迪 鼓点 重低音 加速版 降速版 减速版 降调 升调 变速 改编 抖音版 节奏版 旋律版 钢琴版 吉他版 伴奏 纯音乐 铃声 karaoke instrumental （不含 remix / 混音 之类以外的重混版本；纯 ASCII 词做了词边界，不会把 adj 当成 dj）

登录（会员歌 / 高音质）

三个平台的登录态都是 cookie，面板只能填字符串，所以给了一个扫码脚本：

node tools/login.mjs --platform qq # QQ音乐 · QQ 扫码
node tools/login.mjs --platform qq --wechat # QQ音乐 · 微信扫码
node tools/login.mjs --platform kugou # 酷狗音乐 · App 扫码
node tools/login.mjs --platform netease # 网易云音乐 · App 扫码（需 npm i qrcode）

- 二维码会存成 qr/*.png，加 --serve 会额外起个本地 http，手机同网段直接打开扫；
- 扫完脚本直接打印一行 cookie，粘到对应设置里；
- 微信那条链路偶尔会先返回 loginType 2 失败，脚本会自动再试 loginType 1。

| 平台 | 登录后多什么 |
| QQ音乐 | 320k / 无损（绿钻）；不登录只能搜、放不了 |
| 酷狗 | 高音质直链更稳 |
| 网易云 | 会员曲（fee=1/4）能放；免费曲不登录也有 320k |

不登录也能用：能搜、能放免费歌，会员歌会回「这首歌需要会员，登录有会员的账号后重试」。

各音源能力对比

| 音源 | 免登录 | 会员曲 | 备注 |
| QQ音乐 | 只能搜（匿名播放已关） | 需绿钻 cookie | 未登录会自动去另两个源找同一首 |
| 酷狗 | 能搜能放 128k | 标记 privilege=5 视为会员 | 华语老歌较全 |
| 网易云 | 能搜能放 320k | fee=1/4 需 cookie | 翻唱多，按平台原序展示 |

自测

node contract-test.mjs # 用真 defineTool 校验 3 个工具的 output.render
node smoke-test.mjs # 假 OneBot 服务跑一遍：搜歌 → 选歌 → 真发语音条

已知边界

- QQ音乐匿名接口随时可能收紧（现在只给搜索不给直链）；
- 三个平台的接口都是内部接口，字段变化会导致搜不到，先跑 smoke-test.mjs 定位；
- 语音条音质受 QQ 限制（silk 单声道 ~24kbps），要原音质就选 sendMode: file。

许可与免责声明

本项目采用 MIT License。

下载、安装或使用本插件，即视为你已阅读并同意以下全部内容：

1. 腾讯用户协议与封号风险：本插件通过第三方 OneBot v11 协议端（NapCat / Lagrange.OneBot / LLOneBot / SnowLuma / go-cqhttp 等）与 QQ 通信。此类非官方协议端不符合腾讯《QQ 软件许可及服务协议》，腾讯有权随时限制、冻结或永久封禁相关账号。请务必使用小号测试，禁止使用他人账号或主账号，因账号被封、数据丢失、好友/群关系损失等造成的一切后果由使用者自行承担。
2. 音乐版权与平台条款：搜歌、取直链依赖 QQ音乐 / 酷狗 / 网易云未公开的内部接口，该用法未获各平台授权；取到的音频文件著作权归原权利人所有。请仅用于个人学习与自用，禁止二次分发、批量下载、商业使用、对外提供服务或用于任何侵害著作权的用途。
3. 登录凭据：qqMusicCookie / kugouCookie / neteaseCookie 是你本人账号的登录凭据，请勿提交到仓库、截图外传或共享他人；因凭据泄漏造成的损失自负。
4. 禁止滥用：禁止将本插件用于刷屏、骚扰他人、发送垃圾信息、传播违法或有害内容，或任何违反中华人民共和国法律法规（含《网络安全法》《著作权法》《治安管理处罚法》等）及你所在地法律的用途。
5. 无担保：本插件按「现状」（AS IS）提供，不附带任何明示或默示担保。因平台接口变动、风控、账号限制或使用本插件造成的任何直接或间接损失，作者不承担任何责任。

若你不认同上述条款，请立即停止使用并删除本插件。

相关插件

- dsh-qq-image · 生图 / 封面 / 视频
- dsh-qq-voice · 9 种方言语音
- dsh-qq-bundle · 三个一起装