前言¶
DeepSeek Harness (DSH) 的 Web 界面可以通过插件进行功能扩展。dsh-blue-sea-player 是一个常驻的鲸鱼娘音乐播放器挂件。它会在打开 DSH 页面时自动出现，不干扰主界面，但提供了完整的播放功能与视觉定制选项。
核心功能¶
该插件主要提供以下能力：
- 自动常驻：每次打开 DSH Web 页面，播放器会自动注入显示。
- 可随意拖动：支持在屏幕上拖拽改变位置，位置会被记录（保存在 localStorage 中）。
- CD 机与律动线：播放时，圆形 CD 封面会随之旋转（封面自动裁剪为 1:1）。下方显示居中滚动的歌名（过长走马灯）以及白色的 5 节律动线（每节节奏独立不同步）。
- 播放控制：提供单曲循环、列表循环、随机三种播放模式。支持进度条拖动、音量调节、上一首/下一首。
- 播放列表：点击列表中的曲目即可播放，当前曲目会有金色高亮显示。
- 收纳与隐藏：右上角提供“收纳”和“隐藏”按钮。收纳可将面板收起为条带；“隐藏”则收成鲸鱼娘头像小球，小球可拖动并点击还原。
- 资产管理：支持新增歌曲（自动填名）、批量删除、卡片菜单（修改/删除需二次确认）、以及封面处理。
- 皮肤管理：内置 12 套皮肤，支持一键切换与皮肤轮播（多选皮肤设置间隔后自动轮播）。
安装与启用¶
安装前请准备好插件的目录路径。
dsh plugin --profile web add link:<本目录绝对路径>
安装完成后，重启 dsh web 并刷新页面，播放器将自动出现在界面中。
典型用法¶
- 播放音乐：点击播放列表中的任意一首曲目开始播放。播放时 CD 旋转，律动线舞动。
- 移动位置：按住播放器面板的空白处（按钮、列表或滑杆除外）进行拖动。
- 收纳面板：点击右上角的“收纳”按钮，面板会收起为顶部条带。拖动条带至左右边缘，它会自动吸附成小球。
- 管理资源：进入
⚙ 设置→资产管理，点击+新增。选择封面图（可选）和音乐文件（mp3/wav/ogg/m4a），保存即可。 - 更换皮肤：进入
⚙ 设置→皮肤管理，点击任意一套皮肤即可立即切换并生效。
版权与署名¶
插件代码遵循 MIT 许可证。素材为衍生创作，遵循 CC BY-NC-SA 4.0 许可证（禁止商用，须保留完整署名链）。
鲸鱼娘形象来源 bilibili @上善无形 @ZipZipPipe（署名保留，勿删除）。完整署名链与许可详见 NOTICE 文件。
数据存储¶
您的歌曲资产数据保存在 <DSH_HOME>/dsh-blue-sea-player/ 目录下。
