前言¶
DeepSeek Harness(DSH)的 Web 客戶端支持通過外觀設置切換 Light / Dark / System,但默認配色未必符合你長期盯屏時的視覺偏好。社區裏已有不少皮膚類插件,常見做法是覆蓋 CSS 變量或改宿主資源,維護成本和可逆性各不相同。本文介紹 dsh-grok-night-theme:一枚以 Grok Night / Grok Day 色板爲靈感的純 token 疊加層,不改宿主文件、不注入 DOM,停用即可還原。
這是什麼¶
saber0616/dsh-grok-night-theme(Grok Night)由維護者 saber0616 發佈,歸類爲趣味換裝,當前 GitHub 星標爲 0。插件面向 DeepSeek Harness Web UI,提供 GrokBot 風格的暖炭暗色與暖紙亮色兩套語義色,並在新會話空白頁註冊一枚原創 SVG 機器人標記。README 明確標註爲非官方社區項目,與 xAI / SpaceXAI / DeepSeek 均無隸屬關係。
核心功能¶
明暗雙生¶
dark走 Grok Night:畫布#101012、抬升面#17181b,文字#f0eee8/#c3bfb5,琥珀強調#e0af68。light走 Grok Day:畫布#f6f4ee、紙面#fffdf8,文字#1b1a17/#565249,深琥珀#8a5a12。- 跟隨 DSH 外觀設置(Light / Dark / System),不劫持主題偏好。
語義 token 覆蓋¶
插件通過 ctx.theme.overrideTokens() 注入約 60 個 --dsw-* token,覆蓋背景、層級、文字、品牌、按鈕、邊框、交互態、狀態色、代碼塊、氣泡、輸入框、菜單、側欄、滾動條、diff 等。狀態色在暗色下爲綠 #9ece6a、橙 #ff9e64、紅 #f7768e;亮色下爲綠 #2f7d3f、橙 #a05c00、紅 #c0354d。
空白頁機器人標記¶
標記註冊在 conversation.hero.brand.mark,僅出現在空白會話頁;隨當前強調色着色。
實現方式與可逆性¶
全部邏輯集中在單文件 client.js,無構建步驟、無運行時依賴。theme/change 後會自動重新置頂 token,避免被其他皮膚層壓住。在「設置 → 插件」停用或移除後,主題層整體移除,無持久狀態需手動清理。
安裝與啓用¶
插件以當前 dsh 進程的權限運行,安裝前請自行查閱倉庫源碼與 MIT 許可證。
從 GitHub 安裝(推薦)¶
下面命令來自倉庫 README,請原樣使用:
dsh plugin --profile desktop add git+https://github.com/saber0616/dsh-grok-night-theme.git
安裝後重啓 dsh web(或按你平時的方式重啓 DSH),再刷新瀏覽器頁面。
從本地目錄安裝¶
在 DSH 的 plugin_manager 中使用 install_bundle,target 指向本倉庫絕對路徑:
install_bundle target: /absolute/path/to/dsh-grok-night-theme
卸載¶
dsh plugin --profile desktop remove dsh-grok-night-theme
或在「設置 → 插件」裏停用/移除該 bundle。
典型用法與自定義¶
日常使用¶
安裝並刷新後,無需額外配置:切換 DSH 外觀即可在 Grok Day 與 Grok Night 之間切換,空白新會話頁會顯示機器人標記。
改色¶
所有色值集中在 client.js 的 TOKENS 對象,按 { light, dark } 成對聲明。修改後重新加載插件或重啓 DSH Web 即可;新增 token 時追加同名鍵,主題層會原樣寫入 CSS 變量。
兼容性與注意¶
- 開發與驗證環境爲 DSH
0.2.1-rc.5的 desktop profile,依賴ctx.theme.overrideTokens()與conversation.hero.brand.mark槽位。 - 與其它使用
overrideTokens的皮膚插件可共存:本插件在每次theme/change時重新置頂已設置的 token;未設置的 token 仍由宿主或其它插件決定。 - 若同時啓用帶壁紙/玻璃材質的皮膚,對方自定義 token 仍可能參與渲染;若要純 Grok Night 畫布,可暫時停用其它皮膚插件。
倉庫結構(節選)¶
| 文件 | 作用 |
|---|---|
client.js |
Web Client:token 疊加層 + 機器人標記 |
index.js |
Host 側 Loader |
cordis.patch.yml |
插件行插入 |
locale/en.json、locale/zh.json |
插件管理器文案 |
icon.svg |
插件圖標 |
package.json 中版本爲 1.0.0,許可證 MIT。
結尾¶
dsh-grok-night-theme 把 Grok Night / Grok Day 的暖炭與琥珀氣質收斂成一枚可逆的 DSH Web 主題疊加層,適合希望在 Harness 裏統一明暗兩套剋制配色的開發者。插件目錄頁與源碼分別見:
- 目錄頁:https://www.skillhub.cn/plugins/saber0616/dsh-grok-night-theme
- GitHub:https://github.com/saber0616/dsh-grok-night-theme