dsh-theme-liquid-glass

dsh-theme-liquid-glass

Apple Liquid Glass 主题插件 for DeepSeek Harness。

• 液态玻璃 UI：通过 ctx.theme.overrideTokens 把 --dsw-alias-* 语义 token 覆盖为半透明玻璃质感（{light, dark} 两套值）， 玻璃参数由 body 上的 --dsh-lg-* CSS 变量驱动，改动即时生效。
• 高亮提示：所有可以点击的元素都有悬浮高亮提示.
• 动态壁纸：支持网页链接（iframe / 可选 host 代理）、本地 HTML（<DSH_HOME>/wallpapers 目录）、本地图片、本地视频。
• 可自定义玻璃：磨砂开关、磨砂强度（px）、边缘折射强度、玻璃颜色、玻璃亮度。
• 毛玻璃实现：filter: blur() 直接打在背景图层上（inset: -48px 留出模糊出血），不用 backdrop-filter （backdrop-filter 会让 #root 成为所有 fixed 定位后代的包含块，菜单/弹层/toast 会被重新锚定到 #root）。
• 设置页：设置 →「液态玻璃」（与通用设置 / 模型 / 插件 并列的独立顶层页，settings.section 槽位）， 分「页面背景」「输入卡片 · 磨砂玻璃」两组，实时生效；「恢复默认」一键还原。
• 完全关闭：「启用液态玻璃」开关会同时撤掉 token 层、壁纸与全部毛玻璃/透镜边缘规则 （效果规则全部挂在 body.dsh-lg-on 门控 class 上，关闭即整体失效，不残留高光）。
• 本地文件选择：壁纸类型选本地 HTML / 图片 / 视频 / 本地文件时，点击输入框直接拉起系统文件选择器； 选中后经 POST /liquid-glass/upload 上传到壁纸目录（文件名 lg-<时间戳>-<原文件名>），再通过 /liquid-glass/wallpaper/<文件名> 生效。

结构

src/index.ts          host 半区：壁纸文件路由 + 文件上传 + 网页代理
src/client/index.ts   browser 半区：token 层 + 背景图层 + 玻璃参数 + 设置页
src/shared.ts         常量与设置类型（无运行时依赖）
build.mjs             swc 构建（lib/index.js + lib/client.js 加载器格式）

构建

npm install
npm run build        # 一次性构建
npm run watch        # watch 模式（配合 client-hmr 热替换）
npm run dev          # 构建 + 冒烟测试

安装到 web profile

方式一：从 npm 安装（推荐，稳定版）

dsh plugin --profile web add dsh-theme-liquid-glass

刷新浏览器即可生效。

方式二：本地开发链接

dsh plugin --profile web add "D:\deepseek harness workspace\harness theme\dsh-theme-liquid-glass"

刷新浏览器即可生效。

改代码后的重装：本地开发时，每次改代码后需重新构建并重装到 profile：

cd "D:\deepseek harness workspace\harness theme\dsh-theme-liquid-glass"
node build.mjs
dsh plugin --profile web add "D:\deepseek harness workspace\harness theme\dsh-theme-liquid-glass"

开发期也可用 node build.mjs --watch 监听源码自动重建。 client 改动（设置页 UI、玻璃参数）构建后刷新即可生效； host 改动（路由/上传端点）需要重启 dsh web 才会重新加载 host 半区。

客户端注入说明

client 半区必须在 bundle 里导出 inject（服务名数组： ['slots','locale','theme']，与已发布的 dsh-ui-appearance / dsh-dream-skin 一致）。 client loader 用它构建 fiber 注入表，缺失会导致 cannot get property X without inject 并让 整个 web boot fail-loud。apply 整体有 try/catch 兜底，运行时错误只降级、不会再把 GUI 带崩。

持久化说明（为什么用 localStorage）

设置保存在浏览器 localStorage（键 dsh-liquid-glass.settings），不走 settings RPC： harness 的 settings 网关只对浏览器客户端暴露硬编码的产品命名空间，第三方命名空间即使 在 host 半区 settings.register 了也不会送达客户端 scope（客户端会永远停在 loading）。 已发布的 dsh-ui-appearance / dsh-dream-skin 插件都遇到同一堵墙并选择了 localStorage。 代价：设置跟随浏览器，换浏览器/清站点数据会丢失。

设置页（localStorage 持久化）

字段	说明
enabled	总开关
wallpaper.kind	none / url / html / image / video / local
wallpaper.value	网页链接或 wallpapers 目录下的相对路径
wallpaper.proxy	网页链接走 host 代理（绕过 X-Frame-Options）
wallpaper.muted	视频壁纸静音（默认 true；取消后带声音，可能被浏览器阻止自动播放）
demo.speed	demo.html 动画速度倍率 0.1–4（步进 0.1）
demo.blobs	demo.html 色块数量 1–6
demo.colorCycle	demo.html 颜色变化 0–10（0=静态）
demo.blur	demo.html 色块模糊 10–140px
demo.opacity	demo.html 色块不透明度 0.2–1
demo.wash	demo.html 背景渐变流动开关
glass.frosted	磨砂开关（输入卡片/气泡/任务栏的 backdrop 模糊）
glass.blur	输入卡片磨砂强度 0–60px
glass.bgBlur	背景壁纸独立模糊 0–60px（与卡片磨砂解耦）
glass.refraction	边缘折射 0–1
glass.tint	玻璃颜色
glass.tintOpacity	玻璃颜色不透明度 0–1
glass.toolTextColor	操作文字颜色（#RGB 十六进制，空=默认）
glass.codeBlockOpacity	代码块背景不透明度 0.2–1（独立于玻璃颜色不透明度）
glass.glassBrightness	玻璃材质亮度 0.2–1.6（tint 明度缩放，>1 变亮 <1 变暗）
glass.brightness	背景亮度 0.2–1.6

首次启动

插件首次启用时，会自动检查 <DSH_HOME>/wallpapers 目录下是否存在 demo.html。 若不存在，插件会自动写入内置默认演示壁纸（已有文件不会被覆盖）。 默认演示壁纸路径：C:\Users\JANXT\.dsh\wallpapers\demo.html。 壁纸目录可通过插件配置 wallpaperDir 修改。

预览