DSH 提供了插件化的擴展能力，Aqua 是一個套在 DSH 網頁端的高自由度玻璃質感主題。它將頂欄、側邊欄、輸入框、統計行、軌跡視圖等元素轉化爲磨砂玻璃材質，並提供背景與參數調節選項，在不修改 DSH 源碼的前提下改變界面觀感。
基本信息¶
- 項目名稱：
huangfuren/dsh-client-ui-aqua - 維護者：huangfuren
- 分類：趣味換裝
- 協議：MIT
核心功能¶
Aqua 提供以下核心能力：
- 磨砂玻璃化：支持頂欄、側邊欄、輸入框、統計行、軌跡視圖的磨砂玻璃化處理。
- 兩種顯示模式：
- 漂浮玻璃：將佈局改爲懸浮卡片樣式。
- 兼容模式：保持原版排版不動，僅將材質替換爲通用玻璃，並自動玻璃化其他插件的界面。
- 高度可調：
- 可調節玻璃模糊度、磨砂度。
- 背景支持流體漸變或自定義壁紙，壁紙的模糊與磨砂度亦可單獨調節。
- 支持統一圓角與動態效果。
- 背景插件聯動：可與
dsh-bg-plugin背景插件聯動，複用其/bg-rpc和/bg-file接口讀取配置和圖片。
安裝與啓用¶
Windows（PowerShell 一條命令）¶
在 Windows 環境下，可以使用 PowerShell 執行以下命令安裝：
powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest 'https://github.com/huangfuren/dsh-client-ui-aqua/raw/main/install.ps1' -OutFile install.ps1; .\install.ps1"
該腳本默認安裝最新發布版。若需指定版本或跟隨開發分支，可在腳本後添加參數：
.\install.ps1 -Version 'v1.0.1' # 指定某個發佈版
.\install.ps1 -Version 'main' # 開發分支
安裝腳本會將插件鏈接進 profile 的 node_modules，並在 cordis.patch.yml 裏登記 ui-aqua。安裝完成後刷新 Web 界面即可生效。
macOS / Linux（手動安裝）¶
- 克隆倉庫並切換到指定版本（例如 v1.0.1）：
git clone --depth 1 --branch v1.0.1 https://github.com/huangfuren/dsh-client-ui-aqua.git
- 在
$DSH_HOME/profiles/node_modules下創建軟鏈接：
ln -s "$PWD/dsh-client-ui-aqua" "$DSH_HOME/profiles/node_modules/@deepseek-ai/dsh-client-ui-aqua"
- 編輯
$DSH_HOME/profiles/web/cordis.patch.yml，追加以下內容：
- insert:
- id: ui-aqua
name: '@deepseek-ai/dsh-client-ui-aqua'
- 刷新 Web 界面。
使用與調節¶
安裝後 Aqua 默認開啓。調節功能通過界面設置完成。
總開關與獨立開關¶
- 主開關：進入「設置 → 插件 → 玻璃主題」可控制總開關。
- v1.0.9 新增獨立開關：在「設置 → 通用設置」中，字號大小行下方新增了一條獨立的「玻璃主題」開關行。該行包含標籤、膠囊開關與說明文字，便於快速開關。
- 參數調節：總開關開啓時，其餘調節項在「設置 → 通用設置 → 外觀」中。總開關關閉後，外觀下的調節項會自動隱藏。
背景插件聯動¶
若要使用背景圖庫聯動功能，需先安裝 dsh-bg-plugin（包含 @deepseek-ai/dsh-bg 和 @deepseek-ai/dsh-client-bg）。
聯動邏輯如下：
* 融合取向：背景插件負責出圖，Aqua 負責呈現。
* 優先級：Aqua 自身上傳的壁紙優先級高於背景插件；清空 Aqua 的壁紙設置後，會回落到背景插件。
* 職責分離：玻璃參數在 Aqua 側調節，圖片管理在背景插件側調節，互不重疊。
* 接口複用：Aqua 複用 bg 插件已有的 /bg-rpc（讀配置）與 /bg-file/<id>（取圖）接口，不新增接口。
注意事項¶
- 依賴環境：
- Node.js 版本需 >= 22.19。
- DSH 版本需 >= 0.1.5-rc.2。
- 組件依賴：依賴
@deepseek-ai/dsh-client-store、@deepseek-ai/dsh-client-locale等組件。 - 權限與源碼：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
- 生態說明：該插件屬於社區目錄項目，與 DeepSeek 或幻方無官方從屬關係。
