前言¶
DeepSeek Harness（DSH）是智能体开发与调试的核心界面工具。在长时间运行智能体或调试会话时，静态的界面背景容易造成视觉疲劳。dsh-wallpaper-bg 插件为 DSH 的 Web 界面（dsh web）和 0.2 版桌面端提供了一个独立的动画壁纸层，将浏览器 UI 悬浮在动态背景之上。
插件支持内置壁纸、自定义上传和 Wallpaper Engine 壁纸库三种来源。它不解析本地场景包，不生成缓存文件，视频渲染在浏览器内完成。在浅色主题下会自动叠加半透明白色雾气，深色主题下则应用变暗遮罩，以确保文字的可读性。主对话页面的「原生背景」开关可以一键清除这些遮罩和雾气，让壁纸完全透出。
核心功能¶
三种壁纸来源¶
- 内置壁纸：提供 10 张高分辨率 Unsplash 图片，无需本地服务即可使用。
- 自定义上传：支持本地图片和视频，存储在 IndexedDB 中，刷新不丢失。插件通过扩展名检测自动识别 MIME 类型为空的文件（如
.mkv、.mov），将其作为视频渲染而非黑屏。自定义队列仅支持图片/视频。 - WE 壁纸库：只读连接本地 Wallpaper Engine 库（默认
http://127.0.0.1:8088），仅显示已订阅的壁纸。
播放队列与渲染模式¶
- 播放队列：从内置、自定义或 WE 库的网格中拖拽壁纸到队列中，开启循环播放。队列支持拖拽排序、点击跳转、单条移除和清空，内容持久化存储。WE 队列支持视频、场景预览图、网页和图片。
- 三种渲染模式：
- 静态图片：封面适配。
- 视频：使用
<video object-fit: cover>，通过 GPU 合成，无黑边或变形。支持 4K 视频优化。 - 场景预览：显示 WE 工坊的
preview.gif或preview.jpg。场景的完整动态效果建议通过 WE 的屏幕录制工具录制为 MP4 并通过自定义上传导入。 - 网页壁纸：在浏览器内原生渲染
index.html。
性能与交互优化¶
- 零本地渲染与缓存：插件不解析
scene.pkg，不渲染场景帧，不烘焙视频，也不截取桌面屏幕。无本地缓存文件夹。 - 黑闪消除：切换壁纸时使用 0.42 秒的交叉淡入淡出， incoming 壁纸预加载解码后才开始混合，旧图层完全淡出后才移除。视频路径等待
requestVideoFrameCallback确保第一帧绘制后再进入，避免出现空白帧。 - 下一项预热：当前项播放时，下一项已在后台加载（网络图片下载解码、WE 视频缓冲、IndexedDB 读取），切换时无需等待网络。
- 白屏跳过：针对部分视频（如 Arknights “喧闹法则”）的开头纯白画面，预热阶段检测首个非白帧，从此处开始播放。
- 解码器管理：退出图层淡出时暂停解码，待完全移除后才释放视频资源，防止连续切换导致 FPS 下降。
调节与开关¶
- 四项调节：
- 雾气/遮罩：浅色主题为半透明白色雾气，深色主题为变暗遮罩，随 DSH 主题自动切换。
- 模糊：0–20px。
- 亮度：50–150%。
- 安全放大：0–10%，用于裁剪边缘黑边。
- 原生背景开关：主对话页面的开关可一键清除雾气、遮罩和半透明 UI 层面，展示完整壁纸，同时保持对话界面的清晰度。关闭后恢复之前的设置值。
安装与使用¶
安装¶
可以通过 DSH 的 CLI 执行安装，或在桌面版的插件管理页面输入包名。
典型用法¶
- 设置循环播放：在「自定义上传」或「WE 壁纸库」标签页，将喜欢的壁纸拖入顶部的队列中，调节循环时长（1–10 分钟）。
- 调整显示效果：在设置面板的「壁纸」标签页，根据喜好调节模糊度、亮度和安全放大比例。浅色模式下雾气会自动叠加。
- 清除遮罩：在主对话页面点击「原生背景」开关，让壁纸完全显示，同时保持对话界面的清晰度。
- 使用 WE 库：确保本地运行了 Wallpaper Engine 的 API 服务（不在 npm 包内，插件面板会提示），即可读取本地订阅的壁纸。
注意事项¶
- 权限与资源：插件以当前 DSH 进程权限运行。WE 壁纸库来源需要
wallpaper-engine-api服务在本地运行。 - 桌面独立性：DSH 内部的壁纸切换不会影响桌面壁纸，桌面壁纸的变化也不会反向同步到 DSH（除非使用「同步桌面壁纸」功能，但此功能在当前版本中被移除，目前仅作为只读展示）。
- 许可证：MIT 许可证。
- 性能：4K 视频通过 GPU 合成实现，无需 CPU 逐帧绘制，性能开销极低。
总结¶
dsh-wallpaper-bg 是一个为 DeepSeek Harness 提供独立动画背景的插件。它通过三种来源、队列播放、零缓存渲染和 GPU 优化，解决了静态背景带来的视觉疲劳问题，同时保持了界面的可读性和稳定性。
- 插件主页：https://www.skillhub.cn/plugins/nishuoyang/dsh-wallpaper-bg
- GitHub 仓库：https://github.com/nishuoyang/dsh-wallpaper-bg
