前言¶
DeepSeek Harness（DSH）的 Web 界面默认是纯色画布：侧边栏、内容区和输入框各自铺满主题底色，长时间对着同一套灰阶界面，视觉疲劳很常见。社区里早就有「换背景」类做法，但若只在内容区底下垫一层图，侧边栏和标题栏区域往往仍是不透明块，整体像贴了一张局部海报，而不是整窗壁纸。
下面介绍社区插件 dsh-dt-bg（仓库 War-God0108/dsh-dt-bg，目录页 SkillHub）。维护者 War-God0108，分类为趣味换装。它是 DSH 背景替换的第二版实现：面向官方桌面端 0.2.0-rc.2 重写，支持图片或纯色壁纸，并让侧边栏、内容区、composer 等面板按设计令牌透出壁纸；安装脚本会自动挂载 Cordis 补丁，装完重启客户端即可使用。
这是什么¶
一句话：把壁纸放在窗口级固定层，用面板 alpha 透明化，而不是在布局内部用不透明层 + DOM 中和。
插件包在工程内名为 dsh-web-bg-2（npm version 2.0.0，MIT 许可证，Node >=20）。它注入 DSH Web 客户端（dsh web 与 Windows 官方桌面端 DeepSeek Harness.exe 内嵌页面），在「设置 → 通用 → 背景」提供配置项，持久化写入 <DSH_HOME>/profiles/<profile>/cordis.patch.yml 的 web-bg-2 条目。
与第一版 dsh-web-bg 1.x 相比，v2 针对官方桌面端实测到的三类问题做了架构调整：壁纸无法铺满侧边栏与标题栏高度、标题栏与页面底色割裂、整窗发灰（壁纸被主题底色兑淡）。v2 在复现页上可量到内容区颜色梯度从「完全平」变为「多色阶透出」——详见仓库 README 中的对比表。
核心功能¶
壁纸与视觉效果¶
- 壁纸类型：图片 URL、本地文件（≤4MB，转 data URL 持久化），或纯色。
- 壁纸层：
position: fixed全窗口、z-index: -2，位于所有面板之下，侧边栏与 composer 天然能透出。 - 画布让位：官方
body背景令牌不再盖住壁纸。 - 面板半透明：按几何识别侧边栏、内容面板、弹层等（不写死 React 哈希 class），用
rgba(主题底色, alpha)保留可读性；translucency控制通透强度，并设最低 alpha 地板，避免文字直接压在照片上。 - 壁纸后处理：
opacity（壁纸自身浓度）、dim（压暗以保证对比度）、blur（0–48px）。 - 透出范围：
scope可选all（全窗口）、content（仅内容区）、off（不透出）。
设置字段（默认值来自 README）¶
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true | 总开关 |
kind / image / color |
image / 空 / #1e293b |
图片或纯色 |
opacity |
1 | 壁纸浓度（语义与 v1 不同：v1 为与底色混合比例） |
dim |
0.18 | 壁纸压暗 |
blur |
0 | 模糊 |
translucency |
1 | 面板通透 0–100% |
scope |
all | 透出范围 |
安装与启用¶
安装方式以仓库提供的 install.mjs 为准（不是 dsh plugin add 一行命令）。在克隆或下载源码后的插件目录中执行：
node install.mjs
可选参数：
node install.mjs --profile web
node install.mjs --dry-run
node install.mjs --uninstall
脚本会把 lib/ 与 package.json 安装到 <DSH_HOME>/profiles/node_modules/dsh-web-bg-2，并在目标 profile 的 cordis.patch.yml 追加 web-bg-2 挂载项（已有则跳过，原文件备份为 .bak-dsh-web-bg-2）。
重启客户端才能进入 DSH 启动时的客户端模块表：
- 官方桌面端：完全退出
DeepSeek Harness.exe再打开； - 浏览器版：结束
dsh web后重新运行。
之后若只改 lib/ 内文件，可走 client-hmr 热重载，不必每次重启。若与 v1 同时挂载，两层会叠加；要去掉 v1，需从 cordis.patch.yml 删除 dsh-web-bg 对应 insert 后再重启。
典型用法¶
- 完成安装并重启 DSH。
- 打开 设置 → 通用 → 背景。
- 选择图片或纯色，按需调整浓度、压暗、模糊与通透度；需要整窗效果时将
scope设为all。 - 若效果异常，设置页可使用「上报诊断」，或按 README 运行
node tools/final-state.mjs核对插件实际读到的配置（维护者强调：看诊断时间序列，不要只看最新一条）。
仓库还提供面向维护者的自检命令（改插件代码时使用）：
node install.mjs
node tools/verify-all.mjs
适用场景与注意¶
适合谁：长期在 DSH 官方桌面端或 dsh web 上工作、希望统一壁纸风格且侧边栏与输入区能协调透出的用户。
环境与版本：README 写明面向官方桌面端 0.2.0-rc.2 重写；页面跑在桌面外壳 iframe 内，Windows 标题栏为 Electron 40px 不透明 overlay，本插件通过页面顶部与面板同色减轻接缝，而非修改外壳标题栏色。
安全与信任：插件以当前 DSH 进程权限运行，会修改 profile 下的 Cordis 补丁与 node_modules。安装前请自行阅读 GitHub 源码 与 MIT 许可证；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。
并存与回退：卸载可执行 node install.mjs --uninstall；与 v1 并存时注意层叠关系。
结尾¶
dsh-dt-bg 把 DSH 背景从「内容区底下一张图」推进到「窗口级壁纸 + 面板令牌透明」，针对官方桌面端 iframe 与主题 CSS 的实际行为做了重写，并附带安装脚本与诊断链路，便于装完即用、也便于维护者验证改动是否生效。
- 目录页：https://www.skillhub.cn/plugins/War-God0108/dsh-dt-bg
- GitHub：https://github.com/War-God0108/dsh-dt-bg
