前言¶
在 DeepSeek Harness (DSH) 的开发与使用场景中，如果需要在 Web 界面直接获取音乐服务，往往需要手动跳转或使用外部播放器，导致体验割裂。DSH 插件体系提供了解决这一问题的思路，通过底层协议对接将服务注入到宿主环境中。
这是什么¶
dsh-tencent-music 是一个为 DeepSeek Harness (DSH) 量身定制的 QQ 音乐播放器插件。由用户 L-1124 维护。它解决了在 DSH 环境中直接调用 QQ 音乐协议的问题，提供从搜索、播放到个性化推荐的全链路服务，并深度融合了 DSH 的 Agent 智能体工具体系。
核心功能¶
- 无缝 Web UI 集成：提供顶栏快捷唤醒入口与可折叠的浮动播放器面板，支持进度拖动、音量控制及多种循环模式。
- Agent 智能点歌：注册了
music智能体工具，支持用户使用自然语言控制播放器（如点歌、切歌、音量调节、开启电台）。 - 个性化电台与推荐：内置猜你喜欢、雷达推荐、新歌首发等多种电台模式，支持播放列表的无感续拉。
- 全方位检索与导入：支持按单曲、歌手、专辑、歌单或歌词进行深度搜索，并且可以直接通过 QQ 音乐歌单 ID 或分享链接一键导入（如输入
201导入“我喜欢的音乐”）。 - 全档位高解析音质：支持从 128k MP3、320k HQ 到 SQ 无损 (FLAC)、Hi-Res 以及臻品母带 (AI Master) 的全档位音质。
- 快捷安全登录：播放器内嵌 QQ / 微信扫码登录，持久化存储多端 OAuth 凭据，重启自动恢复会话。
安装与启用¶
建议通过 DSH CLI 工具进行本地化安装与挂载：
dsh plugin --profile web add ./dsh-tencent-music
安装完成后，请重新启动 dsh web 并在浏览器中刷新，即可在页面顶栏看到音乐播放器图标。
典型用法¶
通过在聊天框向 Agent 发送自然语言指令，你可以轻松操控播放器：
- 放一首周杰伦的晴天
- 开启猜你喜欢电台
- 播放今日推荐歌曲
- 下一首 / 暂停 / 继续
- 把音量调大一点
- 帮我导入歌单 201
- 看看现在在放什么歌
适用场景与注意¶
- 环境依赖：本插件依赖于
@deepseek-ai/cordis与 DSH 的 Web UI 注入框架。使用前请确保你的 DSH 宿主环境版本兼容。 - VIP 降级策略：当遇到无权限播放的 VIP 歌曲时，系统会自动平滑降级，获取并播放 30 秒官方试听片段 (RS02)，确保播放队列不会中断。
- 权限检查：插件以当前 dsh 进程权限运行，安装前建议检查源码与许可证。
总结¶
该插件通过深度整合 QQ 音乐协议与 DSH 的 Agent 体系，为开发者与用户提供了一个无需跳转即可掌控全链路音乐服务的解决方案。
- 目录页：https://www.skillhub.cn/plugins/L-1124/dsh-tencent-music
- GitHub：https://github.com/L-1124/dsh-tencent-music
