前言¶
DeepSeek Harness (DSH) 採用插件化架構，Web GUI 的外觀主要由掛載在 html[data-ww="on"] 下的樣式層決定。dsh-whale-atelier 是由 Cicero010 維護的一個皮膚包插件，它不修改 DSH 內部文件，也不寫入產品元素的屬性，而是通過掛載樣式層來改變界面呈現。
該插件旨在爲 DSH 提供一套完整的視覺重寫方案，將鯨魚娘立繪作爲壁紙鋪滿界面，疊加金屬描邊、蕾絲蝴蝶結與環境粒子，並支持通過第三方皮膚包擴展。
核心功能¶
內置皮膚與第三方擴展¶
插件提供五套開箱即用的皮膚方案：
* 女僕工坊
* 夜庭銀飾
* 深海
* 雪夜庭
* 桂月夜庭
每套皮膚包含壁紙場景、金屬描邊、蕾絲蝴蝶結、角落立繪與環境粒子。此外，插件支持第三方皮膚包格式（skin.json），可通過目錄 + 配置文件自行擴展。
視覺與交互細節¶
- 覆蓋範圍：支持全界面（側欄、標題欄、工作區）或僅工作區覆蓋。
- 明暗策略：支持跟隨 GUI 主題、按時段自動切換（07:00–18:30 爲白天版）、固定深色或固定淺色。
- 畫面三維度：可調節遮罩濃度、暗角強度與景深模糊。
- 環境粒子：提供花瓣、螢火、氣泡、雪花、桂花、櫻花六種粒子效果，且遵循
prefers-reduced-motion。 - 立繪聯動：角落立繪會根據 Agent 狀態（等待審批、生成中、出錯、剛完成）切換形象與呼吸節奏。
- 設置管理：支持設置導出與導入，可跨設備複用配置。
- 隱私與性能：全部資源由插件自身路由提供，零外部請求、零遙測。
安裝與啓用¶
1) 作爲插件裝進某個 profile¶
在目標 profile 目錄下執行 pnpm 安裝命令，並將插件名追加至 package.json 的 dsh.profile.bundles 字段末尾：
cd ~/.dsh/profiles/<profile>
"<runtime>/dependencies/node/bin/node.exe" \
"<runtime>/dependencies/pnpm/bin/pnpm.mjs" add "github:Cicero010/dsh-whale-atelier"
# 手動編輯 package.json，在 dsh.profile.bundles 中追加 "dsh-whale-atelier"
也可以在 DSH 的 GUI 插件頁面直接安裝該組合包。
2) 本地目錄鏈接¶
git clone https://github.com/Cicero010/dsh-whale-atelier ~/.dsh/plugins/dsh-whale-atelier
cd ~/.dsh/profiles/<profile>
"<runtime>/dependencies/node/bin/node.exe" \
"<runtime>/dependencies/pnpm/bin/pnpm.mjs" add "link:C:/Users/<you>/.dsh/plugins/dsh-whale-atelier"
# 同樣在 dsh.profile.bundles 中追加插件名
典型用法¶
裝載皮膚包¶
插件倉庫自帶示例皮膚包。安裝方式有兩種：
1. 使用工具腳本（無需重啓）：
python tools/install_skin_pack.py skins/sakura
- 複製到宿主發現路徑（需重啓宿主）：
將skins/sakura/複製到$DSH_HOME/whale-wallpaper-skins/。
切換皮膚¶
在 DSH 的 Web GUI 中切換皮膚即可實時生效。
適用場景與注意事項¶
適用場景：希望爲 DSH Web GUI 換膚、需要 Agent 狀態視覺反饋的開發者。
運行時依賴：目標運行時爲 DSH 0.2.0-rc.2。插件依賴內置客戶端的 CSS-module 類名後綴（如 _frame、_centerCol、_composerSeat、_header、_running、_turnErrorRow、_reject）以及 --dsw-alias-bg-base、--dsw-specific-sidebar-fill 令牌。若 DSH 更改這些契約，界面會靜默失效並回到出廠外觀。
幾何與發現：裝飾層只讀取外殼幾何，不做像素級鎖定，佈局變化通過 resize + 1.5s 同步兜底。皮膚包的宿主發現路徑（投放目錄或插件聲明）在安裝後通常需要重啓一次宿主才能生效。
素材來源：立繪與壁紙衍生自 dsh-whale-musume（MIT 許可），僅本地使用。
結尾¶
dsh-whale-atelier 提供了一套完全本地化、無遙測的視覺定製方案。若需查看源碼或獲取更多文檔，可訪問 GitHub 倉庫。
