DeepSeek Harness (DSH) 強調“一切皆插件”的架構，允許用戶根據需求定製開發環境。在 DSH Web 界面中，模型推理時的狀態通常僅顯示 “Deep diving…” 等文字。爲了在等待過程中提供更生動的視覺反饋，dsh-pixel-whale 插件應運而生。
插件定位¶
dsh-pixel-whale 是一個 Web 專用插件，由開發者 yoke233 維護。它爲 DSH Web 添加了一個緊湊的、動畫化的點雲鯨魚，該鯨魚出現在 “Deep diving…” 狀態之前。它不會改變提示、工具或模型請求，僅對界面進行視覺增強。
核心功能¶
- 視覺呈現：在 “Deep diving…” 狀態前渲染一個 36x26px 的動畫點雲鯨魚。
- 狀態跟隨：鯨魚會跟隨狀態，在 UI 重新掛載時保持顯示，在輪次結束時消失。
- 運動特性：採用平靜的運動風格，像素顏色穩定，包含受控的呼吸效果和身體擺動。
- 可訪問性：遵循
prefers-reduced-motion系統設置，爲需要減少動畫的用戶提供支持。 - 作用範圍：僅限 Web 平臺，不修改任何提示詞、工具調用或模型請求。
安裝與啓用¶
安裝過程非常直接，只需一條命令：
dsh plugin --profile web add github:yoke233/dsh-pixel-whale
安裝完成後，需要重啓 DSH Web。在運行對話輪次時，鯨魚會自動出現在 “Deep diving…” 之前。安裝過程中可能會出現關於 DSH 和 React 的 peer-dependency 警告，這是正常的，因爲 DSH Web 會提供這些運行時依賴。
實現機制¶
由於 DSH 目前未在私有輪次狀態組件中暴露公共 Slot，該插件通過一個特定的 DOM 適配器實現。它使用 MutationObserver 跟蹤當前對話的狀態行，並利用 React Portal 將鯨魚組件注入到指定位置。這種設計確保了鯨魚僅作爲視覺元素存在，不寫入會話數據，也不替換狀態文本。
注意事項¶
- 平臺限制：此插件目前僅支持 DSH Web。
- 依賴警告：安裝時出現的 peer-dependency 警告是預期的，不影響使用。
- 安全性：在安裝前，建議檢查源代碼和許可證（MIT）。
總結¶
dsh-pixel-whale 提供了一種低侵入性的方式來增強 DSH Web 的交互體驗。如果你正在尋找一種穩定、平靜的像素動畫來替代枯燥的文字狀態提示，可以參考其 GitHub 倉庫 或 插件目錄 進行了解。
