Aqua 玻璃主题 · DSH 0.2.1 适配版

让 Aqua 在 DeepSeek Harness 0.2.1-rc.2 上跑起来。

这是兼容性分支，不是原创项目。设计、实现、全部视觉工作归原作者 WYH66666666。 上游与本分支均以 AGPL-3.0 发布，改动清单见 NOTICE.md。

高自由度的玻璃质感主题：顶栏、侧边栏、输入框、统计行都成了磨砂玻璃片。玻璃模糊度、磨砂度、背景（流体或自定义壁纸）都能在设置里调。关掉开关就回到原生界面。

---

为什么有这个分支

上游面向 DSH 0.1.x。0.2.1 做了几处破坏性改动，直接安装会导致：

症状	原因
dsh web 启动失败 / 白屏	依赖 @deepseek-ai/dsh-client-runtime，该包在 0.2.1 已被拆分
设置里找不到主题卡片	settings.plugin.item 插槽已被移除
卡片渲染时崩	IconCheckOutline16 图标已被重命名
会话区背景盖住流体背景	清背景用的 [data-dsh-frame] 属性标记已被删除

本分支把这 5 处全部修好，不改任何视觉设计。

---

安装

方式一：从 GitHub 装（推荐）

dsh plugin --profile web add github:060703Hyj/dsh-aqua-dsh021

装完重启 dsh web（或 DSH 桌面端）。

方式二：本地目录（改代码时用）

git clone https://github.com/060703Hyj/dsh-aqua-dsh021.git
dsh plugin --profile web add /绝对路径/dsh-aqua-dsh021

桌面端用户：设置 → 插件 → 安装 → 填 GitHub 仓库地址或本地目录，重启桌面端生效。

卸载

dsh plugin --profile web remove dsh-aqua-dsh021

---

用法

装好重启后，主题默认是开着的。

两个入口：

入口	内容
设置 → 插件 → 「玻璃主题 / Glass theme」页签	总开关
设置 → 通用 → 外观区	模式、模糊度、磨砂度、流体色调、背景亮度、壁纸、粒子鲸鱼、小鱼、网状交互、鼠标辉光、悬停下压

总开关关掉后，外观区那一整块会隐藏，界面完全回到原生。

两种模式

• 云母（mica，默认）：把布局重排成浮动的玻璃卡片，模糊与磨砂可调
• 兼容（compat）：保持原生布局，只把材质换成玻璃 —— 其他插件的 UI 也会自动跟着变

背景

• 流体：动态流体板，色调可调
• 壁纸：自己的图片或视频，可单独调模糊与磨砂

浅色壁纸配浅色模式，深色壁纸配深色模式，观感最好。

---

已知限制

1. 只测过 DSH 0.2.1-rc.2（Windows x64）。其他版本未验证。
2. 布局补丁依赖 CSS Module 类名哈希（BynINW_centerCol、Dc7zOa_root 等）。DSH 升级后哈希会重新生成，补丁失效的表现是「会话区背景又被盖住」。修复方法见下节。
3. 不含 src/：本仓库只发构建产物。上游构建链依赖 DSH monorepo 里的 tsdown.client.ts，无法独立构建。
4. 不保证跟进后续 DSH 版本。

---

排错

会话区背景又被盖住了

DSH 升级后类名哈希变了。用 DevTools 找到新的类名，替换 lib/client.js 里的 DSH021_LAYOUT_CSS：

1. F12 打开 DevTools
2. 检查会话区域，找到那个有不透明背景色的 div（通常是会话根容器）
3. 记下它的 class，形如 BynINW_centerCol → 哈希前缀可能变成 Xyz123_centerCol
4. 全局替换 lib/client.js 里对应的类名，重启 dsh

设置里没有「玻璃主题」页签

1. 确认已重启（不是刷新页面）
2. 确认 dsh plugin --profile web list 里有这个包
3. 看日志有没有 ui-aqua 相关的报错

界面变成一片透明、文字看不清

背景层没挂上（流体/壁纸都没启用）。补丁里有兜底规则会自动退回原生底色；如果仍异常，把 lib/client.js 里 DSH021_LAYOUT_CSS 最后那条 :not(:has(...)) 规则删掉再试。

想临时关掉

设置 → 插件 → 玻璃主题 → 关掉总开关。不需要卸载，界面立刻回原生。

---

回滚到官方版

如果你升到了 DSH 0.1.x，或者上游发布了 0.2.x 适配：

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

---

致谢

• WYH66666666 —— Aqua 的作者，全部设计与实现
• mexiaosqwq/dsh-web-mobile —— 移动端适配（MIT，上游移植）
• cloudflare/cloudflared —— 上游公网隧道功能依赖

许可证

AGPL-3.0，与上游一致。见 LICENSE。

自由使用、修改、分发；修改版必须以 AGPL-3.0 开源并保留原作者版权声明；通过本软件提供网络服务时，须向用户提供源码。