液态玻璃主题 SuperSgdk/DSH-Liquid-Glass-Theme

DSH液态玻璃皮肤插件

由 SuperSgdk 独立维护并完成 Windows 桌面端适配的 DSH 界面主题。让顶栏、侧边栏、输入区和统计栏使用可调的玻璃材质，支持流体背景、图片/视频壁纸及明暗主题。

v1.4.2 起已支持 DSH 桌面版。 已在 Windows DSH 0.2.0-rc.2 完成适配，修复主对话区背景、侧栏收起后无法展开、中间竖线和输入区占用过高的问题，见 桌面版说明。

在设置里关闭插件，可恢复原生界面。主题不修改 DSH 源码，也不参与模型调用或消息发送。

DSH液态玻璃皮肤插件实际运行效果

兼容范围

| 环境 | 状态 |
| Windows + DSH Web 0.1.5-rc.1 | 已通过运行、设置与开关验证，见 验证记录 |
| DSH 0.1.6 | 社区修复提供参考，维护版尚未实测 |
| Windows + DSH 桌面版 0.2.0-rc.2 | 已适配，用户确认修复后正常；见 桌面版说明 |
| 其他 DSH 桌面版本 / 非 Windows 平台 | 尚未实测 |

仓库名中的 Theme 表示界面主题；同一包 dsh-liquid-glass-theme 支持上述已验证的 Web 和桌面环境。

Windows 安装

先初始化要使用的 DSH profile，再退出该 profile 对应的 DSH 进程。下载本项目安装脚本：

Invoke-WebRequest 'https://raw.githubusercontent.com/SuperSgdk/DSH-Liquid-Glass-Theme/main/install.ps1' -OutFile install-liquid-glass.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\install-liquid-glass.ps1

默认安装最新 GitHub Release 到 web profile。也可以指定版本和 profile：

powershell -NoProfile -ExecutionPolicy Bypass -File .\install-liquid-glass.ps1 -Version v1.4.2 -Profile web

桌面版使用 desktop profile：先正常退出 DSH 桌面版，再执行安装并重新打开应用。

powershell -NoProfile -ExecutionPolicy Bypass -File .\install-liquid-glass.ps1 -Version v1.4.2 -Profile desktop

安装脚本会先备份该 profile 的 cordis.patch.yml、package.json 和原链接信息，然后在 该 profile 自己的 node_modules 建立链接。备份位置会打印出来。

重新启动 DSH，Web 版在 设置 → 插件 查找“DSH液态玻璃皮肤插件”；桌面版的主题开关位于 设置 → 通用设置 的外观附近。模糊度、磨砂度和壁纸等调节项位于 外观 下方。

首次维护版通过 GitHub Release 分发，尚未发布到 npm。

从旧 Aqua 迁移

同一个 profile 中只启用一个版本。安装脚本会把旧的 @deepseek-ai/dsh-client-ui-aqua 注册及 manifest 依赖迁移到新包名，保留其他插件和注释；原源码目录与旧链接目标不会被删除。

浏览器偏好的 dsh.ui-aqua. 键及原媒体数据库继续保留，以便在同一浏览器、同一站点使用原来的设置。不同端口、浏览器和桌面端的存储各自独立，不会自动同步壁纸。

若需要恢复，先退出 DSH，将安装时打印的备份目录中的两个配置文件复制回 profile，再按 link.json 恢复原来的插件链接。新建链接此前没有目标时，可移除该 Junction；只处理链接本身。

本地开发

需要 Node.js 22 或更新版本及 pnpm 11.19.0。构建在本仓库内完成。

pnpm install --frozen-lockfile
pnpm run check

Windows PowerShell 中也使用上述命令完成依赖安装、检查和构建。

check 依次进行类型检查、构建和回归检查。浏览器 bundle 使用 DSH 的模块加载器，CSS 和 CSS Modules 随 bundle 注入；lib 中的构建产物随版本提交，普通安装无需构建。

运行 pnpm pack 可生成完整 .tgz 包；Windows 也可运行 ./pack.ps1，它先检查再打包。GitHub Release 流程会检查版本号、构建并上传包和安装脚本。

本地副本安装到已初始化的测试 profile：

.\install.ps1 -Source $PWD.Path -DshHome '<测试 DSH_HOME>' -Profile '<测试 profile>'

浏览器检查需单独启动测试 profile，将带启动 token 的测试 URL 放入当前终端的 DSH_TEST_URL 环境变量，再运行 node scripts/browser-smoke.mjs。测试 URL 和 token 不应写入提交。使用已有 Chrome 时设置 BROWSER_CHANNEL=chrome，否则按 Playwright 的说明安装测试浏览器。

维护与贡献

仓库所有者和当前维护者为 SuperSgdk。问题和新 PR 请提交到本仓库。外部贡献者不能直接更新 main；PR 必须经过 SuperSgdk 本人审核、验证并明确同意，才能由其合并。兼容修复应写明 DSH 版本、复现步骤和验证结果；新贡献在采纳后记入贡献记录。

main 通过 GitHub 规则集限制更新，仅为 SuperSgdk 本人保留维护通道。PR 的默认要求包括其代码所有者批准、Windows / Linux 检查通过及审核讨论解决；后续代码修改使旧批准失效。另一条独立规则禁止所有人强推或删除 main。SuperSgdk 本人保留 PR 和云端检查规则的豁免，用于按下述流程同步已确认的本地修复；GitHub 无法代替本人测试，也不能识别聊天确认。

本地修复自动同步

本仓库已启用维护规则：修复 → pnpm run check 通过 → 仓库所有者 SuperSgdk 本人测试并明确确认本次修复正常 → 维护者提交并推送 GitHub。这里的「用户确认」仅指 SuperSgdk 本人，其他人的反馈或检查通过均不能代替。本人确认后无需再单独要求更新仓库，具体规则见 AGENTS.md。这由维护者收到确认后调用脚本执行，不是后台文件监视或定时任务。

审阅本次差异后，明确列出需要提交的文件（包含检查生成的构建产物）：

pnpm run sync -- --confirmed --message "fix: describe the confirmed repair" --files src/client/example.ts lib/client.js lib/client.js.map

将示例路径替换为本次实际文件。--confirmed 仅表示已收到 SuperSgdk 对本次修复的明确确认，不授予 GitHub 权限。脚本重新运行检查，只提交列出的修改，并核实 GitHub main 已包含该提交。已有暂存内容、未列出的改动、远端版本变化或检查失败时会停止；推送异常时保留本地提交并先核实远端，不盲目重试或强推。仅修改维护脚本、文档、GitHub 保护规则或检查流程时，完成适用检查后按 SuperSgdk 对本次维护工作的明确授权同步。

普通推送触发 Check；新安装包仍由匹配包版本的 v 标签触发 Release。本同步脚本不创建标签，不提升插件版本。云端检查结果需另行核实。

- 验证记录
- 更新日志

许可证与来源说明

本项目代码以 AGPL-3.0-only 分发，保留 LICENSE 全文。内嵌 Space Grotesk 字体遵循 SIL OFL 1.1。版权来源与历史贡献记录见 NOTICE。项目维护、安装与版本发布入口均为本仓库。