DeepSeek Harness（DSH）的 Web UI 提供了基礎的智能體開發環境。在默認配置下，界面風格較爲統一。如果你希望調整界面的配色、字體或佈局深度，可以使用 DSH Pretty Extension 插件。它通過一個原生的設置頁面提供主題編輯能力，而非依賴外部 CSS 覆蓋。
插件定位¶
這是一個由 Rheasilvia 維護的 DSH 插件，專門用於 DeepSeek Harness Web UI 的主題美化。它利用 DSH 的插件、設置、插槽和主題 API，在 Web UI 的設置中添加了一個獨立的編輯入口，支持從預設或自定義兩個維度修改界面外觀。
核心功能¶
插件提供了以下可用的配置項：
- 28 種主題預設：包含 Ayu、Catppuccin、Dracula、GitHub、Nord、Tokyo Night 等常見風格。
- 獨立調色板：可分別配置淺色和深色模式下的強調色、背景色、前景色和側邊欄顏色。
- 實時預覽：在修改設置時，側邊欄、對話區域和會話選中狀態會實時更新，無需保存即可預覽效果。
- 排版與深度控制：支持單獨選擇 UI 字體和代碼字體，並可調節界面層級（表面、邊框、次要文本、懸停狀態），支持 82% 透明度的側邊欄渲染。
- 無障礙修正：自動對低對比度的前景色進行最小化調整，以保持至少 4.5:1 的文本對比度。
- 原生集成：使用 DSH 的菜單系統和語義化主題令牌，支持設置持久化和版本保護。
安裝與啓用¶
安裝前請確保你的環境滿足以下條件：
- 已安裝 DeepSeek Harness 並配置了
web配置文件。 pnpm可在系統PATH中找到（dsh plugin依賴 pnpm 管理依賴）。
執行以下命令安裝插件：
dsh plugin --profile web add github:Rheasilvia/dsh-pretty-extension
安裝完成後，插件默認處於禁用狀態。你需要重啓 DSH Web 進程使其生效：
dsh web
使用步驟¶
- 啓動 DSH Web，訪問其迴環地址（通常爲
http://127.0.0.1:3080）。 - 打開 Settings（設置） 菜單，選擇 Pretty。
- 打開 Enable Pretty theme 開關。
- 切換 Light 或 Dark 模式，選擇一個預設主題，或手動調整顏色、字體和界面效果。
- 在預覽區域確認效果無誤後，點擊 Save and apply。
注意事項與配置¶
- 默認禁用：插件安裝後不會立即改變界面，必須手動在設置中啓用。
- 持久化存儲：配置信息保存在
$DSH_HOME/settings.yaml文件中的ui-pretty.theme命名空間下。點擊“Restore defaults”可移除此配置覆蓋，恢復 DSH 原生主題。 - 本地字體限制：若要加載系統字體，瀏覽器必須支持該功能，且必須在迴環地址或安全上下文（HTTPS）中運行，並顯式授權。
- 只讀限制：如果瀏覽器不是通過迴環地址（如
127.0.0.1）訪問 DSH，Pretty 設置在當前會話中將是隻讀的。這屬於安全設計，遠程會話僅使用內存設置。
總結¶
DSH Pretty Extension 通過插件化的方式擴展了 DSH Web UI 的定製能力。它適合需要在長時間使用 DSH 時調整視覺體驗的開發者，提供了從預設快速應用到精細像素級調整的完整工作流。
