前言¶
DeepSeek Harness (DSH) Web GUI 的默認界面可能無法滿足所有開發場景下的審美或功能需求。dsh-stzb 插件爲 DSH Web 提供了一套自定義主題方案,模仿了兩種風格:暗色「鐵血戰場」與亮色「水墨古風」。
這是什麼¶
dsh-stzb 是一個純客戶端插件,由 weijunliang23 維護。它通過覆蓋設計令牌來改變界面外觀,不依賴 React,且不包含任何遊戲素材或官方資源。所有視覺素材均由 SVG/CSS 代碼生成,無第三方圖片,無版權風險。
核心功能¶
- 令牌級換膚:覆蓋
--dsw-*全套設計令牌(約 115 項),支持淺色/深色兩套配色。 - 全局樣式:宋體系襯線字體、宣紙/墨染畫布紋理、古風滾動條與選區樣式。
- 裝飾層:包含頂部青銅金線、左上回紋角飾、右上「率土之濱」印璽及全屏墨韻暗角。所有裝飾層設置爲
pointer-events: none,不影響交互。 - 系統適配:跟隨系統偏好(淺色/深色/跟隨系統)自動切換配色。
安裝與啓用¶
安裝命令如下:
dsh plugin --profile web add github:weijunliang23/dsh-stzb
安裝後立即生效,無需改動 DSH 本體。
典型用法¶
- 預覽效果:在項目根目錄下雙擊
preview.html,即可在瀏覽器中查看皮膚效果(包含淺色/深色/跟隨系統切換)。 - 開發修改:修改
src/tokens.js或src/skin.css源碼後,運行npm run build重新生成。
技術原理¶
插件採用零 React 依賴架構。通過 ctx.theme.overrideTokens 疊加令牌層,配合注入的 DOM 節點和純 CSS 實現裝飾層。宿主會掃描 loader 條目並注入引導圖,隨後將活躍主題的令牌寫入 body 內聯 CSS 變量。
適用場景¶
適合 DSH Web 用戶希望在不修改 DSH 本體代碼的情況下,快速切換界面風格,或進行自定義主題開發的場景。