DeepSeek Harness 提供了 AI 工作環境，但界面風格通常與本地操作系統（macOS 或 Windows）存在差異，這可能影響沉浸感。dsh-cyberwhale 插件通過雙端視覺本地化，讓軟件的設置界面更貼近系統原生樣式，並提供主題、壁紙與字體設置，以及可選的藍鯨桌寵。
該插件由 CyberWei922 維護，採用 MIT 許可證。它主要解決視覺統一性問題，提供主題、壁紙、字體設置以及可選的藍鯨桌寵。
核心功能¶
雙端界面本地化¶
插件會自動識別客戶端系統，使用對應的設置界面樣式：
* macOS 風格：模擬系統設置界面的圓角分組、磨砂側欄、小型開關與隨分區變化的標題。
* Windows 風格：模擬 WinUI 3 界面，包含導航指示條、設置卡片、圓形開關滑塊與 Mica 風格底色層次。
主題與配色¶
- 主題選項：提供 27 個淺深色主題選項（淺色 10 個、深色 17 個），涵蓋 Catppuccin、Nord、Tokyo Night 等流行配色。
- 自定義配色：分別調整淺色和深色模式的強調色、背景色與文字色，自動派生界面顏色。
- 背景設置：支持純色、漸變或圖片背景，可調整佈局、遮罩與模糊度。
- 壁紙取色：支持從上傳的壁紙中提取主色，生成配套的淺色與深色方案。
字體與閱讀¶
- 字體設置：讀取本機字體，分別選擇界面字體和代碼字體。
- 閱讀設置：支持輸入框磨砂，或減少透明效果以提升對比度。
藍鯨桌寵¶
- 獨立運行：外觀美化與桌寵功能可分別控制。
- 交互功能：支持拖動、右鍵打招呼、眼睛跟隨鼠標（待機時）。
- 狀態反饋：隨任務切換動作，顯示進度氣泡。
安裝與啓用¶
在安裝前，請確保已安裝並啓動過 DeepSeek Harness 官方 Desktop。
界面安裝¶
- 打開 Harness，進入側欄的 插件 選項。
- 點擊 添加插件，填入插件名稱
dsh-cyberwhale或倉庫地址。 - 安裝完成後點擊 啓用。
命令行安裝（本地開發）¶
如果需要本地開發或調試，可以通過命令行安裝：
git clone https://github.com/CyberWei922/dsh-cyberwhale.git
cd dsh-cyberwhale
npm ci
npm run build:client
安裝完成後，在 Harness 中添加指向該目錄的插件即可。
典型用法¶
啓用插件後，通過設置頁面進行配置：
- 外觀美化：進入 設置 → 主題，開啓“啓用外觀美化”。選擇淺色、深色或跟隨系統，並從預設主題中選擇一個，或自定義配色與背景。
- 桌寵設置：進入 設置 → 桌寵，開啓桌寵功能。此時桌寵窗口將出現，支持拖動位置和調整大小。
- 氣泡提示：在桌寵設置中開啓“氣泡提示”，藍鯨會在任務切換時顯示進度信息。
適用場景與注意事項¶
- 適用場景：希望 DeepSeek Harness 界面更符合個人系統習慣的開發者與用戶。
- 運行環境：基於 Harness Desktop 0.2.0-rc.2 驗證。在 macOS 26+ 上，桌寵氣泡支持原生的 Liquid Glass 效果。
- 資源佔用：桌寵功能需要額外的獨立 Electron 運行時（約 100–150 MB），僅使用外觀美化時可關閉桌寵以節省資源。
- 配置保存：主題配置與壁紙保存在本地。macOS 路徑爲
~/.dsh/dsh-cyberwhale/，Windows 路徑爲%USERPROFILE%\.dsh\dsh-cyberwhale\。
該插件通過本地化設計，讓 DeepSeek Harness 更好地融入桌面環境，提升使用體驗。
