前言¶
DSH 插件生態強調「一切皆插件」。對本地運行 DeepSeek Harness Web GUI 的人來說，換皮膚常會碰到兩個問題：一是隻想改外觀，不想碰源碼；二是手工改過 dist 後，升級或回滾都不方便。dataizu/dsh-whale-aqua-theme 把這個主題做成 DSH 插件包，同時保留傳統 dist 補丁安裝方式。它主要提供三樣東西：macOS 風格皮膚、水中鯨魚動態背景、點陣鯨魚發送按鈕。
這是什麼¶
dataizu/dsh-whale-aqua-theme 是一個用於 DeepSeek Harness Web GUI 的外觀主題包。它不改服務邏輯，不改源碼，重點在 Web 前端樣式和動畫。倉庫提供 MIT License 的樣式與腳本，同時說明 DeepSeek 鯨魚圖形爲 DeepSeek 官方資產，版權歸 DeepSeek 所有；該倉庫僅用於個人主題美化，請勿商用。
核心功能¶
- 水中鯨魚背景：爲 Web 界面提供動態水底效果。
- 點陣鯨魚發送按鈕：發送按鈕使用點陣鯨魚圖形，運行時可帶動畫。
- 蘋果風皮膚：提供 macOS 風格界面樣式。
- 低開銷動畫：性能參數爲
DPR 1.25、24fps，失焦或隱藏時自動暫停，按鈕動畫按需繪製。 - DSH 插件包安裝：可作爲插件包隨 profile 安裝、停用、卸載。
- 插件生命週期管理：插件方式下，停止插件即可完全回收副作用。
- 傳統
dist補丁安裝：也可把樣式文件複製到 Web 前端目錄，並拼接到index.html。
安裝與啓用¶
插件方式安裝¶
插件方式安裝不改動任何 dist 文件，DSH 升級不受影響。執行下面命令，從 GitHub 倉庫地址安裝該插件包：
dsh plugin --profile web add https://github.com/dataizu/dsh-whale-aqua-theme
安裝完成後重啓 DSH 生效。
停用¶
停用插件時，刪除 profile 配置中該主題對應的 insert 行。對應標識爲：
id: dsh-whale-aqua
配置文件爲 cordis.patch.yml。如果你當前環境中有可用的插件市場入口，也可以按市場中的卸載或移除操作處理；本文不把市場入口作爲確定前提。
AI 輔助部署¶
如果不想手工修改文件，可以把倉庫 README 中的 AI 部署提示詞原樣複製給 AI，讓它自動完成定位、備份、複製和拼接。執行後仍需硬刷新頁面查看效果，並檢查皮膚是否生效。
傳統 dist 補丁安裝¶
如果不想引入插件系統，可以使用傳統 dist 補丁方式。先找到目標機器自己的 DSH Web 前端目錄，目錄中應包含：
index.html
然後把主題樣式文件複製到該 dist 目錄：
apple-style.css
whale-icon.css
接下來打開該目錄下的 index.html，做兩處修改。第一處在 <head> 中加入樣式引用：
<link rel="stylesheet" href="/whale-icon.css" />
<link rel="stylesheet" href="/apple-style.css" />
第二處把背景動畫腳本插入到 </body> 之前。倉庫中的腳本片段位於：
install/background-snippet.html
需要把其中的 <script>...</script> 塊複製到目標 index.html。
完成後硬刷新頁面：
Ctrl+Shift+R
注意：這裏只能使用目標機器自己的 index.html，不要用倉庫中的整頁文件直接覆蓋不同版本構建。
same-version 整頁覆蓋¶
倉庫提供 same-version/index.html，它只適用於與開發版本相同的 DSH 構建。如果把它覆蓋到不同版本的 DSH，會導致界面無法加載，因此默認不推薦。
版本兼容¶
這個主題分兩部分，兼容性不同。
- 背景動畫 + 發送按鈕鯨魚：README 標註爲任意 DSH 版本可用，主要依賴穩定 DOM 特徵。
apple-style.css：依賴編譯後的 CSS 類名。不同 DSH 版本的類名哈希可能不同，皮膚可能部分或全部不生效。
如果皮膚未生效，按下面步驟處理：
1、在頁面按 F12 打開檢查器；
2、查看目標元素的實際類名；
3、替換 apple-style.css 中對應的哈希前綴，保持穩定的類名後綴不變。
適用場景與注意¶
- 適合本地運行 DSH Web GUI，並且只希望做界面美化的場景。
- 插件方式安裝不改動任何
dist文件，DSH 升級不受影響；停止插件即完全回收副作用。 - DSH 插件以當前
dsh進程權限運行，安裝前應檢查源碼、依賴和許可證。 - 樣式與腳本爲 MIT License；DeepSeek 鯨魚圖形版權歸 DeepSeek 所有，本倉庫僅用於個人主題美化，請勿商用。
鏈接¶
GitHub 倉庫：
https://github.com/dataizu/dsh-whale-aqua-theme
插件目錄頁（來自插件線索，訪問前請覈對）：
https://www.skillhub.cn/plugins/dataizu/dsh-whale-aqua-theme
