前言¶
DeepSeek Harness (DSH) 和 DSH Desktop 支持插件化擴展。對於開發者或重度使用者而言，界面不僅是交互容器，也是工作流的一部分。在保持技術剋制的前提下，爲 DSH 添加一個具有沉浸感且不影響性能的動態背景，是提升使用體驗的有效手段。
dsh-particle-whale 是一個基於 Three.js 和 WebGL 的 3D 粒子鯨魚背景插件，由 zepeng-jin 維護。它解決了通用 UI 背景靜態、缺乏交互反饋的問題，提供了一種高幀率、可響應狀態的視覺增強方案。
核心功能¶
該插件在 dsh 框架的 web 平臺上運行，主要包含以下能力：
- 體積 3D 粒子網格
使用距離變換映射技術，將 DeepSeek 的 2D 矢量輪廓轉化爲 3D 棒狀體。粒子具有彎曲的背部/腹部厚度、表面法線、高光以及菲涅爾邊緣光效果。 - 頭朝前遊動
模擬真實的海洋生物運動，頭部引導航向，波浪沿脊柱向尾鰭傳播。在窗口切換時，鯨魚會平滑轉向。 - 響應式智能狀態
- 空閒狀態：鯨魚以 1.05 倍縮放和 1.1 倍速度在全屏巡航，尾鰭輕微擺動。
- 活躍狀態：當處於思考、流式輸出或工具執行階段時，鯨魚遊向右上角，縮小至 0.45 倍作爲迷你指示器，並伴隨高能生物發光脈衝。
- 新會話散開效果
僅在創建新會話（Cmd+N/Ctrl+N或點擊“新聊天”按鈕）時觸發星雲爆炸與重組動畫，普通點擊忽略，避免干擾閱讀。 - 毛玻璃合成器
爲聊天輸入卡片添加 88% 透明度的毛玻璃效果（backdrop-filter: blur(20px)），確保鯨魚在輸入框下方可見，同時保持文字對比度。 - 主題自適應
深色模式下使用銀青色發光粒子（加法混合）；淺色模式下使用高對比度的深藍寶石色粒子。 - 性能優化
通過pointer-events: none處理遮罩層，使用預計算抖動緩衝、實例化網格渲染和異步狀態輪詢，維持 60–120 FPS 的幀率。
安裝與啓用¶
安裝該插件需在 DSH Desktop 的 Web 配置目錄下操作。建議開發者使用符號鏈接進行本地開發與測試。
方式一：符號鏈接（推薦用於本地開發）¶
- 進入 DSH Desktop 的 Web 配置
node_modules目錄：
cd ~/Library/Application\ Support/dsh-desktop/harness/profiles/web/node_modules
- 建立項目符號鏈接：
ln -s /path/to/dsh-particle-whale dsh-particle-whale
- 在
~/Library/Application Support/dsh-desktop/harness/profiles/web/package.json中註冊插件：
{
"dependencies": {
"dsh-particle-whale": "*"
},
"dsh": {
"profile": {
"bundles": [
"dsh-particle-whale"
]
}
}
}
- 重啓或重新加載 DSH Desktop。
方式二：通過 npm 安裝¶
直接在 Web 配置目錄下執行安裝命令：
cd ~/Library/Application\ Support/dsh-desktop/harness/profiles/web
npm install dsh-particle-whale
典型用法¶
安裝完成後，插件會自動讀取 dsh 配置中的通用設置頁開關。在正常使用中：
- 默認巡航：鯨魚在屏幕中央偏下位置以正常遊動姿態出現。
- 交互反饋：當你開始提問或模型開始思考時，鯨魚會遊向右上角並縮小，此時它充當了一個狀態指示器。
- 新會話：點擊新建按鈕，鯨魚會炸裂成粒子並重組，提供明確的會話開始視覺提示。
適用場景與注意¶
- 平臺：Web 平臺。
- 性能：插件通過
pointer-events: none確保 UI 層不會阻擋鼠標事件，適合高負載場景。 - 依賴要求：安裝前需確保已滿足以下對等依賴：
react ^18.2.0@deepseek-ai/cordis ^4.0.1@deepseek-ai/dsh-client-runtime ^0.1.0-rc.6@deepseek-ai/dsh-client-locale ^0.1.0-rc.6@deepseek-ai/dsh-client-ui-slots ^0.1.0-rc.6
- 安全性：插件開源且遵循 MIT 許可證。安裝前建議查閱源碼以確認無惡意行爲。
總結¶
dsh-particle-whale 提供了一種輕量級、高性能的 3D 視覺增強方案，通過模擬海洋生物的遊動狀態和粒子特效，豐富了 DSH Desktop 的交互反饋層。
