DSH(DeepSeek Harness)採用插件化架構,一切皆可擴展。在使用原生設置面板配置智能體或工作流時,默認的窗口尺寸、背景透明度或配色方案有時難以滿足實際查看需求。dsh-settings-ui 插件直接作用於原生設置窗口,允許調整其大小、背景透明度與背景色,並支持亮暗主題實時跟隨。
插件定位¶
- 名稱:
dsh-settings-ui - 維護者:
weibaohui - 分類:趣味換裝
- 簡介:dsh 插件 · 設置界面自定義:調整原生設置窗口大小、透明度與背景,支持亮暗主題實時跟隨
- 許可證:MIT
核心功能¶
- 窗口大小:支持默認尺寸、大尺寸、特大尺寸、全屏模式或自定義寬高(最小 480×360,小屏自動收縮)。
- 背景不透明度:支持 30% 至 100% 的調節,配合亮暗主題可實現半透明毛玻璃效果。
- 背景設置:提供“主題默認”或“純色”選項。插件內置亮色與暗色主題各一種預設顏色,切換主題時背景會實時跟隨變化。
- 即時生效:在設置面板內修改配置後,設置立即生效。配置隨 dsh profile 持久化保存。
安裝與啓用¶
在終端中執行以下命令安裝插件:
dsh plugin --profile web add @weibaohui/dsh-settings-ui -w
安裝完成後,需要重啓 dsh web 命令行進程,插件纔會生效。
典型用法¶
- 打開 DSH Web UI。
- 進入「設置」頁面。
- 在左側導航欄找到「設置界面」。
- 在該頁面下調整尺寸、拖動滑塊設置不透明度、選擇背景風格。
- 關閉並重新打開設置窗口,即可看到調整後的效果。在全屏模式下,可以同時查看對話與設置內容。
注意事項¶
- 作用範圍:尺寸、透明度與背景設置僅作用於原生設置窗口本身,不會影響 DSH 的其他界面(如主聊天窗口)。
- 技術細節:插件選擇器使用了穩定的屬性
[data-shortcut-modal="settings"],不再依賴 CSS Module 的易變 hash 類名,因此即使 dsh 內部構建版本更新,選擇器依然有效。 - 配置持久化:設置內容會隨當前的 dsh profile 保存。若從舊版本升級,首次運行時會自動處理殘留配置。
- 版本兼容:插件依賴
@deepseek-ai/dsh版本>=0.2.0-rc.2。
總結¶
如果你覺得原生設置窗口在複雜配置下難以操作,或者需要根據當前環境調整視覺體驗,dsh-settings-ui 提供了一套輕量級的自定義方案。它通過修改 CSS 變量或樣式注入,在不破壞原有邏輯的前提下,增強了設置界面的可用性。