前言¶
DeepSeek Harness（DSH）的 Web 客户端界面默认是纯色或主题自带的背景。若你想用本机图片或短视频做壁纸，同时让侧栏、主框架呈现半透明毛玻璃，常见做法是往页面里叠一层背景 div，再对面板逐个加 backdrop-filter，往往伴随 DOM 扫描或 MutationObserver，关掉插件后还容易留下样式残留。
dsh-ui-background 由社区维护者 ai-yue-love 发布，面向 DeepSeek Harness Web 客户端：在底层加一个固定背景图层，并通过覆盖官方主题令牌实现全界面毛玻璃，而不是扫描 DOM。下面介绍它做什么、怎么装、以及使用时需要接受的限制。
这是什么¶
一句话：dsh-ui-background 是给 DSH Web 端用的插件，提供本地图片/视频背景和基于主题令牌的毛玻璃 UI。
- 维护者：ai-yue-love
- 许可证：MIT（见仓库 LICENSE）
- npm 包名：
dsh-ui-background（package.json中版本为 0.8.3；README 写明在 DSH 0.2.0-rc.2 上开发与验证，RC 阶段内部契约可能变化，升级 DSH 后需重新验收） - 运行要求：Node
>=22.19.0 - 星标：社区目录页线索为 0（以目录站展示为准）
背景层只有一个 position: fixed; z-index: -1 的图层（图片用纯 CSS，视频用一个 <video>）。毛玻璃通过 ctx.theme.overrideTokens 改写如 --dsw-alias-bg-base、--dsw-specific-sidebar-fill 等令牌；DSH 的 body、主框架、侧栏本就依赖这些令牌绘制，因此插件侧不做 DOM 扫描、不用 MutationObserver、也不逐面板挂 backdrop-filter。关闭背景即撤销令牌层，界面可回到默认样式。
核心功能¶
以下能力均来自仓库 README，安装前请自行阅读源码与许可证；插件以当前 DSH Host 进程权限运行，会读取你配置的本机路径与上传文件。
- 背景来源：上传文件，或填写本机路径（只读，不复制、不移动文件）。
- 视频背景：支持
mp4/webm循环播放；切到后台时自动暂停。 - 构图：
cover/contain、缩放 50%–300%、水平/垂直位置；设置页预览里可直接拖动调整。 - 壁纸引擎：自动扫描 Steam 工坊应用
431960，只列出可直接播放的图片或视频项。 - 最近使用：最多 12 条，带缩略图与构图参数，一键恢复，可单条删除。
- 文件管理：上传项可单独删除；若删掉正在使用的背景，背景会自动关闭。
- 隐私：README 写明全部本地处理，不联网、不收集数据。
状态持久化在 $DSH_HOME/storages/dsh-ui-background/（state.json 与 backgrounds/）；卸载插件不会自动删除该目录，需自行清理。
安装与启用¶
安装命令须使用官方 README 原文（针对 Web profile）：
dsh plugin --profile web add dsh-ui-background
装完后必须重启一次 Host：DSH 的模块解析表在启动时构建，当次会话无法导入新装的包。
重启后打开 DSH 设置，进入 「背景与玻璃」 面板配置壁纸与玻璃效果。
典型用法¶
- 安装并重启 Host 后，在 背景与玻璃 中上传图片/视频，或填写本机媒体路径。
- 在预览区拖动调整位置，按需选择铺满或完整显示、缩放比例。
- 若本机安装了 Wallpaper Engine 且订阅了工坊
431960内容，可在插件列出的可播放项中选取（Scene 类壁纸见下文限制）。 - 需要清晰静态图时：README 建议在 Wallpaper Engine 中
Win+Shift+S截图后，在设置里使用「粘贴截图」（示例分辨率 1920×1080）。
Host 端 HTTP 路由仅回环；写操作会拒绝 sec-fetch-site: cross-site。上传文件名会做净化，不接受路径穿越。Host 只读你在设置里显式指定的本机文件，以及 Steam 工坊目录中的 project.json、媒体与预览图。
适用场景与注意¶
适合：
- 希望用本地图片或短视频作 DSH Web 背景，并让主界面随令牌半透明。
- 经常换图，但希望缩放与位置保存在「最近使用」里，下次一键恢复。
做不到或需注意：
| 情况 | 说明 |
|---|---|
| Wallpaper Engine Scene | scene.pkg 需 WE 自有引擎渲染，本插件只处理图片与视频文件。 |
| 用 WE 预览图当大图 | README 实测预览图约 144–254 px，铺满 1920 宽会明显模糊。 |
mkv / mov |
Edge 可能无法播放，建议 mp4 / webm。 |
| 全局半透明副作用 | 凡使用同一套基础背景令牌的区域（如代码块顶栏、图片占位、弹层遮罩）都会变透，这是令牌方案的代价。 |
DSH 生态主张「一切皆插件」；SkillHub 目录页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系。安装任何插件前，建议在 GitHub 仓库 核对源码、Issue 与 CHANGELOG。
开发与自测¶
维护者在 README 中提供本地自测方式（不依赖完整 DSH 界面）：
node selftest.mjs
说明：用模拟 Cordis 上下文挂载 host 半身，直接调用插件 HTTP 处理器。lib 端仅依赖 node:fs、node:path、node:os，无 npm 运行时依赖。
结尾¶
dsh-ui-background 把壁纸层与主题令牌覆盖绑在一起：少 DOM 钩子、关得快、构图可记在本地历史里。若你主要在 Web 端长时间使用 DSH，并愿意接受令牌带来的全局半透明，可按上述命令安装、重启 Host，在 背景与玻璃 里验收效果。
- 目录页：https://www.skillhub.cn/plugins/ai-yue-love/dsh-ui-background
- GitHub：https://github.com/ai-yue-love/dsh-ui-background
