前言¶
DeepSeek Harness 的界面定製通常需要深入修改設計系統的核心文件。如果希望在運行時調整配色、面板透明度或添加背景圖,而不觸碰原有的主題代碼,需要一個獨立的配置層。dsh-style-hub 旨在通過一個插件卡片,提供一套無需編寫樣式表的視覺定製方案。
插件定位¶
這是一個面向 DeepSeek Harness Web GUI 的主題工作室插件,由 Au1314 維護。它是一個組合插件(包含主機端與瀏覽器端),旨在通過插件卡片提供外觀管理能力,而不是替換整個主題系統。該插件遵循 MIT 許可證。
核心功能¶
- 預設樣式:內置 8 套配色方案(如 Nord、Dracula、Tokyo Night 等),直接作爲一級主題註冊,利用設計系統的 token 目錄工作,而非覆蓋樣式表。
- 精細調整:提供品牌強調色和麪板透明度滑塊,支持將面板設爲半透明,從而透出背景。
- 主機端壁紙庫:支持上傳本地圖片至 Host 端,提供封面、透明度、模糊和變暗參數的實時預覽。
- 組合插件:同時作用於主機端與瀏覽器端。
安裝與啓用¶
在 DSH Desktop 的 Web 配置文件目錄下進行操作:
- 解壓包到該配置文件目錄下的
node_modules,並重命名爲插件名:
tar -xzf dsh-style-hub-0.1.0.tgz && mv package dsh-style-hub
- 在該配置文件的
package.json中,將"dsh-style-hub"添加到dependencies和dsh.profile.bundles。 - 重啓應用以使配置生效。
典型用法¶
- 打開 設置 → 插件 → 插件配置 → Style Hub。
- 選擇一個樣式芯片,或保持 Stock 不變以保留原有外觀。
- 拖動 Accent(強調色)和 Panel opacity(面板透明度)滑塊進行微調。
- 選擇或上傳壁紙,設置其 Fit(適配方式)、Opacity(不透明度)、Blur(模糊)和 Dim(變暗)參數。
適用場景與注意¶
- 依賴要求:宿主環境需要已安裝
dsh-client-ui-settings-plugins、dsh-client-ui-theme和dsh-client-locale。運行時 peer 依賴範圍爲>=0.1.5-rc.2 <0.2.0。 - 文件限制:支持的壁紙格式爲 PNG、JPEG 和 WebP,單文件最大 15MB。
- 安全機制:寫入操作要求同源(Same-host Origin/Referer),以防止跨站請求僞造。
- 渲染限制:當壁紙顯示時,畫布渲染會被限制。
- 開關控制:關閉主開關可恢復至原始外觀,該插件不會持久化決定“正常”外觀應該是什麼。
總結¶
通過 dsh-style-hub,可以在不修改核心主題代碼的情況下,快速定製 DeepSeek Harness 的視覺風格。更多細節可參考官方目錄或 GitHub 倉庫。