前言¶
在 DeepSeek Harness(DSH)里写代码、跑任务时,很多人会开浏览器另找音乐。DSH Web GUI 本身并不自带「边干活边听 B 站」的界面;若把播放器做成又一个铺满按钮的网页标签,也容易和手头工作抢注意力。下面介绍的插件把检索与播放收进侧边栏里的一块「唱机面板」:音频在后台继续,面板可以关掉而不中断。
这是什么¶
dsh-plugin-vinyl-player(仓库名 dsh-plugin-vinyl-player)由维护者 ChiaquanLin 发布,在 SkillHub 目录中归类为 趣味换装。它不是文件列表式的音乐应用,而是一个画出来的卡通黑胶唱机:搜索歌曲后结果变成唱片封套,拖上转盘即可播放;音频流来自 B 站,经宿主代理,不向磁盘写入媒体文件。许可证为 MIT(package.json 版本 1.0.0)。
核心功能¶
面板中心是 转盘(deck),下方有两层架子:
- record crate:最近一次搜索得到的封套;
- favourites shelf:收藏的唱片,刷新后仍保留。
交互以拖拽为主:把封套拖到转盘上播放;拖到收藏架则只收藏不播放。唱臂即传输控制——把唱臂拖到唱片上播放,拖回托架暂停;也可配合键盘。转盘下方另有上一首、停止、重播、下一首与可拖动的进度条;灰色区表示已缓冲部分。
其余已核实能力包括:
- 关闭面板后音乐继续播放,侧边栏入口仍显示当前唱片;
- 界面为矢量绘制(木柜、黑胶、唱臂、转速选择与音量旋钮等),无独立设置页或菜单;
- 随应用语言切换 English / 简体中文;
- 运行时流式播放,换曲即释放,不向磁盘写入音频;
- 宿主侧提供搜索、解析音轨列表、解析可播流、代理封面等接口;浏览器端不直接访问 B 站。
开发与自检方面,仓库提供 Node 测试套件(README 记载 node tools/count-checks.mjs 等);Node 20+ 主要用于跑测试,日常使用仅需可用的 DSH Web GUI 配置档及访问 bilibili.com 的网络路径。
安装与启用¶
插件从 GitHub 仓库分发,不依赖 registry 包名安装。官方给出两种路径;dsh plugin 子命令之间 必须 带上 --profile(与你在用的配置档一致,例如桌面端用 desktop,dsh web 用 web)。
方式一:在 DSH 对话里让智能体安装(推荐,无需终端)
安装 https://github.com/ChiaquanLin/dsh-plugin-vinyl-player 插件
智能体会安装 bundle 并重载面板,侧边栏会出现唱机入口。
方式二:使用 dsh CLI
dsh plugin --profile desktop add github:ChiaquanLin/dsh-plugin-vinyl-player
将 desktop 换成你实际使用的 profile。添加依赖同时会注册 bundle,无需单独 enable。查看或移除:
dsh plugin --profile desktop list
dsh plugin --profile desktop remove dsh-plugin-vinyl-player
安装后 重载 Web GUI,侧边栏会出现 黑胶唱片机 / Vinyl player 条目。装入某一 profile 后对该 profile 下所有会话生效,重启后插件仍在。
典型用法¶
README 中的对照表可直接复现日常操作:
| 操作 | 结果 |
|---|---|
| 在搜索框输入并搜索 | crate 里出现唱片封套 |
| 点击某一封套 | 播放 |
| 把封套拖到转盘 | 播放 |
| 把封套拖到 favourites 架 | 收藏,不自动播放 |
| 把唱臂拖到唱片上 | 播放 |
| 把唱臂拖回托架 | 暂停 |
| 拖动进度条 | seek |
| 点击封套上的心形 | 收藏或取消收藏 |
悬停封套会有轻微放大效果;侧边栏与面板通过客户端 store 保持状态一致。
适用场景与注意¶
适合希望在 DSH Web GUI 同一套界面 里听 B 站音频、又不想多开一个「播放器标签页」的开发者;侧栏卡通唱机也符合「趣味换装」类插件的视觉取向。
使用前请注意:
- 权限与信任:插件随当前 DSH 进程运行,安装前建议阅读仓库源码与 MIT 许可证;宿主会代你向 B 站发起匿名访客 cookie、签名请求并代理音视频,行为范围以
index.js等为准。 - 合规:项目为 非官方 实现,与 B 站无隶属或背书关系;不绕过付费墙、DRM 或访问控制,不承担站内媒体版权。使用前请阅读仓库 LEGAL.md,并遵守 B 站服务条款与你所在法域的版权规定,仅限个人合法收听。
- 网络:需要能访问
bilibili.com;音频经宿主代理以支持 range 请求,README 称不在宿主侧缓存媒体。 - 生态:DSH 推崇「一切皆插件」;SkillHub 等为社区目录站点,与 DeepSeek、幻方无官方从属关系,本文所述安装方式以仓库 README 为准。
结尾¶
dsh-plugin-vinyl-player 把 B 站音频检索与播放收进一块可关闭的卡通唱机面板,拖拽唱臂即可 transport,收藏架与侧边栏状态在干活时仍可继续听。目录页与源码分别见:
- SkillHub:https://www.skillhub.cn/plugins/ChiaquanLin/dsh-plugin-vinyl-player
- GitHub:https://github.com/ChiaquanLin/dsh-plugin-vinyl-player