前言¶

DeepSeek Harness（DSH）採用“一切皆插件”的設計理念，在關注代理邏輯與對話能力的同時，Web 界面的視覺呈現同樣影響開發體驗。dsh-soft-glass-ui 是一個非官方的視覺層插件，它通過裝飾現有的 DOM 節點，爲 DSH 提供軟玻璃質感的視覺主題。

插件簡介¶

• 名稱：dsh-soft-glass-ui
• 維護者：Zzc269
• 許可：MIT
• 定位：趣味換裝類插件，僅提供視覺樣式與呈現行爲，不涉及邏輯變更。

核心功能¶

該插件覆蓋了 DSH Web 界面的多個核心狀態：
* 覆蓋範圍：Home（首頁）、conversations（對話）、trajectory（軌跡）、settings（設置）、menus（菜單）、dialogs（對話框）及相關 Web UI 狀態。
* 主題支持：提供 Light（淺色）和 Dark（深色）主題切換。
* 長草稿處理：針對對話輸入框，將長草稿限制在內部滾動區域內，保留圓角裁剪效果，併爲底部的統計行預留緊湊的底部安全區域。
* 行爲隔離：僅修改視覺樣式，不改變 Harness Agent、Session、Tools、Permissions、存儲、憑證或模型運行時的任何行爲。

安裝與啓用¶

從發佈歸檔安裝插件需要指定本地路徑：

dsh plugin --profile web add <path-to-dsh-soft-glass-ui.tgz>

安裝完成後，重啓 Web 進程以使樣式生效。

Windows 快速操作¶

對於 Windows 用戶，倉庫提供了命令行包裝腳本，可自動處理 Harness 檢出路徑、pnpm 環境及端口占用問題。

• install.cmd：停止 Harness 進程，移除舊版/當前主題，安裝插件，啓動 Harness 並打開瀏覽器。
• uninstall.cmd：停止 Harness，移除 Soft Glass 及舊版主題，恢復原始 UI。
• start.cmd：啓動 Harness（默認端口 3081），或檢測已運行實例。
• stop.cmd：停止檢測到的 Harness 進程。
• status.cmd：顯示 Harness 目錄、pnpm 路徑、已安裝主題、歸檔哈希、端口占用及命令行信息。

可選參數：
* -HarnessRoot：指定 Harness 檢出路徑。
* -Port：指定端口號。
* -NoOpen：安裝後不自動打開瀏覽器。

注意：腳本會自動將 pnpm 加入子進程 PATH，避免安裝插件時報錯 pnpm is not recognized。

移除與回滾¶

若需移除插件或回滾到原始界面，執行：

dsh plugin --profile web remove dsh-soft-glass-ui

重啓 Web 進程後，原始 Harness UI 應自動恢復。

源碼構建¶

在兼容的 Harness 檢出目錄下，將此目錄放置於 plugins/soft-glass-ui，然後執行構建：

pnpm run build

構建過程會使用 Harness 的 client-bundle 預設，並運行 release sanitizer 以移除構建機器路徑。

兼容性與架構¶

• 兼容版本：
  • DeepSeek Harness: 0.1.0-rc.5
  • Node.js: ^22.19.0 或 >=24.0.0
  • 平臺: Web profile
  • 視口: 1440 x 900, DPR 1
• 架構說明：插件使用 DSH 客戶端插件注入路徑，通過添加 data-softglass-* 屬性裝飾現有 DOM 節點，並應用 scoped CSS 模塊。卸載時會自動移除裝飾與樣式標籤，不替換或修補核心源文件。
• 日誌位置：運行日誌寫入 %LOCALAPPDATA%\SoftGlassUI\logs。

注意事項¶

• 非官方項目：該社區項目與 DeepSeek 或 Kelivo 項目無隸屬、贊助或背書關係。
• 兼容性提示：雖然當前已驗證兼容 DSH 0.1.0-rc.5，但與後續 Harness 版本的兼容性並未保證，需在升級後重新測試。
• 端口占用：腳本不會自動停止佔用所選端口的未知進程，需手動處理衝突。

資源鏈接¶

• GitHub 倉庫：https://github.com/Zzc269/dsh-soft-glass-ui
• 插件目錄：https://www.skillhub.cn/plugins/Zzc269/dsh-soft-glass-ui