前言¶
DeepSeek Harness（DSH）的 Web 界面默认是纯色背景。长时间盯着对话区、轨迹区或侧边栏工作时，界面容易显得单调；若只想给某个区域换一张图，又往往得改全局样式或自己写 CSS，维护成本高。
dsh-plugin-background 是 gameswu 维护的 DSH 壁纸插件，在 SkillHub 社区目录中归类为「趣味换装」。它借鉴 VSCode 的 background 扩展思路，为对话区、轨迹区、侧边栏、设置页等界面区域分别配置背景，支持图片轮播与静音视频，并在设置页提供独立管理入口。
这是什么¶
dsh-plugin-background（当前版本 0.2.1，MIT 许可证）是一个面向 DSH Web 平台的客户端插件。它以组合包形式发布（dsh.bundle + cordis.patch.yml），通过 Cordis 补丁层注入 Web 界面，在 设置 → 插件 → 背景 中提供配置界面。
维护者 gameswu 在 GitHub 上开源该仓库；SkillHub 目录页与 GitHub 仓库为同一插件的不同入口，社区目录由 SkillHub 运营，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
下面介绍插件已实现的背景管理能力，均来自仓库 README 与 package.json 说明。
按区域独立配置¶
每个界面区域可拥有一套独立背景。图片组按 PPT 式轮播切换；视频组静音循环播放。每组只含一种媒体类型（图片或视频，不混用）。
支持的区域包括对话区、轨迹区、侧边栏、设置页等；若已安装 dsh-plugin-vscode-sidebar，其右侧面板、下侧面板整体以及其中每个标签页也可作为独立背景区域。
素材来源与持久化¶
添加背景时可：
- 粘贴 URL（逗号分隔多张）
- 选择本地图片或视频
- 选择整个文件夹
本地文件以 IndexedDB blob 形式存储，刷新页面后仍保留，不采用 base64 打包。
勾选多个区域后添加，同一批素材可一次落到多个区域。
单张图片的显示参数¶
点击缩略图进入编辑器，可为每张图单独设置：
- 显示模式：填充、适应、拉伸、平铺、居中、自定义
- 不透明度、模糊
- 自定义模式下还可调整位置、缩放、尺寸、重复、旋转、圆角等（见
package.json描述）
轮播与切换¶
可配置轮播间隔、顺序或随机播放，并手动切换下一张。切换前会预加载并交叉淡入，避免闪空。
跨区域合并¶
在表面列表中，把一个区域行拖到另一个区域行上，可合并为一张跨区域大图（类似多显示器壁纸效果）；拖出即拆分。
安装与启用¶
本插件是自带补丁层的组合包。用 dsh plugin 安装即可——命令把参数转发给 profile 的 pnpm，并自动把包挂载进 dsh.profile.bundles，无需手动编辑配置文件。
从本地路径安装（<路径>/background 为本仓库目录）：
dsh plugin --profile web add <路径>/background
从 GitHub 安装时，建议锁定 commit：
dsh plugin --profile web add github:gameswu/dsh-plugin-background#<sha>
从 GitHub 安装时，pnpm 会在安装后运行本包的 prepare 脚本以构建 lib/client.js。pnpm ≥10 默认拒绝执行此类脚本，首次 add 可能失败并提示把包键加入该 profile 的 pnpm-workspace.yaml 后重试：
allowBuilds:
dsh-plugin-background: true
授权构建意味着安装时会在本机执行该包的构建脚本，请只对可信来源授权。
安装完成后重启 Web 界面（dsh web）即可生效。
典型用法¶
打开 设置 → 插件 → 背景，按以下步骤配置：
- 在表面列表中点击要配置的区域；勾选多行可一次添加到多个区域
- 粘贴图片或视频链接，或选择本地文件
- 点击缩略图进入编辑器，调整显示模式与参数
- 把一个区域行拖到另一个区域行上，即可合并为跨区域大图
若以本地路径安装（pnpm link），重新构建后硬刷新浏览器（Ctrl+Shift+R）即可看到变更，无需重启服务。开发相关命令：
pnpm install # 安装依赖
pnpm build # 打包 → lib/client.js
pnpm typecheck # 类型检查
适用场景与注意¶
适合希望在 DSH Web 界面中按区域自定义壁纸、轮播图或静音背景视频的用户，尤其是长期开着对话区或轨迹区工作的智能体开发者。
使用前请注意：
- 插件以当前
dsh进程的权限在浏览器端运行，本地文件会写入 IndexedDB；安装前应阅读源码并确认 MIT 许可证 - 从 GitHub 安装需授权
prepare构建脚本，仅对可信仓库操作 - 跨区域合并与 vscode-sidebar 插件的独立区域能力，依赖对应插件已正确安装
结尾¶
dsh-plugin-background 把「每个区域一套背景、轮播与视频、本地持久化、跨区域大图」收敛到设置页的一个入口，无需改全局 CSS。若你使用 DSH Web 界面且想给工作区加一点视觉区分，可以从下面链接查看目录信息或阅读源码。
- SkillHub 目录页：https://www.skillhub.cn/plugins/gameswu/dsh-plugin-background
- GitHub 仓库：https://github.com/gameswu/dsh-plugin-background
