DSH Aqua · 透明玻璃主题适配版
为 DeepSeek Harness 0.2.1-rc.2 适配的 Aqua 玻璃主题:让流体背景或自定义壁纸透过聊天区、输入框和悬浮侧栏,同时保留宿主操作。
当前版本:1.3.1-patch.9 · 更新记录 · 适配与验证说明
效果预览
流体背景 · 收起侧栏
青绿色流体背景搭配窄幅玻璃图标栏,收起后仍可使用常用入口。

自定义壁纸 · 展开侧栏
壁纸透过玻璃侧栏与输入框,品牌行右侧保留收起按钮。

自定义壁纸 · 收起侧栏
点击顶部鲸鱼可重新展开侧栏,“应用/编辑”菜单在切换前后保持原位。

主要改动
- 修复桌面主栏遮挡流体背景和壁纸的问题。
- Windows 云母模式下,收起后显示 72px 悬浮图标栏,点击鲸鱼可展开;收起按钮位于品牌行右侧,“应用/编辑”菜单位置保持固定。
- 收起时,顶部鲸鱼、新建会话与下方按钮组统一使用 150ms 滑入淡显动画,支持系统“减少动态效果”设置。
- 左右侧栏统一使用 12px 留白、20px 圆角和玻璃材质,右侧栏放大后也保留悬浮效果。
- 适配新版设置入口,保留深浅色、模糊度、磨砂度、壁纸及环境装饰等原作功能。
安装
桌面版:通过应用内插件页安装
打开 DeepSeek Harness
0.2.1-rc.2,点击左侧栏的 插件。点击 添加插件,在“包名或地址”中填入:
github:dyx003/dsh-client-ui-aqua-patched如需选择依赖源,选择 npm 官方源(
https://registry.npmjs.org/),按界面提示完成安装。依赖源用于解析依赖,插件代码仍从 GitHub 下载。确认插件列表中
dsh-client-ui-aqua为1.3.1-patch.9、已启用,再完整退出 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,且 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。已在隔离的同版本网页实例中模拟 Windows 布局,检查侧栏往返、动画规则及按钮命中;本文截图展示 Windows 桌面效果。其他平台、窄屏、多屏缩放及原生 Electron 交互尚未完成全面回归。
来源与致谢
- 原作者: WYH66666666
- 原作仓库: DSH-Transparent-UI-Plugin
- 此前修补版本: Aliww2468/dsh-client-ui-aqua-patched
本仓库基于上述项目继续适配,原始设计与功能归原作者所有。按 AGPL-3.0-only 分发,详见 LICENSE。
No comments yet. Be the first to write one.