dsh-webUI-Glass-Theme DSH 插件

该插件通过叠加半透明表面 token 和全局 backdrop-filter，为 dsh Web UI 带来 iOS/macOS 风格的毛玻璃效果。它在设置→通用中添加了“过渡与计划”行，允许选择切换动画（淡入、圆形展开、从上往下擦除）、设置每日定时深色/浅色模式，以及使用自定义背景图片（URL 或本地文件）。

ui-productivity

如何安装 dsh-webUI-Glass-Theme DSH 插件

dsh plugin --profile web add ./dsh-webUI-Glass-Theme

复制不会执行命令。安装 dsh-webUI-Glass-Theme DSH 插件前请核对仓库和版本。

dsh-webUI-Glass-Theme DSH 插件数据来源

dsh-webUI-Glass-Theme DSH 插件快照日期：2026年8月16日

discovered

dsh-webUI-Glass-Theme DSH 插件能做什么

对 shell 框架和浮动表面应用全局 backdrop-filter 模糊和饱和度，实现毛玻璃效果。
以半透明 rgba 值覆盖表面背景 token（--dsw-alias-bg-* 等），与类名无关。
使用 View Transition API 提供全屏主题切换动画：淡入、圆形展开或从上往下擦除。
支持设定每日深色/浅色模式时间，自动切换，手动切换持续到下一个时间边界。
支持通过 URL 或本地图片上传设置自定义背景，并可一键恢复为内置背景。

dsh-webUI-Glass-Theme DSH 插件适合哪些场景

为 dsh Web UI 赋予类似 macOS 或 iOS 的现代半透明外观。
在一天中用户定义的时间自动切换深色/浅色主题。
使用动画过渡让主题变化视觉上更平滑、更吸引人。
设置自定义背景图片来个性化 UI，超越默认的毛玻璃背景。
作为纯客户端 dsh 插件（包含 bundle patch 和设置集成）的参考实现。

dsh-webUI-Glass-Theme DSH 插件适合谁

希望用毛玻璃效果美化 dsh Web UI 的用户。
倾向于根据时间或自定义计划自动切换主题的用户。
寻找客户端 dsh 插件（含 bundle patch 和设置集成）参考实现的开发者。

dsh-webUI-Glass-Theme DSH 插件的限制

shell 框架和 composer-card 的 backdrop-filter 依赖稳定的 data-* 属性而非哈希类名，如果 dsh UI 结构变化可能失效。
第三方主题 token 覆盖在运行时应用，未做完整性验证；仅覆盖表面背景 token，文本和状态 token 保持可读。
安装或卸载插件后需要重启 web 进程才能生效。

dsh-webUI-Glass-Theme DSH 插件的仓库 README 摘录

以下文字摘自 dsh-webUI-Glass-Theme DSH 插件的上游仓库 makuralymi/dsh-webUI-Glass-Theme 的 README，版权归原作者，仅作引用。

A **global frosted-glass (backdrop blur) theme plugin** for the dsh Web UI. It keeps the existing light/dark preference untouched and layers a translucent surface-token override plus a global `backdrop-filter` on top, giving the whole UI an iOS/macOS-style frosted-glass look. The plugin also adds a **Transition & schedule** row right below **Appearance** in Settings → General: - **Switch animation**: None / Fade / Circle reveal / Wipe from top — full-screen transitions when light/dark is switched. - **Scheduled switching**: set a daily dark-theme time and light-theme time; the UI switches automatically at those boundaries, and manual switches last until the next boundary. - **Custom background**: enter an image URL or choose a local image (auto-compressed and stored browser-locally), with one-click reset to the built-in background. ## Screenshot ![Frosted glass screenshot](assets/sc.png) ## What it does Two browser-side halves: 1. **Global stylesheet** (inlined by `lib/client.js`) - Paints `bg.jpeg` as a centered, cover background on `body` (inlined as base64; source kept at `assets/bg.jpeg`), shown as-is in light mode and dimmed behind a translucent dark veil in dark mod

阅读完整 README仓库未声明许可，使用前请先与作者确认。

dsh-webUI-Glass-Theme DSH 插件常见问题

如何安装毛玻璃主题插件？

克隆仓库后，在 dsh 环境中运行 'dsh plugin --profile web add ./dsh-webUI-Glass-Theme'。这会自动添加插件及其 bundle patch。然后重启 web 进程（例如 'dsh --profile web' 或 'dsh web'）以使更改生效。

如何自定义模糊强度？

编辑插件中 'lib/client.js' 文件里的 '--frosted-blur'（默认 20px）和 '--frosted-saturate'（默认 180%）变量。修改后重启 web 进程即可应用新值。

我可以使用自己的图片作为背景吗？

可以。在设置 → 通用 → 过渡与计划中，你可以输入图片 URL 或选择本地图片。插件会自动压缩并存储到浏览器本地存储（localStorage），然后作为背景显示。要恢复为内置背景，点击“重置为默认”按钮。

如何禁用定时主题切换？

前往设置 → 通用 → 过渡与计划，取消勾选“启用定时切换”选项。之后手动切换深色/浅色模式将不再受自动计划影响。

插件在移动端 dsh 应用上有效吗？

该插件是为浏览器中的 dsh Web UI 设计的。在移动浏览器上，backdrop-filter 和动画应该可以工作，但布局和触摸交互可能没有完全优化。建议在目标设备上测试。