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）即可生效。

使用

打开 设置 → 插件 → 背景：

1. 在表面列表中点击要配置的区域（勾选多行可一次添加到多个区域）
2. 粘贴图片/视频链接，或选择本地文件
3. 点击缩略图进入编辑器调整显示模式与参数
4. 把一个区域行拖到另一个区域行上，即可合并为跨区域大图

更新与开发

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