前言¶
DeepSeek Harness（dsh）是 DeepSeek 開源的智能體運行時，官方倉庫把架構概括成一句話：一切皆插件。Web UI 默認就能完成模型配置、工作區選擇和會話，外觀則主要跟隨內置主題。如果只想改配色、加一層角落光暈、換一張背景圖或循環視頻，不必上整套角色皮膚；社區插件 dsh-gui-customization 把這些選項收進「設置 → 界面設定」。
需要先分清兩件事。DeepSeek Harness 本身由 DeepSeek 發佈；插件目錄站點 deepseek-harness-plugin.com 是獨立的社區索引，與 DeepSeek / 幻方沒有官方從屬關係。下面的功能、安裝命令和版本號，均以該目錄頁、插件 GitHub 倉庫、npm 包以及 deepseek-ai/deepseek-harness 交叉覈對爲準。
這是什麼¶
dsh-gui-customization 是面向 DeepSeek Harness Web UI 的主題定製插件，由 LAN-TINA-WS 維護，許可證 MIT，主要語言 TypeScript。目錄分類爲「主題與外觀」。倉庫自稱「時裝工坊」：改主題配色、自定義圖片或視頻背景、調節氛圍燈，界面中英雙語。
它和鯨魚娘皮膚、桌寵不是同一類東西。能力集中在設置面板裏的配色、光暈和背景，而不是替換整套角色立繪。package.json 裏 dsh.client.platform 聲明爲 web，只掛網頁界面。
當前發佈版本在 npm 與 GitHub Release 上均爲 0.6.2（2026-08-16 發佈）。GitHub 倉庫在 2026-08-17 覈實爲 14 星；社區目錄頁當時顯示 10 星，星標以倉庫頁面爲準。
核心功能¶
倉庫根目錄 README 與 CHANGELOG 對能力的描述可以對照如下。包內 packages/dsh-gui-customization/README.md 仍留有較早的臺賬和待辦，其中「明暗分離編輯」「導入/導出」等條目已被後續版本實現，下文以根 README、CHANGELOG 和 0.6.2 發佈說明爲準。
配色¶
- 默認主題是 Nous 藍，帶明暗雙模式。
- 四套預設一鍵切換：系統默認、Nous 藍、靛紫、翡翠綠。
- 另有 13 個主題色字段，取色器與文本輸入都可以改，點「應用配色」生效。
- CHANGELOG 0.6.0 起，深色主題有一套獨立的 13 色；預設會把深色盤重置爲配套方案，導出、導入和持久化同時攜帶明暗兩套。
氛圍光¶
角落光暈跟隨主題主色。設置項包括開關、強度、呼吸幅度，以及 5 種位置模式，改完即時生效，不用刷新頁面。
動態背景¶
- 圖片：用系統文件選擇對話框選本地圖；README 寫明內置預設「deepseek娘01」，CHANGELOG 0.5.2 又加入「deepseek娘02」「deepseek娘03」。
- 視頻：同樣走原生文件選擇，靜音循環播放。
- 圖片與視頻互斥，只能開一種。
- 主對話區會透出背景，並帶一層隨明暗變化的遮罩。
- 背景透明度滑塊（CHANGELOG 0.5.0 記錄範圍爲 10%–90%）和側邊欄透明開關。
- 背景文件存在瀏覽器 IndexedDB 裏，刷新頁面或重啓 dsh 後仍能恢復。
CHANGELOG 還記了兩處實際使用時會碰到的修復：0.5.1 起大圖改走 Blob URL，避免部分瀏覽器丟棄大約 2 MB 以上的 CSS data URL；0.5.3 修復了深色主題下背景圖/視頻/預設透不出來的問題（由 FuturePioneer-3 提交）。
導入、導出與持久化¶
配色方案可以導出爲 JSON，並自動複製到剪貼板；把 JSON 粘貼回去即可導入應用。界面文案隨 DSH 的中/英文設置切換。設置項走 localStorage，背景走 IndexedDB。插件是組合插件形態，重啓後仍在，並出現在「設置 → 插件」。
安裝與啓用¶
DeepSeek Harness 目前仍是 developer preview，官方 README 寫明可能出現破壞性變更。本機還沒有 CLI 時，可以按官方倉庫的方式先拉起 Web UI：
npx @deepseek-ai/dsh web
默認地址是 http://127.0.0.1:3080。
社區目錄頁給出的安裝命令原文如下，在 DeepSeek Harness 終端中運行即可：
dsh plugin add github:LAN-TINA-WS/dsh-gui-customization
該倉庫是 pnpm monorepo，插件本體在 packages/dsh-gui-customization。根目錄 README 與 v0.6.2 Release 說明都推薦帶上 web profile 和子目錄路徑（倉庫稱國內網絡下這條比等 npm 更快）：
dsh plugin --profile web add github:LAN-TINA-WS/dsh-gui-customization#path:packages/dsh-gui-customization
也可以從 npm 安裝同名包（當前版本同樣是 0.6.2）：
dsh plugin --profile web add dsh-gui-customization
或者從 Releases 下載 dsh-gui-customization-v0.6.2.zip，解壓後用本地 link 安裝。README 裏的解壓目錄示例仍寫着舊版 v0.5.2，以最新 Release 文件名爲準：
dsh plugin --profile web add link:<解壓目錄>/dsh-gui-customization-v0.6.2
目錄頁還給出了固定 commit 的寫法，把 #commit 換成實際哈希即可復現安裝：
dsh plugin add github:LAN-TINA-WS/dsh-gui-customization#commit
無論用哪一種方式，安裝後都需要重啓 dsh web，再打開「設置 → 界面設定」配置。從 GitHub 安裝源碼時，pnpm 可能要求先允許該包的構建腳本，只對你審查過的倉庫放行。
配置與使用¶
打開 Web UI 的「設置 → 界面設定」，區塊與 README 配置表一致。
-
預設配色
先在「系統默認 / Nous 藍 / 靛紫 / 翡翠綠」裏選一套，確認明暗模式切換後顏色是否符合預期。CHANGELOG 0.6.1 修過一個回讀問題：應用靛紫、翡翠綠或自定義色後再打開設置，高亮不再錯誤地停在「Nous 藍」。 -
自定義顏色
改 13 個主題色字段，點「應用配色」。若同時使用明暗主題，按 0.6.0 的說明把深色盤單獨編好，再導出備份。 -
導入 / 導出
導出後剪貼板裏會有一份 JSON，可以留給自己下次重裝，或貼進 issue 裏分享。導入即應用，不需要再點一遍預設。 -
氛圍光
打開開關後調強度、呼吸幅度和位置。這幾項都是即時生效，適合邊看主界面邊微調。 -
背景圖 / 視頻
選本地圖片、用內置「deepseek娘」預設，或選一段視頻（靜音循環）。圖片和視頻不要同時開。透明度滑塊控制背景露多少，側邊欄透明開關單獨控制側欄是否透底。
改完刷新一次頁面，確認配色和背景都還在。設置在 localStorage，背景在 IndexedDB，按倉庫說明應能跨重啓恢復。
適用場景與注意事項¶
適合已經在用 DSH Web UI、只想改外觀、又不想換整套皮膚包的人。日常可以先套 Nous 藍或靛紫，再決定要不要上背景圖；需要把同一套配色同步到另一臺機器時，用 JSON 導出即可。它不提供桌寵、角色立繪或側邊欄工作臺，那些是目錄裏其他「主題與外觀 / 界面增強」插件的範圍。
使用前注意下面幾條：
- 插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前應檢查源代碼倉庫和許可證；需要可復現安裝時，固定 commit 哈希。
- 這是社區開源項目，MIT 許可。倉庫說明
build/下的 tsdown 構建 preset 源自 dsh-web-ui（BSD-3-Clause），許可聲明留在對應文件頭部。 - 只作用於 Web UI，不能拿來改終端 TUI 或其他 profile 的外觀。
- 背景文件存在本機瀏覽器存儲裏，換瀏覽器或清站點數據後需要重新選擇。
- DeepSeek Harness 仍在快速迭代，第三方主題插件可能隨宿主 API 變化而失效，升級 dsh 後如果界面設定消失，先覈對插件是否仍加載。
問題、需求和配色分享，倉庫指向 issue #1。
小結¶
dsh-gui-customization 把 DSH 網頁界面的換裝收成一組可持久化的設置：Nous 藍等預設、13 色自定義、氛圍光，以及圖片/視頻背景。它不是官方皮膚商店裏的貨架商品，而是 MIT 許可的社區組合插件，配置入口就在「設置 → 界面設定」。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-gui-customization/
GitHub：https://github.com/LAN-TINA-WS/dsh-gui-customization
