DSH Wallpaper Bridge

将已安装的 Wallpaper Engine 接入 DeepSeek Harness（DSH）的 Cordis 插件。它提供壁纸集合、悬浮窗、背景注入、画面调节、材质/主色调、轮播清单和启动恢复等功能。

Windows 专用。项目只控制以窗口方式运行的 Wallpaper Engine 内容；默认不会修改 Windows 桌面壁纸，也不会写入 Wallpaper Engine 的桌面壁纸分配。

本项目是独立开发的非官方兼容插件，不属于 DeepSeek、Steam 或 Wallpaper Engine，也未获得这些项目或公司的赞助、认可或背书。

项目说明

DSH Wallpaper Bridge 是本地桥接插件，不是壁纸资源库，也不替代 Wallpaper Engine。它读取当前电脑中已安装、且用户已拥有的 Wallpaper Engine 内容，并在 DSH 内提供统一入口：

• 浏览与控制：按类型、来源与关键词筛选本机壁纸；支持预览、注入、取消、启动恢复和轮播清单。
• 界面体验：提供 Cordis 侧栏入口、独立悬浮窗、设置页，以及画面、材质与主色调调节。
• 兼容边界：图片、视频、网页类背景适合日常使用；场景类实时注入依赖原生环境，详见下方版本限制。

项目不会下载、解锁、分享或分发 Wallpaper Engine 的工坊资源。壁纸的授权、订阅与内容合规由使用者自行负责。

插件界面

插件以 Cordis 入口为中心工作：启动后在 DSH 侧栏提供“壁纸”入口，同时显示可收起的悬浮控制面板。用户无需离开当前会话，即可浏览本机壁纸、注入背景、切换声音并调整画面效果。

主面板与背景注入

本机壁纸集合与实时调节

壁纸集合只索引当前电脑中用户已安装的内容，可按类型搜索和筛选；右侧工具面板用于调节滤镜、光照、色彩与画面材质，效果会与设置页保持同步。

滤镜与光照	画面与材质

DSH 设置页集成

截图中的壁纸和缩略图仅用于展示插件界面，来自截图设备上由用户自行安装的第三方内容，不包含在本仓库或 Release 安装包中。

版本状态

当前版本：0.3.1

0.3.1 更新

• 悬浮窗与设置页将“画面”和“滤镜”合并为一个可展开模块，按基础画面、滤镜/光照/动态和界面材质分类，移除重复控件。
• 基础画面的透明度、亮度、对比度、饱和度和模糊保留全类型支持；8 套滤镜、色温、RGB、色罩、三路光照、暗角和颗粒仅支持图片与视频，播放速度仅支持视频，不适用时会禁用对应子组并保留参数。
• 修复场景注入、声音同步及 DSH 退出后的场景引擎清理问题；场景修改基础画面参数时按原有捕获渲染路径工作。
• 新增经 SHA-256 校验的一键插件更新入口；更新器固定读取本项目 GitHub Release，不读取账号 Token、Cookie，也不自动重试或轮询。

0.3.0 更新

• 悬浮窗新增可展开的“滤镜与光照”调色台，内置原片、影院、霓虹夜、暖阳、冷雾、旧时光、银盐和梦境 8 套可继续微调的方案。
• 新增曝光、对比、饱和、色温、色相、棕褐、黑白、柔焦、RGB 通道、色罩、独立光源、暗角和颗粒调节；设置页同步提供相同模块。
• 图片、视频、网页、场景和应用预览共用同一效果状态；原生实时场景启用像素滤镜时自动叠加捕获效果层，恢复中性值后回到原生直出。
• 修复饱和度调整到 0 时被错误还原为 100% 的问题；自定义方案会保存完整的滤镜与光照参数。

0.2.5 更新

• 修复正常退出 DSH 后，DSH 专用实时场景窗口仍由 Wallpaper Engine 运行并继续播放音效的问题；桌面壁纸保持不变。

0.2.4 更新

• 悬浮窗操作按“背景 / 工具”重新分组，画面与设置模块互斥展开；壁纸合集改为可收起的侧向抽屉。
• 主面板与设置页共用同一声音状态，统一控制 DSH 视频、网页及实时场景的可用音轨；图片、应用预览和无音轨缓存保持静音。
• 静音场景优先命中转码缓存以加快切换；开声时自动使用实时场景，避免后台无音轨缓存覆盖。
• 移除悬浮窗“强制转码”入口，保留原有自动转码、缓存、轮播、画面调整和注入能力。
• 视频和网页声音仅在 DSH 内控制；实时场景按 Wallpaper Engine 窗口所属音频进程控制，若引擎复用进程可能联动桌面声音。

0.2.3 更新

• 悬浮窗改为界面顶部拉绳式展开，保留侧边栏入口和原有功能。
• 主操作、筛选、画面、音乐和设置按关联重排；非常用模块可展开收纳，设置页同步调整。
• DSH 背景音乐不调用 Wallpaper Engine 全局静音；视频和网页可在 DSH 内独立控制。
• 壁纸列表按插件会话复用；图片、视频和网页切换跳过无效场景清理，并发场景切换共用安全清理流程。

0.2.1 更新

• Cordis 壁纸插件改为 DSH 启动时单实例运行，所有对话共享同一份插件；新建或切换对话不再重复启动悬浮窗和设置项。
• 悬浮窗重新整理主操作按钮，并在背景音乐开关旁标明作用范围。
• 背景音乐开关只控制 DSH 内嵌视频/网页背景，不调用 Wallpaper Engine 全局静音，因此不影响桌面壁纸；原生实时场景暂不支持独立静音。

已可用

• Cordis 侧栏入口、插件悬浮窗、设置页和独立自动加载器。
• 图片、视频、网页以及 Wallpaper Engine 项目的发现、筛选、预览、手动注入与取消。
• 画面调节、材质、主色调、轮播清单和上次背景恢复配置。
• 本地完整安装包：安装独立的定制 DSH，不覆盖未知版本的既有 DSH；因包含 DSH 自带运行依赖，仅输出到 dist-local/，不得作为本项目公开候选包。
• 安装后使用稳定运行目录，不依赖解压目录；更新时只迁移本插件的旧启动项，并备份被修改的本地配置。

已知限制 / 试验性能力

• 场景类（3D）壁纸的原生实时层仍是试验性能力。 浏览器无法直接渲染 Wallpaper Engine 私有场景格式，因此依赖 Wallpaper Engine、原生桥接与显卡环境协作；不同 GPU、驱动、壁纸项目可能出现白屏、闪烁或不可用。遇到此类情况请取消注入或改用视频/图片壁纸。
• 场景实时层、沉浸式全屏需要配套定制 DSH；公开轻量包只更新 Cordis 插件和桥接运行文件。完整 DSH 包只能在确认第三方依赖与许可证后本地构建。
• 新设备必须自行安装 Wallpaper Engine，并登录拥有订阅的 Steam 账号，或复制自己拥有的本地壁纸文件。项目不会分发工坊内容。
• 不会迁移个人的壁纸清单、已选轮播清单、缓存、运行状态和本地路径；新设备安装后需要重新扫描、选择或导入自己的配置。

快速安装

公开候选：插件一键安装

适用于已经安装兼容 DSH 的设备。公开候选只包含本项目代码与必要 Helper，不携带 DSH、Wallpaper Engine、壁纸资源、node_modules 或本机运行数据。

1. 发布后从最新 Release下载 DSH-Wallpaper-Setup-0.3.1.zip 及同名 .sha256 文件。
2. 校验 SHA-256 后解压到任意临时目录，双击 install.cmd。
3. 安装器会把桥接运行文件复制到 %LOCALAPPDATA%\DSHWallpaperBridge\current，注册 Cordis 自动加载器，并在开始菜单创建 Update DSH Wallpaper Bridge 更新入口。
4. 重启 DSH，打开 Cordis Plugin 面板确认“壁纸引擎控制”运行中；侧栏和顶部拉绳均可打开悬浮窗。

也可直接从源码目录运行 install.cmd 或 node install.js。重复安装是幂等更新：只迁移本插件旧入口，保留其他插件，并在修改本地配置前创建备份。

一键更新

安装后从开始菜单运行 Update DSH Wallpaper Bridge，或双击稳定运行目录中的 update.cmd。更新器只执行一次 GitHub 最新 Release 查询，下载与版本号严格匹配的轻量 ZIP 和 .sha256，校验后再调用同一安装器；遇到限流会停止并提示稍后重试。

& "$env:LOCALAPPDATA\DSHWallpaperBridge\current\update.cmd"

一键更新只更新本插件、Cordis 文件与桥接 Helper，不替换 DSH 主程序。需要离线更新时，下载 ZIP 和相邻 .sha256 后运行：

./update.ps1 -PackagePath './DSH-Wallpaper-Setup-0.3.1.zip'

完整 DSH 一键安装（仅本地）

现有完整 DSH 必须携带它自己的 Node/Electron 运行依赖，其中包含 runtime/node_modules。这与“公开候选不得包含 node_modules”的要求冲突，因此完整包保留为本地专用构建，输出到 dist-local/，不会进入公开候选目录 dist/。只有在确认 DSH 来源、第三方许可证与分发权限后才能单独处理。

从源码构建安装包

需要 Windows PowerShell 5.1+ 和 Node.js 18+：

npm run check
npm run package:portable
npm run check:release

# 本地完整包需要显式确认它会携带 DSH 运行依赖
./release.ps1 -Full -AllowBundledRuntimeDependencies -HarnessDir 'D:\Path\To\DeepSeek Harness'

也可设置一次环境变量后执行本地完整构建：

$env:DSH_HARNESS_DIR = 'D:\Path\To\DeepSeek Harness'
npm run package:full
npm run check:full-local

公开轻量候选位于 dist/；本地完整包位于 dist-local/。两个目录均不进入 Git 仓库，且发布检查会拒绝 dist/ 中出现任何完整 DSH ZIP。

首次使用

1. 确认 Wallpaper Engine 已安装；必要时先在 Steam 中完成工坊订阅下载。
2. 在 DSH 中打开“壁纸”入口，使用分类、来源和搜索定位壁纸。
3. 单击卡片为手动注入；悬停可预览单张壁纸。
4. 在设置页中调整材质、主色调、画面参数和轮播。
5. 轮播使用“轮播清单”：勾选的项目才会参与，类型/来源筛选只用于快速选择。

技术方案

目录清单

.
├── we.js                         # Wallpaper Engine 控制 CLI
├── native-scene-bridge.js        # 原生场景桥接服务
├── install.cmd / install.ps1     # 一键安装入口
├── update.cmd / update.ps1       # 固定官方 Release 的一键插件更新
├── install.js                    # DSH 配置与稳定运行目录安装
├── release.ps1                   # 生成轻量包/完整包
├── package.json                  # 命令与版本
├── titles.json                   # 可公开的标题覆盖
├── docs/images/                  # README 插件界面截图
├── dsh/
│   ├── plugin.host.js            # Cordis Host 插件
│   ├── plugin.client.js          # 悬浮窗与设置 UI
│   ├── wallpaper-bootstrap.js    # 独立自动加载器
│   ├── install-bootstrap.js      # 安装与旧启动项迁移
│   └── check-*.js                # 无依赖回归检查
└── we-tools/
    ├── capture.cs / capture.exe  # Windows 窗口捕获工具
    ├── SceneLayerHost.cs         # 场景层原生 Helper 源码
    └── native-scene-lab.html     # 完整包随附的原生场景层页面

验证与排错

npm run check            # 隐私、客户端、Host、自动加载器、更新器与安装迁移
npm run check:release    # 包内容、哈希、解压、安装、离线更新与独立运行验证
node we.js detect        # 检查 Wallpaper Engine 发现结果
node we.js list          # 查看当前机器的本地壁纸清单

如果插件入口没有出现：先重启 DSH，再检查 Cordis Plugin 面板中“壁纸引擎控制”是否在运行。若 Wallpaper Engine 未被发现，先确认 Steam/Wallpaper Engine 已安装并完成本机订阅下载。

隐私与安全

本地数据与网络边界

• 插件在本机扫描 Wallpaper Engine 安装目录与用户已下载的壁纸，用于生成本机清单；该清单默认保存在本机，不上传到仓库或 Release。
• 本项目不要求填写 Steam、GitHub、DSH 或 Wallpaper Engine 的账号密码、Cookie、API Key 或 Token；原生场景桥接仅在本机 localhost 通信。
• 项目本身不提供遥测、分析或云端同步服务。DSH、Steam、Wallpaper Engine 与 GitHub 的网络行为分别受其自身的隐私政策约束。

不公开的文件

以下内容已在 .gitignore 与发布脚本中排除，提交前仍请自行复核：

• wallpapers.json、runtime.json、we.config.json、titles.local.json、.env*、转码缓存和安装备份；
• Steam/DSH 会话数据、Cookie、Token、聊天内容、用量记录和运行日志；
• 本机绝对路径、node_modules、Wallpaper Engine 工坊资源、本地导入壁纸，以及用户自己的 DSH 配置与会话数据。

本机修改范围

• 壁纸控制使用 Wallpaper Engine 的窗口模式，并只管理 dsh-we-* 命名的窗口；默认不修改 Windows 桌面壁纸或 Wallpaper Engine 的桌面分配。
• 安装器只写入本插件的稳定运行目录与 DSH 插件配置；迁移旧启动项前会创建备份。建议在更新前关闭正在运行的 DSH，并保留备份直到确认运行正常。

如需分享截图、日志或配置，请先移除用户名、绝对路径、壁纸标题、工作区名称和会话内容。

许可证

本仓库自行编写的桥接代码采用 MIT License。完整安装包内的 DSH、Electron、Node.js 与其他第三方依赖遵循各自随附的许可证与版权声明，详见 THIRD_PARTY_NOTICES.md。

作者

vanhungbui-11 — GitHub: vanhungbui-11/dsh-wallpaper-bridge