前言¶
DSH 的理念是「一切皆插件」。對已經使用 dsh Web UI 的開發者來說，外觀定製最好以插件形式提供：可安裝、可卸載，並儘量減少對宿主界面的長期影響。
下面介紹 dsh-skin-blue-whale。它是爲 dsh Web UI 打造的藍鯨躍海主題插件，提供官網同款藍白漸變背景、官方藍鯨 logo 動畫、主頁/會話雙場景自適應，以及整套藍鯨配色界面令牌。DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-skin-blue-whale 是一個 dsh Web UI 皮膚插件，維護者爲 zenghuizhu69-hub，許可證爲 MIT。
它解決的是 dsh Web UI 的主題化問題：在界面中疊加一層藍鯨躍海視覺，同時保留主頁空會話和對話/思考中兩種場景下的可用性。
核心功能¶
下面介紹該插件已覈實的主要能力：
- 淺色模式復刻 DeepSeek 官網 Hero 區藍白漸變，深色模式自動適配爲夜海幽光版。
- 使用 DeepSeek 官方鯨魚 logo 路徑繪製鯨魚，幷包含水花飛濺、漣漪擴散、氣泡上升效果。
- 主頁空會話場景下，鯨魚以輸入框爲海平面躍出，並在輸入框頂邊顯示發光水線。
- 對話或思考中場景下，鯨魚變爲整頁居中的底層水印，約 10% 透明度，不佔據左側邊欄。
- 將按鈕、焦點環、選區、聊天氣泡、側欄、滾動條統一覆蓋爲 DeepSeek 藍鯨藍令牌。
- 尊重系統
prefers-reduced-motion偏好，用戶偏好減少動效時關閉動畫。 - 卸載插件時，令牌層、DOM、樣式、監聽器自動還原，無殘留。
安裝與啓用¶
前置要求爲：
Node 20+
pnpm
dsh 0.1.0-rc.6+
請將倉庫克隆到不含空格的路徑。當前 dsh CLI 在路徑含空格時，轉發給 pnpm 的絕對路徑不會加引號，會導致安裝失敗。
下面執行安裝命令：
git clone https://github.com/zenghuizhu69-hub/dsh-skin-blue-whale.git
cd dsh-skin-blue-whale
dsh plugin --profile web add .
經過上面的步驟，dsh plugin 會將本包以 link: 方式掛進 profile。因此克隆目錄請勿移動；如果移動了目錄，需要重新執行：
dsh plugin --profile web add .
安裝後重啓 Web 服務即可生效：
dsh web
典型用法¶
安裝並重啓 dsh web 後，插件會在 Web UI 中生效。
如果修改插件源碼，需要再次重啓 dsh web 纔會加載新版本：
dsh web
卸載時使用下面命令：
dsh plugin --profile web remove dsh-skin-blue-whale
卸載後重啓 Web 服務，可還原基礎樣式：
dsh web
適用場景與注意¶
適合希望給 dsh Web UI 增加藍鯨躍海主題，並保留可卸載、可還原能力的用戶。安裝前請檢查插件源碼與 MIT 許可證；插件以當前 dsh 進程權限運行，應將其視爲普通第三方插件包使用。
使用時注意以下幾點：
- 克隆目錄請勿移動。
- 請將倉庫克隆到不含空格的路徑。
- 移動目錄後，需要重新執行
dsh plugin --profile web add .。 - 修改插件源碼後，需要重啓
dsh web。 - 卸載後需要重啓 Web 服務以還原基礎樣式。
鏈接¶
- GitHub：https://github.com/zenghuizhu69-hub/dsh-skin-blue-whale
- 社區目錄頁：本資料未確認具體 URL，以 DSH 插件社區目錄實際發佈爲準。
