前言¶

DSH 的“一切皆插件”讓 Web UI 的展示層可以通過插件接入。對於只想調整界面外觀、不想直接改 DSH 源碼，也不希望換膚影響其他插件佈局的開發者，可開關、可回退的主題插件是一個更穩妥的做法。

dsh-client-ui-aqua-unofficial 是 DeepSeek Harness Web UI 的非官方 Aqua 玻璃擬態主題插件，屬於社區分支，並在上游基礎上增加 DSH rc.7 兼容。

這是什麼¶

• 包名：dsh-client-ui-aqua-unofficial
• 定位：DSH Web UI 的非官方 Aqua 玻璃擬態主題插件
• 維護者：afrel1024
• 上游項目：WYH66666666/DSH-Transparent-UI-Plugin（MIT，(c) 2026 John Wu）
• 本分支變化：增加 DSH rc.7 兼容，並重命名爲非官方包名，不帶 @deepseek-ai scope
• 許可證：MIT，繼承上游項目

核心功能¶

• Mica 模式：將佈局改爲浮動玻璃卡片，blur 和 frost 可調。
• Compatibility Mode：保持原版佈局，並替換爲通用玻璃材質。
• 背景：支持流體板或自定義壁紙背景，壁紙可爲圖片/視頻。
• 背景亮度：隨明暗模式調整；暗色模式變暗，亮色模式變亮。
• 粒子效果：聊天區右側可顯示可開關的粒子鯨/魚效果。
• 徽章：暗色模式下側邊欄顯示 glossy Harness 徽章，亮色模式保留原版。
• 邊緣效果：頁面上下邊緣有 5px 漸變模糊漸隱帶。
• 回退：關閉插件可完全恢復原版 UI，並移除所有效果。
• rc.7 兼容：v1.4.0+ 增加 DSH rc.7 兼容，涉及 keyed slot / aqua 設置命名空間。

安裝與啓用¶

推薦安裝命令：

dsh plugin --profile web add dsh-client-ui-aqua-unofficial

執行後重載 Web UI。v1.4.1+ 自帶 dsh.bundle 補丁，dsh plugin add 可自動註冊；v1.4.0 需要手工向 cordis.patch.yml 添加 ui-aqua 行。

如果不使用上面的包安裝命令，可以使用 GitHub fallback。

Windows 可執行 install.ps1：

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

macOS/Linux 可按下面步驟手動接入：

1、git clone 倉庫：

git clone https://github.com/afrel1024/dsh-client-ui-aqua-unofficial

2、創建 symlink。

3、在 cordis.patch.yml 添加 id: ui-aqua 的配置。

典型用法¶

• 安裝並重載 Web UI 後，Aqua 默認開啓。
• 總開關位於 Settings → Plugins → Glass theme。
• 其他控制位於 Settings → General → Appearance：
• mode
• blur/frost（Mica）
• fluid color
• background brightness
• backdrop 與 particle-whale toggle
• 關閉總開關後，Appearance 下的整個控制塊會隱藏。
• 關閉插件後，可恢復原版 UI 並移除所有效果。

適用場景與注意¶

適合需要在 DSH Web UI 上使用玻璃擬態主題、自定義背景、保留原版佈局，或希望隨時回退到原版界面的場景。

需要注意：

• 非官方社區第三方分支，不是 DeepSeek 官方產品，未獲 DeepSeek 關聯或背書，也不與 @deepseek-ai 包作用域關聯，風險自負。
• v1.4.0+ 面向 @deepseek-ai/dsh-* rc.7；更早版本仍運行在 rc.5/rc.6。
• package.json 當前版本爲 1.4.1，依賴和 peerDependencies 指向 rc.7 相關包。
• 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件以當前 dsh 進程權限運行，安裝前請檢查源碼與許可證。

結尾¶

dsh-client-ui-aqua-unofficial 的價值在於以插件方式改變 DSH Web UI 的外觀，並在關閉時恢復原版界面。

參考鏈接：

• 目錄頁（線索提供）：https://www.skillhub.cn/plugins/afrel1024/dsh-client-ui-aqua-unofficial
• GitHub：https://github.com/afrel1024/dsh-client-ui-aqua-unofficial