前言¶

DeepSeek Harness（dsh）把模型、工具、会话和 UI 都做成插件，核心理念是「一切皆插件」。网页界面开起来之后，对话区、轨迹区、侧边栏、设置页整天对着看，界面皮肤可以换，但各块工作区的背景往往还是同一套底色。

如果你用过 VS Code 的 shalldie.background 扩展，会知道编辑器、侧边栏、面板可以各自贴图。dsh-plugin-background 做的就是类似的事：给 DeepSeek Harness 的 Web GUI 按区域画背景，图片可以轮播，视频可以静音循环。它由 gameswu 维护，MIT 许可，社区目录归在「主题与外观」。截至 2026 年 8 月 18 日查阅，GitHub 仓库约 10 星，当前版本是 0.2.1。

需要先说清楚：DeepSeek Harness 本身是 DeepSeek AI 开源的智能体运行时，目前仍是 developer preview，接口可能不兼容地变动。下面用到的安装命令来自社区站点 DeepSeek Harness 插件目录，该目录是独立索引，和 DeepSeek / 幻方没有官方从属关系，不要把它当成官方应用商店。

这是什么¶

一句话定位：dsh-plugin-background 是跑在 Web 界面 上的背景插件，为对话区、轨迹区、侧边栏、设置页分别设置独立壁纸，并在「设置 → 插件」里挂一张自己的配置卡片。

仓库地址是 gameswu/dsh-plugin-background。package.json 里声明了 dsh.bundle（补丁文件 cordis.patch.yml）和 dsh.client.platform: web，也就是说它是一个自带补丁层的组合包，只面向网页客户端，不会给 headless 或纯终端会话画壁纸。

它要解决的问题很具体：默认 Web UI 没有按区域换壁纸的入口；装上之后，不必手改 CSS，也不必去改 Harness 源码。配置存在浏览器里（localStorage 键 dsh.background，本地文件进 IndexedDB），不写进 profile 的 YAML。

核心功能¶

仓库 README 和源码（src/constants.ts、src/types.ts、src/locales.ts）对得上的能力如下。

1、四个内置区域各自一套背景：对话区、轨迹区、侧边栏、设置页。每个区域可以开关、可以有自己的图片组或视频组。默认全部关闭，要你自己加素材才会画上去。

2、一组里只允许一种媒体。图片组按间隔轮播，像幻灯片；视频组用静音 <video> 循环播放。图片和视频不能混在同一组，混进去的条目会被跳过。GIF 按图片处理，浏览器会自己播动画。视频扩展名识别 mp4、webm、mov、m4v、ogv。

3、素材来源三种：粘贴 URL（逗号、分号或换行分隔）、选择本地图片/视频、选择整个文件夹。本地文件以 Blob 存进 IndexedDB，不转成 base64，刷新页面后仍在。

4、每张图可以单独调显示模式：填充（cover）、适应（contain）、拉伸、平铺、居中、自定义。自定义模式下还能改位置、缩放、宽高、重复方式、旋转和圆角。不透明度和模糊也是按张设置的，默认不透明度 0.9。视频不能平铺。

5、轮播间隔默认 15 秒，间隔设成 0 等于暂停。可以顺序播或随机播，也可以手动切下一张。切换前会预加载，并用交叉淡入，避免闪成空白。

6、表面列表里勾选多个区域再添加，同一批图可以一次落到多个区域。把一行拖到另一行上，两个区域会合成为一张跨区域大图（多显示器壁纸那种效果）；拖出去或点拆分，就恢复成各自独立。

7、兼容同一作者的 dsh-plugin-vscode-sidebar。装了那个侧栏之后，右侧面板整体、下侧面板整体，以及其中每个标签页，都会变成可独立贴背景的表面。

安装与启用¶

社区目录页给出的安装命令如下，在 DeepSeek Harness 终端里运行即可：

dsh plugin add github:gameswu/dsh-plugin-background

这是目录页原文，不要自己按仓库名再拼一遍。插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请看源代码仓库和许可证；需要可复现安装时，固定 commit 哈希。

README 写得更完整：这个包会把参数转发给对应 profile 的 pnpm，并自动挂进 dsh.profile.bundles，不用手改配置。面向网页界面时，建议显式指定 web profile，并把 commit 钉死。2026 年 8 月 17 日 main 上核实到的最新提交是 8660d41a4fb5cb320088b36b4109d055f598e077（版本 0.2.1，适配 dsh 0.1.0-rc.7 的插件配置卡片注册），可以这样装：

dsh plugin --profile web add github:gameswu/dsh-plugin-background#8660d41a4fb5cb320088b36b4109d055f598e077

从本地仓库安装时，把路径换成你 clone 下来的目录：

dsh plugin --profile web add <路径>

从 GitHub 安装时，pnpm 会在安装后跑这个包的 prepare 脚本，构建 lib/client.js。pnpm 10 及以上默认拒绝执行构建脚本，第一次 add 往往会失败，并提示把包名写进该 profile 的 pnpm-workspace.yaml 后再试：

allowBuilds:
  dsh-plugin-background: true

授权构建意味着安装时会在你的机器上执行这个包的构建脚本，只对你信任的来源授权。官方 CLI 文档对 Git 托管插件也是同一套说明。

装完之后重启 Web 界面：

dsh web

本地用路径安装、已经有构建产物时，重新 pnpm build 之后在浏览器里硬刷新（Ctrl+Shift+R）即可，不必每次重启服务。

典型用法¶

打开 设置 → 插件 → 背景，卡片名称就是「背景」。操作顺序按 README：

1、在表面列表里点要配置的区域。勾选多行，可以一次加到多个区域。

2、在输入框里粘贴图片或视频链接，或点「选择图片」「选择视频」「选择文件夹」。

3、点缩略图进入编辑器，改显示模式、不透明度、模糊，以及自定义模式下的位置、缩放等参数。区域上可以设轮播间隔、顺序/随机，也可以点「下一张」。

4、把一个区域行拖到另一个区域行上，合并成跨区域大图；拖出或点拆分则取消合并。

配置存在当前浏览器里。换浏览器、清站点数据，或换一台机器，壁纸不会跟着 profile 走。浏览器存储写满时，界面会提示已应用但未保存，需要删掉一部分图再试。

适用场景与注意事项¶

适合谁：主要在 dsh web 里干活、希望对话区和轨迹区背景分开、或者想像 VS Code 那样给工作区贴图的人。已经在用 dsh-plugin-vscode-sidebar 的，可以顺便给右侧/下侧面板和各个标签页分别贴图。只跑 headless 或不打开网页界面的，这个插件没有用处。

使用前还有几条边界，写进文章里是为了避免装完找不到效果：

1、只作用于 Web GUI。package.json 里 dsh.client.platform 是 web。

2、一组背景不能图和视频混用；视频默认静音，不会出声。

3、DeepSeek Harness 仍在 developer preview。这个插件 0.2.1 的提交说明就是：rc.7 按 settings 命名空间分发插件卡片，服务端必须注册 background 这个空 schema，卡片才会出现。升级 dsh 之后如果设置页看不到「背景」，先核对仓库是否已跟进。

4、插件以当前 dsh 进程权限运行，GitHub 安装还会跑 prepare 构建。安装前检查源码和 MIT 许可证，能固定 commit 就固定。

小结¶

dsh-plugin-background 把 VS Code 分区壁纸那套做法搬到了 DeepSeek Harness 网页界面：四个内置区域独立贴图或静音视频，本地文件进 IndexedDB，设置页里直接编辑，还可以把两块区域合成一张跨区大图。它是 gameswu 维护的社区 MIT 项目，不是 DeepSeek 官方皮肤。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-plugin-background/

GitHub：https://github.com/gameswu/dsh-plugin-background