前言¶
DeepSeek Harness（DSH）支持通过插件扩展功能。在 Web profile 中，开发者通常需要在对话和听音乐之间切换，这会打断工作流。dsh-music 插件解决了这个问题，它直接接入 QQ 音乐，在 Web 界面中提供了一个悬浮播放器，允许用户在对话过程中控制音乐播放。
插件介绍¶
dsh-music 是一个开源插件（MIT 许可证），由用户 1608kiy 维护。它不依赖外部前端框架，通过 host 端代理解决跨域问题，并提供了扫码登录 QQ 音乐账号的能力。
核心功能¶
- 悬浮播放器与交互：播放器采用深色毛玻璃效果，支持展开/收起动画。右下角卡片可自由拖动并记忆位置，播放中封面会旋转。鼠标离开 5 秒后，播放器自动收缩成小唱片圈，靠近屏幕边缘会自动吸附。
- 快捷控制与状态记忆：支持键盘快捷键（空格暂停/播放，左右箭头切歌）。插件会自动记忆队列、音量、循环模式，重启后自动恢复。提供 128k 和 320k 两种音质选择。
- 最小化与插件管理：播放器右上角可收起，最小化为角落小圈（封面继续旋转，双击/三击控制切歌）。可在设置中停用或启用插件。
- QQ音乐接入与登录：支持通过官方 vkey 解析播放，Meting 作为兜底。提供精致的扫码登录页，凭证保存在本地，登录后可解锁 VIP 歌曲播放、导入「我喜欢」及个人歌单。
- Agent 集成：内置
music工具，可通过对话指令（如“放首歌”、“暂停”、“音量调到 50%”）控制播放器，无需手动点击 UI。 - 默认曲库配置：支持通过环境变量
DSH_MUSIC_PLAYLIST配置默认加载的 QQ 音乐歌单 ID。
安装与配置¶
- 下载插件包到本地路径。
- 使用 DSH CLI 安装插件：
dsh plugin --profile web add "file:/path/to/dsh-music"
- 安装后重启 DeepSeek Harness Web 应用。
- 可选配置：设置环境变量
DSH_MUSIC_PLAYLIST为 QQ 歌单 ID，启动时自动加载为内置曲库。
使用方法¶
- 操作播放器：点击右下角卡片展开播放器，拖动顶部可移动位置。鼠标离开 5 秒自动收缩。
- 搜索与导入：在播放器搜索框输入歌名/歌手回车搜索，或粘贴 QQ 音乐歌单链接/ID 导入。
- 快捷键控制：在输入框外使用空格暂停/播放，左右箭头切歌。
- Agent 指令：直接对模型说指令，如“放首歌”、“暂停”、“音量调到 50%”。
- 管理插件：在设置 → 插件 → 插件配置中管理启用/停用状态。
注意事项¶
- 本项目与 DeepSeek、腾讯 QQ 音乐无关，音频来自公开接口与第三方解析服务，仅供学习交流。
- 受版权或权限限制的歌曲可能无法播放，播放器会自动跳过。
- 登录凭证仅保存在本地 DSH 实例中，用于向 QQ 音乐接口发起请求。
music工具与 UI 操作均在本地 DSH 实例内完成，无持久化同步。
总结¶
dsh-music 通过集成 QQ 音乐接口和 Agent 工具，为 DSH Web 用户提供了轻量级的音乐播放解决方案。它支持本地凭证存储、断点续播和快捷键控制，适合需要兼顾对话与背景音乐的开发者。
