前言¶
DeepSeek Harness(DSH)默認只提供中性色系,想要更換整套界面風格,需要手動修改大量哈希類名,或者爲每套新主題準備獨立樣式表——一旦 Harness 自身更新,這些自定義樣式就會失效。大正墨染主題通過主題令牌(theme tokens)和覆蓋層(overlay)的方式,在不觸碰宿主佈局的前提下,替換界面調色板,並增加氛圍層與品牌標識。
這是什麼¶
大正墨染主題是爲 DeepSeek Harness Web UI 設計的一套日式大正時期水墨與硃紅配色主題。由維護者 xbbkok 提供,作爲 DSH 插件發佈,用於替代默認中性調色板,同時提供浮動的氛圍層(飄動的餘燼、紫藤花瓣、和道標太陽紋)。
核心功能¶
- 14 個主題令牌覆蓋:包括基礎背景、層級背景、邊框、品牌主色、標籤、狀態色、側邊欄填充等。
- 亮/暗兩種調色板:隨 Appearance 切換自動生效。
- 氛圍層:18 個向上飄動的餘燼、10 片向下飄落的紫藤花瓣,純 CSS 實現,不依賴腳本動畫。
- 品牌標識:在空白會話標題前展示和道標太陽紋(nichirin-sun crest)。
- 細節優化:紅色文本選擇、圓角品牌色滾動條。
- 可訪問性:在
prefers-reduced-motion: reduce時停止動畫。 - 多語言:插件管理器標題與描述支持英文和中文,插件列表行跟隨 DSH 語言設置。
- 自包含:無圖片、無字體、無網絡請求、無本地存儲,僅包含令牌、CSS 和內聯 SVG。
安裝與啓用¶
通過官方 CLI 以 bundle 方式安裝:
dsh plugin --profile web add github:xbbkok/dsh-taisho-ink
在桌面應用上使用 --profile desktop,安裝後重新打開 DSH。
典型用法¶
安裝後無需額外配置,主題立即生效:
- 打開 Settings → Plugins,確認
dsh-taisho-ink插件行已啓用。 - 在 Appearance 中切換 Light / Dark / System,主題會同步切換對應的調色板。
- 要恢復默認調色板,請禁用或移除該 bundle。
工作原理¶
瀏覽器端在 apply 中註冊三項內容:
- 通過
ctx.theme.overrideTokens('dsh-taisho-ink', TOKENS)覆蓋 14 個 alias 令牌(light / dark 對),並在卸載時移除。 - 在
shell.overlay下添加dsh-taisho-ink.atmosphere條目,渲染氛圍層(餘燼、花瓣、和道標太陽紋),該組件隨插件銷燬。 - 在
conversation.hero.brand.mark處插入和道標太陽紋,顯示在空白會話標題前。
插件不修改宿主 DOM 結構,不依賴宿主服務或路由,不存儲或拉取外部資源。
兼容性¶
- DeepSeek Harness 0.2.x,Web 客戶端(桌面與瀏覽器)。
- 使用 slot:
shell.overlay、conversation.hero.brand.mark。 - 不註冊任何 Host 服務、路由、工具或設置項。
注意事項¶
- 插件以當前 DSH 進程權限運行,安裝前建議查看源碼與許可證。
- 若宿主 Harness 更新導致令牌結構變更,可能需要同步更新。
價值與鏈接¶
大正墨染主題在不侵入宿主佈局的前提下,提供了一套可複用、可維護的日式水墨風格調色板與氛圍層,適合希望爲 DSH 換膚的開發者或體驗升級的用戶。
- 目錄頁:https://www.skillhub.cn/plugins/xbbkok/dsh-taisho-ink
- GitHub:https://github.com/xbbkok/dsh-taisho-ink