dsh-webui-background
English
dsh-webui-background 是一个独立的 DeepSeek Harness 插件，为 Web UI 提供可配置的背景图。它通过 Harness 的组合包与客户端插件扩展点安装，不需要修改或替换 website/public、apps/web/public 中的文件。
功能
- 设置页面内嵌“Web UI 背景”标签页，可上传、拖放和预览图片。
- 支持 PNG、JPEG、GIF 和 WebP，按文件内容识别格式，最大 20 MiB。
- 分别调整浅色模式与深色模式遮罩，保存后立即生效。
- 可以暂时停用背景而保留图片，也可以一键删除图片并恢复默认界面。
- 设置与图片按 Harness profile 独立保存；多个 profile 互不影响。
- 远程页面可以查看设置，只有回环地址页面能够修改，避免受信任 Host 被远程网页写入。
安装
需要支持外部组合包与浏览器客户端插件的 DeepSeek Harness 0.1.0-rc.5 或更高版本。
dsh plugin --profile web add dsh-webui-background@next
dsh web
如果 Web UI 已经在运行，请重启它。打开“设置 → 插件 → Web UI 背景”，选择图片并保存。
卸载：
dsh plugin --profile web remove dsh-webui-background
卸载不会主动删除 profile 数据。需要清除图片时，请先在插件页面点击“恢复默认”。
关于文件名
上传源文件可以使用普通的 .webp、.png 等扩展名。插件会读取文件内容并自动识别格式；保存到 profile 后会使用内容哈希作为内部文件名且不带扩展名，这是正常行为。浏览器通过插件的 /webui-background 路由取得正确的 Content-Type，所以不依赖磁盘扩展名。
每个 profile 的数据位于该 profile 目录下的 data/webui-background/。state.json 保存开关、遮罩和修订号，图片以 background-<sha256> 保存。
从源码安装
git clone https://github.com/lx963/dsh-webui-background.git
cd dsh-webui-background
pnpm install
pnpm test
pnpm build
dsh plugin --profile web add .
发布包在 prepack 阶段生成 Host ESM、浏览器 CJS 和类型声明。源码使用 Node.js ^22.19.0 || >=24 与 pnpm 10。
安全与限制
- SVG 不受支持，因为它可以包含主动内容。
- 图片必须通过魔数校验；扩展名与浏览器传入的 MIME 类型不作为信任依据。
- 图片响应使用
no-store 与 nosniff；URL 中的修订号仅用于页面刷新当前图片。
- 插件每个 profile 只保留一张当前图片，并使用乐观修订号避免多个页面静默覆盖彼此的设置。
许可证
MIT
