前言¶
DeepSeek Harness（DSH）基於插件架構運行。whale-desktop-kit 是一套由 z-time-007 維護的自用增強插件與原生桌面應用，旨在將 DSH 轉化爲一個具備桌面軟件特性的工作環境。
核心功能¶
該插件集提供以下核心能力：
* 桌面體驗：支持本地壁紙導入、透明度調節、玻璃質感與模糊效果，提供頂部快捷欄（dock）與黑鯨魚桌寵。
* 數據源：提供 DeepSeek 餘額與當前會話的 Token 用量數據接口。
* 文檔處理：支持 Word、PowerPoint、Excel 文檔的安全讀取。
* 個人助理：提供本地祕書功能（清單、便籤、摘要）及文檔生成工具。
* 安全策略：對只讀類工具調用提供安全自動批准，減少打斷。
* 原生應用：構建爲原生 Electron 桌面應用，支持系統托盤與貼邊隱藏。
安裝與配置¶
安裝前需確保環境已安裝 Node.js（≥ 22）、pnpm 和 git。
一鍵安裝：
執行以下命令即可完成依賴安裝、插件打包、安全掃描及原生應用構建。
git clone https://github.com/z-time-007/whale-desktop-kit.git
cd whale-desktop-kit
powershell -ExecutionPolicy Bypass -File install.ps1
前置依賴：
* 壁紙功能需要安裝 sharp 圖像庫。
* 個人助理功能需要配置固定工作區（workspaceRoot）或設置環境變量 DSH_ASSISTANT_WORKSPACE。
使用方法¶
安裝完成後，可通過以下方式使用：
- 啓動應用：雙擊桌面快捷方式
DeepSeekHarness.exe啓動，應用會自動檢查並啓動本地 DSH 後端。 - 更換壁紙：進入設置 -> 壁紙，選擇「從本地導入壁紙」或從收件箱掃描；拖動滑塊調整模糊、玻璃質感或透明度。
- 調整透明度：在設置 -> 壁紙中，拖動「對話框不透明度」和「工作區不透明度」滑塊（0 = 完全透明，100 = 完全不透明）。
- 桌寵交互：點擊頂部 dock 的鯨魚圖標打開桌寵；拖動鯨魚到桌面任意位置；點擊鯨魚查看餘額與 Token 數據；右鍵菜單可刷新或關閉。
- 快捷欄：鼠標移動到屏幕頂部喚起 dock，點擊圖標切換側邊欄、詳情欄或壁紙開關。
- 系統托盤：右鍵系統托盤的鯨魚圖標，可控制顯示/隱藏、設置開機自啓或退出。
注意事項¶
- 兼容性：適配 DeepSeek Harness 0.1.0-rc.6。
- 授權範圍：代碼遵循 MIT 協議，但 DeepSeek 鯨魚 Logo 不在授權範圍內，不可用於商業用途。
- 構建路徑：原生桌面應用構建需在
desktop/目錄下運行 Build 腳本，產物位於desktop\dist\DeepSeekHarness\DeepSeekHarness.exe。
