DeepSeek Harness 主題插件 dsh-x9-theme

前言¶

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。對於開發者或使用者而言，在保持系統功能穩定的前提下調整界面風格，通常需要直接修改源碼或使用複雜的開發者工具。dsh-x9-theme 插件通過官方插件機制提供了一套外觀定製方案，無需構建前端，且不影響 DSH 源碼。

簡介¶

dsh-x9-theme 是 DeepSeek Harness WebUI 主題插件（bundle 包）。它提供預設風格、明暗模式切換、分區獨立樣式定製以及背景管理等功能，支持配置持久化與分享。

安裝¶

在終端執行以下命令安裝插件：

dsh plugin --profile web add github:X9wd09ncc/dsh-x9-theme

安裝完成後，重啓 DeepSeek Harness 服務。

核心功能¶

預設風格與明暗模式¶

插件提供極光、午夜、櫻花、森林等多種預設風格。同時支持明暗模式，可選擇跟隨系統、淺色或深色。

分區獨立樣式¶

側邊欄、輸入框、對話氣泡（用戶/AI）、頁面背景等區域可獨立定製樣式，包括毛玻璃、霓虹描邊、浮雕、漸變等效果。

背景定製¶

支持本地上傳、本地路徑、URL 鏈接或內置漸變作爲背景。
* 本地路徑限制：擴展名需在白名單（jpg/jpeg/png/gif/webp/avif/svg/bmp）內，且文件不超過 8 MiB。
* 上傳機制：本地上傳的圖片存入插件 assets 目錄，重啓不丟失。

自定義 CSS 與透明度¶

• 分區自定義 CSS：提供編輯器，免 F12 即可顯示當前區域的實際樣式並直接修改。命名空間衝突時，自定義 CSS 優先級較高。
• 四區透明度：主區、側邊欄、卡片浮層、輸入區透明度獨立調節，支持自動參考值（啓用背景後自動調整）。

配置持久化與分享¶

所有設置自動寫入插件目錄的 config.json。在設置面板的“高級”區可導入、導出配置，方便分享主題給他人。

生效與更新¶

• 生效：修改 lib/client.js（瀏覽器端）後刷新頁面即可生效；修改 lib/index.js（Host 路由）需重啓服務。
• 更新：重新執行安裝命令即可覆蓋更新。

注意事項¶

1. 前置要求：需已安裝 DeepSeek Harness。
2. 版本兼容：DSH 大版本升級後，CSS 類名可能發生變化，自定義 CSS 需相應更新。
3. 背景模式：背景風格層（如賽博網格、星空）均爲深色底，選擇後會自動切換深色模式以保證可讀性。
4. 配置重置：刪除插件目錄下的 config.json 或在面板“高級”區點擊“重置全部”可恢復默認。