dsh-client-ui-aqua-unofficial

English | 中文

> 非官方声明 — 这是社区第三方分支，不是 DeepSeek 官方产品，与 DeepSeek 及其官方组织没有任何隶属或背书关系，也不占用 @deepseek-ai npm 命名空间。请自行评估风险后使用。 > > 上游项目：WYH66666666/DSH-Transparent-UI-Plugin（MIT，(c) 2026 John Wu）。本分支在其基础上增加了 DSH rc.7 兼容，并以「非官方」标识重新发布。

Aqua 是一层高自由度的玻璃质感主题，套在 DeepSeek Harness 网页端。顶栏、侧边栏、输入框、统计行、轨迹视图都成了磨砂玻璃片，还可以添加图片和视频作为背景。关掉开关就回到原生界面，不改 DSH 任何一行源码。





特性

• 双模式：云母效果把布局改成悬浮玻璃卡片（模糊度、磨砂度可调）；兼容模式保持原版排版一字不动，只把材质换成通用玻璃，其他插件的界面也会自动玻璃化
• 背景自由：流体板（颜色可调）或自定义壁纸（铺满页面、比例不变，可单独调模糊度/磨砂度）；浅色壁纸配浅色模式、深色壁纸配深色模式观感更佳
• 背景亮度：自动跟随深浅模式——深色模式 0–50 压暗、浅色模式 50–100 提亮，50 原样
• 粒子鲸鱼：deepseek.com/harness 同款粒子鱼（官网粒子引擎移植），显示在聊天区域正中央（不含侧边栏），深色模式白粒子、浅色模式灰粒子，设置里可开关
• Harness 光泽铭牌：深色模式下侧边栏铭牌换成官网同款「Harness」药丸（135° 渐变描边 + 柔光），浅色模式保持原版铭牌
• 边缘渐变模糊：页面顶部/底部各 5px 渐变模糊带，悬浮在聊天内容上层，内容滚到边缘渐入模糊；浅色微泛白、深色微泛黑
• 一键开关：关闭即完全还原原生界面，所有效果随插件卸载一并消失

本分支的改动

• DSH rc.7 兼容（v1.4.0）：插件设置页的卡片槽改成了 keyed 槽；主开关卡片改用 key: 'aqua' 注册，并由节点侧提供 aqua 设置命名空间，使卡片在「设置 → 插件」里照常显示。
• 非官方重命名：包名改为 dsh-client-ui-aqua-unofficial（不再占用 @deepseek-ai 官方 scope），仓库名带 -unofficial 后缀。
• 其余（主题、设置、壁纸等）与上游 v1.3.0 一致。

安装

方式一：npm 一键安装（推荐）

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

从 npm 安装最新版，自动注册为 profile 插件层（dsh.bundle 补丁），所有平台通用。刷新 Web 界面即可。

> 自动注册：v1.4.1+ 自带 dsh.bundle 补丁，dsh plugin add 会自动注册插件层；v1.4.0 需要手动在 cordis.patch.yml 里登记 ui-aqua 行。

> DSH rc.7：v1.4.0+ 面向 @deepseek-ai/dsh-* rc.7（插件设置页的卡片槽已改为 keyed 槽）。更早的版本仍可运行在 rc.5/rc.6 上。

方式二：GitHub 安装器（备用）

不需要 npm、不需要 git（自动退回 zip 下载）。

Windows（一条命令）：

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest 'https://github.com/afrel1024/dsh-client-ui-aqua-unofficial/raw/main/install.ps1' -OutFile install.ps1; .\install.ps1"

默认安装最新发布版。脚本会把插件链接进 profile 的 node_modules，并在 cordis.patch.yml 里登记 ui-aqua（幂等，重复跑不会重复登记）。

指定版本或跟随开发分支：

.\install.ps1 -Version 'v1.4.0'   # 指定某个发布版
.\install.ps1 -Version 'main'     # 开发分支

macOS / Linux（手动，三步）：

git clone --depth 1 https://github.com/afrel1024/dsh-client-ui-aqua-unofficial.git
ln -s "$PWD/dsh-client-ui-aqua-unofficial" "$DSH_HOME/profiles/node_modules/dsh-client-ui-aqua-unofficial"

然后往 $DSH_HOME/profiles/web/cordis.patch.yml 追加：

- insert:
    - id: ui-aqua
      name: 'dsh-client-ui-aqua-unofficial'

使用

刷新 Web 界面。Aqua 默认开启；总开关在 设置 → 插件 → 玻璃主题（形状与其他插件卡片一致），其余全部调节在 设置 → 通用设置 → 外观 的正下方（无独立标题）：模式、模糊度/磨砂度（云母模式）、流体颜色、背景亮度、背景（流体/壁纸）、壁纸设置，以及粒子鲸鱼开关。总开关关闭时，外观下方的整块调节自动隐藏。

开源协议

MIT，继承自上游项目（(c) 2026 John Wu）。详见 [LICENSE](LICENSE)。