前言¶
DeepSeek Harness(DSH)採用「一切皆插件」的架構。在長時間開發或調試過程中,默認的 UI 界面可能難以滿足視覺舒適度的需求。dsh-client-ui-solarized-grid 是一個爲 DSH 桌面端 / Web 客戶端設計的主題插件,旨在通過 Solarized 配色方案和網格紙背景,提升長時間閱讀和交互的視覺體驗。
插件簡介¶
這是一個客戶端主題插件,由開發者 EYEjunnnn 維護。它將 Solarized Light 和 Solarized Dark 兩套配色引入 DSH,併爲對話區域添加了模擬網格紙的背景,同時重新設計了對話氣泡的樣式。
核心功能¶
- Solarized 配色:支持 Light 和 Dark 兩種模式,將主題表裏聲明的全部
--dsw-*令牌(別名層、靜態色階、Shiki 語法色)進行重映射。 - 網格紙背景:在對話滾動區(
[data-conversation-scroll])繪製背景,包含 75px 主線和 15px 細線,使用background-attachment: local實現隨內容滾動。 - 已調優的對話氣泡:
- 淺色模式:淡青卡片(
#bfe3e0)+ 墨色左邊條(#002b36)。 - 深色模式:象牙卡片(
#e8dfc9)+ 朱橙左邊條(#ff5900)。 - 深色模式下,卡片內文字會單獨壓深,防止淺字淺底導致的可讀性問題。
- 淺色模式:淡青卡片(
- 令牌重映射:涉及 201 項
--dsw-*令牌的覆蓋。 - 兼容性:支持 DSH 桌面端 / Web 客戶端。
安裝與啓用¶
桌面端目前沒有 dsh CLI,推薦使用拷貝式安裝(零依賴)。
- 將倉庫解包或克隆到任意目錄。
- 關閉 DSH 桌面端(確保補丁在啓動時被讀取)。
- 運行安裝腳本。腳本會自動將文件拷貝到
<你的 profile>\plugins\dsh-client-ui-solarized-grid\,並處理掛載配置。
powershell -File .\install.ps1
- 啓動 DSH。
典型用法¶
安裝完成後,主題會在啓動時生效。若要確認配置正確,需檢查 profile 目錄下的 cordis.patch.yml 文件,確保其中包含 ui-solarized-grid 的掛載行。
卸載¶
使用提供的卸載腳本移除掛載行(並可選刪除插件目錄):
powershell -File .\uninstall.ps1 # 移除掛載行
powershell -File .\uninstall.ps1 -Remove # 連插件目錄一起刪
若通過包管理器安裝,則需從 dsh.profile.bundles 中移除包名,並執行 pnpm remove。
設計說明與注意事項¶
- 首次加載行爲:首次加載時,若系統偏好解析爲深色,主題會一次性 pin 成淺色模式。之後可在設置 → 外觀中切換。
- 語義色保留:非正文的語義色(如代碼塊註釋、警告色)保留了 Solarized 原色,未刻意壓深對比度。這是爲了保持 Solarized 本身的低對比度閱讀性格,避免破壞語法的可辨識度。
- 網格繪製:網格必須畫在滾動區上,不能使用
body背景,且必須設置background-attachment: local。 - 氣泡邊條:氣泡邊條只能使用
inset box-shadow,以配合圓角自然收窄,若使用background-image漸變會導致方角。 - 深色模式文字:深色氣泡內文字必須使用 scoped 深色墨規則覆蓋,否則會與背景色衝突。
結語¶
該插件通過重映射 201 項令牌和定製 CSS,爲 DSH 提供了一套視覺上更清晰、長時間閱讀更舒適的界面。其設計在可讀性與原色風格之間做了取捨,適合需要在深色或淺色環境下長時間使用 DSH 的開發者。
- 目錄頁: https://www.skillhub.cn/plugins/EYEjunnnn/dsh-client-ui-solarized-grid
- 源碼: https://github.com/EYEjunnnn/dsh-client-ui-solarized-grid