前言¶
DeepSeek Harness（DSH）默认界面偏工具向，长时间对着同一套配色工作时，有人会想换成自己的图或渐变，又希望对话区文字仍然可读。改客户端文件或注入脚本既难维护，也和 DSH「一切皆插件」的方向不一致。下面介绍社区插件 dsh-private-background：通过官方插件接口注册面板与样式，在桌面版里给工作区（可选整窗）换背景，素材只留在本机。
这是什么¶
dsh-private-background 由维护者 lubanaishuxue 开发，在 SkillHub 插件目录 中归类为「趣味换装」。它解决的是：在 DeepSeek Harness 界面里设置自定义壁纸——本地图片、动图（GIF / 动态 WebP / APNG）、视频、渐变或纯色，并调节模糊、压暗、取景位置，以及面板 / 对话区 / 输入框不透明度；可选液态玻璃质感。默认只作用于右侧工作区，左侧对话栏保持 DSH 原样。
README 写明：非官方插件，第三方开发，DSH 官方不提供支持；不修改客户端文件、不注入脚本、不触碰账号与凭据，但安装任何插件前仍建议查看源码。当前资料中的版本为 1.3.3，在 Windows + DSH 桌面版 0.2.1-rc.2 上开发和测试；macOS / Linux 未验证。许可证为 MIT。
核心功能¶
背景来源¶
| 类型 | 说明 |
|---|---|
| 关闭 | 恢复 DSH 原样 |
| 图片 | 图库中的静图、动图或视频 |
| 渐变 | 6 个内置预设：极光、夜幕、落日、深海、青柠、纸感 |
| 纯色 | 6 个色板或自选颜色 |
添加文件时支持 JPG、PNG、GIF、WebP、MP4、WebM 等。静图会缩到约 2560px 宽再压成 JPEG 存入 IndexedDB；动图与视频保留原始字节（单文件上限 96 MB），视频用第一帧做封面与亮度判断。同一份内容通过 SHA-256 指纹去重，不会重复入库。
观感与范围¶
五条滑杆（质感为「液态玻璃」时第五条变为「玻璃模糊」）：
- 模糊 0–40px、压暗 0–80%、面板不透明度 0–100%、对话区不透明度 0–100%、输入框不透明度 0–100%（实心模式）或 玻璃模糊 0–40px（液态玻璃模式）。
- 默认：模糊 20、压暗 15、面板 50、对话区 0、输入框 50。
- 质感：实心（默认）或液态玻璃（磨砂半透明 + 高光，作用于输入框、状态栏、消息气泡等）。
- 同时应用到左侧对话栏：默认关；开启后整窗铺满，左侧栏也半透明。
- 字体颜色：跟随主题 / 自动 / 浅色 / 深色 / 自定义；README 推荐在亮暗图之间切换时用「自动」。
每张背景单独记住模糊、压暗、取景位置与各档不透明度、质感；玻璃模糊、作用范围、字体颜色为全局共用。换壁纸时有约 0.6 秒淡入；系统开启「减少动态效果」时动图、视频与过渡会相应受限。
隐私与存储¶
图片、动图、视频只写入 DSH 页面下的 IndexedDB，资料说明无网络请求、无统计上报；卸载插件后存储随页面清掉，也可在设置页逐张删除。
安装与启用¶
前置条件：Node.js ≥ 20、DSH 自带 dsh 命令、pnpm 在 PATH 上（缺 pnpm 会报 pnpm was not found）。
桌面版安装（命令来自项目 README）：
dsh plugin --profile desktop add github:lubanaishuxue/dsh-private-background
机器上没有 git 时：
dsh plugin --profile desktop add https://github.com/lubanaishuxue/dsh-private-background/archive/refs/heads/main.tar.gz
从本地目录安装（自行改代码时）：
dsh plugin --profile desktop add D:/path/to/dsh-private-background
装完后需要 重启 DSH（重新打开窗口不算）。入口有两处，同一套表单：左栏底部壁纸图标，或 设置 → 插件 → 界面背景。
插件以当前 DSH 进程权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
按 README「一分钟上手」可复现如下：
- 点左栏底部的壁纸图标。
- 背景类型选「图片」。
- 点「添加图片」，选择本地文件。
- 拖 压暗 和 面板不透明度，直到文字可读（多数情况下先调压暗，再微调面板，模糊可最后加）。
- 主体不在画面中央时，在预览图上拖动调整取景，或使用「左右」「上下」滑杆。
- 若希望壁纸含左侧对话栏，打开「同时应用到左侧对话栏」。
改完即时生效并自动保存，无需「应用」按钮或再次重启。图库下方可用 浏览文件夹 批量列出文件夹内尚未入库的图片与视频，逐张添加。
调参顺序上，README 建议：先选图 → 压暗 → 面板不透明度 → 模糊 → 需要时再开液态玻璃并调玻璃模糊。
适用场景与注意¶
适合：希望在 DSH 桌面版用本地壁纸或渐变个性化界面、且在意素材不出本机的用户。
注意：
- 作用范围依赖 DSH 外壳 DOM 结构，宿主大改布局可能失效；设置页底部有
样式 / 激活 / 框架 / 三栏诊断读数，出现异常时可对照 README「出问题了」一节。 - 只改工作区时标题栏仍为侧栏色；视频壁纸持续解码，笔记本上更费电。
- WebP 在实现上按动图路径处理，静态 WebP 可能占用大于静图缩存后的体积。
- 左栏图标无响应时，检查 DSH 启动日志是否加载
dsh-private-background。
停用插件后界面改动撤回，设置仍留在本机直至卸载或清数据。
结尾¶
dsh-private-background 把壁纸、渐变、纯色和可读性调节收进一个官方插件面板里，数据留在 IndexedDB，不上传、不进会话。若要安装或看更新说明，可打开 SkillHub 目录页 与 GitHub 仓库。
