Passer au contenu principal
V

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.

Installer

dsh plugin --profile web add github:vicyangworld/dsh-music

Ce plugin se trouve dans le sous-répertoire bundle du dépôt.

README

dsh-music · 本地音乐插件

dsh-music logo — 戴耳机的蓝肥鱼

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、无后端、数据不出机(本期仅设计)
模块说明
新歌真发行新歌推荐只推真正新发行(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 页面,左侧栏出现「音乐」面板。

使用

  1. 点左侧栏「音乐」打开面板,曲库自动扫描。
  2. 点曲目播放;正在播放页可看同步歌词、点歌手名打开歌手卡片。
  3. 「推荐」页点「生成推荐」→ 得到 7 相近 + 3 探索,逐首可「试听」(不入库);点 ♥ 喜欢才下载入库。
  4. 入库队列看进度,完成后自动入库可播放。
  5. 曲库工具栏「同步 Spotify」一键同步收藏。
  6. 「历史」页查看收听记录。

数据位置(全部本地,无上传/无遥测)

路径内容
~/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/;歌手内容注明来源与日期;历史/缓存仅存本地。

Plugins associés