dsh-we-wallpaper: 将 Wallpaper Engine 壁纸库接入 DSH Web GUI

前言¶

DeepSeek Harness (DSH) 是一套用于构建 LLM 智能体的模块化框架，其 Web GUI 提供了可视化的操作界面。对于习惯使用 Wallpaper Engine 的用户，默认的 DSH 界面显得较为单调。dsh-we-wallpaper 插件解决了这个问题，它允许将你本地的 Wallpaper Engine 壁纸库直接映射到 DSH 的 Web GUI 背景中。

这是什么¶

这是一个将 Wallpaper Engine 壁纸库作为 DeepSeek Harness (DSH) Web GUI 背景的插件。它支持视频、Web、图片和场景壁纸，并提供了相应的配置与缓存优化机制。

核心功能¶

多类型壁纸支持
- 视频：作为循环静音的 <video> 元素播放，保持原生分辨率。
- Web：在沙盒化、点击穿透的 <iframe> 中渲染。
- 图片：直接显示。
- 场景：首次加载时通过 Wallpaper Engine 渲染并录制为 12 秒 H.264 循环视频缓存，后续加载直接使用缓存。
场景缓存机制
场景壁纸首次生成时，会在前台展示约 15 秒以生成高清动画缓存。后续启动的 DSH 会直接读取 ~/.dsh/we-wallpaper-cache/ 中的缓存文件，不再使用低分辨率的 160px Workshop 预览图。
插件配置界面
在 DSH 的 设置 → 插件配置 中新增“动态壁纸”卡片。支持浏览库、实时预览、搜索壁纸、一键应用，并显示当前桌面正在运行的壁纸状态。
阅读性与性能
- 提供暗色遮罩、面板半透明、覆盖/包含适配模式以及锐化控制。
- 资源友好：媒体元素复用，拖动进度条不会重启视频流。
- 持久化：壁纸选择存储在 ~/.dsh/we-wallpaper.json。

安装与启用¶

插件支持通过 profile 热插拔方式安装，无需修改 dsh 源码。

git clone https://github.com/pbadgpmeb22791-sketch/dsh-we-wallpaper.git
dsh plugin --profile desktop add "<repository-path>\new"

安装后，重启或热重载 DSH 主机，刷新 Web GUI 页面，进入 设置 → 插件配置 → 动态壁纸。

注意事项¶

运行环境要求：HD 动画缓存生成需要 Windows 桌面 Harness 和正在运行的 Wallpaper Engine。
交互时长：首次生成场景壁纸时，Wallpaper Engine 场景窗口会临时置顶约 15 秒。
音频策略：出于浏览器自动播放策略，音频默认静音。
安全策略：每个路由都拒绝跨站请求（CSRF 保护）；Web 壁纸在沙盒化 iframe 中运行。
透明度覆盖：该插件的透明度设置会覆盖官方的 --dsw-alias-* 代币，可能影响依赖这些代币的第三方插件。

短结尾¶

该插件为 DSH Web GUI 提供了高度个性化的背景定制能力，无需离开 DSH 生态即可享受 Wallpaper Engine 的动态效果。项目维护者为 pbadgpmeb22791-sketch。

GitHub: https://github.com/pbadgpmeb22791-sketch/dsh-we-wallpaper