前言¶

DSH 的插件結構允許把界面能力拆成獨立插件。dsh-ui-skin 解決的是一個具體問題：給 DeepSeek Harness 加壁紙或視頻背景，同時讓界面和側欄的表層背景透出。下面介紹它的定位、安裝方式、用法和安全邊界。

定位¶

dsh-ui-skin 是面向 DeepSeek Harness 的 UI 皮膚插件，包名爲 dsh-ui-skin，版本爲 1.0.0，許可證爲 MIT。GitHub 倉庫地址爲：

https://github.com/huabai-flowerwhite/dsh-ui-skin

它主要做兩件事：

• 在 UI 下方注入壁紙 / 視頻背景。
• 把 DSH 整個界面（含側欄）的表面背景烘焙爲半透明（毛玻璃），讓皮膚透出。

核心功能¶

• 在 UI 下方注入壁紙 / 視頻背景。
• 把 DSH 整個界面（含側欄）的表面背景烘焙爲半透明（毛玻璃）。
• 支持拖動裁剪縮放。
• 歷史皮膚記錄。
• 可拖動懸浮窗。
• 自定義皮膚支持網絡地址或本地文件。
• 提供「設置 → UI 皮膚」設置頁。
• 提供 skin_list 只讀工具。
• 提供 /dsh-ui-skin/skins 本地路由。
• 本地圖片壓縮後存 localStorage，本地視頻存 IndexedDB。

安裝與啓用¶

先安裝插件，再重啓 dsh。按系統選擇倉庫提供的安裝命令。

Linux / macOS（bash）：

cd dsh-ui-skin
bash install.sh

Windows（PowerShell）：

cd dsh-ui-skin
powershell -ExecutionPolicy Bypass -File install.ps1

安裝完成後，打開：

設置 → UI 皮膚

皮膚與參數配置持久化到瀏覽器 localStorage。

典型用法¶

1、安裝後重啓 dsh，打開「設置 → UI 皮膚」切換皮膚與參數。

2、「自定義」裏可填網絡地址，或點「選擇圖片/視頻」從本地文件夾選取。

3、在預覽區拖動裁剪位置，滾輪縮放。

4、上傳後會進入「歷史皮膚」。

5、點「展開懸浮窗」彈出可拖動快捷面板。

在聊天框中可調用 skin_list 查看皮膚清單：

skin_list

皮膚清單¶

運行環境¶

已覈實的運行與兼容要求如下：

engines: node >=22 <25
compatibility: apiLevel 1, harness >=0.1.0-rc.7

插件包含的 Host 側能力包括：

skin_list
/dsh-ui-skin/skins

其中 skin_list 是隻讀工具，/dsh-ui-skin/skins 是本地路由。

安全與注意¶

已覈實的安全邊界如下：

• Security Level S1 / Permission Level P1：只讀 Host 工具 + 本地路由 + 純 UI。
• 不讀不寫文件。
• 不發外部網絡。
• 不跑 shell/subprocess。
• 不含密鑰。

使用自定義皮膚時，需要注意：

• custom 皮膚的網絡 URL 需瀏覽器可訪問。
• 插件自身不發外部網絡。
• 本地圖片壓縮爲 JPEG（0.85，1920px 寬）後存 localStorage，受站點配額約束。
• 本地視頻存 IndexedDB。
• 側欄半透明 0.6 是整個界面透出與文字可讀的折中。
• 裁剪縮放只放大不縮小，範圍爲 scale 1.0–4.0。

插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

未實現與已知限制¶

• Agent 反應式強度與 WebGL/Shader 渲染未實現。
• dshpd_analyze 是啓發式掃描，會誤報嵌套 manifest 的 plugin.id 等字段。

結尾¶

dsh-ui-skin 適合用於 DSH 的 UI 皮膚場景：在界面下方加壁紙或視頻背景，並把整個界面表層烘焙成半透明，讓背景透出。

社區目錄是獨立站點；本文未提供已覈實的目錄頁地址。

GitHub：

https://github.com/huabai-flowerwhite/dsh-ui-skin