DeepSeek Harness (DSH) 插件介紹：dsh-trae-skin

前言¶

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。除了功能擴展，開發者往往也需要定製界面風格以適應不同的工作流或個人偏好。dsh-trae-skin 是一個純皮膚插件，它不改變 DSH 的任何業務邏輯，僅通過覆蓋樣式變量和 DOM 結構，將 Web GUI 換成一套近黑紙面、薄荷綠強調色、帶漸變字標狀態帶的視覺風格。

是什麼¶

dsh-trae-skin 是一個由 RonnyJung2021 維護的 MIT 協議插件。它的核心作用是“整頁換膚”，基於 DSH Web GUI 的官方文檔接口（--dsw-* token），重寫了約 93 個頁面的顏色與樣式定義。它不依賴外部字體文件或圖片資源，所有樣式通過純 CSS 變量和少量內聯腳本實現，產物體積控制在 45.7 KB 左右。

主要功能¶

整頁換膚¶

插件只通過產品已有的文檔化 token 進行改色，不觸碰頁面結構，也不修改生成的 CSS-module 類名。它覆蓋了頁面底色、抬升面（菜單、代碼塊）、正文、次級文字以及邊框和遮罩層。

三檔配色¶

插件提供三檔配色方案：
* 深色：默認方案，頁面底色爲近黑（#0a0b0d），強調色爲薄荷綠。
* 淺色：頁面底色爲純白，強調色自動適配。
* 跟隨產品：配色跟隨 DSH 引擎自身的明暗設置。當引擎切換明暗模式時，皮膚會自動重繪。

一個輸入框 → 一整套安全色¶

在設置面板中，你只需提供一個十六進制顏色值（默認爲 #32f08c）。插件會根據這個主色，自動派生出填充色、Hover 狀態色、12% 底色、用於文字顯示的可讀色以及兩套漸變色。派生出的文字顏色會經過 WCAG AA 標準的對比度校驗（淺色底白字、深色底黑字）。

頂部狀態帶¶

界面頂部固定一條 32px 的狀態帶，包含以下元素：
* 漸變字標：默認顯示 DEEPSEEK HARNESS，支持 1-24 字符的自定義。
* 指示燈：空閒時爲空心圓，輸入框聚焦或鼠標懸停時填實。
* 呼吸效果：僅在引擎報告“推理中”時呼吸脈衝；若無法讀取該信號，則變爲持續呼吸。
* 無障礙：聲明爲 role="status"，僅用於屏幕閱讀器。

細節修飾¶

幾何：統一使用 2px 或 4px 的直角，沒有中間值。
投影：使用 0.5px 的內高光與柔和投影。
禁用項：明確不使用徑向漸變、輝光、backdrop-filter 或混合模式。

插件卡片設置面板¶

在側欄的“插件”菜單中，點擊已安裝的 dsh-trae-skin 卡片，下方會展開專門的設置頁。這裏包含 10 項外觀配置，分爲“外觀”和“呼吸燈”兩組。修改後點擊保存，頁面會立即重畫。設置面板支持“恢復默認”操作，並在保存前對非法值進行校驗。

安裝與啓用¶

安裝¶

使用 DSH 命令行安裝插件：

dsh plugin --profile web add https://github.com/RonnyJung2021/dsh-trae-skin

或者在 Web GUI 中操作：側欄插件 → Add plugin → 輸入 dsh-trae-skin → Install → Enable now。

啓用與配置¶

安裝並啓用後，在側欄 插件 → 已安裝 中找到 dsh-trae-skin。
點擊卡片下方的設置頁。
調整配色、字標內容或呼吸燈參數。
點擊保存，界面即時更新。

配置項¶

配置寫入 profiles/web/cordis.patch.yml，包含以下主要項：

配置項	類型	默認值	說明
`scheme`	`dark` \| `light` \| `auto`	`dark`	外殼配色方案
`accent`	`#rgb` / `#rrggbb`	`#32f08c`	強調色，驅動整套色系
`wordmark`	string (1-24 chars)	`DEEPSEEK HARNESS`	頂部狀態帶文字
`strip`	boolean	`true`	是否顯示頂部狀態帶
`stripBare`	boolean	`false`	條帶是否僅顯示文字（不畫底）
`pulse`	boolean	`true`	推理時是否開啓呼吸
`pulseColor`	`follow` / `#rrggbb`	`follow`	光暈擴散顏色模式
`pulseScale`	number (1.2-2.4)	`1.6`	光暈擴散大小倍數
`pulsePeriodMs`	number (800-4000)	`1600`	呼吸週期（毫秒）
`pulseOpacity`	number (0.1-0.6)	`0.35`	光暈強度

卸載¶

如需移除插件，執行以下命令：

dsh plugin --profile web remove dsh-trae-skin

或在 Web GUI 的插件卡片中點擊卸載。卸載後，樣式表、狀態帶、呼吸燈效果以及配置文件中的相關條目將一併清除，界面恢復到產品自帶狀態。

注意事項¶

宿主半邊加載：宿主側的樣式只在引擎啓動時加載一次。升級插件或修改 cordis.patch.yml 後，必須重啓 DSH 引擎才能生效，刷新頁面無效。
無額外資源：插件不包含任何字體文件或圖片資源，所有圖標和字體均依賴宿主系統或 DSH 自帶資源。
環境要求：需要 DSH 版本 0.1.5-rc.2 及以上。

總結¶

dsh-trae-skin 是一個輕量級、純樣式的 DSH 外觀插件。它通過單一強調色驅動整套視覺體系，提供了深色/淺色/跟隨三檔模式，並包含一個具備呼吸效果的頂部狀態帶。對於希望將 DSH 界面統一爲特定設計風格（如參考 trae.cn）的開發者，這是一個無需重構代碼即可落地的方案。