前言¶
在 DeepSeek Harness (DSH) 的 Web 模式下，默认壁纸往往不具备持久化特性，且 localStorage 的作用域包含协议、主机和端口。如果 Web 服务器端口发生变化，已保存的壁纸设置可能会失效。dsh-wallpaper 插件解决了这一痛点，它为 Web 配置文件提供了持久化的自定义壁纸能力，并修复了端口相关问题。
插件介绍¶
该插件由 Frog755 维护，采用 MIT 许可证。它为 DSH Web 配置文件添加了一个持久化的壁纸设置项，允许用户选择本地图片或视频作为背景。插件利用本地存储和文件系统来保存壁纸数据，确保重启后设置依然存在。
核心功能¶
- 持久化存储：壁纸设置和文件存储在本地
~/.dsh/wallpapers目录，数据同时也保存在浏览器的localStorage中。 - 媒体支持：支持本地图片和 MP4 视频文件（最大 300MB）。
- 视觉调整：提供“表面透明度”和“壁纸模糊度”调节选项。
- 视频处理：
- 视频静音并自动循环播放。
- 如果系统安装了
ffmpeg和ffprobe，视频会被压缩为 H.264 格式（目标约 18MB，1080p 分辨率，30fps），音频被移除；否则保留原文件。
- 端口锁定：Bundle 补丁将 Web 服务器端口锁定在 9191，以防止因端口变化导致
localStorage作用域改变而丢失壁纸。
安装与启用¶
安装完成后需要重启 dsh web 进程以加载新的 Bundle 补丁。
1. 安装官方插件
dsh plugin --profile web add -w @frog755/dsh-wallpaper
2. 本地开发安装
如果在克隆的仓库根目录进行开发，运行：
dsh plugin --profile web add -w .
3. 启用与配置
安装后重启 dsh web，进入 设置 -> 通用 -> 壁纸。在此处选择本地图片或视频文件，并调整透明度和模糊度。
注意事项¶
- 端口占用：插件默认将 Web 服务器锁定在 9191 端口。如果该端口被占用，需要停止占用进程或修改
cordis.patch.yml文件中的端口配置。 - 视频压缩：视频压缩功能依赖于
ffmpeg和ffprobe，且需确保它们在 DSH Host 进程的PATH中。 - 依赖管理：插件依赖 Peer Dependencies（如
react ^18.2.0、@deepseek-ai/cordis ^4.0.1等），这些由 DSH Host 提供，无需手动安装。 - 数据清理：更换或删除壁纸时，旧的本地文件会被删除；启动时也会自动清理未引用的旧壁纸视频。
总结¶
dsh-wallpaper 是一个专注于界面个性化的实用工具。通过持久化存储和端口修复，它解决了 DSH Web 模式下壁纸配置不稳定的问题。对于需要深度定制 Web 界面的用户，这是一个可靠的解决方案。
