前言¶
DeepSeek Harness（DSH）的界面默认偏工具向：对话区清晰，但背景往往是纯色或静态主题。若你本机已经订阅 Wallpaper Engine，壁纸库在 Steam 里却进不了 DSH，只能另开窗口或放弃动态背景。社区插件 dsh-we-wallpaper（维护者 maoshiba6863）把本机 WE 壁纸放到 DSH 界面背后，聊天窗口浮在动态壁纸之上，并配合液态玻璃外观、播放与省电策略，在 SkillHub 分类为「趣味换装」。插件以 MIT 许可发布，合并改写自早期 DSH 壁纸插件与 WebWallGL 渲染引擎；与 Wallpaper Engine 官方、Steam、DeepSeek 官方均无隶属关系。
这是什么¶
一句话：让 DSH 的聊天界面变成「玻璃面板 + 会动的壁纸」，同时尽量控制耗电与卡顿。
- 仓库：maoshiba6863/dsh-we-wallpaper
- 目录页：SkillHub 插件页
- 环境：DSH ≥ 0.1.5-rc.1，Node ≥ 18；支持 profile
desktop与web - 平台：Windows / macOS / Linux（部分能力按平台降级，见下文）
- 本机数据目录：
~/.dsh-wallpaper-engine（设置、缓存、上传、账单），不同步到任何服务器
核心功能¶
下面按实际使用顺序概括，均为 README 中已实现的能力。
壁纸来源与类型¶
插件只读扫描本机 Wallpaper Engine / Steam 壁纸库（Windows 读注册表与常见路径；非默认库或 WSL / macOS 可用环境变量 DSH_WE_STEAM_ROOT 指定根目录）。支持四类壁纸：
- 场景壁纸：WebGL 实时渲染，粒子、脚本、鼠标交互等
- 视频壁纸：MP4 / WebM 等
- 网页壁纸：沙箱内运行，并提供 WE 属性接口
- 图片壁纸：自行上传的 JPG / PNG
可读取 WE 播放列表轮换或单选；支持类型/分级筛选、搜索、隐藏；上传目录可改。切换支持 7 种过场（淡入淡出、推移、擦除等），方向与速度可调；另有背景轮播、定时轮换与快捷「下一张」。
画面与性能¶
壁纸层可调模糊、透明度、亮度、对比度、暗化；适配方式覆盖 / 填充 / 居中 / 拉伸；倍速与水平/垂直翻转。场景与网页壁纸可开关实时渲染，帧率可选 15 / 30 / 60；整体帧率上限 30 / 60 / 不限制。渲染失败会降级到壁纸自带视频或静态画面。可选抽帧转码、自定义画面（抓帧或导入截图）、清空 GPU 帧缓存。
液态玻璃与界面¶
整体与各区域（设置窗、对话框、侧栏、标题栏等）可单独开关玻璃效果；预设可导入导出。主题可随壁纸取色；UI 配色、字体（预设集、本机字体、终端字体等）、会话布局（居中 / 铺开）、扩展页签中的头像均可调。
声音、可视化与费用¶
壁纸音轨可开关并调音量；可显示本机媒体桥提供的歌曲信息与歌词。音乐律动（音频频谱）仅对场景壁纸生效；macOS 首次需「音频录制」授权，未授权时退回模拟频谱。侧边栏与会话轮次可显示用量费用（缓存命中/未命中/输出等），可在「系统 → 费用统计」关闭。
省电与桌面配合¶
最小化、切页签、失焦、用电池时可暂停；Linux X11 下还支持窗口被遮挡时暂停。macOS 可选启动时铺满屏幕（需一次性辅助功能与自动化授权）。设置保存在宿主端，不占对话上下文。
安装与启用¶
安装前请确认已安装 DSH；若要用本机 WE 库，Windows 上需已安装 Wallpaper Engine 并订阅壁纸；其它系统可上传媒体或通过 DSH_WE_STEAM_ROOT 指向壁纸文件。
方式一（推荐，npm）：
dsh plugin add dsh-we-wallpaper
桌面端也可在插件管理里搜索 dsh-we-wallpaper 安装。
方式二（Releases 指定版本，README 示例为 v1.1.8）：
dsh plugin add https://github.com/maoshiba6863/dsh-we-wallpaper/releases/download/v1.1.8/dsh-we-wallpaper-1.1.8.tgz
升级时先 dsh plugin remove dsh-we-wallpaper，再安装新版 tgz；具体子命令以你所用 DSH 的 dsh plugin --help 为准。
装好后重载 DSH 界面，从侧边栏底部或快捷面板进入「壁纸引擎设置」。
典型用法¶
- 在「壁纸库」页点击「扫描 Wallpaper Engine」，等待列表加载。
- 选中壁纸后点「选择壁纸」；需要时可暂停或清除。
- 在「外观」调整玻璃与主题，在「播放」调整清晰度与帧率。
- 设置页分五个页签：壁纸库、外观、播放、系统、扩展；按需打开省电策略、费用显示、Edge 兼容等。
非 Windows 找不到库时，设置 DSH_WE_STEAM_ROOT 或直接上传图片/视频。
适用场景与注意¶
适合： 已在 DSH 上长时间对话、希望背景与 WE 创意工坊或自建媒体统一，并愿意在设置里权衡帧率与省电的用户。
平台差异（摘要）： Windows 可自动定位 WE 库；macOS 无官方 WE，需指路或上传；Linux 原生需 DSH_WE_STEAM_ROOT，WSL 可找 Windows 盘内库。场景实时渲染三平台均支持；macOS 铺满桌面与音频频谱需系统授权。
安全与权限： 插件以当前 DSH 进程权限运行，只读扫描壁纸库；首次转码或音频频谱可能从公开地址下载 ffmpeg 与媒体桥到本机。安装前应阅读仓库源码、SECURITY.md 与 MIT / 第三方声明。可选外部请求包括 AnySearch、Hacker News（AI 热点相关，仅出站，不上传用户数据）。
DSH 社区目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；装插件同样遵循「一切皆插件」的自选与自担风险。
结尾¶
dsh-we-wallpaper 把 Wallpaper Engine 的四类壁纸与 DSH 聊天层叠在一起，用玻璃化 UI 和播放/省电选项把「能看」和「能用」拆开调。问题与功能请求可到 GitHub Issues；更多信息见 目录页 与 仓库 README。
