前言¶
DeepSeek Harness (DSH) 採用了插件化架構，允許開發者通過擴展功能來增強客戶端體驗。在實際使用或開發中，如果需要調整界面風格以適應特定場景（如模擬特定聊天環境或進行 UI 調研），直接修改核心代碼往往成本較高。下面介紹 lispking/dsh-qq-skin，它通過覆蓋主題 Token 和注入佈局層，爲 DSH Web 客戶端提供原生的 QQ 消息器風格。
插件介紹¶
這是一個面向 DeepSeek Harness (dsh) 的 QQ NT 消息器皮膚插件，由開發者 lispking 維護。它通過雙層結構實現 UI 風格切換：不註冊新的主題 ID，而是直接覆蓋現有的語義 Token（Token layer），並通過全局 CSS 注入調整佈局（Layout layer）。淺色模式追求乾淨剋制，深色模式則爲冷靜的藍灰色調。
核心功能¶
- 雙層架構與零干擾：插件包含 Token 層和佈局層兩層。卸載時會通過效果清理完全移除，使產品外觀恢復默認。它不會觸碰用戶的淺色/深色/系統跟隨偏好設置。
- 五種配色方案：內置 Classic Blue（經典藍）、Vivid Purple（生動紫）、Clean White（純淨白）、Green Bubble（綠氣泡）、Deep Black（深黑）五種變體。
- 可配置開關：支持調節配色方案、氣泡尾巴形狀、助手頭像顯示、聊天流最大寬度。
- 熱重載：通過設置面板修改配置後，無需重啓插件即可立即重新應用兩層樣式。
安裝與啓用¶
在終端中執行以下命令，將插件安裝到 web profile：
dsh plugin --profile web add dsh-qq-skin
dsh plugin 命令會初始化 profile、在 profile 目錄運行 pnpm add，並將插件的 bundle layer 與當前已安裝狀態合併。插件聲明瞭 dsh.client 與 dsh.bundle.patch，因此 dsh web 啓動時會自動加載客戶端包並在 ui-theme 激活時應用皮膚。
配置與用法¶
插件接收 Cordis 函數插件格式的配置對象 (apply(ctx, config))，未設置的字段會回退到默認值。
| 配置項 | 默認值 | 說明 |
|---|---|---|
palette |
'classic' |
配色方案：classic (經典藍) / vivid (生動紫) / clean (純淨白) / green (綠氣泡) / black (深黑) |
bubbleTail |
true |
用戶氣泡右側的小三角尾巴 |
assistantAvatar |
true |
助手消息左側的企鵝頭像圓盤 |
chatMaxWidth |
880 |
聊天流的最大寬度（像素） |
配置示例（可在 profile 的插件配置中設置）：
{ "palette": "vivid", "bubbleTail": false, "chatMaxWidth": 720 }
注意事項¶
- 依賴版本：需要安裝
deepseek-harness (dsh) 0.1.2-alpha.5或更高版本。 - 生態背景：DSH 的插件生態獨立於 DeepSeek 官方，社區目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係。
- 權限與安全：插件以當前 DSH 進程權限運行，安裝前建議查閱源碼與許可證。
結語¶
lispking/dsh-qq-skin 提供了一種低侵入性的 UI 定製方案，通過熱重載和配置化的設計，使得開發者可以快速切換界面風格。更多細節與源碼，可參考以下鏈接：GitHub 倉庫 | 插件目錄。
