前言¶
DeepSeek Harness (DSH) 採取“一切皆插件”的架構理念，允許用戶通過擴展來改變客戶端的行爲與外觀。默認的 Web GUI 專注於功能性，但在視覺上可能缺乏個性化。dsh-hu-tao-skin 是爲此類需求設計的插件，它將界面風格替換爲原神角色胡桃的“往生堂”主題，通過疊加樣式與 DOM 操作，在不破壞原有主題邏輯的前提下提供沉浸式視覺體驗。
插件定位¶
- 名稱：dsh-hu-tao-skin
- 定位：DeepSeek Harness Web GUI 客戶端插件皮膚
- 核心價值：原神 · 胡桃（往生堂）界面美化
- 維護者：MistyRain-field
- 開源協議：MIT
核心功能¶
本插件通過 14 個主題令牌定義了墨黑、緋紅、琥珀金配色，並提供了一套氛圍層系統。
-
主題令牌
- 提供明暗兩套配色方案。
- 通過
theme.overrideTokens()疊加在當前主題上，不修改主題註冊表，不會覆蓋用戶原本的主題偏好。 - 配色包括底色墨黑、主色緋紅、警示色琥珀金。
-
氛圍層
- 利用
shell.overlay掛載點實現。 - 包含金點梅紋底、緋紅暈染、右下角梅花水印、右側豎排“往生堂”金印。
- 動態效果包括 14 片飄落梅花瓣與 3 只流光蝴蝶。
- 系統開啓“減少動態效果”時，動畫會自動停用。
- 利用
-
交互控制
- 浮動開關：位於對話區左下角，可一鍵開關花瓣與蝶影。該開關通過讀取側欄的網格寬度動態定位，隨側欄拖動或收起而移動。
- 設置頁：在 DSH 設置中新增“往生堂”欄目，提供三個獨立開關：梅花飄落、蝶影流光、胡桃配色。
-
其他特性
- 首屏徽記：將空白會話的品牌圖標替換爲五瓣梅花徽記。
- 狀態持久化：開關狀態保存在
localStorage中，重啓後自動恢復。 - 無構建步驟：瀏覽器半邊爲手寫代碼，無需編譯，直接加載。
安裝與啓用¶
插件以 DSH profile bundle 的形式分發，支持一鍵安裝或腳本部署。
方式一：使用部署腳本（推薦）¶
克隆倉庫後，使用 PowerShell 執行部署腳本。腳本會將運行時文件安裝到指定 profile 的本地插件目錄，並修改 profile 的 package.json 以建立依賴關係。
git clone https://github.com/MistyRain-field/dsh-hu-tao-skin.git
cd dsh-hu-tao-skin
pwsh -File tools/deploy.ps1
腳本支持通過參數指定 profile 名稱或目錄：
pwsh -File tools/deploy.ps1 -ProfileName web
pwsh -File tools/deploy.ps1 -ProfileDir 'D:\some\profile'
安裝完成後，必須重啓 dsh web 以加載插件。
方式二：使用 DSH 命令行¶
在終端中指定 profile 和倉庫路徑進行添加。
dsh plugin --profile web add <本倉庫路徑或 git 地址>
方式三：插件市場一鍵安裝¶
如果已安裝插件市場，可在設置中直接安裝。
dsh plugin --profile web add dshmarket
典型用法¶
安裝並重啓後，界面將呈現胡桃主題。
- 視覺體驗：觀察墨黑與緋紅的配色，以及背景中飄落的梅花與流光蝴蝶。
- 交互測試：拖動左側側欄，觀察左下角浮動開關是否隨之平滑移動。
- 開關控制：點擊左下角浮動開關，或進入設置 -> 「往生堂」關閉花瓣與蝶影，觀察界面變化。
- 持久化驗證：關閉並重啓
dsh web，再次打開開關，確認狀態被保留。
注意事項¶
- 非官方作品：本插件爲同人美化，與米哈遊及 DeepSeek 無任何關聯。
- 生命週期：所有樣式與 DOM 操作均在插件生命週期內生效，卸載後會自動恢復到默認界面。
- 系統兼容性：在 Windows 系統中，請確保腳本執行策略允許運行 PowerShell 腳本。
- 動態效果：若系統開啓了“減少動態效果”，花瓣與蝴蝶的動畫將不會運行。
結尾¶
dsh-hu-tao-skin 爲 DSH 用戶提供了無需編寫代碼即可體驗同人主題的途徑。其通過不侵入註冊表的疊加式樣式和動態 DOM 操作，實現了輕量級且可逆的界面美化。
