前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构，社区生态中的插件目录与官方应用解耦。在使用 Web 界面进行智能体开发或交互时，默认主题往往无法满足对视觉细节的定制需求。dsh-bloomglass 是一个 Web 主题插件，它将 10 套 OKLCH 莫兰迪配色与磨砂玻璃效果结合，并提供本地壁纸支持，旨在提升界面的视觉质感，并专门适配 DS Bot（Bot 团队）界面。
插件定位¶
dsh-bloomglass 是一个由 CosmoSail 维护的 DSH Web 主题插件。它通过覆盖官方的 Token 层，在不修改 settings.yaml 的情况下，为用户提供了独立的磨砂玻璃主题设置入口。
核心功能¶
10 套莫兰迪配色
提供黛蓝、朱砂、桃夭、天青等 10 套配色方案。这些配色支持明暗自适应，能够根据系统或手动切换自动调整颜色深浅。
磨砂玻璃效果
磨砂玻璃效果覆盖了左侧栏、会话区、右侧栏、设置弹窗，以及 DS Bot 的固定面板与弹层。开启壁纸后，表面色会根据玻璃浓度转为半透明，而文字与边框保持不透明，确保可读性。
本地壁纸支持
支持上传本地 JPEG、PNG、WebP 或 GIF 格式的壁纸。插件对壁纸文件大小无限制，文件存储在 IndexedDB 中。
独立设置栏
在 DSH 设置中提供独立的「Bloom Glass」配置页。用户可以在此选择配色，并通过滑杆调整玻璃浓度、模糊度、饱和度及压暗程度。
DS Bot 界面适配
插件会接管 DS Bot 的界面渲染。它会优先处理 --bt-* 变量，并覆盖 ds-bot 原有的 6 个 DSH token，确保 Bot 界面的侧栏、气泡、面板等完全跟随当前主题配色。
安装与启用¶
前提条件是 dsh web 已在运行。
- 执行安装命令：
dsh plugin --profile web add dsh-bloomglass
或从仓库直接安装：
dsh plugin --profile web add github:CosmoSail/dsh-bloomglass
-
必须重启
dsh web（仅刷新页面不足以加载插件）。 -
打开设置，找到「Bloom Glass」选项进行配置。
首次启动时，插件会自动读取旧版插件留下的配色（localStorage 中的 dsh-bloom-variant）和玻璃参数（dsh-frosted-window:knobs），以及 IndexedDB 中的壁纸设置。
技术细节与注意事项¶
实现机制
插件不写入 settings.yaml，也不请求任何远程 URL。它利用官方的 overrideTokens 覆盖层来实现主题切换，而非调用 setTheme('custom')。
数据存储
壁纸文件存储在 IndexedDB 中；旋钮参数（玻璃浓度等）存储在 localStorage 中。
与 ds-bot 的交互
插件具有 Token 优先权。当检测到 ds-bot 注册了同名 Token 时，插件会重新压回自己的值。因此，ds-bot 的「外观设置」（主题/强调色）对 Bot 界面不再生效，Bot 界面完全由 Bloom Glass 控制。
官方主题保留
官方的 Light / Dark / System 主题仍然掌权，插件通过覆盖层叠加效果，不会破坏默认的明暗切换逻辑。
结语¶
dsh-bloomglass 提供了一套无需修改配置文件即可实现的 Web 界面美化方案，特别适合需要高度定制视觉体验的开发者。
- 项目地址: https://github.com/CosmoSail/dsh-bloomglass
- 许可证: MIT
