前言¶
DeepSeek Harness(DSH)的 Web 客戶端側欄、設置頁和會話列表,在日常長時間使用時,圓角偏大、間距偏松、懸停卡片頻繁彈出,會讓視線難以快速掃過工作區與會話。換一套完全不同的主題往往成本高,也難和後續宿主升級對齊。dsh-ui-alt 針對的是這類「還想保留原版氣質,只想更冷靜、更緊湊」的需求:用 CSS 覆蓋加少量 DOM 注入,在設置裏逐項開關,關掉即回原版外觀。
這是什麼¶
dsh-ui-alt 由維護者 AomiRaku 發佈,在社區目錄中歸類爲「趣味換裝」。當前 package.json 版本爲 0.2.13,許可證 MIT。插件不改變 DSH 的業務邏輯,只調整 Web 端可見的排版與交互細節,並在 設置 →「UI 改進」 中爲多數改動提供獨立開關。
實現上,Host 側 index.js 的 apply 爲空;客戶端邏輯集中在 client.js:一大段按 html[data-dcc-*] 條件生效的 CSS,以及三個帶 MutationObserver 防抖兜底的 DOM 注入(新會話行、側欄摺疊箭頭、設置頁返回按鈕)。
核心功能¶
下面按 README 中的開關分組說明;默認值以資料爲準。
外觀¶
| 開關 | 默認 | 效果 |
|---|---|---|
| 隱藏左上角 Logo | 關 | 隱藏側欄頂部的 Logo |
| Windows 默認微軟雅黑字體 | 關 | Windows 端默認字體改爲微軟雅黑;低分辨率、200% 以下縮放帶 hinting;手動設置字體或 macOS 不受影響 |
佈局¶
| 開關 | 默認 | 效果 |
|---|---|---|
| 減小圓角與緊湊界面 | 開 | 縮小全局圓角、側欄部分字號與間距 |
| 統一新會話按鈕樣式 | 開 | 新會話按鈕樣式與導航按鈕一致 |
| 摺疊側欄導航功能 | 開 | 側欄導航可點擊箭頭展開收起 |
| 弱化工作區名稱 | 開 | 工作區名稱弱化,便於與會話區分 |
| 會話前圓點 | 開 | 會話行前顯示圓點 |
| 移除工作區與會話懸停提示 | 開 | 懸停側欄工作區、會話時不再彈出詳情卡片 |
| 隱藏會話懸停多餘按鈕 | 開 | 懸停會話行僅保留菜單和置頂;若某插件按鈕不在右鍵菜單中可關閉此項 |
| 設置面板全屏 | 開 | 使用非窗口化的設置頁面 |
另有一些不掛開關的固定樣式,例如設置導航列寬 220px、歸檔會話標題刪除線、淺色主題下選中會話背景加強等。若同時安裝了 @michengai/dsh-archive-manager,插件內有與收藏星標避讓相關的 CSS 規則纔會生效。
安裝與啓用¶
DSH 以 link 方式將本倉庫登記到 profile,目錄需保留在原絕對路徑;移動或刪除前請先卸載。
在 DeepSeek Harness 插件管理器中,對本倉庫目錄執行:
plugin_manager install_bundle target=<本倉庫絕對路徑>
安裝後刷新 Web 頁面。設置裏會出現「UI 改進」一欄,側欄設置導航會出現對應圖標。
本地修改 client.js 後需重新安裝並刷新,例如:
plugin_manager remove_bundle target=dsh-ui-alt
plugin_manager install_bundle target=<本倉庫絕對路徑>
典型用法¶
- 完成安裝並刷新頁面後,打開 設置,進入 UI 改進。
- 按需開關「減小圓角與緊湊界面」「摺疊側欄導航功能」等項;每項關閉後對應區域恢復宿主默認外觀。
- 若側欄滾動仍因宿主 HoverCard 預覽感到卡頓,可開啓「移除工作區與會話懸停提示」;滾動時鼠標劃過會話行仍可能觸發宿主預覽,插件未乾預該行爲。
開關狀態寫在瀏覽器 localStorage 的鍵 dsh-ui-alt:prefs:v1 下,並映射到 html 上的 data-dcc-* 屬性,例如 data-dcc-radius、data-dcc-nav(collapsed / expanded)等,供 CSS 選擇器使用。
適用場景與注意¶
適合長期用 DSH Web 界面寫提示詞、切換會話、整理工作區的開發者,希望界面更專業、易讀,又不願整體換膚。
安裝前建議自行閱讀 GitHub 倉庫 源碼與 MIT 許可證。插件在 當前 DSH 進程權限 下運行,屬於客戶端 UI 注入,不替代對宿主版本與安全策略的判斷。
已知限制(來自 README):克隆出的新會話行沒有原按鈕的 Tooltip 與快捷鍵提示,點擊已轉發至原按鈕;關閉「統一新會話按鈕」時,摺疊導航計數可能偏移一項,顯示仍正常;樣式依賴宿主 CSS module 類名、設置面板 DOM 結構及 --dsw-* 等主題 token,宿主大版本升級後個別條目可能靜默失效。
結尾¶
dsh-ui-alt 在保留原版 UI 大風格的前提下,用可逐項回退的改動收緊側欄與設置頁。目錄與源碼可從社區頁 dsh-ui-alt 與 GitHub 獲取。