前言¶

DeepSeek Harness（DSH）的 Web 界面默认是纯色或系统主题，长时间对着开发会话时，背景往往单调。有人用浏览器主题或外层窗口换肤，但那样改不到 DSH 聊天画布本身的底层。dsh-wallpaper-intro 是社区插件，由维护者 fengyevvv 发布，归类为「趣味换装」：在本机图片/视频或 Wallpaper Engine（WE）视频壁纸之上叠一层可调蒙版，并在应用启动时播放可自定义片头。配置集中在设置页，右下角还有快捷面板，不必为切壁纸反复进菜单。

下面按定位、能力、安装、用法与限制说明，事实均来自仓库 README 与 package.json。

这是什么¶

插件仓库：fengyevvv/dsh-wallpaper-intro。目录页：skillhub.cn 条目。

一句话：把本地媒体或 WE 库里的视频壁纸当作聊天背景，启动时全屏播放一段可配置的片头；外观参数拖动即生效，可选 WE 列表或文件夹轮播。

运行要求（package.json）：Node >=22，DSH >=0.2.0-rc.1。许可 MIT。插件以当前 DSH 进程权限读取你指定的路径与 WE 库索引，安装前宜自行浏览源码与许可证；它不写入 WE 安装目录，只按需读取壁纸文件并在本地提供媒体流。

核心功能¶

背景¶

• 本机文件：任意磁盘路径的图片或视频，设置页提供路径选择器、目录浏览与常用目录。
• Wallpaper Engine：自动扫描本机库（工坊、我的项目、官方）；视频壁纸实时播放，场景与 Web 类壁纸目前只显示封面静态图。
• 桌面当前壁纸：一键使用当前桌面壁纸。
• 外观：蒙版浓度、模糊、画布不透明度（暗/亮各一套），拖动滑杆即时作用于主界面，并带合成预览。
• 共存：检测到其他壁纸插件时自动让路，对方撤掉后自动接回。

片头¶

• 素材：任意视频（mp4/webm/ogv）或图片（含 GIF），启动时全屏播放。
• 参数：展示时长（0 表示随素材播完）、淡出时长（默认 900ms）、是否带声音、音量及三处文案；设置页可预览，无需重启。
• 交互：点击画面、Esc、空格、回车可跳过；播完自动淡出。

轮播¶

• WE 播放列表：在 WE 面板给卡片点「＋」勾选，只在选中项之间轮换。
• 文件夹：指定一层目录，其中的图片/视频成池。
• 间隔 1–240 分钟，顺序或随机，切换带交叉淡入；关闭轮播会淡回「基础壁纸」，不会停在最后一张。

快捷面板¶

右下角圆钮：暂停背景、下一张、开关轮播、重载页面（桌面正式版无 F5，改 runtime 后需用此项或重启）。

安装与启用¶

官方 README 给出三条安装方式，桌面版也可在 设置 → 插件 → 添加插件 完成同等操作。装完后需完全退出并重新打开 DSH：注入表是宿主启动时的一次性快照。

# 从 Release 安装（推荐，固定版本）
dsh plugin --profile desktop add https://github.com/fengyevvv/dsh-wallpaper-intro/releases/latest/download/dsh-wallpaper-intro-0.1.0.tgz

# 或跟随仓库最新
dsh plugin --profile desktop add github:fengyevvv/dsh-wallpaper-intro

# 本地目录（开发时）
dsh plugin --profile desktop add link:E:\path\to\dsh-wallpaper-intro

当前发行包版本号为 0.1.0（与上述 Release 文件名一致）。

典型用法¶

1. 打开 设置 → 壁纸与片头，启用背景并选择来源：本机路径、source 为 WE 扫描结果，或「就用我现在这张」。
2. 按需调整外观滑杆，观察主界面与预览区变化；背景与外观类改动在 重载页面 后即可生效（见下文生效规则）。
3. 片头区选择文件并设 durationSec（0 = 播完为止）、fadeMs、sound；下次冷启动观看效果。片头参数变更需完全重启 DSH。
4. 轮播：在 WE 面板勾选列表或填 folder，设 intervalMin 与 mode（sequential / 随机），打开 rotation.enabled；日常用右下角面板切换，不必进设置。

配置持久化在 $DSH_HOME/dsh-wallpaper-intro.json（一般为 ~/.dsh/），升级插件不会清空。字段结构如下（节选默认值，便于对照文档改 JSON）：

{
  "boot":       { "enabled": true, "file": "", "durationSec": 0, "fadeMs": 900, "sound": true, "volume": 0.8 },
  "background": { "enabled": true, "file": "", "title": "", "source": "local" },
  "appearance": { "veil": 0.14, "surface": 0.2, "surfaceLight": 0.55, "blur": 0 },
  "we":         { "autoYield": true },
  "overlay":    { "enabled": true },
  "rotation":   { "enabled": false, "source": "list", "items": [], "folder": "", "intervalMin": 30, "mode": "sequential", "fadeMs": 700 }
}

片头常用项说明：

适用场景与注意¶

适合谁：本机已有 WE 库或一批工作区壁纸/片头素材，希望在 DSH 桌面版里统一背景与开屏体验，且能接受「场景/Web WE 仅静态封面」的现状。

已知限制（README 原文摘要）：

• 场景（scene.pkg）与 Web 壁纸不动态渲染，只显示 preview.jpg 等封面；不宜用 scene/Web 封面当片头。
• 文件夹轮播只看一层子目录；多显示器目前只取 Monitor0。
• 4K 片头在设置页预览可能卡顿，可换 1080p 或较短切片。
• 约 35% 的 mp4 因索引在文件尾，首帧可能偏慢；完整「虚拟 faststart」等在 ROADMAP，未实现。

改代码后的生效方式（维护者文档）：

DSH 生态强调「一切皆插件」；skillhub.cn 等为社区目录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-wallpaper-intro 把聊天背景、启动片头、WE 扫描与轮播收进同一套设置与快捷面板，适合想给桌面版 DSH 做视觉定制的开发者。未实现能力与工作量评估见仓库 ROADMAP.md。

• 目录页：https://www.skillhub.cn/plugins/fengyevvv/dsh-wallpaper-intro
• GitHub：https://github.com/fengyevvv/dsh-wallpaper-intro