dsh-plugin-backgroundDeepSeek Harness plugin

dsh壁纸插件

GitHub
Stars
11
Forks
1
License
MIT
Last commit
Sep 2, 2026

Overview

dsh壁纸插件

Original README

Cached from the project repository on Sep 3, 2026. This is source content, separate from the Agents.md review above.

View source

dsh-plugin-background

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

兼容性：v0.4.0 起要求 DSH ≥ 0.1.2-alpha.5（客户端继续使用平台基线模块 @deepseek-ai/dsh-client-store 与 @deepseek-ai/dsh-client-ui-primitives，这些基线在 alpha.5 仍然存在）。

它能做什么

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

安装

本插件是一个自带补丁层的组合包（dsh.bundle + cordis.patch.yml）。用 dsh plugin 安装即可——它把参数转发给 profile 的 pnpm，并自动把包挂载进 dsh.profile.bundles，无需手动编辑任何配置文件：

bash
# 从本地路径安装（<路径>/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 后重试：

yaml
allowBuilds:
  dsh-plugin-background: true

授权构建意味着安装时会在你的机器上执行本包的构建脚本——请只对可信来源授权。

安装完成后重启 Web 界面（dsh web）即可生效。

使用

打开 设置 → 插件 → 背景：

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

更新与开发

bash
pnpm install        # 安装依赖（esbuild 为构建依赖；typescript、React 18/@types、alpha.5 client 类型仅开发/typecheck 用）
pnpm build          # 打包 → lib/client.js
pnpm typecheck      # 类型检查

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

License

MIT