kendu76/dsh-music-player 预览 preview

kendu76/dsh-music-player

Bundle捆绑包 Native原生 ⭐ 16 MIT Runtime & Injection运行时与注入

DeepSeek 工具框架的音乐播放器插件

Project Overview项目介绍

This is a native DSH plugin built exclusively for the DeepSeek Harness ecosystem. It is designed to add full-featured audio playback functionality directly into the DSH web GUI, so users do not need to switch windows to listen to music, novels, news, or radio while coding. To install it, you need to have the DSH CLI already set up on your machine, then run the command dsh plugin --profile <profile> add dsh-music-player to install it from npm. Alternatively, you can install it directly from this GitHub repository with a slightly different command. After installation, restart DSH and you will see the playback bar in the Web GUI immediately.

This plugin is targeted at DSH users who want to take a break from coding without switching to a separate audio app or browser tab. After the first launch, you just need to select your local music directory (defaults to ~/Music) and the plugin will automatically scan all supported audio files recursively. You can create custom playlists, adjust the size and position of the playback panel, and control playback directly through natural language commands to the DSH agent, like "play Jay Chou's songs". You can also access QQ, Kugou, and NetEase Cloud Music after scanning a QR code to log in, with support for VIP high-quality tracks if you have an active account.

This plugin is released under the open-source MIT license, and it requires Node.js version 20 or higher for development and normal operation. There are a few usage limits to note: local audio scanning is capped at 500 tracks, with a maximum recursive directory depth of 4 layers. AI audiobook functionality currently only supports the xiaomi/MiMo TTS model, which requires you to configure the corresponding API key in your DSH model settings before use. All user preferences and playlist data are persisted on the DSH host side, so they will not be lost after refreshing the page or restarting DSH. The online music functionality uses unofficial interfaces, so it is for personal non-commercial use only, and users take responsibility for any copyright or account risks.

这是一款原生专为DeepSeek Harness(DSH)开发的音乐播放插件,可通过DSH CLI直接安装到指定的DSH配置中。它支持本地音乐扫描播放、AI小说朗读、三大在线音乐平台接入、每日新闻播报和全球网络电台收听等多种功能,还提供了可拖拽调整大小位置的播放面板、实时频谱可视化和同步歌词显示等交互体验,安装完成后重启DSH即可在Web GUI中看到播放条直接使用。

面向需要在编写代码间隙放松、又不想频繁切换窗口的DSH用户,这款插件让你不用离开DSH网页界面就能享受各类音频内容。你可以选择扫描本地音乐目录,手动建立多个自定义歌单,也可以直接在对话框中通过自然语言指令,让AI代理按关键词播放指定歌曲或启动小说朗读。对于听书需求,插件会自动解析小说结构,支持章节跳转和多音色选择,使用体验十分顺畅。

本插件采用MIT开源许可,完全免费使用,它分为Host端和Web端两部分,开发需要Node.js 20及以上版本支持。本地音频扫描上限为500首,递归子目录深度上限4层,AI听书当前仅支持配置xiaomi/MiMo TTS模型。在线音乐功能使用非官方接口,仅用于个人学习研究,禁止商用,使用相关功能需自行承担相关风险。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 16 stars - an early-stage project星标 16,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-music-player

把 kendu76/dsh-music-player 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-music-player

Awesome DSH Plugin

DeepSeek Harness 音乐/小说播放插件。

写代码写累了、想摸鱼又不想切窗口?这个插件就是你的摸鱼神器——直接在 DeepSeek Harness 的网页里塞进一个 DSH音乐播放器:扫一下你电脑上的音乐目录(默认 ~/Music)就能在浏览器里听歌,带播放条和可拖拽的播放面板,还能自己建歌单。

光听歌还不够,它还能听书:把本地 .txt/.epub 小说丢给 AI 朗读,想听哪章点哪章、声音随便挑。现在还能听新闻:让 agent 用联网搜索收集当天头条(热点/国内/国际/科技/财经/体育/娱乐,或 AI 等任意自定义主题),整理筛选成口播稿用 AI 声音播报——支持每日多定时任务定时、静默收集、文字版阅读。还能听网络电台:中文主流台(央广/凤凰/CCTV 伴音等,含 HLS 流)与全球电台一键开播。最绝的是它注册了 music_play 等模型工具——你连鼠标都不用动,在对话框里跟 agent 说句「播放周杰伦的歌」,音乐分分钟响起来,摸鱼摸出新境界。

特性

  • 本地音频流式播放,刷新后断点续播
  • 顺序播放、单曲循环、乱序播放三种模式
  • 实时频谱可视化,两种样式可在「系统配置」切换(默认柱状图):柱状图与波形图(示波器式连续曲线,按低/中/高频分成三条层次线)
  • 实时歌词/字幕:本地歌曲自动显示同步歌词——优先读取文件内嵌歌词(FLAC LYRICS/MP3 USLT 标签,无需额外 .lrc),其次同名 .lrc,都没有时自动在线匹配;在线 QQ 歌曲显示官方歌词(外语歌带逐句翻译);AI 讲书时显示当前朗读句子。单击播放条歌词可打开完整歌词/字幕面板(标识当前进度、可拖动/拉伸、位置独立记忆),面板默认开启透明模式——歌词像直接悬浮在页面上,可在「系统配置」关闭
  • 播放时防止电脑熄屏/休眠(需浏览器支持,如 Chrome/Edge)
  • 播放条位置可换:在「系统配置 → 播放条位置」(配置页最后一项)里三选一——输入框上方(默认)/ 页面底部 / 悬浮可拖动。悬浮条是紧凑的三行卡片(歌词整行 / 歌名+频谱 / 播放控制,行高固定不随歌词有无跳动),整条可以直接拖着挪地方,位置会记住(配置页可「重置位置」回到默认右下角);改到底部/悬浮后,播放条不再挂在输入框区域,因此对话里的询问弹窗(会接管输入区)也不会再把它一起盖住——弹窗开着照样能暂停/切歌
  • 滚轮调音量:鼠标停在音量条上直接滚轮即可加减音量,按滚动快慢分两档步进——慢速滚动每次 1%(细调)、快速滚动每次 5%(快速拉大/拉小);上滚加、下滚减,滚轮被音量条消费,不会连带把外层对话滚走。鼠标滚轮慢慢拨与触控板细碎轻推都算慢速,鼠标快速连拨、触控板用力快滑算快速(阈值见 lib/client.js 的 VOL_WHEEL_* 常量)
  • 播放列表面板可自由拖动,右下角可拖拽调整大小,位置与尺寸跨刷新记忆
  • AI 讲书:本地 .txt / .epub 小说 AI 语音朗读,自动识别书名/前言/章节/尾声结构,播放条带章节目录跳转(打开即定位到当前正在播放的章节)、章节切换,可选 4 种中文 AI 声音(默认白桦)
  • music_play 模型工具:agent 可按关键词播放本地音乐,也可按小说名启动 AI 讲书
  • 每日新闻播报:agent 用 web search 收集当天头条(可分类别/自定义主题),整理筛选后 AI 语音播报;播放面板「新闻播报」页签随时回看、挑条目播放、看文字版;支持每日多定时任务定时与静默收集(详见下文「每日新闻播报」)
  • 多标签页统一播放器:同时开多个 DSH 标签页时,所有标签页共用同一个播放器——同一时刻只有一页出声,其余页静音并同步显示同一首歌/同一进度/同一播放状态(曲目、歌手、歌词、播放模式、音量、讲书章节全都一致),在任意一页点播放/暂停、上一首/下一首或直接点歌,都会作用到这个唯一播放器上(详见 FAQ)
  • 支持的格式:mp3 / m4a / m4b / aac / flac / wav / ogg / opus / webm / aiff(自动递归扫描子目录,上限 500 首)
  • 真实音质识别:扫描时自动识别每首歌的音质档位,播放条显示「格式 · 音质档」(如 FLAC · 无损 / MP3 · 高音质 / MP3 · 标准),与在线音乐的音质标签一致
  • 自建歌单:可新建多个歌单,从本地文件(支持多选、可跨目录)添加歌曲;播放条爱心按钮一键收藏到默认歌单「我最喜欢」;歌单作为播放来源时,顺序/乱序循环只在该歌单内进行
  • 在线 QQ 音乐:面板内置「QQ音乐」页签——微信/QQ 扫码登录(解锁 VIP/高音质)、我的歌单/推荐歌单/分类歌单/排行榜/新歌/搜索浏览、卡片式歌单展示、一键收藏到「我喜欢」
  • 在线酷狗音乐:面板内置「酷狗音乐」页签——酷狗 App 扫码登录(解锁高音质)、推荐/分类歌单/排行榜(TOP500 等)/统一搜索/我的歌单,逐字歌词内嵌翻译;详见下文「在线酷狗音乐」
  • 在线网易云音乐:面板内置「网易云」页签——扫码登录后浏览/搜索/播放(免费歌 320k 高音质直链、VIP 歌试听片段)、我的歌单/推荐/分类歌单/排行榜、YRC 逐字歌词与 LRC+逐句翻译;详见下文「在线网易云音乐」
  • 网络电台:面板内置「网络电台」页签——radio-browser 全球开放电台目录(数万台、无登录),按台名/国家/标签搜索,中文电台/热门电台按主题分组浏览、收藏与最近播放;支持 HLS(m3u8) 电台(央广/凤凰/CRI/CCTV 伴音等中文主流台),Host 端纯 Node 把 HLS 转成浏览器直接可播的音频流,无新依赖;music_play 传 source=radio 可按台名直接开播;详见下文「网络电台」

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-manager 下一个 Next dsh-llm-hub →