前言¶

DeepSeek Harness（DSH）的 Web GUI 默认背景通常是纯色或主题自带样式。若希望在不改主题的前提下，用本机图片或短视频做对话界面背景，并能在设置里切换、定时轮换，就需要一个挂在 web profile 上的本地壁纸插件。dsh-wallpaper 由 whf-jx 维护，归类为社区目录中的「趣味换装」；素材不上传外网，状态与文件都落在本机 $DSH_HOME/wallpaper/。

下面介绍它的定位、能力、安装方式与使用要点。事实以 GitHub 仓库 README 与 package.json 为准。

这是什么¶

dsh-wallpaper 为 DSH Web GUI 提供本地图片 / 视频壁纸：上传素材、手动切换、按间隔自动轮换，改动在设置界面内完成并实时生效。它不依赖在线服务，运行时通过 shell.overlay 与 settings.section 注入，仅支持 web 形态的 DSH GUI。

插件要求 DSH 引擎版本 >=0.1.2-alpha.1（见 package.json 的 dsh.engines）。当前 package 版本为 0.1.0，许可证 MIT。社区目录页：https://www.skillhub.cn/plugins/whf-jx/dsh-wallpaper。

核心功能¶

素材类型与播放¶

• 图片：.jpg、.jpeg、.png、.webp、.gif、.bmp、.avif
• 视频：.mp4、.webm、.ogv、.mov、.m4v，自动静音循环；HTTP 层对视频支持 Range 请求，便于浏览器流式播放

切换与轮换¶

• 手动：点选素材、上一张 / 下一张
• 定时轮换：7 档间隔（30 秒、1 分钟、5 分钟、30 分钟、1 小时、3 小时、6 小时），可独立开关；计时在 Host 端，关闭页面也会继续推进
• 随机顺序：依次轮换或随机抽取

观感与可读性¶

• 壁纸清晰度（5–100%）、文字压暗（0–90%）、背景模糊（0–60px）、填充方式（铺满 / 完整 / 拉伸 / 平铺；视频不支持平铺，按铺满处理）
• 深色主题且壁纸启用时，自动提亮三档文字色，便于阅读正文
• README 建议深色主题下：清晰度 15–20%、文字压暗 60–70%、背景模糊 10–15px

持久化¶

启用状态、间隔、当前素材等写入 $DSH_HOME/wallpaper/index.json（默认 ~/.dsh/wallpaper/）。原始字节在 images/ 目录。

安装与启用¶

README 说明本插件尚未发布到 npm，推荐用 dsh plugin 从 GitHub 源码安装。安装后需重启一次 DSH（插件按启动缓存发现），再刷新页面。

dsh plugin --profile web add github:whf-jx/dsh-wallpaper

插件以当前 DSH 进程权限运行；安装前请自行查看仓库源码与 MIT 许可证，确认符合你的环境策略。本包零运行时依赖，profile 的 package.json 无需额外登记该包。

典型用法¶

1. 打开 设置 → 本地壁纸。
2. 使用「上传图片 / 视频」多选本地文件；上传后立即出现在素材列表。
3. 打开「启用壁纸」总开关；需要轮播时再开「自动轮换」，并选择间隔与是否「随机顺序」。
4. 按需调节清晰度、压暗、模糊与填充方式；关闭总开关后背景层整体卸载（含视频解码）。

删除素材为两步确认（首次点击武装，约 4 秒后自动解除），以防误删大文件。

数据与 API（排障参考）¶

数据目录结构：

$DSH_HOME/wallpaper/
  index.json          # 状态与素材清单
  images/             # 原始素材
  trace.log           # 可选，需环境变量 DSH_WALLPAPER_TRACE
  client-probe.json   # 可选，客户端自检快照

HTTP 路由前缀为 /api/dsh-wallpaper，包括 GET /state、GET /revision（轻量轮询）、GET /image/<id>、POST /upload、POST /config 等。上传视频时若系统 PATH 有 ffmpeg，会 best-effort 转码为 1600×900 等参数后再入库；缺失或失败则保留原文件。设 DSH_WALLPAPER_NO_TRANSCODE=1 可关闭转码。

适用场景与注意¶

适合：长期在本地跑 DSH Web GUI、希望用私有素材做背景、需要定时或随机换壁纸且不依赖第三方图床的用户。

注意：

• 仅 web profile；其他 GUI 形态不适用。
• 视频壁纸会持续占用 GPU 解码；上传转码可将码率压到约 3 Mbps 量级（依赖 ffmpeg）。
• 无缩略图；列表里视频以 preload="metadata" 预览，悬停播放。
• 社区目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」的扩展方式。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/whf-jx/dsh-wallpaper
• 源码与文档：https://github.com/whf-jx/dsh-wallpaper