前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，界面往往只有對話流本身：助手回覆以文字爲主，缺少一個常駐、可互動的視覺載體。若希望在不引入外部 3D 資源的前提下，給 Web 端掛一個與 DeepSeek 品牌氣質相近的伴侶，並在助手輸出時自動朗讀、附帶節奏反饋，就需要一個前後端一體的 DSH 插件。dsh-plugin-whale（Makesupper/dsh-plugin-whale）走的就是這條路線：基於 dsh-plugin 架構，在 Web 平臺注入客戶端 UI，監聽會話事件並驅動前端能力。
這是什麼¶
dsh-plugin-whale 是 Makesupper 維護的開源 DSH 插件（MIT License，當前 package 版本 0.1.0），分類爲趣味換裝。它提供程序化 3D「深度求索鯨魚娘」舞臺、對 LLM 助手回覆的即時 Web Speech 朗讀，以及朗讀期間可配置的電子木魚/清磬伴奏。插件入口爲 ./lib/index.js，並通過 cordis.patch.yml 與 DSH 客戶端槽位（@deepseek-ai/dsh-client-ui-slots）集成；dsh.client.immediately 爲 true，面向 Web 平臺加載。
社區目錄頁：https://www.skillhub.cn/plugins/Makesupper/dsh-plugin-whale（獨立社區站點，與 DeepSeek / 幻方無官方從屬關係）。源碼：https://github.com/Makesupper/dsh-plugin-whale。
核心功能¶
3D 鯨魚娘舞臺（WhaleStage3D）¶
內置零外部依賴的程序化 3D 模型，包含 3D 透視投影、呼吸起伏、雙馬尾鰭與鯨尾擺動、眨眼，以及隨語音變化的口型同步；另有伴奏迷你木魚與深海聲吶水波紋效果。同時預留外部 .glb / .gltf 掛載槽，可在不替換整套舞臺邏輯的情況下換模型。
LLM 回覆語音朗讀（完全替換模式）¶
監聽 DSH session/event 中的 assistant/message，自動清洗 Markdown 與代碼塊，按自然句切分後推入實時語音隊列，由前端 Web Speech API 朗讀。該模式在 README 中描述爲「完全替換模式」，即由插件接管助手消息的朗讀流程，而非僅做裝飾性提示音。
木魚伴奏與互動¶
當鯨魚娘開始朗讀 LLM 回覆時，按設定節拍自動敲擊電子木魚/清磬並積攢功德；朗讀結束後自動停止。默認節拍爲 1200ms；面板可在 600ms / 900ms / 1200ms / 1800ms 間切換。也支持手動點擊互動，以及常駐伴奏開關。
安裝與啓用¶
資料中未給出形如 dsh plugin add … 的固定 shell 安裝命令。SkillHub 目錄頁提供「發送給 DeepSeek Harness 安裝」指引，表述爲：請安裝 DSH 插件 Makesupper/dsh-plugin-whale（頁面正文在此處有進一步說明，安裝前建議在 Harness 中按社區指引完成插件拉取與啓用）。
安裝前請自行閱讀 GitHub 倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，會監聽會話事件並在瀏覽器側使用 Web Speech，啓用前確認環境與隱私策略可接受。
本地開發與自測時，可在克隆後的倉庫目錄執行構建與測試（見下文「構建與測試」），這與在 Harness 中安裝社區插件是兩條路徑，按需選擇。
典型用法¶
構建與測試¶
在插件源碼根目錄：
cd dsh-plugin-whale
npm test
pretest 會先執行 npm run build，再運行 node --test tests/whale.test.js。
切換外部 3D 模型¶
方式一：掛件設置面板
- 點擊掛件下方「⚙ 鯨魚設置」。
- 進入「🧊 3D模型」。
- 填入
.glb/.gltf模型地址並保存。
方式二：前端事件
window.dispatchEvent(new CustomEvent('dsh-whale:load-model', {
detail: { url: '/path/to/deepseek-whale.glb' }
}))
上述 url 需指向 Harness Web 端可訪問的模型路徑。
適用場景與注意¶
適合希望在 DSH Web 界面增加趣味換裝、可視化伴侶，並讓助手長回覆以語音形式呈現的場景。朗讀依賴瀏覽器 Web Speech API，不同瀏覽器與系統語音包差異會導致音色與可用性不一致；3D 與動畫在前端渲染，需注意頁面性能與窗口尺寸。
插件會處理 assistant/message 內容並觸發朗讀與木魚邏輯，請勿在不可信 Harness 環境中盲目安裝。星標與社區元數據以目錄頁爲準（當前 GitHub 星標爲 0）；版本以 package.json 爲準（0.1.0）。
結尾¶
dsh-plugin-whale 把 3D 伴侶、會話驅動的 TTS 與木魚節奏收進一個 DSH 插件包，適合作爲 Web 端 Harness 的輕量趣味增強。進一步說明與安裝入口見 SkillHub 目錄頁 https://www.skillhub.cn/plugins/Makesupper/dsh-plugin-whale ，實現細節與許可證見 https://github.com/Makesupper/dsh-plugin-whale 。
