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 或幻方无官方从属关系。
