前言¶
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/ 目錄下。
