前言¶
DeepSeek Harness（DSH）把對話殼、擴展點和插件打包在一起，開發者可以在官方 UI 插槽里加視覺層，而不必 fork 整套前端。若你希望在寫提示、跑智能體的同時，用系統正在播放的音樂驅動界面律動，並在輸入框附近顯示同步歌詞，單獨寫瀏覽器腳本或改主題往往對不上 SMTC 進度和真實音頻。下面介紹社區插件 摸鯨魚（dsh-plugin-moyu，維護者 TYWIM），它面向 DSH 提供 Windows 下的音樂律動與歌詞顯示；小說閱讀、可獨立配置的多功能模式在 README 中標註爲規劃中、尚未實現。
這是什麼¶
摸鯨魚 是面向 DeepSeek Harness 的摸魚工具箱（目錄分類：趣味換裝）。當前已實現的能力集中在 Windows：宿主側通過常駐 PowerShell 媒體橋採集 SMTC「正在播放」信息、WASAPI 系統迴環音頻與 48 頻段 FFT，解析歌詞後經本機 GET /moyu/stream（SSE）推給瀏覽器；瀏覽器側在 DSH 官方插槽裏渲染，不替換 DSH 自帶 UI。非 Windows 平臺（process.platform !== 'win32'）插件保持休眠，不啓動媒體橋。
插件版本爲 0.1.0（package.json），要求 DSH >=0.2.1-rc.2、Node ^22.19.0 || >=24.0.0，許可證 MIT。GitHub 倉庫：TYWIM/dsh-plugin-moyu；社區目錄頁：SkillHub · dsh-plugin-moyu（獨立社區站點，與 DeepSeek / 幻方無官方從屬關係）。
顯示位置與兩種模式¶
全部 UI 走官方插槽，便於與 DSH 佈局共存：
| 內容 | 插槽 |
|---|---|
| 火焰 / 頻譜律動 + 頂部歌詞 | conversation.input.dock |
| 摸鯨模式底部歌詞條 | conversation.composer.dock |
| 鯨魚按鈕（設置面板） | conversation.input.right |
| 標題旁歌詞膠囊 | conversation.session.header.actions |
| 左右側邊歌詞 | shell.overlay |
正常模式：輸入框正上方一條柔和極光帶（由 48 頻段真實迴環頻譜驅動），可切換「頻譜」細條或「兩者」；歌詞默認疊在光帶上方。律動強度可選 平緩（頻段分組、較慢回落）或 動感（默認，直接使用 48 頻段）；連續插值可減輕跳動，但會帶來一定延遲。效果由音頻驅動，並非自動節拍識別。
摸鯨模式：律動完全隱藏，歌詞縮到輸入框下方狀態欄；滾輪在「信息 / 歌詞」之間切換；標題膠囊與側邊歌詞同時收起。
歌詞與配色¶
歌詞來源：本地 .lrc（按歌名/歌手匹配）、網易雲、LRCLIB。歌名和歌手來自 SMTC；聯網時會向相關服務發送歌名和歌手，結果（含歌詞）緩存在 $DSH_HOME/dsh-plugin-moyu/cache。切換來源或關閉聯網不會自動清除舊緩存，使用前請自行評估隱私與歌詞版權。
設置面板中可配置歌詞位置（頂部 / 左側 / 右側 / 標題旁 / 底部條）、開關、字號 9~24 px、顏色（跟隨主題或自選）。配色支持 RGB 流轉 或 色標（默認，1~8 色漸變，含 8 套預設）。偏好保存在瀏覽器 localStorage（鍵名 dsh-plugin-moyu:prefs:v4）。
宿主配置¶
在 cordis.patch.yml 的 config 中可調整媒體橋與歌詞策略：
- id: moyu
config:
lyricsDirs: ['D:/Music/lyrics'] # 本地 .lrc 目錄，按「歌名/歌手」匹配
onlineLyrics: true # 允許請求網易雲 / LRCLIB；會發送歌名和歌手
sourceOrder: auto # auto | local | online
intervalMs: 100 # 媒體橋採樣間隔（毫秒）
auto 模式下即使找到本地歌詞，也可能仍請求網易雲。面板裏還可調「歌詞偏移」，用於部分不更新 SMTC Position 的播放器（README 舉例汽水音樂）導致的長時進度外推誤差。
安裝與啓用¶
DSH 生態強調「一切皆插件」；本插件在 SkillHub 目錄頁提供「發送給 DeepSeek Harness 安裝」說明，插件標識爲 TYWIM/dsh-plugin-moyu，按該頁原文複製給 DSH 或按你環境中的插件安裝流程操作即可。資料中未給出獨立的 shell 安裝命令，請勿自行拼接未在文檔出現的 CLI。插件以當前 DSH 進程權限運行，安裝前應閱讀 GitHub 源碼 與 MIT 許可證。
典型用法¶
- 在 Windows 上安裝並啓用插件，確認本機 DSH 版本滿足
>=0.2.1-rc.2。 - 用系統默認支持 SMTC 的播放器播放音樂；必要時在
lyricsDirs放置本地 LRC，或開啓onlineLyrics並設置sourceOrder。 - 點擊輸入框右側 鯨魚按鈕 打開設置：選擇正常 / 摸鯨模式、律動樣式與強度、歌詞位置與配色。
- 摸鯨模式下在輸入框下方歌詞條上用滾輪切換「信息 ⇄ 歌詞」。
經過上面的步驟，對話界面會在官方插槽中顯示律動與歌詞，而不接管 DSH 核心 UI。
適用場景與已知限制¶
適合在 Windows 上長時間使用 DSH、並希望用真實系統音頻做輕量視覺反饋、同時本機查看歌詞的開發者。不適合需要 macOS / Linux 媒體橋、或依賴精確節拍檢測的場景。
README 列出的限制包括：僅 Windows 啓動媒體橋；WASAPI 迴環與 FFT 加平滑會帶來延遲；歌詞僅供本機顯示，勿批量抓取或再分發。若播放器長時間不更新 SMTC 進度且循環播放，歌詞可能對不齊，需用面板偏移修正。
結尾¶
摸鯨魚把 Windows 媒體橋、歌詞解析與 DSH 官方插槽接在一起，在當前版本里專注音樂律動與歌詞展示；後續規劃中的小說閱讀等功能以倉庫 README 更新爲準。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
