dsh-background-plugin
用于 DeepSeek Harness Web UI 的背景图片，可调整不透明度、适应方式、模糊度和变暗程度。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yzf-king/dsh-background-plugin#f527ff3a3da55a3ca92d757413786b279749278e
Background Plugin 以 dsh-background-plugin 发布，当前版本为 1.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为 DeepSeek Harness（DSH Desktop / Web）提供的「背景图片」插件：把任意图片或内置渐变设为应用背景，并调节透明度、适应方式、模糊与暗化。背景覆盖主区域和左侧栏，状态持久化在宿主，重启/换端口都不丢。
A background plugin for the DeepSeek Harness Web UI: use an image or a built-in gradient as the app background, with opacity, fit, blur and dim controls. The state lives on the Host, so it survives restarts.
prefers-reduced-motion 时只显示静帧。<DSH_HOME>/storages/dsh-background.json，图片二进制保存在宿主附件库；重启、换端口、多窗口都不丢。background_set 直接换背景（set / clear / status）。react 由 Harness 客户端提供；宿主只用 Node 内置模块。前提：DSH Desktop 或
dshCLI，profile 位于%USERPROFILE%\.dsh\profiles\<name>（默认desktop）。 安装后需要重启 DSH Desktop（或重启dsh进程）让宿主半部分加载。
在 DSH 里对 Agent 说：
帮我安装 dsh-background-plugin 这个 bundle
Agent 会调用 plugin_manager install_bundle，自动完成依赖安装与 bundle 注册。
设置 → 插件 / Plugins → 添加（安装 bundle），选择本包或输入包名。安装成功后启用并重启。
# 在 profile 里安装依赖（pnpm 透传）
dsh plugin --profile desktop add <本包路径或包名>
随后把包名加入该 profile package.json 的 dsh.profile.bundles，再执行 pnpm install，重启 DSH。
克隆仓库后运行：
# Windows
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Profile desktop
# macOS / Linux
bash ./install.sh
脚本会：把包复制到 <DSH_HOME>\plugins-src\dsh-background-plugin，把依赖与 bundle 写入 profile 清单，执行 pnpm install，然后提示重启。
dsh plugin --profile desktop add github:<your-gh-user>/dsh-background-plugin
同样需要把包名加入 dsh.profile.bundles 并重启。
bundle 的行配置在 cordis.patch.yml 的 config 里，可在 profile 补丁层覆盖：
- insert:
- id: background-plugin
name: dsh-background-plugin
config:
defaultPreset: '' # 首次运行使用的预设名（如 深海）
defaultOpacity: 0.6 # 0..1
fit: cover # cover | contain
blur: 0 # 0..40
dim: 0 # 0..0.9
这些是首次运行的默认值；用户之后在设置页里改的值优先。
设置 → 背景图片：
动图与视频的限制：单文件 ≤8MB，视频 ≤15 秒，推荐 MP4(H.264) / WebM。
上传或导入过的背景会出现在「背景库」里，点缩略图即可换回，右上角 × 可移除。
也可以直接对 Agent 说：「把背景换成暮色，透明度 40%」。
package.json # dsh.bundle + dsh.client 声明
cordis.patch.yml # 插入 background-plugin 行
index.js # 宿主：状态持久化 + /api/background/* + background_set 工具
client.js # 浏览器：设置页 + html::before 背景层
locale/{zh,en}.json # 插件显示名与描述
icon.svg # 插件图标
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/background/state | 读取当前状态与预设 |
| PUT | /api/background/state | 修改 opacity/fit/blur/dim/preset/url/clear |
| POST | /api/background/image | 上传 { dataUrl }，存入附件库 |
| GET | /api/background/image | 读取当前背景图 |
| POST | /api/background/media | 上传动图/视频 { dataUrl }，逐字节保存（≤8MB） |
| GET | /api/background/media | 读取动图/视频（支持 Range，视频可正常循环/seek） |
| POST | /api/background/clear | 清除背景 |
发布到 npm（任选其一）：
npm publish --access public
或使用 GitHub Actions：在仓库 Secrets 里配置 NPM_TOKEN（npm 发布令牌），然后推 tag：
git tag v1.0.0
git push origin v1.0.0
.github/workflows/publish.yml 会在 tag 推送时自动发布。
纯 JavaScript，无构建步骤：
node --check index.js
node --check client.js
安装到本地 profile（推荐用 Agent 的 plugin_manager，或运行 install.ps1），重启后即可在设置里看到。
plugin_manager、dsh.client 与 settings.section slot 的版本）。dsh-client-ui-slots / settingsScope 时代不适用。MIT