DSH Aqua · 透明玻璃主题适配版

为 DeepSeek Harness 0.2.1-rc.2 / 0.2.1-rc.3 适配的 Aqua 玻璃主题：让流体背景或自定义壁纸透过聊天区、输入框和悬浮侧栏，同时保留宿主操作。

当前本地版本：1.3.1-patch.10 · 更新记录 · 适配与验证说明

本轮 rc.3 修复已在本地目录链接中应用，尚未提交、推送或发布。下方 GitHub 安装方式只有在修复发布后才能取得 patch.10；已有本地链接用户可通过插件管理器重新启用 Aqua 来应用清单修复。

效果预览

流体背景 · 收起侧栏

青绿色流体背景搭配窄幅玻璃图标栏，收起后仍可使用常用入口。

自定义壁纸 · 展开侧栏

壁纸透过玻璃侧栏与输入框，品牌行右侧保留收起按钮。

自定义壁纸 · 收起侧栏

点击顶部鲸鱼可重新展开侧栏，“应用／编辑”菜单在切换前后保持原位。

主要改动

• 修复桌面主栏遮挡流体背景和壁纸的问题。
• Windows 云母模式下，收起后显示 72px 悬浮图标栏，点击鲸鱼可展开；收起按钮位于品牌行右侧，“应用／编辑”菜单位置保持固定。
• 收起时，顶部鲸鱼、新建会话与下方按钮组统一使用 150ms 滑入淡显动画，支持系统“减少动态效果”设置。
• 左右侧栏统一使用 12px 留白、20px 圆角和玻璃材质，右侧栏放大后也保留悬浮效果。
• 适配新版设置入口，保留深浅色、模糊度、磨砂度、壁纸及环境装饰等原作功能。

安装

桌面版：通过应用内插件页安装

1. 打开 DeepSeek Harness 0.2.1-rc.2 或 0.2.1-rc.3，点击左侧栏的 插件。

2. 点击 添加插件，在“包名或地址”中填入：

   github:dyx003/dsh-client-ui-aqua-patched
   

3. 如需选择依赖源，选择 npm 官方源（https://registry.npmjs.org/），按界面提示完成安装。依赖源用于解析依赖，插件代码仍从 GitHub 下载。

4. 确认插件列表中 dsh-client-ui-aqua 为 1.3.1-patch.10、已启用，再完整退出 Harness（包括托盘驻留）并重新打开。

已在 Windows 桌面版 0.2.1-rc.2 的实际 desktop profile 中验证：卸载本地目录版本后，使用上述 GitHub 地址和 npm 官方源安装成功，主题设置入口正常注册。下载的前端产物与仓库产物哈希一致，安装目录为独立副本。

安装包自带可加载的构建产物，无需先克隆仓库、运行 npm install 或自行构建。desktop profile 由桌面应用管理，普通 dsh CLI 会拒绝 --profile desktop，请使用上面的应用内入口。

若之前从本地目录安装，先在插件页卸载旧版本，并确认指向源码的旧目录链接已移除，再安装 GitHub 版本；仅关闭开关不会切换安装来源。若出现 EPERM ... rename，先检查是否有旧链接残留；仅清理确认过的目录链接，保留源码目录，再重新安装。详细记录见安装验证说明。

Web 版：通过 CLI 安装

先确认终端中的 dsh --version 为 0.2.1-rc.2 或 0.2.1-rc.3，且 git、pnpm 可用，再运行：

dsh plugin --profile web add github:dyx003/dsh-client-ui-aqua-patched

若使用自定义 profile，将 web 替换为对应名称。安装后重启 Web 宿主，再刷新页面。

GitHub 安装需要本机能访问 GitHub；若提示代理连接失败，请先检查本机 Git／代理配置。切换 npm 镜像不能解决 GitHub 连接问题。

使用

• 总开关： 设置 → 插件 → 玻璃主题。
• 效果调节： 通用设置 → 外观下方的主题设置。
• 悬浮效果： 选择云母模式；兼容模式保留宿主布局。
• 背景： 可选择流体背景或自定义壁纸，调节模糊、磨砂等参数。
• 恢复原生界面： 关闭插件总开关。

桌面版在 插件 页找到 dsh-client-ui-aqua 并选择 卸载。Web 版可运行：

dsh plugin --profile web remove dsh-client-ui-aqua

卸载后重新启动对应的桌面应用或 Web 宿主。

开发与验证

本仓库包含可直接加载的 lib 产物。修改 Aqua CSS 或 DOM 标记后，可使用 Node.js 22.13 及以上版本同步并检查：

npm run sync:visual
npm run check:visual
node --check lib/client.js

该同步工具仅处理视觉 CSS 与 DOM 标记模块，不能替代完整 TypeScript 构建。详细方法见 适配与验证说明。

当前支持 DSH 0.2.1-rc.2 和 0.2.1-rc.3，声明精确枚举这两个预发布版本，不自动放行后续版本。1.3.1-patch.10 修复 rc.3 升级后因版本声明仍锁定 rc.2 而被阻止加载的问题；JavaScript 语法、视觉产物同步检查通过，当前 rc.3 运行时已确认插件应用成功，两个 Aqua 设置入口均已激活。本轮没有浏览器窗口操作工具，未重新验收深浅色、折叠、壁纸和原生 Electron 交互。下文及适配说明中的 rc.2 截图和隔离实例结果是此前验证记录。

来源与致谢

• 原作者： WYH66666666
• 原作仓库： DSH-Transparent-UI-Plugin
• 此前修补版本： Aliww2468/dsh-client-ui-aqua-patched

本仓库基于上述项目继续适配，原始设计与功能归原作者所有。按 AGPL-3.0-only 分发，详见 LICENSE。