前言¶
DeepSeek Harness（DSH）桌面端的聊天界面默认是纯色或主题色背景，长时间对着同一套 UI 写提示词、看 agent 输出，视觉疲劳很常见。换主题只能动配色，很难像桌面壁纸那样用自己喜欢的图铺满窗口，还要保证侧栏文字仍然可读。社区插件 dsh-chat-background 在本地运行，把背景图、侧栏遮罩、输入栏装饰和用量信息收进「设置 → 页面设置」，不依赖外网资源。
下面介绍这个插件的定位、能力、安装方式与日常使用要点。
这是什么¶
dsh-chat-background 是 LittleLemonJam 维护的 DSH 桌面端插件，分类属于社区目录中的「趣味换装」。它在 Web GUI 上叠加聊天背景图，并附带三栏独立遮罩、背景轮换与分组、输入栏背景条、任务进度条，以及全会话 Token 总用量显示；各项均在「设置 → 页面设置」里调整。
插件以当前 DSH 进程权限在本机读写背景目录与会话投影，安装前建议在 GitHub 仓库核对源码与 MIT 许可证。
核心功能¶
资料中列出的能力如下，均可在设置页配置。
| 能力 | 说明 |
|---|---|
| 聊天背景 | 从背景文件夹选图铺满界面；支持 png / apng / jpg / jpeg / webp / gif / avif / bmp / svg；GIF、动画 WebP、APNG 会播放动画 |
| 背景轮换 | 固定一张或自动轮换；轮换间隔 5–300 秒 |
| 切换特效 | 淡入淡出、渐变过渡、无；时长 0–3 秒 |
| 轮换分组 | 只轮换勾选的图片；缩略图、5 行滚动列表、拖动排序，勾选不改变顺序 |
| 三栏遮罩 | 左侧栏 / 主窗口 / 右侧栏分别设置 0–100 遮罩不透明度 |
| 背景条 | 输入栏下方一条等宽背景条，包住用量数据，可自定义颜色 |
| 任务进度条 | 有任务清单时显示完成度，执行中按步数估算，空闲时隐藏 |
| Token 总用量 | 左下角显示所有会话（含已归档）的累计 token 用量，可调字号 |
| 图片滚轮缩放 | 聊天图片灯箱、右侧栏图片预览可滚轮缩放；灯箱双击还原 |
浅色 / 深色主题会自动适配；遮罩调到 100 时该区域完全不透明，调到 0 时完全显示背景。右侧栏全屏预览时，左侧栏保持可见，主窗口与原右栏变为右栏内容，退出后恢复原布局。
安装与启用¶
前置条件：DSH 桌面端 ≥ 0.2.1-rc.3。从源码构建需要 Node ≥ 22.19，普通安装不需要 Node。
从 GitHub 安装（推荐）¶
在终端执行：
dsh plugin --profile desktop add github:LittleLemonJam/dsh-chat-background
从 npm 安装¶
npm 包与 GitHub 发布同步（当前 1.1.0），任选其一：
dsh plugin --profile desktop add dsh-chat-background
安装后完全退出并重新打开 DSH 桌面端；宿主半在启动时加载，只刷新页面不够。可在 插件 → 已安装 确认 dsh-chat-background 处于启用状态。
背景图目录¶
图片放在 ~/.dsh/backgrounds/（Windows 为 C:\Users\<用户名>\.dsh\backgrounds\）。也可用环境变量 DSH_BACKGROUNDS_DIR 指向其他目录。目录不存在时不必手动创建：第一次打开设置页或点「打开文件夹」时插件会自动建好。放入图片后，在 设置 → 页面设置 → 背景 点「重新扫描」即可看到。
典型用法¶
- 固定或轮换背景：在「背景显示方式」里选择。轮换时只使用「轮换分组」里勾选的图片；全部不勾选则使用整个背景库。
- 调节可读性：分别拖动左栏、主窗口、右栏遮罩，在壁纸与文字对比度之间取舍。
- 看 agent 进度：有任务清单时进度条按「已完成 / 总数」显示；没有清单但正在执行时按本轮步数估算（最高 92%）；空闲时隐藏。
- 看累计 Token：左下角汇总所有会话（含已归档）的 token 用量，每 10 秒缓存、每分钟刷新；数据只在本机读取。
适用场景与注意¶
适合希望在 DSH 桌面端长期使用、又想把聊天窗口做成「带壁纸的工作台」的用户。背景与 Token 数据均本地处理；插件不访问互联网、不读取凭据，HTTP 路由默认只监听本机回环地址。
若通过非回环地址（反向代理或远程访问）打开 GUI，图片与 Token 路由默认会被请求栅栏拒绝。需在可信代理环境下设置 DSH_CHAT_BACKGROUND_ALLOWED_HOSTS=<你的主机名> 后再使用。
兼容性方面，资料记载已验证 DSH 0.2.1-rc.3（Electron 44 / Node 24），支持 Windows / macOS / Linux 桌面端。SVG 以沙箱 CSP 提供；文件名、图片大小、目录扫描数量和会话文件大小均有上限，细节见仓库 SECURITY.md。
结尾¶
dsh-chat-background 把壁纸式背景、侧栏柔化和小型用量 UI 收进同一套页面设置，适合在不动核心对话逻辑的前提下给 DSH 桌面端换肤。社区目录页：https://www.skillhub.cn/plugins/LittleLemonJam/dsh-chat-background；源码与完整说明：https://github.com/LittleLemonJam/dsh-chat-background。
