前言¶
DeepSeek Harness (DSH) 是一个插件化的智能体开发平台。默认的界面风格虽然稳定，但对于追求个性化工作环境的开发者来说，缺乏定制空间。dsh-frosted-window 插件提供了一种解决方案：上传本地图片，将其转化为全窗口的毛玻璃效果，同时保持官方 Light / Dark / System 主题的控制权。
插件介绍¶
这是一个 Web 端主题插件。由 SenryLee 维护。它的核心功能是将用户上传的图片作为壁纸，并在侧边栏、对话区和详情页覆盖一层统一的磨砂玻璃效果。插件不依赖远程 URL 获取图片，所有数据均存储在本地。
安装与启用¶
安装前，请确保 dsh web 正在运行（默认配置文件名为 web），且系统 PATH 中包含 pnpm。
使用以下命令安装：
dsh plugin --profile web add github:SenryLee/dsh-frosted-window
安装完成后，必须重启 dsh web 才能生效（简单的页面刷新是不够的）。
典型用法¶
- 打开左侧底部的 Settings。
- 找到 Frosted 面板（该面板位于 General 下，Appearance 下方）。
- 启用该主题。
- 上传本地图片（支持 JPEG、PNG、WebP、GIF，无文件大小限制）。
- 调整滑块：玻璃密度、模糊程度、饱和度、壁纸变暗度。
- 点击 Save。下次启动时，该区域会显示 Saved，表示已持久化。
- 替换：选择另一张图片，再次点击 Save。
- 清除：点击 Delete 恢复官方外观。
核心功能¶
- 本地图片支持：支持本地 JPEG / PNG / WebP / GIF 上传，无文件大小限制。
- 全窗口覆盖：提供全窗口壁纸，并在侧边栏、对话和详情区域应用统一的毛玻璃层。
- 参数调节：提供玻璃密度、模糊、饱和度、壁纸变暗度四个滑块。
- 状态管理：支持预览、保存持久化、替换图片、删除配置。
- 外观切换：提供绿色（开启）和灰色（关闭）开关，关闭后可恢复官方外观。
- 无侵入设计：仅使用
overrideTokens覆盖样式，从未调用setTheme('custom')，不会破坏官方主题逻辑。
技术细节与注意事项¶
- 数据存储：图片存储在 IndexedDB，设置参数存储在
localStorage。 - 配置路径：不会修改
$DSH_HOME/settings.yaml，也不会从 URL 获取资源。 - 插件识别：在设置中的 Plugins 列表里，该插件的技术名称为
frosted-window或dsh-frosted-window。 - 许可证：MIT。
总结¶
dsh-frosted-window 让 DeepSeek Harness Web 的界面从单纯的工具栏转变为可定制的个人工作空间。它通过轻量级的本地存储机制，实现了既美观又安全的个性化体验。
- GitHub 仓库：https://github.com/SenryLee/dsh-frosted-window
- 插件目录：https://www.skillhub.cn/plugins/SenryLee/dsh-frosted-window
