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 也会自动跟着变
背景
- 流体：动态流体板，色调可调
- 壁纸：自己的图片或视频，可单独调模糊与磨砂
浅色壁纸配浅色模式，深色壁纸配深色模式，观感最好。
已知限制
- 只测过 DSH
0.2.1-rc.2（Windows x64）。其他版本未验证。
- 布局补丁依赖 CSS Module 类名哈希（
BynINW_centerCol、Dc7zOa_root 等）。DSH 升级后哈希会重新生成，补丁失效的表现是「会话区背景又被盖住」。修复方法见下节。
- 不含
src/：本仓库只发构建产物。上游构建链依赖 DSH monorepo 里的 tsdown.client.ts，无法独立构建。
- 不保证跟进后续 DSH 版本。
排错
会话区背景又被盖住了
DSH 升级后类名哈希变了。用 DevTools 找到新的类名，替换 lib/client.js 里的 DSH021_LAYOUT_CSS：
- F12 打开 DevTools
- 检查会话区域，找到那个有不透明背景色的
div（通常是会话根容器）
- 记下它的
class，形如 BynINW_centerCol → 哈希前缀可能变成 Xyz123_centerCol
- 全局替换
lib/client.js 里对应的类名，重启 dsh
设置里没有「玻璃主题」页签
- 确认已重启（不是刷新页面）
- 确认
dsh plugin --profile web list 里有这个包
- 看日志有没有
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
致谢
许可证
AGPL-3.0，与上游一致。见 LICENSE。
自由使用、修改、分发；修改版必须以 AGPL-3.0 开源并保留原作者版权声明；通过本软件提供网络服务时，须向用户提供源码。
