DeepSeek Harness (DSH) 提供了 Web 界面用於智能體的配置與運行。在長時間使用過程中，開發者可能需要調整界面風格以適應個人習慣或特定的視覺環境。dsh-ui-customizer 是一個爲 DSH Web 提供的視覺自定義插件，允許用戶在不修改源碼的情況下，通過面板直接調整顏色、字體、背景和組件樣式。
功能概覽¶
該插件提供了一套完整的視覺定製方案，主要包含以下模塊：
- 總開關：控制 DIY 主題的啓用與禁用，關閉後所有覆蓋設置將移除。
- 皮膚中心：提供 8 種一鍵預設方案，用戶可在預設基礎上進行微調。
- 色彩系統：支持品牌色、強調色、成功/警告/錯誤狀態色，以及中性色方向（藍灰、冷灰、暖灰、石墨）。
- 字體設置：可配置 UI 字體與代碼字體，並支持整體縮放（80%-140%）和文本縮放（80%-130%）。
- 背景設置：支持自定義圖片 URL（需瀏覽器安全策略允許），並調節面板的透明度與毛玻璃效果。
- 組件樣式：調整陰影層級與圓角大小，控制視覺深度與圓潤度。
- 我的方案：保存完整的主題配置爲預設，並支持隨時切換。
安裝與啓用¶
在安裝前，請確保系統已安裝 Node.js（用於運行 npx）。
- 執行安裝命令：
dsh plugin --profile web add dsh-ui-customizer@latest
*(注：該插件在 v1.1.0 版本起聲明爲標準 bundle，會自動註冊到 `dsh.profile.bundles`)*
- 完全重啓 DSH Web 進程以加載插件：
npx @deepseek-ai/dsh web
- 在瀏覽器中打開 Web 界面，依次進入 Settings (設置) → DIY Theme (DIY 主題) 即可使用自定義面板。
使用方法¶
進入 DIY 主題面板後，所有修改均爲實時預覽。
- Apply：保存當前配置。
- Revert：撤銷未保存的更改。
- Reset：恢復爲工廠默認值。
數據存儲與兼容性¶
- 數據存儲：主題配置與方案保存在瀏覽器的
localStorage中；上傳的媒體文件（如有）存儲在IndexedDB。數據不會上傳至 DSH 服務器。 - 圖片加載：遠程圖片 URL 的加載受瀏覽器安全策略、CORS（跨域資源共享）及服務器響應頭的限制。
- 兼容性：DSH 版本迭代較快，官方的 token、插槽和頁面結構可能會發生變化，這可能影響插件功能的兼容性。
- 可讀性設計：插件遵循“可讀性優先”原則。環境表面（如主背景、側邊欄）會根據透明度設置變透明，而覆蓋層（對話框、菜單、輸入框）保持約 94% 的不透明度，以確保文本始終清晰可見。
總結¶
dsh-ui-customizer 爲 DSH Web 提供了一個無代碼的視覺定製入口。它利用本地存儲管理配置，適合需要頻繁調整界面風格或進行統一視覺風格管理的開發者。該插件開源（MIT 協議），維護者爲 Final-LX。
