前言¶
DeepSeek Harness（DSH）是面向智能體開發者的可視化編排工具。默認界面通常較爲樸素，開發者希望在不改變 DSH 核心邏輯的前提下，通過皮膚定製界面樣式。現有方案要麼零散打補丁，要麼不支持多主題切換。鯨魚娘皮膚通過統一調色板與皮膚管理器協議，將視覺改造模塊化。
是什麼¶
鯨魚娘是 DSH Web GUI 的主題皮膚，由維護者 zhenhua520 接入 skin-manager 生態。它基於 DreamSkin 的鯨魚娘皮膚包，由 ZHOUcourier 首次移植到 DSH，本倉庫將其重製爲可被皮膚管理器發現、切換、調參的獨立皮膚包，並補齊了深色外觀。
插件提供完整的令牌重映射、淺色/深色/跟隨系統三態、對話區壁紙收斂、以及 7 項實時可調參數。
核心功能¶
統一調色板¶
174 個 --dsw-* 令牌全部由統一調色板推導，包括表面、文字、邊框、按鈕、代碼塊、滾動條、狀態色等。不是零散打補丁，而是從調色板生成的視覺一致性。
三態外觀¶
通過 theme.overrideTokens() 一次提交 { light, dark } 兩套調色板，由 presenter 按當前外觀自行選取。皮膚不改寫你的外觀偏好，你在「設置 → 通用 → 外觀」裏選淺色、深色或跟隨系統，皮膚會自動對應。
對話區壁紙¶
壁紙只鋪在對話列，作爲 background-image。側欄、插件頁、設置頁保持自身的實底，不會出現壁紙跑到別處的情況。
皮膚管理器接入¶
提供 skin.json 與 customization 協議 v2，可與「深海女僕工坊」「虎鯨鏈路」等皮膚互斥切換。啓動時由管理器兜底。需要在「設置 → 皮膚管理」裏選擇「鯨魚娘」。
7 項實時參數¶
在「設置 → 皮膚管理」裏拖動即時生效，無需刷新。按 skinId 保存在瀏覽器 localStorage。
| 參數 | 範圍 | 默認 | 說明 |
|---|---|---|---|
| 主框背景模糊 | 0–24px | 4px | 應用主框毛玻璃的半徑；0 = 完全關閉 |
| 表面透明度 | 0–100% | 45% | 0 = 面板全不透明，100 = 原版半透設計 |
| 用戶氣泡透明度 | 0–100% | 70% | 用戶消息氣泡的透出程度 |
| 壁紙遮罩濃度 | 0–100% | 58% | 蓋在插畫上的紙色薄紗強度 |
| 顯示環境壁紙 | 開/關 | 開 | 關閉後回到純淨紙面 |
| 壁紙模糊 | 0–16px | 0px | 插畫本身的銳度（不影響文字） |
| 輸入框聚焦光暈 | 開/關 | 開 | DreamSkin 原版的咖啡色聚焦描邊 |
壁紙模糊控制插畫銳度，壁紙遮罩控制插畫顯不顯眼。想讓鯨魚娘更清楚就降前者，想讓文字更穩就升後者。
安裝與啓用¶
需要先安裝皮膚管理器 @smalltailqwq/dsh-client-ui-skin-deep-whale-manager：
dsh plugin --profile web add '@smalltailqwq/dsh-client-ui-skin-deep-whale-manager'
dsh plugin --profile web add 'dsh-whalegirl'
從 GitHub Release 的預構建包安裝：
dsh plugin --profile web add -w https://github.com/zhenhua520/dsh-whalegirl/releases/latest/download/dsh-whalegirl.tgz
從本地目錄 / 壓縮包安裝：
dsh plugin --profile web add -w /path/to/dsh-whalegirl
dsh plugin --profile web add -w /path/to/dsh-whalegirl-1.0.19.tgz
安裝後重啓一次 DSH：
dsh web
然後在「設置 → 皮膚管理」裏選擇「鯨魚娘」。
卸載：
dsh plugin --profile web remove dsh-whalegirl
適用場景與注意¶
適合需要自定義 DSH 界面風格、希望界面與對話內容視覺分離的開發者。皮膚以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
代碼以 MIT 授權，可商用；美術素材以 CC BY-NC-SA 4.0 授權，禁止商業使用。修改後必須以相同許可分發，並保留完整署名鏈。
署名鏈¶
鯨魚娘角色與全部圖片素材均爲衍生作品，按創作順序致謝：
- 一創 上善（Pixiv · Bilibili：上善無形）—— 角色形象原作者
- 二創 ZipZipPipe（Pixiv）—— 加入 DeepSeek 元素的二次設計
- 三創 Small-tailqwq ——
dsh-deep-whale皮膚家族的再設計 - 移植 ZHOUcourier —— 首次移植到 DSH，本包繼承其調色板錨點、壁紙與 CSS 生成邏輯
本包新增：skin-manager 接入（協議 v2 / skin.json / 實時參數）、深色調色板、外觀三態映射、壁紙收斂到對話列、以及行內代碼/改動卡片/滑桿/反色徽標的對比度修正。
短結尾¶
鯨魚娘皮膚通過統一調色板與皮膚管理器協議，將視覺改造模塊化，支持淺色、深色、跟隨系統三態，並提供 7 項實時可調參數。更多細節與源碼見：https://github.com/zhenhua520/dsh-whalegirl
