dsh-pet-qqmusic

鲸歌：让 dsh-pet 跟着 QQ 音乐 / 网易云音乐逐行显示歌词。QQ 音乐走 Windows SMTC，网易云读本地 cloudmusic.elog（无需插件、支持 seek），延迟可调、翻译、桌面悬浮模式不切动画实现桌宠歌词同步与翻译，适合想要在桌面或Web端边听歌边看歌词互动的用户。

패키지

dsh-pet-qqmusic

호환성

미검증

Harness peer 범위

^0.2.0-rc.1

Cordis peer 범위

^4.0.4

버전

1.3.0

라이선스

MIT

최근 업데이트

2026. 10. 18.

用户配置在 $DSH_HOME/dsh-pet-qqmusic/config.json（默认 %USERPROFILE%\.dsh\dsh-pet-qqmusic\config.json）。改完下一轮生效，不需要重启。

键	默认	说明
`enabled`	`true`	总开关；关掉后浏览器侧不再投喂
`petId`	`""`	目标桌宠 id；空 = dsh-pet 当前桌宠（`/pet` 选中的那只，未选则第一只）
`player`	`"auto"`	`auto`：谁在播放就用谁；`qq` / `netease` 强制指定播放器（两个客户端同时开时有用）
`displayMode`	`"auto"`	`auto`：web 桌宠用自绘气泡、桌面悬浮回落到投喂；`overlay`：只用自绘气泡（不触发动画，桌面模式不显示）；`bubble`：始终走 `dsh-pet /broadcast`
`offsetMs`	`600`	歌词提前量（毫秒），范围 −5000 ~ 5000；正数 = 歌词更早出现。默认 600 是补偿 dsh-pet 气泡约 1 秒的轮询
`keepAliveSec`	`8`	同一行超过 N 秒补发一次，防止气泡 10 秒自动收起；`0` = 不补发
`showTrackInfo`	`true`	切歌时先显示「歌名 - 歌手」
`showTranslation`	`false`	有翻译时显示两行（原文 + 译文）
`prefix`	`"♪ "`	气泡前缀，最多 8 字符
`hints`	`true`	没有 SMTC / 没开 QQ 音乐时让桌宠提示（每 10 分钟最多一次）
`debug`	`false`	宿主日志开关

也可以直接改接口（把 `` 换成你的 DSH 端口）：

dsh-pet-qqmusic

설치