dsh-music-player 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kendu76
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# dsh-music-player
+
+DeepSeek Harness 本地音乐库播放器插件（bundle）。
+
+在 Host 进程里扫描本地音乐目录（默认 `~/Music`，可在面板里改），以 HTTP 流式（支持 Range/拖进度）给浏览器提供音频；浏览器侧给聊天输入区注入**正在播放条**，并提供一个浮动的**播放面板**（曲目列表 / 循环模式 / 音量 / 实时频谱 / 音乐目录设置）。同时注册 `music_play` 模型工具，让 agent 可以直接按关键词播放本地音乐。
+
+## 特性
+
+- 本地音频流式播放，支持 seek / 断点续播
+- 顺序播放、单曲循环、乱序播放三种模式
+- 实时 7 段频谱可视化（解码音频包络驱动）
+- `music_play` 模型工具：agent 可按关键词让浏览器播放
+- 支持的格式：`mp3 / m4a / m4b / aac / flac / wav / ogg / opus / webm / aiff`（自动递归扫描子目录，上限 500 首）
+
+## 安装
+
+需要已安装 `dsh` CLI。
+
+直接从一个 git 托管安装（推荐，无构建步骤）：
+
+```sh
+# 安装到你的 profile（把 <profile> 换成实际 profile 名，如 web）
+dsh plugin --profile <profile> add github:kendu76/dsh-music-player
+```
+
+> 项目是手写的纯 JS（`lib/` 直接是发布产物），**没有**需要从源码构建的步骤，因此从 GitHub 直装即可使用，无需像 TypeScript 包那样为构建脚本授权。
+
+安装后重启 DSH，打开 Web GUI：
+- 聊天输入区下方会出现「本地音乐播放器」播放条
+- 点击右侧「列表」按钮打开播放面板
+- 在面板顶部点击「选择音乐目录」并选定音乐目录（默认 `~/Music`），自动递归扫描
+- 之后可直接在对话框里让 agent 播放，例如「播放周杰伦的歌」
+
+### 从本地目录 / tarball 安装
+
+```sh
+# 本地目录
+dsh plugin --profile <profile> add /path/to/dsh-music-player
+
+# 或先打包再安装
+pnpm pack
+dsh plugin --profile <profile> add ./dsh-music-player-0.1.0.tgz
+```
+
+## 配置
+
+插件为「Host 端 + Web 端」双面结构：
+
+- Host 端（`lib/index.js`）：音乐扫描、HTTP 流式、`music_play` 工具
+- Web 端（`lib/client.js`）：浏览器里的播放条 / 播放面板 / 频谱
+
+两者由一个 `cordis.patch.yml` 插入 `music-player` 行并自动组对（在 Web 端 `dsh.client` 声明即指回该行名并加载浏览器半体）：
+
+```yaml
+- insert:
+    - id: music-player
+      name: 'dsh-music-player'
+```
+
+播放模式与音量保存在浏览器 `localStorage`，当前曲目与进度也会在刷新后恢复（浏览器的自动播放可能被拦截，点一次 ▶ 即可解锁）。
+
+## 开发
+
+```sh
+# 修改 lib/ 后，在本机 profile 里用 link 方式本地调试
+dsh plugin --profile <profile> add ./   # 或直接改 profile 里的 link 目标
+```
+
+## License
+
+[MIT](LICENSE) © kendu76

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-music-player bundle patch: inserts the dual-face plugin row into the web
+# profile roster. The node half (exports ".") runs in the host process (audio
+# streaming, music-library scan, and the music_play model tool), and the
+# dsh.client declaration in package.json loads the browser half (exports
+# "./client") in the web GUI.
+- insert:
+    - id: music-player
+      name: 'dsh-music-player'