- Главная
- Плагины
- Улучшения UI
- dsh-music (bundle)
dsh-music (bundle)
vicyangworld/dsh-music/bundle
Music plugin for DeepSeek Harness: scans local libraries, previews tracks online from YouTube Music (~128 kbps AAC; liking a track saves it to the library), recommends from listening history with taste preferences, shows artist pages with Wikipedia intros and cover art, tracks listening stats, and greets first-time users with a welcome flow plus a public-domain starter library. Listening history and caches stay local. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Установка
dsh plugin --profile web add github:vicyangworld/dsh-musicЭтот плагин находится в подкаталоге bundle репозитория.
README
dsh-music · 本地音乐插件
![]()
DeepSeek Harness Desktop 的音乐插件:播放本地曲库、同步歌词与歌手故事、基于收听历史的反信息茧房推荐、推荐歌曲试听/喜欢才入库、Spotify 收藏同步。界面简约、中文、跟随明暗主题。
预览
| 曲库 | 推荐三栏 | 歌手页 |
|---|---|---|
| 曲库(我喜欢卡片架) | 推荐三栏 | 歌手页 |
| :---: | :---: | :---: |
![]() | ![]() | ![]() |
![]() | ![]() | ![]() |
- npm 包名:
@vicyangorg/dsh-music(v0.6.0);品牌名与 GitHub 仓库仍为dsh-music(原名dsh-music在 npm 被占位包占用,故用 scoped 名,见docs/publishing.md) - 形态:DSH bundle(Host 服务 + Web 客户端面板)
- 验证状态:一期 S1–S4、二期四批、三期、四期、五期、六期、七期、八期、九期、十期均已验收通过(验收证据为内部文档,含本机数据,不随公开仓库发布)
- 分发状态:
@vicyangorg/dsh-music@0.6.0已发布 GitHub Release + npm(MIT/engines.dsh/8 语 meta/DETAIL+截图/README,打包守门+冷装冒烟通过);插件目录 PR #15213 审核中
功能
| 模块 | 说明 |
|---|---|
| 曲库播放 | 扫描本地目录,封面/歌手/标题列表;播放/暂停/切歌/进度/音量;跨页迷你播放条 |
| 歌词 | 内嵌标签→LRCLIB→联网补齐,逐句同步滚动高亮;无词时优雅降级「暂无歌词,仅播放」 |
| 歌手卡片 | 简介/近期动态/逸闻趣事(逐条注明来源与日期、区分事实与传闻)+ 相似歌手/歌曲 |
| 推荐 | 传统算法(零 LLM):7 相近 + 3 探索,探索位轮换流派/语言/年代/场景/意外之喜轴,避开高频歌手;每首经 MusicBrainz 联网核实、带推荐理由 |
| 下载 | 推荐歌曲经核实后下载到本地,带封面标签,自动入库即可播放;共享锁防并发 |
| Spotify 同步 | 一键同步收藏到本地,显示新增/缺失/失败;只经 spotify-sync CLI 间接用凭据 |
| 收听历史 | 记录播放完整度/跳过,仅存本地,作为推荐画像输入 |
二期新增
| 模块 | 说明 |
|---|---|
| 迷你播放窗 | 右下角贴边不挡输入框;「关闭」仅隐藏、播放继续;面板可显示/隐藏,隐藏后悬浮球唤回 |
| 播放模式 | 单曲循环 / 顺序播放 / 随机播放 三态切换 |
| 推荐三栏目 | 今日推荐(7+3 反茧房)/ 歌手推荐 / 新歌推荐;不显示下载按钮,点播放时自动下载并播 |
| 曲库管理 | 行内删除(Spotify 收藏需二次确认、Apple Music 拒删)/ 在 Finder 显示 |
| 搜索 | 曲库页歌曲/歌手搜索(简繁归一+MusicBrainz 联网补全);推荐页风格描述搜索(如「深夜爵士」,传统算法标签映射,零 LLM) |
三期新增(高颜值易操作)
| 模块 | 说明 |
|---|---|
| 推荐三栏并排 | 今日推荐/歌手推荐/新歌推荐三栏同时展示(各 20,列表式非 tab),每栏一键播放 |
| 喜欢才入库 | ♥ 喜欢标记;点喜欢才下载入库,点播放仅试听(缓存不入库);取消喜欢不删文件 |
| 歌手页 | 歌手推荐 20 位,点击进独立歌手页:资料(简介/动态/逸闻,来源+日期)+ 歌曲列表 + 播放 + ♥ |
| 播放模式 | 单曲/顺序/随机三态常驻按钮 + 当前模式说明;迷你窗可切换 |
| 迷你播放窗 | 右下贴边不挡输入框;显示/隐藏幂等、无歌时禁用提示 |
| 核实防伪 | 下载/试听核实记录校验来源白名单 + musicbrainz 域名 + 本机留档比对,伪造拒绝 |
四期新增(视觉丰富度)
| 模块 | 说明 |
|---|---|
| 推荐封面图 | 今日/新歌推荐每行 38px 圆角封面(同曲库样式);公开源 iTunes 搜索 API / 本地曲走曲库封面路由,无匹配时音符占位 |
| 歌手列表行 | 歌手栏列表形式、每位歌手一行:44px 圆形真实歌手/乐队照片(维基公开图)+ 名字 + 流派 + ›,整行可点进歌手页;无图图标占位,不用文字头像 |
| 歌手页视觉 | 132px 渐变横幅头图(bannerUrl ~1200px 适中尺寸,避免原图大图白屏)+ 96px 圆形大头像 + 资料(来源+日期)+ 带封面歌曲列表 |
| 图片兜底与缓存 | 全部图片 onError 兜底不裂图不破版;封面 URL 缓存 30 天、歌手图缓存本地(限流不缓存、确定性无图负缓存 3 天) |
五期新增(体验与统计)
| 模块 | 说明 |
|---|---|
| 曲库播放模式 | 工具栏单曲/顺序/随机三态段控件常驻 + 当前模式说明;「播放全部」跟随当前模式(随机态打乱队列并随机起播) |
| 统一搜索 | 删除歌曲/歌手类型下拉框,只保留分组下拉框;搜索同时命中歌名+歌手+专辑;联网补全 song+artist 并行合并去重,歌手项带 chip 可进歌手页 |
| 历史统计 | 新增 GET /api/history/stats 本地聚合:总播放/总时长/歌曲数/歌手数/跳过/平均完整度 + top 歌曲/top 歌手 + 近 7 天趋势;历史页六卡 + 纯 CSS 趋势柱 + Top 榜 |
| 历史视觉 | 日期分组行 + 40px 封面 + 完整度徽章(三档色)+ 跳过 chip + 时间;统计接口失败优雅降级不阻塞列表 |
| 布局紧凑 | 各页内容 max-width 居中(1120/1280/980)、间距收紧一档;窄屏 980/680/560 断点降级,推荐三栏塌单列不溢出 |
六期新增(迷你窗/冷启动/分发就绪)
| 模块 | 说明 |
|---|---|
| 迷你播放条 | ×=隐藏(无悬浮球)直到工具栏「显示迷你播放条」,播放不断;独立收起/展开(收起细条+1 行歌词、展开进度条+3 行歌词高亮);握把拖动位置持久化;进度可拖 seek |
| 播放模式 | 全端单个循环点击按钮(顺序→随机→单曲循环),图标+title 说明当前态 |
| 列表播放 | 任何列表(含历史)「播放该列表」;点任何单曲整列入队并立即切播 |
| 歌手统一 | 任何地方点歌手进同一歌手页;歌手名 hover pointer;六处真实头像(分组头/搜索chip/相似/正在播放/迷你/历史) |
| 冷启动 | 零历史出探索批(≥6 首逐首联网核实+中文说明);空态引导「搜歌手/歌名试听」;二进制 PATH 自动探测+中文安装引导;Spotify 同步标可选 |
| 分发就绪 | 公开包名 dsh-music、MIT、engines.dsh、8 语 meta.detail、用户向 DETAIL+截图+README;打包守门+冷装冒烟脚本入回归 |
七期新增(悬浮标/欢迎页/社区设计)
| 模块 | 说明 |
|---|---|
| 悬浮标 | 迷你条可收起为可拖悬浮标(位置持久),点击恢复展开;×=隐藏直到工具栏「显示迷你播放条」;迷你条/悬浮标位于应用内全局顶层(fixed+body 级挂载),任何页面/面板/弹窗不遮挡;跨应用悬浮 web GUI 不可实现,已如实说明 |
| 统一试听 | 全部「下载并播放」统一为试听语义(试听不入库),喜欢才下载入库;8 语零「下载并播放」类文案 |
| 常听列表播放 | 常听歌曲「播放该列表」+行点击立即切播;不在库行置灰并提示 |
| 欢迎页 | 蓝色大肥鱼戴耳机原创 logo;首启个性化(流派/语言偏好)→ 设本地目录进曲库,或一键建 starter 曲库(4 首公有领域曲目,逐首许可核实+署名)进推荐;老用户不被打扰,设置内可预览欢迎页 |
| taste 软偏置 | 偏好被推荐消费:探索批按偏好流派/语言软偏置,不锁死多样性 |
| 社区设计稿 | docs/community-design.md:分享卡片/分享码/GitHub Discussions 广场,opt-in、无后端、数据不出机(本期仅设计) |
八期新增(真新歌/全流派/喜欢与不喜欢/品牌 logo)
| 模块 | 说明 |
|---|---|
| 新歌真发行 | 新歌推荐只推真正新发行(180 天内、MusicBrainz 真实首发日期,区分专辑/单曲/EP),不再把「刚入库的歌」当新歌;来源拓宽到高频歌手→相似歌手→口味流派直查,过滤库内/近期已荐/不喜欢,按真实发行日降序 |
| 流派全覆盖 | 欢迎页流派 10→15(补 pop/rock/hip hop/punk/country),推荐池 GENRE_POOLS 同步补全(逐首 MusicBrainz 核实),taste 软偏置生效 |
| 我喜欢列表 | 曲库「曲库 / 我喜欢(N)」双 Tab,喜欢的歌独立成列,行点击立即切播,不在库行置灰 |
| 不喜欢 | 每首歌(曲库/推荐/新歌/歌手页)可「不喜欢」👎;与喜欢互斥(二值口味信号);不喜欢不下载、不删文件;推荐避开不喜欢的歌与歌手 |
| 不喜欢进统计 | 不喜欢计入收听统计历史(独立口味事件,默认不污染播放画像);历史页统计卡新增不喜欢计数 +「不喜欢的歌」列表(可取消不喜欢) |
| 品牌 logo | 用户提供的蓝肥鱼戴耳机图设为插件 logo(Plugin Manager 清单页 / 插件目录 / README) |
九期新增(卡片架/跨页同步/后台加载与双层缓存)
| 模块 | 说明 |
|---|---|
| 我喜欢卡片架 | 曲库页顶部横向封面卡片架展示「我喜欢」(≤12 张横滑 +「查看全部」进完整列表),取代常驻双 Tab;无喜欢时空态引导 |
| 跨页喜欢同步 | 任何页面(曲库/推荐/新歌/歌手页/搜索)点 ♥,回曲库卡片架即时同步并置顶新喜欢;取消喜欢同步移除 |
| 后台加载 | 离开加载中的歌手页加载在后台继续;完成后 toast 提示「歌手页已就绪」,点击 toast 直达该歌手页 |
| 双层缓存 | 歌手页等内容客户端会话缓存(同会话重开秒开、pending 去重、失败不缓存可重试)+ Host 持久缓存(歌手资料/维基兜底回写/相似/图 30 天、核验 30 天、确定性未命中负缓存 3 天,重复打开零重复网络拉取),重启后仍命中 |
| 歌手页文案 | 歌手页歌曲区标题「的歌曲」改为「歌曲」(8 语同步) |
十期新增(推荐按天固化/每栏重新推荐/播放转圈反馈)
| 模块 | 说明 |
|---|---|
| 推荐按天固化 | 三栏(今日/歌手/新歌)按本地自然日缓存:当天首次进推荐页生成一次,之后切换进来零重算秒开;跨天首次进入自动生成新批 |
| 每栏重新推荐 | 每栏标题行「重新推荐」按钮只重算本栏,其余两栏不受影响;重算期间该栏独立显示进度 |
| 播放转圈反馈 | 点行播放 ▶ 变转圈(试听准备中),就绪恢复播放态;「播放本栏」整栏转圈、逐首就绪逐首恢复;转圈期间防重复点击 |
安装
插件以 bundle 形式安装在 desktop profile,只用 plugin_manager install_bundle(不手写 profile 配置):
plugin_manager install_bundle target=@vicyangorg/dsh-music@0.6.0
# 或本地源码:target=<项目>/bundle
以返回 application: applied 为准。安装后刷新现有 GUI 页面,左侧栏出现「音乐」面板。
使用
- 点左侧栏「音乐」打开面板,曲库自动扫描。
- 点曲目播放;正在播放页可看同步歌词、点歌手名打开歌手卡片。
- 「推荐」页点「生成推荐」→ 得到 7 相近 + 3 探索,逐首可「试听」(不入库);点 ♥ 喜欢才下载入库。
- 入库队列看进度,完成后自动入库可播放。
- 曲库工具栏「同步 Spotify」一键同步收藏。
- 「历史」页查看收听记录。
数据位置(全部本地,无上传/无遥测)
| 路径 | 内容 |
|---|---|
~/Music/dsh-music/ | 喜欢入库的歌曲(本插件写入) |
~/Music/dsh-music/starter/ | 欢迎页 starter 曲库(公有领域,署名见 ~/.dsh/dsh-music/starter.json) |
~/Music/spotify-liked/ | Spotify 收藏(仅 spotify-sync CLI 写入,本插件不改) |
~/.dsh/dsh-music/history.jsonl | 收听历史 |
~/.dsh/dsh-music/cache/ | 歌词/歌手/推荐发现/核实/封面与歌手图缓存 |
~/.dsh/dsh-music/reco-history.json | 推荐批次留档 |
卸载
plugin_manager remove_bundle target=@vicyangorg/dsh-music
如需清理数据,手动删除上表所列目录(~/Music/dsh-music/、~/.dsh/dsh-music/);~/Music/spotify-liked/ 是否保留由您决定。
已知限制
- 音源上限 YT Music ~128k AAC;个别曲目源头无封面或时长与 MusicBrainz 目标略有出入(软警告,仍可播放)。
- 推荐为传统算法 + MusicBrainz 发现,探索多样性依赖曲库与历史规模;不依赖任何 LLM。
- Spotify 取消收藏不触发本地删除,是否删本地文件由您决定。
红线(设计约束)
不并发下载管线;绝不查看/移动/删除 ~/.config/spotify-sync/refresh_token;推荐候选先联网核实再下载;推荐下载只写 ~/Music/dsh-music/;歌手内容注明来源与日期;历史/缓存仅存本地。
Похожие плагины
dsh-web (dsh-task-board)
zhu1090093659/dsh-web
dsh-web (dsh-web-all)
zhu1090093659/dsh-web
dsh-TUI
ccch1mneyyy/dsh-tui
dsh-web-ui (dsh-task-board)
zhu1090093659/dsh-web-ui





