dsh-qq-sing
QQ 点歌插件（DSH 插件，OneBot v11）：点歌 → 选音源 → 选歌，三源 QQ音乐/酷狗/网易云
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ENDDREAM-ZM/dsh-qq-sing#f04d94180a7e546f1580baaa032185091ff83825Qq Sing 以 dsh-qq-sing 发布，当前版本为 1.0.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
群友说「点歌 晴天」→ 选音源 → 选歌 → 收歌。不需要模型参与，零延迟、不会答非所问。
在 QQ 里说「点歌 晴天」，机器人先问你用哪个音源，再列候选，你回个序号就把歌发过来（语音条 + 原文件双发）。
| 你说 | 它做什么 |
|---|---|
点歌 晴天 | 列音源菜单（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: |
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，手机同网段直接打开扫；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 服务跑一遍：搜歌 → 选歌 → 真发语音条
smoke-test.mjs 定位；sendMode: file。