At a glance

What it does

Personalize DeepSeek Harness Web with independent image or muted-video backgrounds for its main interface areas.

Code-evidenced contributions

What it adds to DSH

Web UIWeb background settings

Adds independent image or muted-video backgrounds for DSH Web surfaces, with per-media display controls and slideshows.

Mechanism evidence ↗

Before you choose it

This Web GUI plugin adds a Background settings section for the chat, trace, left sidebar, and settings surfaces. Add media from URLs, local files, or folders; configure each item’s fit, opacity, blur, and other display properties; and create image slideshows or looping muted-video groups. You can also merge two surfaces into one cross-surface wallpaper.

Best for

DeepSeek Harness Web users who want a configurable visual workspace and are comfortable installing a Git-based DSH bundle.

Common tasks

Use a different wallpaper for chat, traces, the sidebar, and settings.
Cycle through an image group with a chosen order and interval.
Keep locally selected image or video media available after a browser refresh.
Apply a shared wallpaper across two interface surfaces by merging them.

Permissions and data

The plugin builds locally during GitHub installation when authorized and retains chosen local media in browser IndexedDB.

Permissions

Authorize pnpm to run the package's `prepare` build script when installing from GitHub.

Data handling

Local image and video selections are stored as IndexedDB blobs rather than base64 data.
Media URLs can be pasted into the plugin configuration.

External services

No external service requirement is declared; users may supply their own media URLs.

Credentials

No credentials are declared.

Limitations

Requires DSH 0.1.5-rc.1 or later.
The official right sidebar added in the cited DSH baseline does not receive a background layer.
The package is not evidenced as available from the npm registry.
GitHub installation may fail until the package is explicitly allowed to run its build script.

What DSHub checked

The pinned source is an immutable Git commit with a verified DSH bundle patch.
The package declares a Web client injection and an immediate client load.
The documented feature set includes per-area backgrounds, media groups, slideshows, local media selection, and compatibility with dsh-plugin-vscode-sidebar.

What DSHub did not check

Installation and runtime behavior were not executed in this curation record.
The behavior, availability, and privacy characteristics of user-provided media URLs were not verified.

Pinned install

Install DSH Background

This plugin bundle does not have a DSH Plugin install action. Use its source documentation for the delivery method.

Visit the source project ↗

Maintainer source

Project README

View at commit 0bb878f ↗

Maintainer-authored contentCaptured from README.md on Sep 10, 2026. The text and repository-relative media are fixed to commit 0bb878f2aa10 with content hash 2d233067e5ea; provider-hosted badges may update independently. README commands are upstream documentation; the DSHub copy action above is the verified, version-pinned install.

dsh-plugin-background

DeepSeek Harness Web 界面的背景插件：为对话区、轨迹区、侧边栏、设置页等界面区域设置独立背景，支持图片轮播与静音视频。灵感来自 VSCode 的 background 扩展。

兼容性：v0.5.0 起要求 DSH ≥ 0.1.5-rc.1（客户端继续使用平台基线模块 @deepseek-ai/dsh-client-store 与 @deepseek-ai/dsh-client-ui-primitives；0.1.5-rc.1 的平台基线新增 @deepseek-ai/dsh-client-ui-dockkit，本插件不导入它）。背景区域仍为对话区、轨迹区、左侧栏与设置面板；0.1.5-rc.1 新增的官方右侧栏没有对应的背景层需求，本兼容版本不为其增加新区域（存在 dsh-plugin-vscode-sidebar 时，其右侧面板与标签页区域照旧可用）。

它能做什么

每个区域一套独立背景：图片组像 PPT 一样轮播切换，视频组静音循环播放（每组只含一种媒体）
支持粘贴 URL（逗号分隔多张）、选择本地图片/视频、或整个文件夹；本地文件刷新后保留
每张图独立设置：显示模式（填充/适应/拉伸/平铺/居中/自定义）、不透明度、模糊
轮播间隔、顺序/随机、下一张；切换前预加载并交叉淡入，不会闪空
勾选多个区域后添加，同一批图可一次落到多个区域
拖拽两个区域可合并为一张跨区域大图（多显示器壁纸效果），拖出即拆分
兼容 dsh-plugin-vscode-sidebar：其右侧面板、下侧面板整体以及其中每个标签页都可作为独立背景区域

安装

本插件是一个自带补丁层的组合包（dsh.bundle + cordis.patch.yml）。用 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 install        # 安装依赖（esbuild 为构建依赖；typescript、React 18/@types、0.1.5-rc.1 client 类型仅开发/typecheck 用）
pnpm build          # 打包 → lib/client.js
pnpm typecheck      # 类型检查

本地路径安装（pnpm link）会直接使用本仓库的构建产物：重新构建后硬刷新浏览器（Ctrl+Shift+R）即可，无需重启服务。

License

MIT

Operate deliberately

Install and manage

Prerequisites and target Profile

Target： Web Profile

Delivery： Dsh Bundle Git — gameswu/dsh-plugin-background#0bb878f2aa104761a600c626dd7cab53dc7b035d。

Verify, update, and remove

Show lifecycle commands

Verify

dsh plugin --profile web list

Compatibility and access

Requires DeepSeek Harness Web 0.1.5 Rc.1 or later： DSH >= 0.1.5-rc.1。

Review compatibility evidence ↗

Risk facts

Local Build Execution

GitHub installation requires authorizing the package's prepare build script.

Evidence ↗

Local Media Storage

Selected local images and videos are stored as IndexedDB blobs so they persist after refresh.

Evidence ↗

Evidence and editorial reviewManifest, Bundle patch, distribution and freshness

Immutable evidence

Review status and source activity

AI reviewed

MIT-licensed bundle. Review the source and authorize its build script only if you trust the pinned repository.

AI reviewed Sep 10, 2026, 1:58 PM UTC。GitHub facts last checked Sep 10, 2026, 1:58 PM UTC。

No material source change has been recorded since this evidence baseline.

Next step

Follow the Plugin installation workflow →

Subscribe to material changes for DSH Background →