前言¶

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