dsh-music-player 0.3.6 → 0.5.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 +28 -2
- package/lib/client.js +806 -17
- package/lib/index.js +254 -3
- package/lib/qq.js +723 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,6 +19,7 @@ DeepSeek Harness 本地音乐/小说播放插件。
|
|
|
19
19
|
- `music_play` 模型工具：agent 可按关键词播放本地音乐，也可按小说名启动 AI 讲书
|
|
20
20
|
- 支持的格式：`mp3 / m4a / m4b / aac / flac / wav / ogg / opus / webm / aiff`（自动递归扫描子目录，上限 500 首）
|
|
21
21
|
- **自建歌单**：可新建多个歌单，从本地文件（支持多选、可跨目录）添加歌曲；播放条爱心按钮一键收藏到默认歌单「我最喜欢」；歌单作为播放来源时，顺序/乱序循环只在该歌单内进行
|
|
22
|
+
- **在线 QQ 音乐**：面板内置「QQ音乐」页签——微信/QQ 扫码登录（解锁 VIP/高音质）、我的歌单/推荐歌单/分类歌单/排行榜/新歌/搜索浏览、卡片式歌单展示、一键收藏到「我喜欢」
|
|
22
23
|
|
|
23
24
|
## 截图
|
|
24
25
|
|
|
@@ -84,7 +85,7 @@ dsh plugin --profile <profile> add ./dsh-music-player-0.1.0.tgz
|
|
|
84
85
|
|
|
85
86
|
## 自建歌单（收藏）
|
|
86
87
|
|
|
87
|
-
|
|
88
|
+
播放面板「本地音乐」页内新增子标签：**曲库 / ♥ 我最喜欢 / ＋**，支持自建歌单并把歌单作为播放来源——此时顺序/乱序循环只在该歌单内进行。
|
|
88
89
|
|
|
89
90
|
- **新建歌单**：点「＋」输入名称即建（可建多个）。
|
|
90
91
|
- **曲库加入**：在「曲库」列表每首歌行尾有「＋」按钮，点击可把该曲加入任一已有歌单，或直接新建歌单加入。
|
|
@@ -95,6 +96,31 @@ dsh plugin --profile <profile> add ./dsh-music-player-0.1.0.tgz
|
|
|
95
96
|
- **命令**：`music_play` 工具新增 `playlist` 参数，可让 agent 直接播放某个歌单（如「播放歌单 我最喜欢」）。
|
|
96
97
|
- 歌单数据保存在 `~/.dsh/music-player-playlists.json`，刷新/重启不丢；歌单可包含曲库目录之外的本地音频文件。
|
|
97
98
|
|
|
99
|
+
## 在线 QQ 音乐
|
|
100
|
+
|
|
101
|
+
播放面板顶部切到「QQ音乐」页签即可在线听歌。**需先扫码登录**（QQ 登录或微信登录），登录后可浏览/搜索/播放并访问「我的歌单」，VIP 曲目可播高音质。
|
|
102
|
+
|
|
103
|
+
> **使用声明（重要）**：在线 QQ 音乐功能通过**非官方接口**访问 QQ 音乐资源，所播放/收藏的内容版权归
|
|
104
|
+
> 版权方及 QQ 音乐平台所有。本功能**仅供个人学习、技术研究、日常试听使用**，
|
|
105
|
+
> **严禁用于任何商业用途、公开传播、二次分发或盈利行为**。使用本功能即表示您已知悉并同意：
|
|
106
|
+
> 1. 您应对自己的使用行为及其后果负责；
|
|
107
|
+
> 2. 因使用非官方接口登录/播放导致的账号风控、封禁、限流，以及可能引发的法律、版权纠纷，均由使用者自行承担；
|
|
108
|
+
> 3. 本项目作者不承担任何因此产生的直接或间接责任。
|
|
109
|
+
> 如您不同意以上条款，请勿使用本功能。
|
|
110
|
+
|
|
111
|
+
- **登录**：两种扫码方式——**QQ 登录**或**微信登录**（推荐）。登录态保存在 Host 端（`~/.dsh/music-player-qq-cookie.json`），刷新/重启不丢；面板右上角可退出登录。
|
|
112
|
+
- **浏览**：6 个子页签——**我的歌单 / 推荐歌单 / 分类歌单 / 排行榜 / 新歌 / 搜索**。
|
|
113
|
+
- 我的歌单：登录后展示当前账号的歌单（卡片式）。
|
|
114
|
+
- 推荐歌单：热门推荐 12 条，底部「加载更多」可续载。
|
|
115
|
+
- 分类歌单：60+ 分类（默认折叠显示 8 个，可展开），每个分类的歌单支持「加载更多」。
|
|
116
|
+
- 排行榜：巅峰榜/地区榜/特色榜等分组，点榜单看歌曲（带榜单封面卡片）。
|
|
117
|
+
- 新歌：新歌速递（最新/内地/港台/欧美/韩国等）。
|
|
118
|
+
- 搜索：搜歌曲与歌单，带搜索历史（localStorage，最近 10 条）。
|
|
119
|
+
- **播放**：点击任意歌曲即可播放（同一播放条 + 频谱）；VIP 标识显示在歌名后，行尾显示歌手名。
|
|
120
|
+
- **收藏**：播放条爱心按钮把当前在线曲目收藏到 QQ 音乐「我喜欢」（dirId 201）；已收藏歌曲爱心实时点亮。
|
|
121
|
+
- **续播**：在线播放进度（当前曲目 + 队列）刷新后自动恢复，点 ▶ 续播。
|
|
122
|
+
- 在线曲目不占本地曲库的 500 首上限，与本地/讲书完全隔离。
|
|
123
|
+
|
|
98
124
|
## AI 讲书
|
|
99
125
|
|
|
100
126
|
把本地 `.txt` 小说交给 AI 朗读（复用 DSH 已配置的 xiaomi/MiMo TTS）。**AI 语音目前仅支持 xiaomi 提供方（限时免费），请在设置中配置好再使用此功能。**
|
|
@@ -121,7 +147,7 @@ dsh plugin --profile <profile> add ./dsh-music-player-0.1.0.tgz
|
|
|
121
147
|
|
|
122
148
|
```sh
|
|
123
149
|
npm install
|
|
124
|
-
npm test # 跑 vitest 测试套件（Host 单测 + Web 渲染冒烟，共
|
|
150
|
+
npm test # 跑 vitest 测试套件（Host 单测 + Web 渲染冒烟，共 120+ 用例）
|
|
125
151
|
```
|
|
126
152
|
|
|
127
153
|
修改 `lib/` 后，在本机 profile 里用 link 方式本地调试并验证：
|