前言¶
DeepSeek Harness (DSH) 采用插件化架构，默认工作区背景往往较为单调。在长时间进行智能体开发或对话时，一个贴合场景的背景能提升沉浸感。dsh-scenery 旨在通过视觉叠加的方式，为 DSH 工作区注入环境氛围，而不改变原有的 UI 布局和交互逻辑。
插件简介¶
dsh-scenery 是一个由 wbaws 维护的背景类插件。它模拟了 Capy 风格的环境背景：选取一张图片后，插件会将其与巨大的底部黑色渐变以及环绕编辑器的柔和径向光晕进行合成，使 UI 看起来像是“置身于场景之中”，而非浮在平色之上。该插件仅做加性叠加，不触碰现有 UI、布局和交互行为。
核心功能¶
- 环境背景：为 DSH 工作区提供氛围感背景。
- 图像支持：支持本地上传图片（通过 PUT 存储在用户 DSH 主目录）或直接粘贴图片 URL。
- 图像控制：支持 fit（cover/contain/fill）、pan（位置 X/Y）、zoom（缩放）、blur（高斯模糊）以及整体透明度控制。
- 底部渐变：生成一个巨大的底部黑色线性渐变，平滑过渡，无色带。
- 编辑器光晕：在编辑器周围生成一个径向光晕，该光晕会自动跟踪真实的编辑器座位（粘性底部栏）。
- 实时预览：内置独立页面
preview/index.html，可在浏览器中独立预览和微调视觉效果。 - 持久化：配置和壁纸文件存储在
~/.dsh/dsh-scenery/config目录下。 - 重置功能：提供一键重置设置和清除当前图片的功能。
安装与启用¶
通过官方 CLI 安装：
dsh plugin --profile desktop add dsh-scenery
安装完成后，重启或重新加载 DSH，进入 Settings → Scenery background，选择一张图片并开启 Enable 开关。
典型用法¶
- 启动 DSH 并确保已安装
dsh-scenery。 - 打开设置菜单，找到 “Scenery background” 区域。
- 上传一张本地图片或输入图片 URL。
- 根据需要调整 Fit、Position、Zoom、Opacity 等参数。
- 如需精细调整，可打开插件目录下的
preview/index.html进行离线预览和调试。
适用场景与注意¶
- 加性叠加：该插件仅在对话列后添加一个点击穿透层，不重新设计 UI，不改变现有组件的布局。
- 权限要求：插件以当前 DSH 进程权限运行，需要 DSH 配置文件支持客户端插件系统（与
dsh-pet、dsh-better-sidebar等同类插件一致）。 - 存储路径：配置持久化路径为
~/.dsh/dsh-scenery/config，壁纸文件存储在对应目录或$DSH_HOME/dsh-scenery/下。 - 许可证：MIT 许可证。
总结¶
dsh-scenery 提供了一种低侵入式的视觉增强方案。如果你希望在保持 DSH 原生交互体验的同时，为工作区增添一点氛围感，这个插件是合适的工具。
