# dsh-plugin-wallpaper-engine · 小白向使用指南

[English README](README.en.md) | [中文 README（完整版）](README.md) | **小白向指南（你正在看）**

> 这是一份**给完全没用过命令行的人**看的简化说明。
> 想看完整的功能细节和技术原理，请看上面的「中文 README（完整版）」。

---

## 这是什么？

一句话：**把你 Steam 里的 Wallpaper Engine 壁纸，搬到 DeepSeek Harness（DSH）的网页聊天界面背景上。**

- 装好之后，打开 `dsh web`，你的聊天界面后面就会显示一张动态壁纸（视频 / 网页 / 场景静态图）。
- 壁纸上面还会盖一层 **iOS 风格的「液态玻璃」**，让文字依然看得清。
- 你可以随时换壁纸、调透明度、调颜色，甚至上传自己的图片/视频当壁纸。
- **所有设置从 v0.4.0 起保存在你电脑上的一个文件里**，重启、换浏览器、清缓存都不会丢。

---

## 开始前，请确认你有

- ✅ 一台 **Windows** 电脑（Mac 用户请看本页最后的「Mac 用户」一节）。
- ✅ 已经装好并打开过一次 **Wallpaper Engine**（Steam 上的那个壁纸软件），且里面至少有一张壁纸。
- ✅ 已经装好 **DSH**（DeepSeek Harness），并能跑起 `dsh web`。
- ✅ 知道怎么打开「**命令提示符**」或「**PowerShell**」（在开始菜单里搜就行）。

> 没有 Wallpaper Engine？这个插件依赖它来扫描壁纸，没有它就用不了 WE 自带的壁纸。不过你**仍然可以**只用「自定义壁纸」功能上传自己的图片/视频当背景。

> ⚠️ **升级顺序很重要（v0.7.2 起）**：更新本插件之前，要先满足**两个前置条件**——① **DSH 桌面版（DSH Desktop）为最新版**（至少 v2.0.7），② **dsh-better-sidebar 侧边栏插件为最新版**（0.19.0+，装了的话）。两个条件都满足之前，请不要更新本插件；顺序反了也不用怕，把 DSH 桌面版和侧边栏插件各自更到最新就能恢复正常。

---

## 第一步：安装

打开命令提示符 / PowerShell，**复制粘贴**下面这一行，回车：

```sh
dsh plugin --profile web add dsh-plugin-wallpaper-engine
```

看到安装成功的提示后，**重启 `dsh web`**（关掉重新打开就行）。

> 💡 看到一行命令就慌？别怕——这一行的意思是：「给 DSH 的网页模式装上 Wallpaper Engine 这个插件」。**复制 → 粘贴 → 回车**，三步搞定。

---

## 第二步：打开壁纸设置页

1. 打开 `dsh web`，进入聊天界面。
2. 点界面里的 **设置**（一般在左下角或左侧栏）。
3. 在设置页的**左侧导航**里，找到一项叫 **「Wallpaper Engine」**，点它。

你会看到一个漂亮的**液态玻璃卡片**，里面就是所有壁纸相关的开关。

---

## 第三步：选一张壁纸

1. 点卡片里的 **「选择壁纸」** 按钮，会弹出一个**缩略图网格**窗口。
2. 窗口里列出了你 Wallpaper Engine 里的所有壁纸（带预览图）。**点一张你喜欢的**，它就会出现在聊天界面背景上。
3. 点空白处、按 `ESC`、或点「关闭」就能收起这个窗口。

🎉 **搞定！** 现在你的聊天界面后面应该有壁纸了。

> 选不到壁纸？看下面「常见问题」第 1 条。

---

## 常用功能速查

| 想做什么 | 在哪里点 | 备注 |
|---|---|---|
| **换壁纸** | 选择壁纸 → 弹窗里点一张 | Video / Web / 上传的图视频都行 |
| **关掉壁纸** | 当前壁纸卡片 → 「关闭」 | 壁纸消失，但设置还在 |
| **暂停视频** | 当前壁纸卡片 → ⏸ 按钮 | 只对视频壁纸有用 |
| **调玻璃透明度** | 顶部「外观」→ 玻璃透明度滑条 | 越高越透，越低越实 |
| **换主题色** | 顶部「外观」→ 配色 | 6 种预设 + 自定义取色 |
| **换玻璃底色** | 顶部「外观」→ 玻璃颜色 | 决定玻璃本身的色调 |
| **视频调速** | 「壁纸效果」→ 倍速 | 0.5x ~ 2x |
| **镜像翻转** | 「壁纸效果」→ 水平翻转 | 视频/网页/图片都行 |
| **上传自己的壁纸** | 「自定义壁纸」→ 上传 | 支持 JPG / PNG / MP4 |
| **隐藏不喜欢的壁纸** | 弹窗里卡片右上角「隐藏」 | 软删除，不碰源文件，可恢复 |
| **自动轮换壁纸** | 「轮播列表」→ 新建列表 | 可设切换间隔和顺序 |
| **改上传文件存哪** | 「自定义壁纸」→ 存储「更改」 | 默认存 C 盘，可改到其他盘 |

---

## 四个滑条怎么调？

壁纸激活后，「壁纸效果」区有四个滑条。**它们都是即时生效的，不用刷新页面**：

| 滑条 | 干什么用 | 建议起手值 |
|---|---|---|
| **壁纸模糊** | 把壁纸本身变模糊 | 0（清楚） |
| **暗化** | 加深壁纸和文字之间的遮罩 | 25% |
| **边框** | 让边框/分割线更醒目 | 35% |
| **玻璃** | 玻璃面板（输入栏、气泡）的模糊半径 | 24 px |

> 👀 **如果文字看不清**：先把「暗化」和「边框」两个滑条往右拉（调高），还不够就稍微加点「壁纸模糊」。也可以试试切换 DSH 的**浅色 / 深色**主题——不同壁纸适合的模式不一样。

---

## 我的设置存在哪？（v0.4.0 新变化）

**从 v0.4.0 起，你的全部设置都保存在电脑上的一个文件里**，不再存在浏览器里：

- **Windows**：`C:\Users\<你的用户名>\.dsh-wallpaper-engine\config.json`
- **Mac / Linux**：`~/.dsh-wallpaper-engine/config.json`

这样做的好处：

- ✅ **重启不丢** —— 关机再开，壁纸和设置都还在。
- ✅ **换端口不丢** —— DSH Desktop 每次启动用随机端口，以前会丢设置，现在不会了。
- ✅ **清浏览器数据 / 换浏览器 / 无痕模式都不丢**。
- ✅ **多个浏览器共享同一份设置**（以前 Chrome 和 Edge 各存各的）。
- ✅ **从老版本升级自动迁移** —— 你不用做任何事，第一次打开就自动把旧设置搬过来。

---

## 常见问题（FAQ）

**1. 打开选择壁纸，里面是空的 / 一张都没有？**
- 确认 Wallpaper Engine 装好并至少下载过一张壁纸。
- 确认 Steam 没装在特别奇怪的位置（一般默认位置没问题；非默认盘插件也会自动找）。
- 重启一次 `dsh web`。

**2. 视频壁纸不播放 / 是黑的？**
- 现代浏览器要求视频**静音**才能自动播放——本插件的视频壁纸本来就是静音的，正常应该能播。
- 试试换一张壁纸，或者点一下「暂停」再「播放」。
- 「当前壁纸」卡片现在会直接写明原因（[#84](https://github.com/elysia395/dsh-wallpaper-engine/issues/84)）：如果播放按钮显示的是「播放」而不是「暂停」，说明视频并没有真的在播，点它即可重试；若提示「无法解码这段视频」，说明这个文件的编码浏览器解不了，换成 **H.264 编码的 MP4** 即可（例如重新导出一次）。
- 自己上传的壁纸如果「看不到 / 应用后一片空白」：检查弹窗上方的**内容分级**下拉框——默认是 Everyone，未标注分级的自上传壁纸现在按 Everyone 处理，不会再被默认过滤藏起来。

**3. 场景（Scene）壁纸为什么是静止的图片？**
- Wallpaper Engine 的场景壁纸是 3D 实时渲染的，浏览器里没法重放 3D。插件会**提取它最主要的那张图**作为静态背景（大约 80% 的场景壁纸能提取出接近原图的彩色图）。
- 提取不出来的（纯粒子特效、特殊格式等）会**自动回退**显示工坊预览图，这是正常的，不是 bug。

**4. 我想让壁纸自动换，怎么做？**
- 在「轮播列表」里点「新建」，给列表起个名，勾选你想轮换的壁纸，设置**切换间隔**（比如每 30 分钟），勾上「自动轮转」就行。每个列表至少要 2 张壁纸。

**5. 上传的壁纸存在 C 盘，我想挪到 D 盘？**
- 「自定义壁纸」区有个「更改」按钮，点它选一个新文件夹（比如 `D:\wallpapers`），已有的文件会**自动搬过去**，不用手动复制。

**6. 设置改了没生效 / 重启后又变回去了？**
- v0.4.0 已经不存在这个问题了（设置存文件里）。如果你还在用老版本，升级到 0.4.0 即可：重新跑一次第一步的安装命令。

**7. 这个插件会不会让 AI 变笨 / 多花 token？**
- **不会。** 插件不向模型暴露任何工具或提示文本，对 agent 是零 token 开销。它纯粹是个界面美化。

**8. 它会把我电脑里的文件传到网上吗？**
- **不会。** 壁纸文件全是从你本机的 Wallpaper Engine 目录读取的，自定义上传的也只存在你电脑上，不往任何服务器发送。

---

## Mac 用户

macOS 没有 Wallpaper Engine 客户端，所以本插件的 Windows 版用不了。不过社区维护者 **Jerry** 做了一个 macOS 专用版本（支持 WaifuX 和散装媒体）：

```sh
dsh plugin --profile web add dsh-plugin-wallpaper-engine-mac
```

仓库地址：https://github.com/ruijiaang-lab/dsh-wallpaper-engine

---

## 名词表

| 词 | 意思 |
|---|---|
| **DSH** | DeepSeek Harness，就是跑 `dsh web` 的那个东西。 |
| **`dsh web`** | DSH 的网页版界面，你在浏览器里聊天的那个。 |
| **Wallpaper Engine** | Steam 上的壁纸软件，里面存着你买的/下载的壁纸。 |
| **Video 壁纸** | 本质就是一个 `.mp4` 视频文件，可以直接在网页里播。 |
| **Web 壁纸** | 用 HTML 网页做的壁纸，插件用 iframe 加载它。 |
| **Scene（场景）壁纸** | Wallpaper Engine 用 3D 引擎实时渲染的壁纸，浏览器里只能提取一张静态图。 |
| **液态玻璃** | iOS 那种半透明、带模糊和光泽的玻璃效果。 |
| **轮播** | 让几张壁纸按时间间隔自动轮流切换。 |
| **软删除（隐藏）** | 把壁纸从列表里藏起来，但**不删源文件**，随时能恢复。 |
| **localStorage** | 浏览器自己存数据的地方——**v0.4.0 起插件不再用它存设置了**，改存电脑上的文件。 |
| **`config.json`** | 插件保存设置的文件，在你用户目录的 `.dsh-wallpaper-engine` 文件夹里。 |

---

## 还想看更详细的？

👉 回到 [中文 README（完整版）](README.md)，里面有工作原理、所有 HTTP 路由、场景静态帧的提取细节、开发者构建说明等等。

用得开心！🎉