DeepSeek Harness (DSH) 的 Web GUI (dsh web) 默认界面通常比较朴素,缺乏个性化。如果你希望在开发或调试智能体时拥有更舒适或专注的视觉环境,dsh-ui-background 是一个轻量的解决方案。该插件为 DSH Web 提供了一键背景切换功能,通过 Web profile 的 patch 层接入,不修改内核,支持持久化保存设置。
核心功能¶
该插件主要解决 Web 界面背景单一的问题,提供了以下能力:
- 预设与图片:内置极光、落日、翡翠三套渐变预设;支持上传本地图片或使用必应每日壁纸。
- 显示调节:可调节背景不透明度(0.05–1)、模糊半径(0–32 px)及填充方式(铺满/适应/平铺)。
- 动态特效:支持流光或粒子动态特效(需在激活背景后开启)。
- 持久化:所有配置写入
$DSH_HOME/settings.yaml,刷新后保持。 - 零侵入:插件卸载后界面完全恢复默认。
安装¶
通过 DSH CLI 安装插件,命令如下:
dsh plugin --profile web add dsh-ui-background
安装完成后,必须重启 dsh web 进程才能使插件生效。卸载命令为:
dsh plugin --profile web remove dsh-ui-background
使用¶
- 切换背景:进入「设置 → 通用 → 背景」行,点击预设卡片、上传图片或获取今日必应壁纸。
- 快速切换:界面右下角有一个悬浮按钮,单击可在「无背景 → 预设… → 无背景」之间循环切换。
- 必应壁纸:获取今日壁纸后,按钮变为「换一张」,可在最近 8 天内回溯选择。图片会缓存到本地,不依赖网络热链。
注意事项¶
- 文件限制:上传图片大小限制为 50 MiB,支持格式为 png/jpg/jpeg/gif/webp/avif。
- 重启生效:由于涉及 Node 半边的路由注册,安装或修改插件后务必重启
dsh web。 - 特效说明:动态特效(流光/粒子)需先激活一个背景(预设或图片)才能开启,且会遵循系统的「减少动态效果」设置。
- 恢复默认:卸载插件后,界面会完全恢复 DSH 默认状态,不会残留配置。
项目信息¶
- 作者:it-kxw
- 许可证:MIT
- 仓库:GitHub | SkillHub 目录