dsh-music-player 0.6.7 → 0.7.0

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/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
4
4
 
5
- DeepSeek Harness 本地音乐/小说播放插件。
5
+ DeepSeek Harness 音乐/小说播放插件。
6
6
 
7
7
  写代码写累了、想摸鱼又不想切窗口?这个插件就是你的**摸鱼神器**——直接在 DeepSeek Harness 的网页里塞进一个 **DSH音乐播放器**:扫一下你电脑上的音乐目录(默认 `~/Music`)就能在浏览器里听歌,带播放条和可拖拽的播放面板,还能自己建歌单。
8
8
 
@@ -13,7 +13,7 @@ DeepSeek Harness 本地音乐/小说播放插件。
13
13
  - 本地音频流式播放(HTTP Range),刷新后断点续播
14
14
  - 顺序播放、单曲循环、乱序播放三种模式
15
15
  - 实时频谱可视化,两种样式可在「系统配置」切换(默认柱状图):**柱状图**(12 段真实 FFT 对数频段)与**波形图**(示波器式连续曲线,按低/中/高频分成**三条**层次线,各自反映一段频率的起伏)。二者都只由 `captureStream()`+`AnalyserNode` **只读旁路**实时采样、t=0 即响应——它不重定向媒体元素输出,因此绝不会让播放静音;失败(如该环境报 Chromium 的 `getTopURL` 取不到音轨)则**直接不显示**,无离线回退。柱状图柱高把各频段的 bin 归到对数频段取峰值、按分析器 dB 量程归一化(标准做法),柱高由**绝对响度**驱动(安静时柱自然低),并用一条**固定、与响度无关的频率加权**抹平音乐天然的 1/f 低频倾斜——低频几根不再常年钉在高位,同时安静片段也保持低柱)
16
- - **实时歌词/字幕**:本地音频自动匹配同名 `.lrc` 逐行显示;**本地没有同名 `.lrc` 时自动在线兜底**(QQ 音乐官方歌词 → LRCLIB 免费同步歌词,结果按曲目缓存避免重复请求);在线 QQ 歌曲自动取官方歌词(外语歌带逐句翻译「原文 / 翻译」);AI 讲书时显示当前朗读句子(逐句滚动)。歌词/字幕显示在播放条频谱之后、时长之前,仅在闲置(控件组折叠)时展示,鼠标进入操作时自动收起;**AI 讲书还有一条「已读字符/全书字符」的全书进度细线**(按已读字数实时计算,不依赖合成时长,切块不回退,操作时再显示「N%」)
16
+ - **实时歌词/字幕**:本地音频自动匹配同名 `.lrc` 逐行显示;**本地没有同名 `.lrc` 时自动在线兜底**(QQ 音乐官方歌词 → 酷狗 KRC 逐字 → LRCLIB 免费同步歌词,结果按曲目缓存避免重复请求);在线 QQ 歌曲自动取官方歌词(外语歌带逐句翻译「原文 / 翻译」);AI 讲书时显示当前朗读句子(逐句滚动)。歌词/字幕显示在播放条频谱之后、时长之前,仅在闲置(控件组折叠)时展示,鼠标进入操作时自动收起;**AI 讲书还有一条「已读字符/全书字符」的全书进度细线**(按已读字数实时计算,不依赖合成时长,切块不回退,操作时再显示「N%」)
17
17
  - 播放时申请屏幕唤醒锁,防止听歌时熄屏/休眠(支持 Wake Lock 的浏览器,如 Chrome/Edge)
18
18
  - 播放列表面板可自由拖动,右下角可拖拽调整大小,位置与尺寸跨刷新记忆
19
19
  - AI 讲书:本地 `.txt` / `.epub` 小说经 MiMo TTS 合成朗读,自动识别**书名/前言/章节/尾声**结构,播放条带**章节目录**跳转(打开即定位到当前正在播放的章节)、章节切歌,可选 4 种中文 AI 声音(默认白桦)
@@ -22,6 +22,7 @@ DeepSeek Harness 本地音乐/小说播放插件。
22
22
  - **真实音质识别**:本地歌曲扫描时自动解析文件头(FLAC/WAV/AIFF 无损、MP3/AAC/OGG 码率、采样率/位深/声道),播放条显示「格式 · 音质档」(如 `FLAC · 无损` / `MP3 · 高音质` / `MP3 · 标准`),与在线 QQ 音乐的「无损/高音质/标准」三档一致
23
23
  - **自建歌单**:可新建多个歌单,从本地文件(支持多选、可跨目录)添加歌曲;播放条爱心按钮一键收藏到默认歌单「我最喜欢」;歌单作为播放来源时,顺序/乱序循环只在该歌单内进行
24
24
  - **在线 QQ 音乐**:面板内置「QQ音乐」页签——微信/QQ 扫码登录(解锁 VIP/高音质)、我的歌单/推荐歌单/分类歌单/排行榜/新歌/搜索浏览、卡片式歌单展示、一键收藏到「我喜欢」
25
+ - **在线酷狗音乐**:面板内置「酷狗音乐」页签——酷狗 App 扫码登录(解锁高音质)、推荐/分类歌单/排行榜(TOP500 等)/统一搜索/我的歌单,KRC 逐字歌词内嵌翻译;详见下文「在线酷狗音乐」
25
26
 
26
27
  ## 截图
27
28
 
@@ -131,6 +132,20 @@ dsh plugin --profile <profile> add ./dsh-music-player-0.1.0.tgz
131
132
  - **续播**:在线播放进度(当前曲目 + 队列)刷新后自动恢复,点 ▶ 续播。
132
133
  - 在线曲目不占本地曲库的 500 首上限,与本地/讲书完全隔离。
133
134
 
135
+ ## 在线酷狗音乐
136
+
137
+ 播放面板侧栏切到「**酷狗音乐**」页签。**需先用酷狗 App 扫码登录**才能试听(未登录可浏览榜单/歌单/搜索,但取链播放需要登录态)。登录后支持:
138
+
139
+ - **浏览**:推荐歌单(600+ 热门精选)/ 分类歌单 / 排行榜(TOP500、国潮音乐榜等 57 个)/ 统一搜索(歌曲 + 歌单)/ 我的歌单(可在歌单详情里移除歌曲)。
140
+ - **逐字歌词**:KRC 逐字行窗口(与 QQ 的 QRC 同级精度),内嵌翻译自动并入歌词显示。
141
+ - **高音质**:按「无损 → Hi-Res → 320k → 128k」梯队请求,tracker 按账号权限授予真实档位,播放条显示实际品质标签。
142
+ - **续播**:与 QQ 同构——播放进度+队列独立持久化,刷新后自动恢复;单曲取链失败自动跳下一首。
143
+ - 登录态保存在 Host 端(`~/.dsh/music-player-kugou-cookie.json`,0600,含设备指纹),刷新/重启不丢。
144
+
145
+ > **使用声明**:与在线 QQ 音乐相同——非官方接口、仅供个人学习试听、严禁商业用途;
146
+ > 账号风控风险由使用者自行承担。技术细节与端点调研见
147
+ > [docs/kugou-integration-research.md](docs/kugou-integration-research.md)。
148
+
134
149
  ## AI 讲书
135
150
 
136
151
  把本地 `.txt` / `.epub` 小说交给 AI 朗读。**AI 语音目前仅支持xiaomi提供方(限时免费),请在设置中配置好再使用此功能。**