前言¶

DeepSeek Harness（dsh）是 DeepSeek AI 開源的智能體運行時，架構口號是「一切皆插件」：模型、工具、會話、UI 都可以用插件替換或疊加，而不必改 Harness 源碼。官方倉庫當前仍標爲 developer preview，默認用下面這條命令就能拉起網頁界面，地址一般是 http://127.0.0.1:3080：

npx @deepseek-ai/dsh web

界面能用之後，下一層需求往往是外觀。頂欄、側邊欄、輸入框、統計行、軌跡視圖都是工作區裏停留最久的幾塊區域，原生樣式偏「能幹活」，想做成磨砂玻璃，通常要麼去改前端源碼，要麼裝一套會動佈局的皮膚。前者升級時容易衝突，後者可能把其他插件的面板擠亂。

DSH-Transparent-UI-Plugin 走的是第三條路：在網頁端外面再套一層玻璃材質。模糊度、磨砂度、背景都可以在設置裏調；關掉總開關，界面回到原生樣子。社區插件目錄把它歸在「主題與外觀」。需要說明的是，DeepSeek Harness 插件庫 是獨立的社區站點，和 DeepSeek / 幻方沒有官方從屬關係，不要把它當成官方應用商店。

這是什麼¶

一句話定位：DSH-Transparent-UI-Plugin 是套在 DeepSeek Harness 網頁端上的玻璃質感主題。維護者是 GitHub 用戶 WYH66666666，倉庫採用 MIT 許可證，版權頁署名爲 John Wu。目錄頁與 package.json 都標明主要語言是 JavaScript。

倉庫內部的 npm 包名是 @deepseek-ai/dsh-client-ui-aqua，README 裏簡稱 Aqua，設置頁總開關的文案是「玻璃主題」。這個 @deepseek-ai/ 作用域只是包名，插件本身由社區維護，不是 DeepSeek 官方主題。package.json 裏 dsh.client.platform 寫的是 web，對等依賴指向 @deepseek-ai/dsh-client-* 的 ^0.1.0-rc.5，也就是說它掛在 Web UI 這一側，不覆蓋終端 TUI。

截至 2026 年 8 月 17 日，GitHub API 顯示該倉庫 177 星、最新正式版 v1.3.0（2026-08-16 發佈）。社區目錄頁同期仍顯示 19 星，和倉庫即時數據不一致，星標以 GitHub 爲準。

它要解決的問題很具體：在不改 DSH 任何一行源碼的前提下，把頂欄、側邊欄、輸入框、統計行、軌跡視圖變成可調的磨砂玻璃，並允許用流體、圖片或視頻當背景。

核心功能與亮點¶

下面能力來自倉庫 README / README.zh.md 和 CHANGELOG，以當前最新版 v1.3.0 爲準。README 對 v1.2 之後的幾項（懸停下壓、鼠標輝光、視頻壁紙等）更新較慢，這些以 CHANGELOG 爲準。

1、雲母效果和兼容模式¶

主題提供兩種模式：

• 雲母效果（早期版本叫「漂浮玻璃」）：把佈局改成懸浮玻璃卡片，模糊度、磨砂度可調。頂欄、側邊欄、發送框、統計行、軌跡視圖各自成片，聊天區在背景上滑動。
• 兼容模式：原版排版保持一字不動，只把材質換成通用玻璃。README 寫明它按角色和類名子串命中菜單、卡片、氣泡、下拉、提示等表面，其他插件的界面也會自動玻璃化。

v1.2.0 的 CHANGELOG 還記過一次兼容模式修復：注入層不再頂歪頂欄、新建會話按鈕和發送欄。如果裝了側邊欄、看板一類會往頁面裏塞控件的插件，優先用兼容模式更穩妥。

2、流體、圖片和視頻三種背景¶

背景有三條路：

1. 流體板：一塊會動的背景，顏色可調。v1.2.0 起拆成「色調」「顏色深淺」兩條滑桿：0°/360° 錨定藍色，默認色調 320°（青藍）；深淺從濃到粉彩無極調節。
2. 圖片壁紙：鋪滿頁面、保持比例，可單獨調模糊度和磨砂度。圖片會壓縮後存在本地。README 建議淺色壁紙配淺色模式、深色壁紙配深色模式。
3. 視頻壁紙（v1.3.0）：用瀏覽器原生解碼，循環播放、鋪滿裁剪，窗口縮放會跟着適配。Chromium 內核下可用 File System Access「記住文件授權」，刷新後自動讀回原文件；非 Chromium 會退回數據庫存儲。CHANGELOG 寫明視頻上會加自動柔光罩，聊天氣泡改實底，避免字看不清。

背景亮度跟當前深淺色走：深色模式只能在 0–50 壓暗，淺色模式只能在 50–100 提亮，50 表示不改。選「跟隨系統」時，旋鈕範圍會按實際解析出的模式翻轉。

3、玻璃旋鈕和出廠默認值¶

雲母模式下，玻璃本身有模糊度、磨砂度兩條旋鈕。v1.2.0 給出的出廠默認是：

• 模糊 20
• 磨砂 7
• 色調 320
• 深淺 25
• 亮度 50
• 相關開關默認開啓

v1.3.0 還把發送欄和數據欄收成一塊玻璃：同一套背景、模糊、邊框和投影，分界線落在左右圓角彎曲處，避免兩片玻璃模糊度對不齊。數據欄文字和發送欄佔位符改成中性色（深色近白、淺色深灰），去掉原來的藍色調。

4、裝飾層：粒子鯨魚、小魚、邊緣模糊、銘牌¶

這些都可以在設置裏關掉，不是主題本體：

• 粒子鯨魚：README 寫的是 deepseek.com/harness 同款粒子魚的 2D 移植，放在聊天主區域正中央（不含側邊欄）。深色模式白粒子，淺色模式灰粒子。
• 小魚（v1.1.2）：背景裏遊動的小魚/氣泡，開關在粒子鯨魚旁邊。
• Harness 光澤銘牌：僅深色模式生效，側邊欄銘牌換成官網同款藥丸（135° 漸變描邊 + 柔光）；淺色模式保持原版。
• 邊緣漸變模糊：頁面頂部和底部各 5px 漸變模糊帶，浮在聊天內容上層，滾到邊緣會融進去。淺色微泛白，深色微泛黑。

v1.2.0 另外加了兩組懸停效果，設置裏單獨分組：

• 鼠標輝光：光標附近一層熒光光暈，畫在玻璃下面從磨砂裏透出來，不擋內容。v1.2.1 起顏色跟隨「色調」滑桿。
• 懸停下壓：官網卡片同款 3D 傾斜（哪邊有鼠標哪邊下壓，透視 800px，微放大 1.01，0.1s 過渡）。頂欄、側邊欄、發送框+數據欄、軌跡窗用同一配方，軌跡窗幅度減半。

5、一鍵開關，關掉就回到原生界面¶

總開關打開後主題默認生效；關掉之後，README 的表述是「完全還原原生界面」，效果隨插件卸載一起消失。總開關在「設置 → 插件 → 玻璃主題」，形狀和其他插件卡片一樣。其餘旋鈕都在「設置 → 通用設置 → 外觀」正下方，沒有單獨標題。總開關關閉時，外觀下面那一整塊調節會隱藏。

安裝與啓用¶

目錄頁給出的安裝命令如下，在已經裝好 dsh CLI 的終端裏執行即可。命令以目錄頁原文爲準，不要自己拼接倉庫名：

dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin

需要可復現安裝時，按目錄頁說明把 commit 哈希釘死：

dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin#<commit>

把 <commit> 換成倉庫裏實際的提交哈希。dsh 官方文檔裏，GitHub 源安裝走的是 pnpm；若第一次 add 被 pnpm ≥10 攔住 prepare 腳本，按終端提示把對應包名寫進當前 profile 的 pnpm-workspace.yaml 的 allowBuilds，再執行一次 add。

Windows 用戶如果更想用倉庫自帶的安裝器，README 提供了一條 PowerShell 命令，默認裝最新 Release，不強制本機有 git（會退回到 zip 下載）。腳本會把插件鏈到 profile 的 node_modules，並在 cordis.patch.yml 裏登記 ui-aqua，重複執行不會重複登記：

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest 'https://github.com/WYH66666666/DSH-Transparent-UI-Plugin/raw/main/install.ps1' -OutFile install.ps1; .\install.ps1"

指定版本或跟蹤開發分支：

.\install.ps1 -Version 'v1.3.0'
.\install.ps1 -Version 'main'

README 裏 macOS / Linux 的示例仍寫着 --branch v1.1.0，而當前最新正式版已經是 v1.3.0。跨平臺更穩妥的做法是優先用上面的 dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin。裝好後刷新 Web 界面即可。

典型用法¶

刷新網頁後，Aqua 默認是開着的。按 README 的路徑操作：

1. 打開 設置 → 插件 → 玻璃主題，確認總開關爲開啓。關掉它，外觀頁那一組旋鈕會一起消失，界面回到原生。
2. 打開 設置 → 通用設置 → 外觀，在外觀區塊正下方調節：
   - 模式：雲母效果 / 兼容模式
   - 模糊度、磨砂度（雲母模式）
   - 流體色調、顏色深淺
   - 背景亮度
   - 背景類型：流體 / 壁紙（含圖片、以及 v1.3.0 的視頻）
   - 壁紙自己的模糊、磨砂、刪除按鈕
   - 粒子鯨魚、小魚
   - 鼠標輝光、懸停下壓
3. 先在默認值附近試：模糊 20、磨砂 7、色調 320、深淺 25、亮度 50。背景太搶眼就先把亮度往 50 收，或把壁紙模糊拉高。
4. 如果同時裝了會改 DOM 的界面插件，先切到兼容模式，確認其他插件的按鈕、面板還在原位，再決定要不要用雲母效果改佈局。
5. 用視頻壁紙時，CHANGELOG 建議在 Chromium 內核瀏覽器裏授權一次本地文件，這樣刷新後不用重新選；氣泡在視頻上是實底，這是有意爲之，不是顯示故障。

設置頁本身在 v1.2.0 之後也會玻璃化（約 50px 磨砂，區分深淺色，兼容模式生效）。裝飾和懸停效果在設置裏分成兩組，可以整組關掉，只留玻璃材質。

適用場景與注意事項¶

適合這幾類用法：

• 日常用 DSH 網頁端寫代碼、看軌跡，希望界面接近磨砂玻璃，但不想 fork 前端。
• 已經裝了側邊欄、看板、皮膚類插件，只想換材質、儘量不動排版——用兼容模式。
• 想用自己的壁紙或循環視頻當工作區背景，並且能單獨調模糊和亮度。

使用前注意下面幾條：

1. 只覆蓋 Web UI。 package.json 聲明 platform: "web"。終端 TUI、桌面套殼如果沒用這份網頁界面，裝了也不會出現玻璃主題。
2. 對等依賴是 ^0.1.0-rc.5。 DSH 仍在 developer preview，官方 README 寫明會有破壞性變更。升級 Harness 之後如果主題錯位或開關消失，先覈對插件版本和 Web UI 版本是否還匹配。
3. 包名裏的 @deepseek-ai/ 不代表官方出品。 維護者是 WYH66666666，許可證 MIT。安裝前應自己打開倉庫看源碼和 LICENSE。
4. 插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。目錄頁也寫了同一句警告。社區目錄只是索引，不代替你做安全審查。需要可復現環境時，用 #<commit> 釘死版本，避免後續 push 悄悄改掉正在跑的代碼。
5. README 的 macOS 示例仍釘在 v1.1.0，缺粒子鯨魚之後的多項能力。不要照抄過期分支號；以 GitHub Release 的 v1.3.0 或 dsh plugin add 解析到的當前默認版本爲準。
6. 粒子鯨魚、小魚、懸停下壓、視頻壁紙在設置裏都有獨立開關。不需要這些裝飾時可以關掉，只留玻璃材質；倉庫沒有提供性能基準，是否卡頓以本機 Web UI 實測爲準。

小結¶

DSH-Transparent-UI-Plugin 做的事情很收束：給 DSH 網頁端加一層可開關的玻璃主題，佈局可以改成雲母卡片，也可以只換材質。背景支持流體、圖片和視頻，旋鈕都在「外觀」下面，關掉總開關就回到原生界面，不改 Harness 源碼。

它是社區 MIT 項目，不是官方皮膚。裝之前看一眼源碼和許可證，安裝命令用目錄頁這一條即可：

dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-transparent-ui-plugin/

GitHub：https://github.com/WYH66666666/DSH-Transparent-UI-Plugin