前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在構建或使用 DSH Web UI 時，除了核心的模型交互，界面的視覺呈現往往也是開發者或高頻用戶關注的重點。普通的背景修改往往伴隨着性能損耗，或者破壞系統的原生主題邏輯。
dsh-liquid-glass-ui 插件旨在解決這些問題。它提供了一種基於 iOS 風格的液態玻璃透明效果，允許用戶自定義背景並調整透明度，同時通過輕量級的渲染方式，在不影響流式輸出性能的前提下實現個性化界面。
核心功能¶
該插件通過原生 DSH 服務進行集成，具備以下能力：
- 背景與圖片支持：支持選擇遠程背景 URL，也允許上傳本地圖片（最大 4MB，以 Data URL 形式存儲在設置文檔中）。
- 視覺參數調整：提供玻璃不透明度、背景變暗程度、尺寸及位置的控制選項。
- 性能優化：使用輕量級的 alpha 混合技術，避免引入實時模糊或複雜的濾鏡管道，防止在流式輸出時觸發全局重繪。
- 主題兼容：通過
theme.overrideTokens()與 DSH 原生主題配合。當插件被禁用或卸載時，系統會自動恢復原有的主題設置。 - 設置持久化與預覽：修改內容在保存前可在設置卡片中實時預覽，且設置會通過 DSH 原生用戶設置服務持久化保存。
安裝與啓用¶
通過 npm 安裝該插件：
dsh plugin --profile web add dsh-liquid-glass-ui
安裝完成後，需要重啓 dsh web 以加載插件。隨後進入 Settings → Plugins → Liquid Glass Appearance 進行配置。
典型用法¶
在設置界面中，你可以選擇上傳一張本地圖片，或者輸入一個遠程圖片的 URL。系統會即時渲染出玻璃效果背景。根據需要調整滑塊來改變玻璃的透明度和背景的亮度。配置完成後點擊保存，界面即會應用新的外觀。
適用場景與注意事項¶
適用場景：適合需要深度定製 DeepSeek Harness Web UI 視覺風格，同時希望保持系統輕量、不干擾流式輸出的用戶。
注意事項：
* 隱私風險：如果使用遠程背景 URL，瀏覽器會直接請求該圖片，可能會向圖片託管服務暴露 DSH 用戶的 IP 地址。建議在個人環境或信任的圖片源下使用。
* 本地文件安全：本地上傳的圖片僅作爲 Data URL 存儲在 DSH 設置文檔中，插件本身不會上傳至外部服務。
* 彈窗權限：插件包含一個可選功能——在 DSH 會話開始新的思考步驟時，自動在獨立標籤頁打開抖音或 Bilibili。此功能默認禁用。啓用時，瀏覽器必須允許 DSH 站點的彈窗，且該娛樂網站會獲得正常的網絡元數據。
* 共享環境：由於配置文件中可能包含本地圖片數據，請避免在共享計算機上設置敏感圖片，並遵守配置的 DSH 設置提供者的訪問控制規則。
結語¶
dsh-liquid-glass-ui 提供了一種在保持 DeepSeek Harness 核心功能穩定性的同時，提升界面美觀度的方案。通過輕量級的渲染機制和良好的主題兼容性，它讓 UI 定製變得可控且安全。
