前言¶
在 DeepSeek Harness(DSH)裏寫代碼、跑任務時,很多人會開瀏覽器另找音樂。DSH Web GUI 本身並不自帶「邊幹活邊聽 B 站」的界面;若把播放器做成又一個鋪滿按鈕的網頁標籤,也容易和手頭工作搶注意力。下面介紹的插件把檢索與播放收進側邊欄裏的一塊「唱機面板」:音頻在後臺繼續,面板可以關掉而不中斷。
這是什麼¶
dsh-plugin-vinyl-player(倉庫名 dsh-plugin-vinyl-player)由維護者 ChiaquanLin 發佈,在 SkillHub 目錄中歸類爲 趣味換裝。它不是文件列表式的音樂應用,而是一個畫出來的卡通黑膠唱機:搜索歌曲後結果變成唱片封套,拖上轉盤即可播放;音頻流來自 B 站,經宿主代理,不向磁盤寫入媒體文件。許可證爲 MIT(package.json 版本 1.0.0)。
核心功能¶
面板中心是 轉盤(deck),下方有兩層架子:
- record crate:最近一次搜索得到的封套;
- favourites shelf:收藏的唱片,刷新後仍保留。
交互以拖拽爲主:把封套拖到轉盤上播放;拖到收藏架則只收藏不播放。唱臂即傳輸控制——把唱臂拖到唱片上播放,拖回托架暫停;也可配合鍵盤。轉盤下方另有上一首、停止、重播、下一首與可拖動的進度條;灰色區表示已緩衝部分。
其餘已覈實能力包括:
- 關閉面板後音樂繼續播放,側邊欄入口仍顯示當前唱片;
- 界面爲矢量繪製(木櫃、黑膠、唱臂、轉速選擇與音量旋鈕等),無獨立設置頁或菜單;
- 隨應用語言切換 English / 簡體中文;
- 運行時流式播放,換曲即釋放,不向磁盤寫入音頻;
- 宿主側提供搜索、解析音軌列表、解析可播流、代理封面等接口;瀏覽器端不直接訪問 B 站。
開發與自檢方面,倉庫提供 Node 測試套件(README 記載 node tools/count-checks.mjs 等);Node 20+ 主要用於跑測試,日常使用僅需可用的 DSH Web GUI 配置檔及訪問 bilibili.com 的網絡路徑。
安裝與啓用¶
插件從 GitHub 倉庫分發,不依賴 registry 包名安裝。官方給出兩種路徑;dsh plugin 子命令之間 必須 帶上 --profile(與你在用的配置檔一致,例如桌面端用 desktop,dsh web 用 web)。
方式一:在 DSH 對話裏讓智能體安裝(推薦,無需終端)
安裝 https://github.com/ChiaquanLin/dsh-plugin-vinyl-player 插件
智能體會安裝 bundle 並重載面板,側邊欄會出現唱機入口。
方式二:使用 dsh CLI
dsh plugin --profile desktop add github:ChiaquanLin/dsh-plugin-vinyl-player
將 desktop 換成你實際使用的 profile。添加依賴同時會註冊 bundle,無需單獨 enable。查看或移除:
dsh plugin --profile desktop list
dsh plugin --profile desktop remove dsh-plugin-vinyl-player
安裝後 重載 Web GUI,側邊欄會出現 黑膠唱片機 / Vinyl player 條目。裝入某一 profile 後對該 profile 下所有會話生效,重啓後插件仍在。
典型用法¶
README 中的對照表可直接復現日常操作:
| 操作 | 結果 |
|---|---|
| 在搜索框輸入並搜索 | crate 裏出現唱片封套 |
| 點擊某一封套 | 播放 |
| 把封套拖到轉盤 | 播放 |
| 把封套拖到 favourites 架 | 收藏,不自動播放 |
| 把唱臂拖到唱片上 | 播放 |
| 把唱臂拖回托架 | 暫停 |
| 拖動進度條 | seek |
| 點擊封套上的心形 | 收藏或取消收藏 |
懸停封套會有輕微放大效果;側邊欄與面板通過客戶端 store 保持狀態一致。
適用場景與注意¶
適合希望在 DSH Web GUI 同一套界面 裏聽 B 站音頻、又不想多開一個「播放器標籤頁」的開發者;側欄卡通唱機也符合「趣味換裝」類插件的視覺取向。
使用前請注意:
- 權限與信任:插件隨當前 DSH 進程運行,安裝前建議閱讀倉庫源碼與 MIT 許可證;宿主會代你向 B 站發起匿名訪客 cookie、簽名請求並代理音視頻,行爲範圍以
index.js等爲準。 - 合規:項目爲 非官方 實現,與 B 站無隸屬或背書關係;不繞過付費牆、DRM 或訪問控制,不承擔站內媒體版權。使用前請閱讀倉庫 LEGAL.md,並遵守 B 站服務條款與你所在法域的版權規定,僅限個人合法收聽。
- 網絡:需要能訪問
bilibili.com;音頻經宿主代理以支持 range 請求,README 稱不在宿主側緩存媒體。 - 生態:DSH 推崇「一切皆插件」;SkillHub 等爲社區目錄站點,與 DeepSeek、幻方無官方從屬關係,本文所述安裝方式以倉庫 README 爲準。
結尾¶
dsh-plugin-vinyl-player 把 B 站音頻檢索與播放收進一塊可關閉的卡通唱機面板,拖拽唱臂即可 transport,收藏架與側邊欄狀態在幹活時仍可繼續聽。目錄頁與源碼分別見:
- SkillHub:https://www.skillhub.cn/plugins/ChiaquanLin/dsh-plugin-vinyl-player
- GitHub:https://github.com/ChiaquanLin/dsh-plugin-vinyl-player