前言¶
DeepSeek Harness（DSH）的 Web GUI 默认是统一的浅色或深色底。长时间对着同一套界面工作时，有人会希望换一张自己的背景图，但又不能动布局、不能把文字和控件糊成一片。社区插件 DSH Background Image（仓库 ASUKAq01/dsh-background-image）走的就是这条线：只在浏览器里加一层背景，用滑块调不透明度和虚化，主画布和侧栏底色变透明以便露出图片，卡片和输入框仍用不透明表面。下面介绍它是什么、能做什么，以及如何安装和使用。
这是什么¶
DSH Background Image 是由维护者 ASUKAq01 发布的轻量 客户端 Web 插件（当前版本 1.0.0，MIT 许可）。SkillHub 目录将其归类为 趣味换装。
一句话定位：为 DeepSeek Harness Web UI 上传自定义背景图，调节不透明度与虚化，只改外观，不移动任何宿主控件。图片与设置保存在当前浏览器的 localStorage，插件不上传图片、不读取会话内容，也不为此发起网络请求。
核心功能¶
以下能力均来自仓库 README 与 package.json 说明。
- 上传即用：支持选择或拖入 JPG / PNG / WebP / GIF；浏览器内自动缩放、重新编码。
- 两个滑块：背景不透明度（0–100%）与虚化程度（0–40 px），拖动实时生效。
- 主题自适应：浅色 / 深色主题分别叠加白色、
#151517的主题色薄纱；切换主题自动跟随。 - 不改变布局：背景层
z-index: -1、pointer-events: none，不参与布局、不拦截点击。 - 可读性优先：仅让主画布、会话区和侧栏的底色透明；卡片、输入框、弹层仍用不透明表面。
- 本地存储：压缩后的图片与设置写入
localStorage（键名见下文「存储与隐私」）。 - 干净卸载：禁用或卸载时清理样式、CSS 变量、令牌覆盖与类名。
- 双语界面：设置页随 Harness 界面语言显示中文或英文。
兼容性：DeepSeek Harness >=0.1.7-rc.1 <0.3.0-0。插件使用 ctx.slots、ctx.locale、ctx.theme.overrideTokens，注册槽位 settings.plugins.tab 与 plugins.row.config；client.js 直接以 Harness 模块格式加载，无单独构建步骤。
安装与启用¶
插件目前通过 GitHub 分发，尚未发布到 npm（package.json 已命名为 @asukaq01/dsh-background-image，发布后可用 CLI 从 npm 添加）。
安装前请确认 Harness 版本落在上述区间内。插件在 当前 DSH 进程与 Web 客户端 中运行；安装前应自行查看仓库源码与 MIT 许可证，再决定是否启用。
方式一：DSH 插件管理器¶
先把仓库克隆到本地（官方 README 给出的命令如下）：
git clone https://github.com/ASUKAq01/dsh-background-image.git
在 Harness 中打开 设置 → 插件，通过添加/安装本地目录的入口选择克隆下来的 dsh-background-image 目录，启用后 刷新一次页面。
方式二：dsh CLI¶
同样先克隆仓库：
git clone https://github.com/ASUKAq01/dsh-background-image.git
dsh plugin --profile <profile> add ./dsh-background-image
将 <profile> 换成正在使用的 profile（例如 desktop 或 web），然后重启或刷新 Harness。
npm（尚未可用）¶
README 说明发布后预期命令为：
dsh plugin --profile <profile> add @asukaq01/dsh-background-image
当前请勿依赖 npm 安装，除非维护者已正式发布包。
典型用法¶
经过上面的步骤启用并刷新页面后，可按 README 中的流程操作：
- 打开 设置 → 插件 → 背景图（或从插件列表中本插件的配置入口进入）。
- 点击「选择图片」，或将图片拖进预览框。
- 调整「背景不透明度」和「虚化程度」；关闭设置面板即可查看整窗效果。
- 需要恢复默认外观时，使用「移除背景」：删除本地图片并恢复宿主原始样式。
首次安装完成后需刷新一次页面，浏览器才会加载新的客户端模块。
存储与隐私¶
dsh.background-image.image.v1：压缩后的图片与尺寸。dsh.background-image.settings.v1：不透明度与虚化值。
图片在浏览器内缩放至最长边 2560 px，并优先编码为 WebP，以适配 localStorage 配额。清除站点数据或在设置页点击「移除背景」会删除已保存的图片。
适用场景与注意¶
适合谁：希望在 DSH Web 界面做轻度「换装」、又需要保持控件可读性与原布局的用户；数据敏感场景下可接受「仅本地浏览器存储、无上传」的实现方式。
注意：
- 背景仅存在于当前浏览器 profile 的站点数据中，换设备或清缓存需重新上传。
- 与 Harness 主版本强相关：
peerDependencies要求@deepseek-ai/dsh在>=0.1.7-rc.1 <0.3.0-0范围内，升级 Harness 前宜核对插件是否仍兼容。 - 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；安装来源以你信任的仓库与 commit 为准。
开发或二次修改时，可将仓库目录安装到某个 profile 后直接改 client.js，刷新页面即可验证；仓库提供 node scripts/validate.mjs 做字段、locale、图标与语法校验，GitHub Actions 在 push 与 PR 时运行同一脚本。
结尾¶
DSH Background Image 把「自定义壁纸」收束成上传、两枚滑块和本地存储，并通过令牌覆盖与固定背景层避免破坏布局与可读性。若要查看元数据与分类，可打开 SkillHub 目录页；源码、CHANGELOG 与 issue 见 GitHub：
