前言¶
DeepSeek Harness (DSH) 提供了基於插件的擴展架構。默認的 Web 界面風格固定，若需修改背景、配色或佈局細節，通常需要修改源碼。dsh-theme-customizer 將這些定製需求封裝爲插件，提供可視化的配置面板，支持實時預覽、持久化保存以及配置文件的導出與導入。
插件簡介¶
該插件由 lxxz1918 維護，開源協議爲 MIT。核心價值在於對 DSH Web 界面的主題進行全可視化調整，覆蓋背景、文字、框線及細節樣式。配置通過 localStorage 本地持久化，支持導出爲 .tczp 文件並在其他設備上導入還原整套效果。
核心功能¶
-
多區域背景定製
支持對 7 個區域的背景進行設置，包括主界面、側邊欄、對話區、輸入區、設置界面、浮窗面板以及 Cordis 插件界面。- 每個區域支持純色、圖片（支持選區裁剪）、透明度及底色。
- 主界面支持“包含側邊欄”與“不包含側邊欄”兩種顯示模式的獨立配置。
- 側邊欄圖片支持淡出效果，不影響頂部 UI。
-
全局細節調整
- 框線與字體：支持獨立設置各區域的邊框/分隔線顏色與透明度，以及正文、過程、輔助、弱化、強調五類文字顏色。
- 標誌與歡迎頁：可調整左上角 Logo 顏色、側邊欄收起後的圖標樣式，以及新會話歡迎頁的圖標、標題與徽章顏色。
- 對話區與輸入區：定製氣泡樣式、代碼塊（背景與滾動條）、輸入框高度、統計條顯示項及按鈕樣式。
-
管理與工具
- 預設系統：支持預設的導入、導出（
.tczp格式，含圖片）、重命名、刪除及拖拽排序。 - 浮動面板：提供可拖動的迷你設置面板，方便快速調整。
- 佈局調整：設置界面面板支持拖動位置及一鍵復位。
- 全局恢復：支持一鍵重置所有設置。
- 預設系統：支持預設的導入、導出（
安裝與啓用¶
使用官方安裝命令添加插件，安裝後需重啓 DSH Web 使改動生效。
dsh plugin --profile web add dsh-theme-customizer
使用方法¶
- 常規調整：進入 DSH 設置，點擊“主題”，在面板中逐項調整背景、顏色和樣式，改動即時生效。
- 快速調整：點擊界面右上角的“↗ 打開浮窗”按鈕，使用迷你面板快速切換設置。
- 效果驗證：在對話區發送指令，直接測試對話區細節選項（如氣泡、代碼塊）的實際效果。
注意事項¶
- Cordis 按鈕常駐：若需在主題設置中啓用“Cordis 按鈕常駐”功能，需依賴
dsh-client-ui-cordis補丁。插件包內提供了apply-patch.cjs腳本，需運行該腳本進行打補丁。
node apply-patch.cjs
- 版本兼容：DSH 官方包升級後會覆蓋插件目錄，升級後需重新執行打補丁命令。
- 卸載：卸載時執行移除命令。
dsh plugin --profile web remove dsh-theme-customizer
結語¶
該插件通過可視化手段解決了 DSH Web 界面定製的問題，適合需要統一視覺風格或在不同設備間同步主題配置的開發者。相關源碼與文檔可參考 GitHub 倉庫。
