dsh-sidebar-media-player 0.2.4 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,31 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.6 (2026-11-18) — 多轮返修收口 + 默认外观定稿
4
+
5
+ > 更正:0.2.5 条目里写的「修正 lib/client.js 的 VERSION」当版并未真正落地(0.2.5 包里仍是 0.2.0),实际在 0.2.6 完成。历史条目不回改。
6
+
7
+ - **免责申明**:README 中英双版新增免责段——本插件为第三方爱好者工具,非 QQ 音乐官方产品、与腾讯无隶属关系;仅用于播放用户自己账号的 QQ 音乐列表,不支持也不参与任何官方活动;内容版权归腾讯 / QQ 音乐;收到侵权通知即删库(含 npm 包与 Release)。
8
+ - **来源声明**:README 中英双版新增「来源与致谢」段——胶囊播放条的 UI 设计与落位方式、QQ 音乐接口层(`lib/qq.js` / `lib/qrc.js`)照抄第三方原作者(上游 MIT,`dsh-music-player v1.0.4`,kendu76);把播放器整体搬进侧边栏、胶囊按钮、界面改造与主要功能为本人设计与实现。
9
+ - **默认外观定稿**:胶囊在输入框上方、列表 10 列、歌词炫彩、顺序播放、频谱开、两句歌词、柱状。新增一次性迁移(localStorage `smp.appearanceRev2`)让老存档也落到默认值,之后手动设置不再被覆盖。
10
+ - **胶囊位置三态**:输入框上方 / 页面底部 / 隐藏(隐藏 = 完全不渲染胶囊条,侧边栏面板顶部播放器不受影响)。
11
+ - **面板页签行**:新增「隐藏列表」按钮(只留上方播放器);点页签自动展开列表;`⟲` 刷新 QQ 数据(不重载页面、不中断播放);`⟳` 检查更新。
12
+ - **控件行统一**:原「系统配置」独立页下线,设置项并入控件行 18 枚同风格按钮(收藏 / 上一首 / 播放暂停 / 下一首 / 停止 / 音量 / 倍速 / 循环 / 频谱开关 / 频谱样式 / 字幕 / 歌词 / 歌词模式 / 歌词动效 / 胶囊位置 / 列数 / 精简条 / 下载),单行不折行。
13
+ - **本地音乐可拖动 seek**:音频项改走整文件 Blob(视频与 >250MB 大文件仍走 `/media` 直链),修复「本地曲不能快进拖动」;seek 另加 300ms 复核重试。
14
+ - **收藏与 QQ 音乐「我喜欢」同源**:胶囊 / 面板 / 卡片三处读写同一集合(宿主 `GET /qq/liked`、`POST /qq/fav`),不再是本地假标记。
15
+ - **播放 / 切歌 / 循环三态**:单曲循环与随机播放对手动「下一首」同样生效;胶囊与面板按钮统一走 `SMP_STORE`,一一对应。
16
+ - **倍速**:QQ 曲不再假禁用(去 `not-allowed` / `opacity` 锁),选择后无条件写回 `audioEl().playbackRate` 并同步 store。
17
+ - **歌词**:5 档动效真正落到面板与胶囊(此前只有 slide 生效);两句 / 歌词板切换;无歌词时有兜底文案不再空白。
18
+ - **界面**:QQ 卡片封面 1:1 `contain` 自适应、无封面统一用唱片图标占位、翻页与「播放全部」同行、320px 窄宽不折行不横滚。
19
+ - **移除**:自动弹 QQ 音乐网页版「看广告」整条链路(客户端 effect / 免费时长卡片 / 宿主 `/qq/free/open` 路由与 `findBrowserExecutable()`)。
20
+ - 文档:README 重写为中英双语并覆盖当前全部能力与默认值;`lib/client.js` 的 `VERSION` 同步到 0.2.6。
21
+
22
+ ## 0.2.5 (2026-11-13)
23
+
24
+ - 状态标注:README、package.json description 与 locale/*.json 的 meta.description 明确写出「当前 0.2.x 版本 bug 较多,正在重做中」,避免用户误以为这是稳定版。
25
+ - 修正 lib/client.js 的 VERSION(此前一直停在 0.2.0,与 package.json 不一致)。
26
+ - 补 icon.svg + exports 的 ./icon 与 ./locale/*.json + files 收录,符合官方 dsh-doc 图标与 locale 规范。
27
+ - 功能代码未改动,已知缺陷仍在。
28
+
3
29
  ## 0.2.4 (2026-11-12) — 播放器页签行新增 ⟳ 检查更新
4
30
 
5
31
  - 播放器面板页签行(本地库 / 系统配置 …)右侧新增 ⟳:查 npm 最新版 → 有新版变蓝「更新到 vX」→ 再点一键安装到 desktop profile。
package/README.md CHANGED
@@ -1,31 +1,90 @@
1
1
  # 侧边栏多媒体播放器(dsh-sidebar-media-player)
2
2
 
3
- 侧边栏统一音视频播放器,作为 `dsh-better-sidebar` 的配套插件,接管侧边栏里音视频文件的预览。一个 viewer 同时覆盖视频与音频扩展名,解决过去做不好的三件事:**能拖的进度条**(HTTP Range 206 流式)、**实时频谱**、**音准读数**;并新增**视频字幕**(同名 `.srt/.vtt/.ass` 自动加载)与**音频歌词**(同名 `.lrc` 滚动高亮)。
3
+ 侧边栏统一音视频播放器,作为 `dsh-better-sidebar` 的配套插件:一个 viewer 同时接管视频与音频预览,并提供独立的**播放器面板**(QQ 音乐在线曲库 + 本地音乐库)、一条可三态摆放的**胶囊播放条**,以及实时频谱 / 音准 / 歌词 / 字幕等播放态增强。
4
4
 
5
- **适配 DSH 内核 0.2.2-rc.1。**
5
+ **适配 DSH 内核 0.2.2-rc.1;当前版本 0.2.6。**
6
6
 
7
- - 版本:0.2.0(首个正式发布版本)
8
- - 依赖:`dsh-better-sidebar`(提供 `ctx.betterSidebar` 文件查看器注册服务)
7
+ > 0.2.6 起,此前记录的已知缺陷(进度条拖不动、切歌/收藏/倍速失效、歌词动效不生效、胶囊位置切换后消失等)已逐项修复;发布前对默认值、源码改动与打包清单做过机器断言核验(校验脚本随源码改动在开发环境执行,未纳入发布包)。仍建议先小范围试用再依赖。
8
+
9
+ - 版本:0.2.6
10
+ - 依赖:`dsh-better-sidebar`(提供 `ctx.betterSidebar` 文件查看器注册服务;缺失时插件自动降级,不影响 DSH 启动)
11
+
12
+ ## 免责申明(请先读)
13
+
14
+ 本插件是**第三方爱好者工具,不是 QQ 音乐官方产品,与腾讯 / QQ 音乐没有任何隶属或合作关系**。
15
+
16
+ - **目的**:只为了让 QQ 音乐的忠实用户,能在自己的 DSH 侧边栏里更方便地播放**自己账号的 QQ 音乐歌单**。
17
+ - **范围**:仅支持「播放 QQ 音乐列表」这一件事;**不支持、也不参与任何官方活动**——不做签到、不做任务、不领券、不刷播放量、不破解会员权益、不下载版权内容。
18
+ - **内容归属**:所有音乐、账号与版权均归腾讯 / QQ 音乐所有。本插件不存储、不分发任何音频文件,播放走的是用户自己已登录的账号。
19
+ - **请移步官方**:需要完整功能、会员权益或官方活动,请使用 QQ 音乐官方客户端 / 官网(y.qq.com)。
20
+ - **侵权即删**:若权利方认为本项目构成侵权,请告知,**收到通知后立即删除仓库(连同 npm 包与 Release)**,不做申辩或拖延。
21
+
22
+ ## 来源与致谢(哪些是照抄的、哪些是自己做的)
23
+
24
+ 为避免误会,把来源讲清楚:
25
+
26
+ **照抄第三方原作者的部分(上游 MIT)**
27
+
28
+ - **胶囊播放条的 UI 设计与落位方式**:输入框上方 / 页面底部的落位行为、两层容器结构、尺寸与样式数值、悬停收起机制 —— 逐字照抄 `dsh-music-player v1.0.4`(MIT,作者 kendu76),源码内已注明参照位置。
29
+ - **QQ 音乐接口层**:`lib/qq.js` 的接口签名、请求与响应解析,以及 `lib/qrc.js` 的扫码登录渲染 —— 来自上游实现(MIT),版权归原作者。
30
+
31
+ **本人设计并实现的部分**
32
+
33
+ - 把播放器**整个搬进侧边栏**:`ctx.betterSidebar` viewer 注册、侧边栏播放器面板、页签行(QQ音乐 / 本地音乐 / 隐藏列表 / ⟲ / ⟳)。
34
+ - **胶囊上的按钮**:收藏、上一首、播放暂停、下一首、停止、音量、播放列表,以及与侧边栏按钮一一对应的同一控制源。
35
+ - **界面改造**:控件行 18 枚同风格按钮、胶囊三态位置(上 / 下 / 隐藏)、精简播放条、歌词区与频谱 / 音准区、列表 6–10 列、唱片占位图、翻页与「播放全部」同行。
36
+ - **主要功能**:本地音乐库与整文件 Blob seek、收藏与 QQ 音乐「我喜欢」同源、循环三态对手动切歌生效、歌词 5 档动效、字幕、默认值与一次性迁移。
9
37
 
10
38
  ## 功能
11
39
 
12
- - **侧边栏统一音视频播放器**(接管 dsh-better-sidebar 的文件预览):一个组件按扩展名分流音频与视频。
40
+ ### 1. 侧边栏统一音视频播放器
41
+
13
42
  - **视频**:mp4 / webm / mov / m4v / ogv;**音频**:mp3 / wav / flac / ogg / opus / m4a / aac。
14
- - **拖动进度条(HTTP Range 206 流式)**:自建 Range 路由,浏览器拿到 206 才解锁 seek;含 **Blob 救援**,修复「桌面端 `content-length` 被剥离导致时长未知、进度条不可拖」的问题(音频与视频统一生效,>300MB 也不整文件入内存)。
15
- - **实时频谱柱 + 音准(Hz + 音名)**:`AnalyserNode` 对数分桶柱状图;归一化自相关(ACF)+ 抛物线插值给出 Hz 与音名。
16
- - **视频字幕**:自动加载同目录同名 `.srt / .vtt / .ass`(服务端统一转 VTT),自绘字幕层,支持开关 / 字号 4 档 / 位置 3 档(设置本地记忆)。
17
- - **音频歌词**:自动加载同目录同名 `.lrc`(含内嵌歌词),滚动高亮,支持开关。
18
- - **修复图标尺寸 bug**:图标函数曾被当组件调用,导致 SVG 撑到 300×150 并遮挡进度条,本版修复。
43
+ - **字幕**:自动加载同目录同名 `.srt / .vtt / .ass`(宿主统一转 VTT),自绘字幕层,支持开关 / 字号 4 档 / 位置 3 档,设置本地记忆。
44
+ - **拖动进度条**:自建 Range(206) 流式路由;桌面端 `content-length` 被剥离时用整文件 Blob 兜底,保证时长与 seek 可用。
45
+ - **不支持的编码**(wma / ape / ncm / qmc 等)给出中文提示,而不是静默无声。
19
46
 
20
- ## 截图
47
+ ### 2. 侧边栏播放器面板(两个页签:QQ音乐 / 本地音乐)
21
48
 
22
- ![视频 + 字幕(字幕设置面板)](docs/screenshots/01-video-subtitle.png)
49
+ - **顶部播放器区**:唱盘 + 歌名、歌词区(两句 / 歌词板)、实时频谱(柱状 / 波形)、音准读数(Hz + 音名 + 音分刻度尺)、进度条、控件行。
50
+ - **页签行**:`QQ音乐` / `本地音乐` 两个页签(点页签自动展开列表)+ `隐藏列表`(只留上方播放器)+ `⟲` 刷新 QQ 数据(不重载页面、不中断播放)+ `⟳` 检查更新。
51
+ - **控件行(18 枚候选同风格按钮,同屏最多 17 枚——字幕钮只在视频出现、歌词模式钮只在音频出现;单行不折行)**:收藏、上一首、播放/暂停、下一首、停止、音量、倍速 0.5–2、循环(顺序 → 单曲 → 随机)、频谱开关、频谱样式(柱状/波形)、字幕、歌词开关、歌词模式(两句/歌词板)、歌词动效(无/上滑/模糊/卡拉OK/炫彩 5 档)、胶囊位置(上/下/隐藏)、列表列数(6–10)、精简播放条、下载原文件。
52
+ - 原「系统配置」独立页已并入控件行,不再有单独的设置页。
23
53
 
24
- ![音频 + 歌词 + 频谱 + 音准](docs/screenshots/02-audio-lyric.png)
54
+ ### 3. 本地音乐库
25
55
 
26
- ## 安装
56
+ - 递归扫描音乐库目录(扫描深度固定 8 层,当前无 UI 可调),支持「重新扫描」「选目录」、点行播放;列表最多显示前 2 万条。
57
+ - 音频项走**整文件 Blob** 读取 → 时长与 seek 完整可靠(这是本地曲能拖动快进的关键);**视频**与 >250MB 大文件仍走 `/media` 直链,避免占内存。
58
+ - 无封面的歌单/条目统一用**唱片图标**占位;列表行内也带一枚小唱片标记。
59
+
60
+ ### 4. QQ 音乐在线曲库
61
+
62
+ - 搜索、榜单、歌单(含「我喜欢」)、新歌速递;卡片封面 1:1 `contain` 自适应、VIP 左上角标、播放键右下小圆。
63
+ - **收藏与 QQ 音乐「我喜欢」同源**:胶囊 ♥、面板 ♥、卡片 ♥ 三处读写同一个集合(宿主 `GET /qq/liked` 读、`POST /qq/fav` 写),不是插件自建的本地标记。
64
+ - 歌词(含逐字歌词回落)、MV 同源反代(透传 Range/206)。
65
+ - 卡片列数 6–10 可调;「翻页」与「播放全部」同一行,列表区不被页脚占用。
66
+
67
+ ### 5. 胶囊播放条
68
+
69
+ - **三种位置**:输入框上方(默认)/ 页面底部 / 隐藏。选「隐藏」则完全不渲染胶囊条(侧边栏面板顶部的播放器不受影响)。
70
+ - **精简播放条**:可切换成只留音符 + 歌名的一行(与「隐藏」是两件事)。
71
+ - 条上按钮与面板控件**一一对应、同一控制源**(`SMP_STORE`):收藏、上一首、播放/暂停、下一首、停止、音量、播放列表。
72
+ - 音量竖条可上下拖动;歌词单行显示并跟随 5 档动效;点歌名可展开/收起。
27
73
 
28
- 本插件是 `dsh-better-sidebar` 的配套插件,安装命令:
74
+ ## 默认值(0.2.6 起定稿)
75
+
76
+ | 项 | 默认值 |
77
+ |---|---|
78
+ | 胶囊位置 | 输入框上方(dock) |
79
+ | QQ 卡片列数 | 10 列 |
80
+ | 歌词动效 | 炫彩(rainbow) |
81
+ | 循环模式 | 顺序播放 |
82
+ | 频谱 | 打开,柱状 |
83
+ | 歌词模式 | 两句(duo) |
84
+
85
+ 升级到 0.2.6 时会做一次**一次性迁移**(localStorage 标记 `smp.appearanceRev2`),把上述外观项拉到默认值;之后手动改过的设置完全保留,不再被覆盖。
86
+
87
+ ## 安装
29
88
 
30
89
  ```bash
31
90
  dsh plugin add dsh-sidebar-media-player
@@ -34,24 +93,29 @@ dsh plugin add dsh-sidebar-media-player
34
93
  > 桌面端 `desktop` profile 由 Electron 独占管理(`dsh plugin --profile desktop add` 会被 CLI 直接拒绝),需走「真实副本 + 只加 bundles」的方式手动挂载:
35
94
  >
36
95
  > 1. 备份 `~/.dsh/profiles/desktop/package.json` 与 `cordis.patch.yml`;
37
- > 2. 把 `local-plugins/dsh-sidebar-media-player` 复制成**真实副本**到 `~/.dsh/profiles/desktop/node_modules/dsh-sidebar-media-player`(**不要**用 `link:`/`file:` 依赖,也不要直接改 pnpm 装出来的目录);
38
- > 3. 在 profile `package.json` 的 `dsh.profile.bundles` 数组里追加 `"dsh-sidebar-media-player"`;
39
- > 4. **彻底退出 DSH 客户端再启动**(宿主是 Node 进程,无热重载);
40
- > 5. 在侧边栏打开任意 `.mp3` / `.mp4` 验证。
96
+ > 2. 把插件真实副本放到 `local-plugins/` 下并加入 profile 的 `dependencies` 与 `dsh.profile.bundles`;
97
+ > 3. **彻底退出 DSH 客户端再启动**(宿主是 Node 进程,没有热重载)。
98
+
99
+ ## 生效方式
41
100
 
42
- ## 技术要点
101
+ | 改了什么 | 怎么生效 |
102
+ |---|---|
103
+ | `lib/client.js`(客户端 bundle) | `Ctrl+Shift+R` 硬刷新;没变化就彻底退出 DSH 再启动 |
104
+ | `lib/index.js`(宿主端)/ `package.json` / `cordis.patch.yml` | 彻底退出 DSH 客户端再启动 |
105
+ | 面板底部构建戳(`构建 YYYY-MM-DD HH:mm`) | 用来判断是否加载到新 bundle |
106
+
107
+ ## 截图
108
+
109
+ ![视频 + 字幕(字幕设置面板)](docs/screenshots/01-video-subtitle.png)
43
110
 
44
- - **可拖动 seek**:宿主媒体路由回 200 且无 `Accept-Ranges` 时浏览器不给拖动条;本插件自建 Range 路由(`bytes=a-b` / `bytes=a-` / `bytes=-N` 三种形态 + HEAD 探测),206 到位即解锁 seek。视频用原生控件,音频用自建 `input[type=range]`(`currentTime` 节流写入,时长与 Web Audio 解码解耦)。
45
- - **频谱**:`createMediaElementSource → AnalyserNode(fftSize 2048) → destination`,`requestAnimationFrame` 每帧 `getByteFrequencyData`,按 40 Hz–16 kHz 对数分桶,canvas 按 `devicePixelRatio` 缩放。
46
- - **音准**:`getFloatTimeDomainData` → 归一化 ACF + 抛物线插值;取第一个达到全局峰 90% 的「先升后降」局部峰,避免八度错位。
47
- - **安全围栏**:Host 信任围栏(loopback / 可信 Host)+ 路径必须落在会话 cwd 内 + 音视频扩展名白名单,本路由不能当通用下载器用。
111
+ ![音频 + 歌词 + 频谱 + 音准](docs/screenshots/02-audio-lyric.png)
48
112
 
49
113
  ## 已知限制
50
114
 
51
- - **编码靠浏览器**:`mkv/avi/wmv/flv/ape/wma/amr` 等通常放不出来(无内置解码器),会提示并给下载链接。
52
- - **没有预解码波形**:频谱是实时分析,不是预解码波形。
53
- - **音准是估算**:单声道混音 + ACF,复音(和弦、多人说话)只给出最突出的基频;噪声/打击乐读数会跳动,属正常。
54
- - **视频不带自建进度条**:视频用原生控件(自带拖动、全屏、画中画);音频才用自建整轨 scrubber。
115
+ - QQ 音乐的付费 / VIP 曲目受登录账号权限限制;无版权或下架曲目无法播放。
116
+ - 浏览器原生不支持的编码(wma / ape / ncm / qmc)只能提示,不能解码。
117
+ - 无歌词 / 无时间轴的曲目显示「无歌词」;逐字歌词缺失时回落到整行歌词。
118
+ - 本地音乐的 seek 依赖整文件 Blob,超大文件(>250MB)走直链时依赖浏览器 Range 缓冲进度。
55
119
 
56
120
  ## 文件结构
57
121
 
@@ -59,10 +123,14 @@ dsh plugin add dsh-sidebar-media-player
59
123
  dsh-sidebar-media-player/
60
124
  ├── package.json # name/version/type/main/exports/dsh.bundle/dsh.client
61
125
  ├── cordis.patch.yml # insert 1 条 entry(id=name=dsh-sidebar-media-player)
62
- ├── lib/index.js # host:Range(206) 媒体路由 + 安全围栏
63
- ├── lib/client.js # client:__ModuleLoader__ bundle + viewer(音视频统一)
64
- ├── docs/screenshots/ # 两张真实界面截图
65
- ├── screenshots.json # 插件市场配图清单(纯数组)
126
+ ├── lib/index.js # host:Range(206) 媒体路由 / 曲库扫描 / 歌词字幕 / QQ 音乐代理
127
+ ├── lib/client.js # client:__ModuleLoader__ bundle(viewer + 面板 + 胶囊条)
128
+ ├── lib/qq.js # QQ 音乐接口签名与解析
129
+ ├── lib/qrc.js # 二维码渲染(QQ 登录扫码)
130
+ ├── docs/screenshots/ # 真实界面截图
131
+ ├── screenshots.json # 插件市场配图清单(纯数组、相对路径)
132
+ ├── locale/{zh,en}.json # 市场标题与描述
133
+ ├── icon.svg
66
134
  ├── CHANGELOG.md
67
135
  ├── README.md
68
136
  └── LICENSE
@@ -76,49 +144,136 @@ dsh-sidebar-media-player/
76
144
 
77
145
  # dsh-sidebar-media-player (Sidebar Media Player)
78
146
 
79
- A unified audio + video player for `dsh-better-sidebar`: one sidebar file viewer that takes over previewing audio/video files. It fixes the three things that used to be broken — **a draggable progress bar** (streamed over an HTTP Range 206 route), **a live spectrum**, and **a pitch readout** — and adds **video subtitles** (same-name `.srt/.vtt/.ass` auto-loaded) and **audio lyrics** (same-name `.lrc`, scroll-highlighted).
147
+ A unified audio + video player for `dsh-better-sidebar`. One viewer takes over audio/video preview, and the plugin adds its own **player panel** (QQ Music online library + local library) and a **capsule bar** that can sit in three places, plus live spectrum, pitch readout, lyrics and subtitles.
148
+
149
+ **Adapts the DSH kernel 0.2.2-rc.1; current version 0.2.6.**
150
+
151
+ > Since 0.2.6, the previously documented defects (undroppable scrubber, dead next/favourite/rate controls, lyrics effects not applying, capsule disappearing after changing position) have been fixed one by one. Defaults, source changes and the packed file list were checked with machine assertions during development; those check scripts live in the development environment and are not shipped in this package. Trying it on a small scale first is still recommended.
152
+
153
+ - Version: 0.2.6
154
+ - Requires: `dsh-better-sidebar` (provides the `ctx.betterSidebar` viewer registration service; when absent the plugin degrades gracefully and never blocks DSH startup)
155
+
156
+ ## Disclaimer (please read first)
157
+
158
+ This plugin is a **third-party hobby tool. It is not an official QQ Music product and has no affiliation or partnership with Tencent / QQ Music.**
159
+
160
+ - **Purpose**: only to make it easier for loyal QQ Music users to play **their own QQ Music playlists** inside their own DSH sidebar.
161
+ - **Scope**: playing QQ Music playlists and nothing else. It does **not** support or take part in any official campaign — no check-ins, no quests, no coupons, no play-count inflation, no membership bypass, no downloading of copyrighted content.
162
+ - **Ownership**: all music, accounts and copyrights belong to Tencent / QQ Music. This plugin stores and distributes no audio; playback uses the account the user has already signed in with.
163
+ - **Use the official app**: for full features, membership benefits or official campaigns, please use the official QQ Music client or site (y.qq.com).
164
+ - **Takedown on request**: if a rights holder considers this project infringing, tell us and the **repository will be deleted immediately, together with the npm package and any Release**.
165
+
166
+ ## Credits & provenance (what is copied, what is original)
167
+
168
+ **Copied from third-party upstream (MIT)**
80
169
 
81
- **Adapts the DSH kernel 0.2.2-rc.1.**
170
+ - **The capsule bar UI design and placement**: the dock-above-input / bottom-of-window behaviour, the two-layer container structure, the size and style values and the hover-collapse mechanism are copied verbatim from `dsh-music-player v1.0.4` (MIT, by kendu76); the source marks every reference location.
171
+ - **The QQ Music API layer**: request signing, calls and response parsing in `lib/qq.js`, plus the QR login renderer `lib/qrc.js`, come from that upstream implementation (MIT). Copyright remains with the original author.
82
172
 
83
- - Version: 0.2.0 (first public release)
84
- - Requires: `dsh-better-sidebar` (provides the `ctx.betterSidebar` file-viewer registration service)
173
+ **Designed and implemented here**
174
+
175
+ - Moving the whole player **into the sidebar**: the `ctx.betterSidebar` viewer registration, the player panel, and the tab row (QQ音乐 / 本地音乐 / hide list / ⟲ / ⟳).
176
+ - **The capsule buttons**: favourite, previous, play/pause, next, stop, volume and playlist, all driven by the same store as the sidebar buttons.
177
+ - **The UI rework**: the 18-button control row in one style, the three-state capsule position (top / bottom / hidden), the compact bar, the lyric + spectrum + pitch area, 6–10 grid columns, vinyl artwork fallback, pager next to "play all".
178
+ - **The main features**: local library with whole-file Blob seeking, favourites shared with QQ Music's "I like", loop modes that also apply to manual next, five lyric effects, subtitles, defaults plus the one-time migration.
85
179
 
86
180
  ## Features
87
181
 
88
- - **Unified sidebar audio/video player** (takes over dsh-better-sidebar's file preview): one component dispatches by extension.
89
- - **Video**: mp4 / webm / mov / m4v / ogv; **Audio**: mp3 / wav / flac / ogg / opus / m4a / aac.
90
- - **Draggable progress bar (HTTP Range 206 streaming)**: a self-hosted Range route so the browser receives 206 and unlocks seeking; includes a **Blob rescue** that fixes "on desktop the stripped `content-length` leaves the duration unknown and the scrubber un-draggable" (applies to audio and video alike, and a >300MB file is never loaded fully into memory).
91
- - **Live spectrum bars + pitch (Hz + note name)**: `AnalyserNode` log-binned bars; normalized autocorrelation (ACF) + parabolic interpolation yields Hz and note name.
92
- - **Video subtitles**: auto-loads same-name `.srt / .vtt / .ass` (server converts to VTT), custom subtitle layer, toggle / 4 font sizes / 3 positions (prefs remembered locally).
93
- - **Audio lyrics**: auto-loads same-name `.lrc` (including embedded lyrics), scroll-highlighted, toggleable.
94
- - **Icon size bug fix**: the icon function was mistakenly invoked as a component, stretching the SVG to 300×150 and covering the progress bar — fixed in this release.
182
+ ### 1. Unified sidebar audio/video viewer
95
183
 
96
- ## Screenshots
184
+ - **Video**: mp4 / webm / mov / m4v / ogv. **Audio**: mp3 / wav / flac / ogg / opus / m4a / aac.
185
+ - **Subtitles**: same-name `.srt / .vtt / .ass` auto-loaded (converted to VTT host-side), custom subtitle layer with on/off, 4 font sizes and 3 positions, remembered locally.
186
+ - **Draggable scrubber**: self-hosted Range(206) streaming route; when the desktop shell strips `content-length`, a whole-file Blob rescue keeps duration and seeking working.
187
+ - **Unsupported codecs** (wma / ape / ncm / qmc …) produce an explicit message instead of silence.
97
188
 
98
- ![Video + subtitles (subtitle settings panel)](docs/screenshots/01-video-subtitle.png)
189
+ ### 2. Player panel (two tabs: QQ音乐 / 本地音乐)
99
190
 
100
- ![Audio + lyrics + spectrum + pitch](docs/screenshots/02-audio-lyric.png)
191
+ - **Top player area**: turntable + title, lyrics (two-line or lyric board), live spectrum (bars or wave), pitch readout (Hz + note name + cents ruler), scrubber, control row.
192
+ - **Tab row**: `QQ音乐` / `本地音乐` tabs (clicking a tab auto-expands the list) + `Hide list` (keeps only the top player) + `⟲` refresh QQ data (no page reload, no playback interruption) + `⟳` check for updates.
193
+ - **Control row (18 candidate buttons in one style, at most 17 on screen — the subtitle button only appears for video and the lyric-mode button only for audio; one line, no wrapping)**: favourite, previous, play/pause, next, stop, volume, playback rate 0.5–2, loop (order → single → shuffle), spectrum on/off, spectrum style (bars/wave), subtitles, lyrics on/off, lyric mode (two-line/board), lyric effect (none/slide/blur/karaoke/rainbow), capsule position (top/bottom/hidden), grid columns (6–10), compact bar, download original file.
194
+ - The former standalone "settings" tab has been folded into this control row.
101
195
 
102
- ## Install
196
+ ### 3. Local music library
197
+
198
+ - Recursively scans the music directory (depth fixed at 8 levels, not configurable in the UI), with rescan, pick-directory and per-row play; the list shows at most 20,000 entries.
199
+ - Audio items are read as a **whole-file Blob** so duration and seeking are complete and reliable; **video** and files over 250MB still stream from `/media` to keep memory flat.
200
+ - Playlists/items without artwork fall back to a **vinyl record icon** (also shown inline in each list row).
201
+
202
+ ### 4. QQ Music online library
203
+
204
+ - Search, charts, playlists (including "I like"), new songs; 1:1 `contain` artwork, VIP corner badge, small play button.
205
+ - **Favourites are shared with QQ Music's own "I like"**: capsule heart, panel heart and card heart all read and write the same remote collection (host `GET /qq/liked` / `POST /qq/fav`), not a local flag.
206
+ - Lyrics (with word-by-word fallback), MV proxied same-origin with Range/206 passthrough.
207
+ - Grid columns adjustable 6–10; pager sits on the same line as "Play all" so the list never loses a row to the footer.
208
+
209
+ ### 5. Capsule bar
103
210
 
104
- This plugin is a companion to `dsh-better-sidebar`:
211
+ - **Three positions**: above the input box (default) / bottom of the window / hidden. Choosing "hidden" stops rendering the capsule entirely (the panel's top player is unaffected).
212
+ - **Compact mode** shrinks it to one line with just a note glyph and the title.
213
+ - Every capsule button **maps one-to-one onto a panel control** through the same store (`SMP_STORE`): favourite, previous, play/pause, next, stop, volume, playlist.
214
+ - Vertical volume slider is draggable; the single-line lyric follows the same 5 lyric effects.
215
+
216
+ ## Defaults (as of 0.2.6)
217
+
218
+ | Item | Default |
219
+ |---|---|
220
+ | Capsule position | Above the input box (dock) |
221
+ | QQ grid columns | 10 |
222
+ | Lyric effect | Rainbow |
223
+ | Loop mode | Sequential |
224
+ | Spectrum | On, bars |
225
+ | Lyric mode | Two lines (duo) |
226
+
227
+ Upgrading to 0.2.6 runs a **one-time migration** (localStorage marker `smp.appearanceRev2`) that pulls these appearance settings back to defaults; anything you change afterwards is preserved.
228
+
229
+ ## Install
105
230
 
106
231
  ```bash
107
232
  dsh plugin add dsh-sidebar-media-player
108
233
  ```
109
234
 
110
- > On desktop, the `desktop` profile is managed exclusively by Electron (`dsh plugin --profile desktop add` is rejected by the CLI), so mount it manually with a real copy + bundles-only:
111
- >
112
- > 1. Back up `~/.dsh/profiles/desktop/package.json` and `cordis.patch.yml`;
113
- > 2. Copy `local-plugins/dsh-sidebar-media-player` into `~/.dsh/profiles/desktop/node_modules/dsh-sidebar-media-player` as a **real copy** (do **not** use `link:`/`file:` deps, and do not edit the pnpm-installed directory);
114
- > 3. Append `"dsh-sidebar-media-player"` to the profile `package.json`'s `dsh.profile.bundles` array;
115
- > 4. **Fully quit and relaunch the DSH client** (the host is a Node process, no hot reload);
116
- > 5. Open any `.mp3` / `.mp4` in the sidebar to verify.
235
+ > On desktop the `desktop` profile is managed exclusively by Electron (`dsh plugin --profile desktop add` is rejected by the CLI), so mount it manually: back up `~/.dsh/profiles/desktop/package.json` and `cordis.patch.yml`, place a real copy under `local-plugins/`, wire it into `dependencies` and `dsh.profile.bundles`, then **fully quit and relaunch DSH** (the host is a Node process with no hot reload).
117
236
 
118
- ## Changelog
237
+ ## How changes take effect
119
238
 
120
- See [CHANGELOG.md](CHANGELOG.md).
239
+ | What changed | How to apply |
240
+ |---|---|
241
+ | `lib/client.js` (client bundle) | `Ctrl+Shift+R` hard refresh; if nothing changes, fully quit and relaunch DSH |
242
+ | `lib/index.js` (host) / `package.json` / `cordis.patch.yml` | Fully quit and relaunch DSH |
243
+ | Build stamp at the panel bottom (`构建 YYYY-MM-DD HH:mm`) | Tells you whether the new bundle is loaded |
244
+
245
+ ## Screenshots
246
+
247
+ ![Video + subtitles (subtitle settings panel)](docs/screenshots/01-video-subtitle.png)
248
+
249
+ ![Audio + lyrics + spectrum + pitch](docs/screenshots/02-audio-lyric.png)
250
+
251
+ ## Known limitations
252
+
253
+ - Paid/VIP QQ Music tracks depend on the signed-in account; unavailable or delisted tracks cannot be played.
254
+ - Codecs the browser cannot decode (wma / ape / ncm / qmc) can only be reported.
255
+ - Tracks without lyrics or timestamps show "no lyrics"; word-by-word lyrics fall back to line lyrics.
256
+ - Local seeking relies on a whole-file Blob; for files over 250MB streamed directly, the browser's Range buffering applies.
257
+
258
+ ## Layout
259
+
260
+ ```
261
+ dsh-sidebar-media-player/
262
+ ├── package.json # name/version/type/main/exports/dsh.bundle/dsh.client
263
+ ├── cordis.patch.yml # one insert entry (id=name=dsh-sidebar-media-player)
264
+ ├── lib/index.js # host: Range(206) media route / library scan / lyric+subtitle / QQ proxy
265
+ ├── lib/client.js # client: __ModuleLoader__ bundle (viewer + panel + capsule bar)
266
+ ├── lib/qq.js # QQ Music signing and parsing
267
+ ├── lib/qrc.js # QR code rendering (QQ login scan)
268
+ ├── docs/screenshots/ # real UI screenshots
269
+ ├── screenshots.json # marketplace screenshot list (plain array, relative paths)
270
+ ├── locale/{zh,en}.json # marketplace title and description
271
+ ├── icon.svg
272
+ ├── CHANGELOG.md
273
+ ├── README.md
274
+ └── LICENSE
275
+ ```
121
276
 
122
- ## License
277
+ ## Changelog
123
278
 
124
- MIT
279
+ See [CHANGELOG.md](CHANGELOG.md).
package/docs/DETAIL.md ADDED
@@ -0,0 +1 @@
1
+ ![Sidebar media player: the capsule bar docked above the composer, and the player panel with QQ Music / local music tabs plus an artwork grid](preview.svg)
@@ -0,0 +1 @@
1
+ ![侧边栏多媒体播放器:胶囊播放条停在输入框上方,播放器面板带 QQ音乐 / 本地音乐 页签与封面网格](preview.svg)
@@ -0,0 +1,161 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="640" height="300" viewBox="0 0 640 300" role="img" aria-label="Sidebar media player: a capsule bar docked above the composer and a player panel with tabs and an artwork grid">
2
+ <defs>
3
+ <linearGradient id="surface" x1="0" y1="0" x2="0" y2="1">
4
+ <stop offset="0" stop-color="#1b1d24"/>
5
+ <stop offset="1" stop-color="#15171d"/>
6
+ </linearGradient>
7
+ <linearGradient id="art" x1="0" y1="0" x2="1" y2="1">
8
+ <stop offset="0" stop-color="#2b2f3a"/>
9
+ <stop offset="1" stop-color="#20232b"/>
10
+ </linearGradient>
11
+ <linearGradient id="brand" x1="0" y1="0" x2="1" y2="0">
12
+ <stop offset="0" stop-color="#7C5CF5"/>
13
+ <stop offset="1" stop-color="#4C8DFF"/>
14
+ </linearGradient>
15
+ <linearGradient id="lyric" x1="0" y1="0" x2="1" y2="0">
16
+ <stop offset="0" stop-color="#7C5CF5"/>
17
+ <stop offset="0.5" stop-color="#4C8DFF"/>
18
+ <stop offset="1" stop-color="#37C9A0"/>
19
+ </linearGradient>
20
+ </defs>
21
+
22
+ <rect x="0" y="0" width="640" height="300" rx="14" fill="url(#surface)"/>
23
+ <rect x="0.5" y="0.5" width="639" height="299" rx="14" fill="none" stroke="#2c3039"/>
24
+
25
+ <!-- close-up: capsule bar docked above the composer -->
26
+ <g>
27
+ <rect x="32" y="40" width="576" height="52" rx="26" fill="#22252d" stroke="#333844"/>
28
+ <circle cx="60" cy="66" r="14" fill="#111319" stroke="#4a4f5c"/>
29
+ <circle cx="60" cy="66" r="8.5" fill="none" stroke="#5a6070"/>
30
+ <circle cx="60" cy="66" r="2.4" fill="#7C5CF5"/>
31
+ <rect x="84" y="56" width="132" height="7" rx="3.5" fill="#9aa1b0"/>
32
+ <rect x="84" y="69" width="96" height="6" rx="3" fill="url(#lyric)" opacity="0.9"/>
33
+ <g stroke="#6f7686" stroke-width="2.2" stroke-linecap="round">
34
+ <path d="M300 60v12"/>
35
+ <path d="M300 60v12" transform="translate(7 0)"/>
36
+ <path d="M300 60v12" transform="translate(14 0)"/>
37
+ <path d="M300 60v6" transform="translate(21 0)"/>
38
+ <path d="M300 66v6" transform="translate(21 0)"/>
39
+ <path d="M300 63v9" transform="translate(28 0)"/>
40
+ <path d="M300 58v12" transform="translate(35 0)"/>
41
+ <path d="M300 63v9" transform="translate(42 0)"/>
42
+ </g>
43
+ <g fill="none" stroke="#b6bcc9" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
44
+ <path d="M372 62l-6 4 6 4"/>
45
+ <path d="M380 62l6 4-6 4"/>
46
+ </g>
47
+ <circle cx="410" cy="66" r="14" fill="url(#brand)"/>
48
+ <path d="M406 59.5v13l11-6.5z" fill="#ffffff"/>
49
+ <g fill="none" stroke="#b6bcc9" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
50
+ <path d="M444 62l6 4-6 4"/>
51
+ <path d="M452 62l6 4-6 4"/>
52
+ </g>
53
+ <rect x="470" y="58" width="14" height="16" rx="2.5" fill="#b6bcc9"/>
54
+ <g fill="none" stroke="#8b93a4" stroke-width="2" stroke-linecap="round">
55
+ <path d="M506 60l6 4-6 4"/>
56
+ <path d="M522 64v10M522 64c0-2 4-2 4 0v10"/>
57
+ </g>
58
+ <rect x="548" y="58" width="16" height="16" rx="4" fill="none" stroke="#b6bcc9" stroke-width="2"/>
59
+ <path d="M552 62h8M552 66h8M552 70h5" stroke="#b6bcc9" stroke-width="1.8" stroke-linecap="round"/>
60
+ <rect x="46" y="88" width="576" height="2" rx="1" fill="#3a3f4b"/>
61
+ <rect x="46" y="88" width="212" height="2" rx="1" fill="url(#brand)"/>
62
+ <circle cx="258" cy="89" r="4.5" fill="#ffffff"/>
63
+ </g>
64
+
65
+ <!-- main example: player panel -->
66
+ <g>
67
+ <rect x="32" y="112" width="576" height="156" rx="12" fill="#191c22" stroke="#2f343f"/>
68
+
69
+ <!-- tab row -->
70
+ <rect x="44" y="124" width="86" height="22" rx="11" fill="url(#brand)"/>
71
+ <rect x="140" y="124" width="86" height="22" rx="11" fill="#242832" stroke="#333844"/>
72
+ <rect x="470" y="124" width="22" height="22" rx="6" fill="#242832" stroke="#333844"/>
73
+ <rect x="500" y="124" width="22" height="22" rx="6" fill="#242832" stroke="#333844"/>
74
+ <rect x="530" y="124" width="22" height="22" rx="6" fill="#242832" stroke="#333844"/>
75
+ <rect x="560" y="124" width="36" height="22" rx="11" fill="#242832" stroke="#333844"/>
76
+
77
+ <!-- artwork grid -->
78
+ <g>
79
+ <g transform="translate(44 158)">
80
+ <rect width="66" height="52" rx="6" fill="url(#art)"/>
81
+ <circle cx="33" cy="26" r="15" fill="#101217" stroke="#4a4f5c"/>
82
+ <circle cx="33" cy="26" r="9" fill="none" stroke="#565d6c"/>
83
+ <circle cx="33" cy="26" r="2.6" fill="#7C5CF5"/>
84
+ <circle cx="57" cy="45" r="8" fill="url(#brand)"/>
85
+ <path d="M54.5 41.5v7l6-3.5z" fill="#fff"/>
86
+ </g>
87
+ <g transform="translate(120 158)">
88
+ <rect width="66" height="52" rx="6" fill="url(#art)"/>
89
+ <circle cx="33" cy="26" r="15" fill="#101217" stroke="#4a4f5c"/>
90
+ <circle cx="33" cy="26" r="9" fill="none" stroke="#565d6c"/>
91
+ <circle cx="33" cy="26" r="2.6" fill="#4C8DFF"/>
92
+ <rect x="4" y="4" width="20" height="10" rx="5" fill="#d9a441"/>
93
+ </g>
94
+ <g transform="translate(196 158)">
95
+ <rect width="66" height="52" rx="6" fill="url(#art)"/>
96
+ <circle cx="33" cy="26" r="15" fill="#101217" stroke="#4a4f5c"/>
97
+ <circle cx="33" cy="26" r="9" fill="none" stroke="#565d6c"/>
98
+ <circle cx="33" cy="26" r="2.6" fill="#37C9A0"/>
99
+ </g>
100
+ <g transform="translate(272 158)">
101
+ <rect width="66" height="52" rx="6" fill="url(#art)"/>
102
+ <circle cx="33" cy="26" r="15" fill="#101217" stroke="#4a4f5c"/>
103
+ <circle cx="33" cy="26" r="9" fill="none" stroke="#565d6c"/>
104
+ <circle cx="33" cy="26" r="2.6" fill="#e5534b"/>
105
+ </g>
106
+ <g transform="translate(348 158)">
107
+ <rect width="66" height="52" rx="6" fill="url(#art)"/>
108
+ <circle cx="33" cy="26" r="15" fill="#101217" stroke="#4a4f5c"/>
109
+ <circle cx="33" cy="26" r="9" fill="none" stroke="#565d6c"/>
110
+ <circle cx="33" cy="26" r="2.6" fill="#7C5CF5"/>
111
+ </g>
112
+ <g transform="translate(424 158)">
113
+ <rect width="66" height="52" rx="6" fill="url(#art)"/>
114
+ <circle cx="33" cy="26" r="15" fill="#101217" stroke="#4a4f5c"/>
115
+ <circle cx="33" cy="26" r="9" fill="none" stroke="#565d6c"/>
116
+ <circle cx="33" cy="26" r="2.6" fill="#4C8DFF"/>
117
+ </g>
118
+ <g transform="translate(500 158)">
119
+ <rect width="66" height="52" rx="6" fill="url(#art)"/>
120
+ <circle cx="33" cy="26" r="15" fill="#101217" stroke="#4a4f5c"/>
121
+ <circle cx="33" cy="26" r="9" fill="none" stroke="#565d6c"/>
122
+ <circle cx="33" cy="26" r="2.6" fill="#37C9A0"/>
123
+ </g>
124
+ <g transform="translate(44 218)">
125
+ <rect width="66" height="40" rx="6" fill="url(#art)"/>
126
+ <circle cx="33" cy="20" r="11" fill="#101217" stroke="#4a4f5c"/>
127
+ <circle cx="33" cy="20" r="6.5" fill="none" stroke="#565d6c"/>
128
+ </g>
129
+ <g transform="translate(120 218)">
130
+ <rect width="66" height="40" rx="6" fill="url(#art)"/>
131
+ <circle cx="33" cy="20" r="11" fill="#101217" stroke="#4a4f5c"/>
132
+ <circle cx="33" cy="20" r="6.5" fill="none" stroke="#565d6c"/>
133
+ </g>
134
+ <g transform="translate(196 218)">
135
+ <rect width="66" height="40" rx="6" fill="url(#art)"/>
136
+ <circle cx="33" cy="20" r="11" fill="#101217" stroke="#4a4f5c"/>
137
+ <circle cx="33" cy="20" r="6.5" fill="none" stroke="#565d6c"/>
138
+ </g>
139
+ <g transform="translate(272 218)">
140
+ <rect width="66" height="40" rx="6" fill="url(#art)"/>
141
+ <circle cx="33" cy="20" r="11" fill="#101217" stroke="#4a4f5c"/>
142
+ <circle cx="33" cy="20" r="6.5" fill="none" stroke="#565d6c"/>
143
+ </g>
144
+ <g transform="translate(348 218)">
145
+ <rect width="66" height="40" rx="6" fill="url(#art)"/>
146
+ <circle cx="33" cy="20" r="11" fill="#101217" stroke="#4a4f5c"/>
147
+ <circle cx="33" cy="20" r="6.5" fill="none" stroke="#565d6c"/>
148
+ </g>
149
+ <g transform="translate(424 218)">
150
+ <rect width="66" height="40" rx="6" fill="url(#art)"/>
151
+ <circle cx="33" cy="20" r="11" fill="#101217" stroke="#4a4f5c"/>
152
+ <circle cx="33" cy="20" r="6.5" fill="none" stroke="#565d6c"/>
153
+ </g>
154
+ <g transform="translate(500 218)">
155
+ <rect width="66" height="40" rx="6" fill="url(#art)"/>
156
+ <circle cx="33" cy="20" r="11" fill="#101217" stroke="#4a4f5c"/>
157
+ <circle cx="33" cy="20" r="6.5" fill="none" stroke="#565d6c"/>
158
+ </g>
159
+ </g>
160
+ </g>
161
+ </svg>
package/icon.svg ADDED
@@ -0,0 +1,5 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 36 36" width="36" height="36" role="img" fill="none" stroke="#7C5CF5" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
2
+ <rect x="4.5" y="6.5" width="27" height="23" rx="2.5"/>
3
+ <path d="M13.5 6.5v23"/>
4
+ <path d="M20.5 14l6.5 4.2-6.5 4.2z" fill="#7C5CF5" stroke="none"/>
5
+ </svg>