前言¶
在 DeepSeek Harness（DSH）里长时间开智能体会话时，默认界面往往是统一的浅色或深色卡片风格。若你希望整个界面背后是自己选的图片或循环静音视频，又不想把对话框、审批提示和设置页弄得难以阅读，需要在「全屏媒体」和「可读交互面」之间做分层控制。社区插件 dsh-plugin-wallpaper（维护者 william-godric-han，目录分类为趣味换装）就是做这件事的：在 Harness Web UI 里导入本地图片或视频作为背景，用遮罩、模糊、填充和表面不透明度等参数调节观感，并让弹窗、菜单等交互区域保持可读下限。
这是什么¶
dsh-plugin-wallpaper 是一个 Harness bundle：一条 cordis.patch.yml 记录加浏览器端模块，面向已启用 Web UI 的 DSH 环境。宿主侧 index.js intentionally 为空，逻辑集中在 client.js。插件不向网络上传任何内容，安装后行为以当前 DSH 进程与浏览器中的模块为准；使用前建议自行查看仓库源码与 MIT 许可证。README 写明在 0.2.2-rc.1（桌面端与 dsh web）上构建与测试；支持 Harness Web UI 所运行的各操作系统，无独立构建步骤与额外依赖。
核心功能¶
下面按 README 已列能力归纳，不超出文档表述。
- 自有媒体：通过系统文件选择器导入任意
image/*或video/*（视频静音循环播放），仅保存在当前浏览器。 - 玻璃化外壳：框架、侧栏、标题栏等 shell 令牌设为透明，媒体成为界面底色而非窄条背景。
- 表面不透明度：单一滑块控制环境表面（气泡、输入区、色调等）保留多少「实体感」；
0%接近纯壁纸，100%接近默认白卡片观感。 - 交互面可读性：对话框、问题卡片、审批提示、菜单、弹出层与 toast 至少保持约 88% 主体不透明度；设置页强制完全不透明。
- 六种渐变预设：无文件时也可使用，或作为后备方案。
- 遮罩、模糊与填充：按明暗主题在媒体上叠加白/黑遮罩；模糊 0–24 px；填充模式
cover或contain。 - 持久化：媒体存 IndexedDB，设置存 localStorage，刷新或重启后仍保留。
- 单文件上限：每个文件最大 200 MB；插件不进行网络请求。
安装与启用¶
插件以本地 bundle 形式安装。资料给出三种路径，任选其一即可。
在应用内：打开左侧边栏 Plugins，选择从本地目录安装，指向包含本插件的文件夹（需先自行取得仓库或解压后的目录，路径因环境而异）。
在 Agent 会话中：让 Harness Agent 安装 bundle，或对插件管理工具传入绝对路径，例如：
{ "action": "install_bundle", "target": "D:\\path\\to\\dsh-plugin-wallpaper" }
通过 CLI：在 Harness 检出目录下执行（将路径替换为本机绝对路径）：
dsh plugin --profile <profile> add /absolute/path/to/dsh-plugin-wallpaper
bundle 通过 HMR 激活。若页面仍显示旧构建，请 reload 一次页面（或重启应用），因浏览器会按图版本保留客户端模块。
若 Wallpaper 药丸按钮未出现，多在 Plugins 中未启用 bundle，需在插件页打开后再试。
典型用法¶
- 打开任意会话，在 composer 坞右侧找到 Wallpaper 药丸（靠近 round/token 计数器）。
- 在面板中：
- Image / Video：选择文件，立即生效并记住。
- Presets：六种渐变，适合尚未准备媒体时。
- Veil：媒体上的变暗层（浅色主题为白、深色主题为黑）。
- Blur：0–24 px；媒体会略放大以避免模糊露出边缘。
- Surface opacity：环境表面主体强度；对话框等仍遵守可读下限。
- Fill：Cover或Fit。
- Enable wallpaper：临时关闭显示但保留媒体与设置。
- Reset all：清除媒体与全部设置。 - 药丸上的圆点表示壁纸处于启用状态。
数据落点（便于排查或理解隐私边界）：
| 内容 | 位置 |
|---|---|
| 图片 / 视频 blob | IndexedDB dsh-beautify，对象库 media，键 image / video |
| 设置 | localStorage["dsh-beautify/settings/v1"] |
适用场景与注意¶
适合谁：希望在 Harness Web UI 里个性化背景、又需要对话框与设置页保持可读的开发者或个人用户；偏「趣味换装」类体验，不改变 Agent 核心能力。
权限与信任：插件随 DSH Web 客户端在浏览器内运行，读写本机 IndexedDB 与 localStorage。安装前应阅读 GitHub 仓库 中的 client.js 等源码，确认符合你的环境与合规要求。资料明确说明无上传、无插件发起的网络调用。
使用注意（摘自官方故障排除表）：
| 现象 | 处理 |
|---|---|
| 亮图导致文字难读 | 提高 Veil 或 Surface opacity |
| 视频卡顿 / CPU 高 | 将模糊设为 0，或改用图片 |
| 提示文件过大 | 单文件上限 200 MB |
| 清除站点数据后壁纸消失 | 媒体仅存当前浏览器，需重新导入 |
| 更新后界面无变化 | 重新加载页面或重启应用以拉取新 client 模块 |
卸载：在 Plugins 禁用或移除 Wallpaper，或从 profile 的 dsh.profile.bundles 去掉对应项；浏览器数据可能残留，若需彻底清除可先使用面板 Reset all。
结尾¶
dsh-plugin-wallpaper 把 Harness Web UI 的背景换成本地图片或视频，并用主题令牌覆盖与交互面不透明下限，在个性化与可读性之间做了文档化的折中。社区目录页：william-godric-han/dsh-plugin-wallpaper；源码与完整说明：github.com/william-godric-han/dsh-plugin-wallpaper。
