dsh-aqua-glass

Readme

# dsh-aqua-glass

Aqua 玻璃拟态主题的 **dsh 0.1.3-alpha.1 适配版**——毛玻璃、可调模糊/磨砂、流体或壁纸背景、粒子鲸鱼与动效(与 deepseek-harness 官网同款视觉)。

> **上游与本仓库的关系**
> 本项目是 [WYH66666666/DSH-Transparent-UI-Plugin](https://github.com/WYH66666666/DSH-Transparent-UI-Plugin)(Aqua,rc.5 时代)的**适配衍生**,非官方出品。
> 上游许可证为 **GNU AGPL-3.0**(见 [LICENSE](./LICENSE),已完整保留);本适配同样以 AGPL-3.0 发布,修改点如下。

## 与上游的差异(0.1.3-alpha.1 适配记录)

上游停更于 rc.5 前端 API;dsh 0.1.3-alpha.1 的 client 架构发生以下变化,均已适配:

| 上游(rc.5) | alpha.1 现状 | 适配 |
|---|---|---|
| `@deepseek-ai/dsh-client-runtime` | 拆并为 `dsh-client-store`(store 引擎)与 `dsh-client-modules`(模块系统) | import 改指向 `dsh-client-store` |
| `ctx.slots` 类型由 settings 系带出 | 由 `dsh-client-ui-renderer/client` 提供 | 补 type-only import |
| `settings.plugin.item` 槽支持表单式注册 | 改为 keyed 架构(按 settings 命名空间配对) | 主开关降级注册到 `settings.general.item`(设置→通用→外观 区,order 12) |
| `FileSystemFileHandle.queryPermission/requestPermission` | 已从 DOM lib 移除(规范废弃) | 改用 `getFile` 探测读授权 |
| TS `noUncheckedIndexedAccess` 关闭 | 构建链默认开启 | 局部 tsconfig 豁免(不改动画数学代码) |

## 安装

```powershell
# 本地目录
dsh plugin --profile web add <本仓库目录>

# 重启 web profile 后生效(或直接刷新页面看 live 热更)
```

## 使用

- 默认启用玻璃拟态;**设置 → 通用 → 外观** 区可见:
  - `Aqua` 主开关(开/关整体皮肤)
  - `Aqua` 旋钮行(模糊/磨砂/流体色相/背景亮度/壁纸/鲸鱼/浮游生物/网格/聚光等)
- 一键关闭即还原原生 UI(所有层都是 effect,随开关 dispose)

## 维护

- 适配锁定 dsh **0.1.3-alpha.1**;升级 dsh 需按上表重新核对 API 漂移
- 源码在 `src/`;重新构建需在 dsh 源码仓库的 client workspace 内进行(见 git 历史中的适配记录)

## License

[GNU AGPL-3.0](./LICENSE) — 上游版权归原 Aqua 作者;适配修改同协议发布。