前言¶
DeepSeek Harness（DSH）採用插件化架構，Web UI 的外觀通常由宿主內置的主題系統控制。bpz0726/dsh-bestui 插件通過覆蓋層機制，爲 DSH Web UI 提供了一套自適應壁紙與外觀配置方案，允許用戶上傳本地圖片作爲背景，並獨立調整各層級的透明度與配色。
核心功能¶
- 上傳圖片當背景：支持本地選圖，超限圖片自動壓縮，動畫 GIF 保留動畫效果，設置持久保存在瀏覽器
localStorage。 - 透明部件不透明度：針對背景基底、第二層表面、側邊欄設置獨立滑塊與“默認”勾選，數值越小壁紙透出越多。
- 元素顏色自定義：支持 14 個設計 token 和 9 個額外元素色，分爲淺色/深色兩套方案，邊框按透明度渲染。
- 自動配色：有背景圖時通過 Canvas 採樣生成配色；無背景圖時使用中性配色或跟隨系統深淺。
- 字體與界面：支持字體風格、大小、縮放、圓角等自定義。
- 方案導出/導入：支持導出完整方案爲 JSON，便於遷移。
- 停用易恢復：基於
theme.overrideTokens覆蓋層，不註冊新主題 id，卸載後自動清除樣式，可與其它主題插件並存。
安裝與啓用¶
安裝該插件需在終端執行以下命令：
dsh plugin --profile web add dsh-bestui
安裝後重啓 dsh web，插件將在啓動時自動加載。
典型用法¶
- 進入 設置 → 常規，在「外觀」下方找到 「壁紙主題 · BestUI」。
- 勾選 啓用，點擊 上傳圖片（支持 JPG/PNG/WebP/GIF）。上傳後自動生成一組推薦透明度，可手動微調。
- 使用 透明部件不透明度 滑塊調整各層級的透出程度。
- 通過 元素顏色 取色器自定義淺色/深色方案的配色，此設置與壁紙啓用狀態無關。
- 若需自動配色，點擊 自動配色，系統會根據圖片生成配色方案。
- 完成配置後，可使用 導出方案 或 導入方案 進行保存或遷移。
架構與兼容性¶
該插件不註冊新的主題 ID，而是通過 theme.overrideTokens 疊加一層 token 覆蓋層。這意味着它可與其它註冊了主題 ID 的插件並存。視覺效果通過 CSS 變量實現，卸載時會自動移除覆蓋層。插件在構建時需要 Node.js >= 18，但運行時僅需瀏覽器環境。所有配置均存儲在瀏覽器的 localStorage 中。
適用場景與注意¶
- 適用場景：適合需要深度定製 DeepSeek Harness Web UI 外觀的開發者，特別是希望爲界面添加個性化壁紙或調整透明度/配色的用戶。
- 注意事項：
- 該插件爲預覽版（0.1.x），面向 DeepSeek Harness Developer Preview，宿主升級後可能需要同步適配。
- 導出的方案 JSON 包含完整壁紙數據，分享前請確認隱私安全。
- 若曾按壁紙明暗自動切換主題，停用插件後需在宿主設置中手動切回主題。
短結尾¶
BestUI 提供了從壁紙到 UI 細節的全方位外觀控制能力，且具備良好的兼容性與可恢復性。更多細節與源碼，請參考 GitHub 倉庫。
