前言¶
DeepSeek Harness（DSH）支持通过插件扩展功能。对于经常在 DSH 界面中进行对话或开发的用户，在操作过程中需要播放背景音乐或听书，频繁切换应用窗口会打断心流。这个插件通过 Host 端与 Web 端的双面结构，将音乐播放、歌词显示、频谱可视化以及 AI 讲书功能集成进 DSH 的 Web 界面，解决了在对话窗口内完成音频播放的需求。
核心功能¶
该插件提供本地音频流式播放与多种播放模式，支持刷新后断点续播、顺序播放、单曲循环与乱序播放。播放面板支持实时频谱可视化，可在柱状图与波形图之间切换。对于本地音乐，插件支持内嵌歌词、LRC 文件及在线歌词匹配，并具备防止电脑休眠的功能。播放面板支持自由拖动、调整大小，位置与尺寸可跨刷新记忆。
AI 讲书与工具¶
插件支持本地 .txt / .epub 文件的 AI 语音朗读，能自动识别书名、前言、章节与尾声结构，并提供 4 种中文 AI 声音。Agent 可通过 music_play 模型工具调用播放功能，例如输入“播放周杰伦的歌”即可触发播放。此外，插件还提供每日新闻播报功能，Agent 可联网搜索今日头条并生成口播稿，或通过 music_play 工具直接播放网络电台。
在线音乐与网络电台¶
插件支持多种音频格式（mp3/m4a/flac/wav/ogg/webm 等），并能扫描并显示音质档位。面板支持自建歌单管理与收藏功能。集成方面，插件内置了在线音乐（QQ音乐、酷狗音乐、网易云音乐）入口，支持扫码登录并浏览歌单、排行榜及搜索。同时支持网络电台，使用 radio-browser 全球开放电台目录，并支持 HLS 流播放。
安装与启用¶
使用前需确保已安装 dsh CLI。
- 安装插件：
执行以下命令安装（将<profile>替换为实际配置文件名）：
dsh plugin --profile <profile> add dsh-music-player
- 配置与启动：
安装后重启 DSH，打开 Web GUI。点击播放条右侧的列表按钮打开播放面板，在面板顶部点击“选择音乐目录”并选定目标目录（默认为~/Music），插件会自动递归扫描。
典型用法¶
- Agent 播放：在对话框输入“播放周杰伦的歌”，Agent 调用
music_play工具启动播放。 - 网络电台：在对话框输入“播放网络电台 中国之声”，Agent 使用
music_play工具并指定source=radio。 - AI 讲书：将本地
.txt或.epub文件拖入对话框，Agent 会自动识别章节并进行语音朗读。 - 新闻播报：让 Agent 收集今日头条，整理筛选后用 AI 声音播报。
技术细节与注意事项¶
插件为 Host 端（Node.js）与 Web 端的双面结构，配置与状态持久化保存在 Host 端文件 ~/.dsh/music-player-prefs.json 中，包括音量、播放顺序、面板位置及播放进度。升级旧版本时，旧数据会自动迁移至 Host 端。
使用声明：
在线音乐（QQ音乐、酷狗音乐、网易云音乐）功能通过非官方接口访问，仅供个人学习、技术研究及日常试听使用。严禁用于商业用途、公开传播或盈利行为。因使用非官方接口导致的账号风控、封禁及版权纠纷由使用者自行承担。网络电台数据来源于 CC 开放数据，仅供个人收听，不录制或二次分发。
链接¶
- GitHub: https://github.com/kendu76/dsh-music-player
