壁纸引擎同步 YRN-playmaker/dsh-wallpaper_share

dsh-wallpaper_share

English · 双语 README

把 Wallpaper Engine（WE）当前壁纸同步为 DeepSeek Harness（DSH）Web / 桌面端界面的背景，在 wallpaper_share 标签页调整渲染模式、透明度、模糊、阴影、专注透镜与壁纸库。本次在独立 Harness 0.1.0-rc.6 环境完成实际安装与浏览器验证。

同步功能读取 WE 状态，不更改桌面壁纸。安装目录会自动检测；眼动追踪在本机推理，摄像头画面不上传。

- 26.10.13-D 更新
- DeepSeek 日夜 1.3.2
- 安装与升级
- 渲染模式与窗口跟随
- 功能与操作
- 配置
- 限制与排查
- 开发与验证
- 关于我 / 赞助

26.10.13-D 更新 · 日夜壁纸 1.3.2

1. 突破大文件下载限制：启动器现在支持通过直链、网盘下载超过 4 GB 的大型软件。下载逐块写入磁盘、同步校验，不再把整个文件装进内存；支持 ZIP64 和大压缩包的磁盘解压。当前下载上限为 64 GiB，单层展开上限为 128 GiB，需为下载包和解压文件预留磁盘空间。详细说明。
2. 优化背景与主题冲突：重新调整壁纸、侧边栏和页面的主题衔接，减少叠加遮罩；浅色主题下文字更清晰，进入、退出及切回对话时保持平滑过渡。
3. 一并更新 DeepSeek 日夜主题：DWP 1.3.2 带来更丰富的入水、滚轮下潜、水面焦散和二维气泡动画，并细分预览与完整模式。预览模式下，wallpaper_share 页面固定使用白天蓝色背景，不随本地时间切换，并采用开销更低的普通气泡；完整模式保留昼夜切换、夜间暖红水体与完整剪影、橙金水花及珊瑚红按钮。上浮气泡经过剪影时显露人物细节并放大至 1.35 倍，常驻气泡最多 12 个，入场临时小泡泡除外。

DeepSeek 日夜：白天完整模式

DeepSeek 日夜：夜间完整模式

从 插件 26.10.13-D Release 安装 dsh-wallpaper_share-26.10.13-D.tgz，重启 Harness 后，在壁纸库更新或导入 日夜 1.3.2 并重新挂载。人物、水花素材及声明式效果参数均随 DWP 分发；插件提供通用渲染器。截图由作者提供，界面显示的旧插件版本仅为演示。此次更新 GitHub 发布，不变更 npm 渠道。

26.10.9-D 更新

- DeepSeek 日夜侧边栏：普通悬停变蓝，选中项显示两层深色游鱼剪影，剪影缩小 10%；DeepSeek 品牌按钮除外。支持展开、收起、刷新恢复和减少动态效果偏好。
- 配套 DWP 1.2.0：日夜壁纸包附带新版插件使用说明，保留昼夜切换和两档纹理。

26.10.6-D 更新

- 桌面端捕获连接修复：Capture 使用 Harness 桌面端提供的帧流地址，解决桌面端无法连接的问题；Web 端继续使用页面地址连接。
- 高 DPI 窗口跟随修复：随包捕获器升级为 we-capture 0.4.3，正确处理 Windows 显示缩放，修复 125% 等缩放下背景与真实壁纸错位、窗口越靠右偏差越大的问题。
- 自定义快捷键：新增「快捷键设置」卡片，沉浸模式默认 F11、专注模式默认 F10；支持录制新按键或组合键，设置会保存并在重启后恢复。
- 移除状态圆点：删除侧边栏和右上角状态圆点，避免桌面端显示异常。专注模式仍会根据会话任务状态调整视觉浓度。
- 移除桌面悬浮球：不再提供悬浮球开关、状态显示和点击返回窗口功能，随包也不再包含悬浮球程序。沉浸模式通过快捷键进入。

完整记录见 CHANGELOG.md。仓库源码版本为 26.10.13-D；2026-10-12 核对 npm latest / desktop 为 26.10.9-D、web 为 26.10.3，不含本次入水页面修复。

安装与升级

需要 DSH Web profile。使用原生场景捕获时，还需要在同一台 Windows 电脑上运行 WE 并应用场景壁纸。

从 GitHub 安装本仓库版本：

dsh plugin --profile web add github:YRN-playmaker/dsh-wallpaper_share

npm 安装（默认推荐 desktop 版本）：

Web 端可通过 npm 的 web 标签获取：下方命令中的 --profile web 指定 DSH Web profile，@web 指定插件的 Web 版本。web 标签当前指向 26.10.3；如需固定该版本，可将 @web 替换为 @26.10.3。

默认 desktop 版本（latest 标签，版本号带 -D）
dsh plugin --profile web add dsh-wallpaper_share

明确选择 desktop 渠道
dsh plugin --profile web add dsh-wallpaper_share@desktop

保留的 Web 版本（web 标签）
dsh plugin --profile web add dsh-wallpaper_share@web

自行打包的本地安装包
dsh plugin --profile web add ./dsh-wallpaper_share-26.10.13-D.tgz

安装或升级后，重启 DSH Web profile 并刷新浏览器页面。默认地址为 http://127.0.0.1:3080，实际端口以启动日志为准。仅刷新页面不会更新已加载的后端程序。

新会话的会话区会出现 wallpaper_share 标签页；在其中开启同步并选择渲染模式。多显示器可通过「背景显示器」锁定来源。安装包包含前后端及 Windows 原生程序，用户无需自行构建；cordis.patch.yml 会随插件安装接入 profile。

DeepSeek 日夜 1.3.2

1. 从 1.3.2 Release 下载壁纸 deepseek-day-night.dwp 和本次配套插件包。
2. 安装插件，重启 DSH Web profile 并刷新页面：

dsh plugin --profile web add ./dsh-wallpaper_share-26.10.13-D.tgz

3. 在「壁纸库 → 市场」更新日夜壁纸到 1.3.2，或导入下载的 DWP，然后重新挂载。
4. 打开 wallpaper_share 查看入水；滚轮下潜，再切回对话检查退出过渡。选择「完整」查看焦散和泡泡照明；开启专注后查看呼吸模糊。

人物、水花十帧、U 型展开、剪影渐变、滚轮深度、光效与界面浓度参数均随 DWP 分发，插件负责通用渲染。普通 DWP 播放器继续显示日夜背景；两档纹理及自动昼夜切换保留。系统「减少动态效果」会抑制动态效果。

若未出现新版效果，确认插件为 26.10.13-D、壁纸为 1.3.2，重启后台后重新挂载。仅更新 DWP 或仅刷新网页不能更新插件渲染器。参数与验证说明见 页面动画文档。

渲染模式与窗口跟随

| 模式 | 场景壁纸（scene） | 适用情况 |
| 预览（eco） | 显示静态预览图 | 节省资源 |
| 捕获（perf，默认） | 镜像 WE 正在渲染的桌面壁纸；不可用时回退浏览器渲染 | 使用 WE 自身的粒子、脚本和 shader 效果 |
| 完整（enhanced） | 解析 .pkg，在浏览器中重绘图层、粒子与骨骼动画 | 不依赖 WE 持续运行；部分复杂效果仍有差异 |

「完整」是模式名称，浏览器渲染器仍是 WE 引擎的子集。

| 壁纸类型 | 预览 | 捕获 / 完整 |
| scene | 静态预览 | 按上表选择原生捕获或浏览器渲染 |
| video | 静态预览 | 播放源视频，支持 HTTP Range |
| web | 静态预览 | 在 iframe 中加载源页面 |
| image | 静态预览 | 显示源图 |
| application / other | 静态预览 | 背景回退预览；应用可在壁纸库中管理 |

窗口跟随仅用于原生 scene 捕获，在运行 WE 的同一台电脑上生效。小窗口位于屏幕左侧就显示左侧区域，移到右侧就显示右侧区域。鼠标移入页面后自动校准标题栏偏移；全屏时显示整屏。跟随范围由「背景显示器」决定，跨屏使用时请选择对应显示器，窗口超出所选屏幕的部分不会拉伸补齐。

高 DPI 显示缩放需要 we-capture 0.4.3 或更新版本，并同步更新前后端。捕获器会按显示器缩放转换屏幕坐标，使背景与窗口所在区域对齐；旧捕获器会提示升级。不提供屏幕坐标的旧捕获器、静态预览及浏览器回退仍居中铺满。原生捕获失败时，场景背景依次回退为浏览器渲染、提取纹理、预览图；当前通路显示在面板副标题。

功能与操作

- 视觉效果：调整面板透明度、壁纸模糊和阴影；同步开关与渲染偏好会保存到本地。
- 专注透镜：圆心清晰、圆外模糊，默认跟随鼠标；开启专注后，视觉浓度随任务状态调整。
- 眼动追踪：可选摄像头推断视线，提供 9 点校准、文字吸附与抗抖动；首次使用需要联网加载模型并授予摄像头权限。关闭眼动或专注时释放摄像头。
- 沉浸模式：快捷键切换（默认 F11，可在面板「快捷键设置」里修改）。开启时先切到新会话并隐藏会话界面、只留壁纸；再按一次、按 Esc，或点侧边栏任意按钮退出。
- 专注模式快捷键：同样可自定义（默认 F10），与面板里的「专注模式」按钮等效。
- 壁纸库：管理本地 DWP、WE 应用与启动器应用；市场支持搜索、筛选、安装与更新。管理模式支持多选卸载 DWP 和启动器应用，Steam 工坊内容不参与批量删除。
- 应用启动器：支持 HTTP(S) 直链及 139 分享链接，导入 .zip、.7z 或 .exe；智能粘贴可从分享文本识别链接、提取码、解压密码和启动文件。应用在「本地 → 应用」启动，列表显示名称、位置与下载时间。
- DWP 背景：挂载自定义壁纸包后由 WebGL2 渲染，低配时回退 Canvas2D；挂载期间暂停 WE 同步。内置工作区脉搏可展示近期文件变化，支持昼夜变量与纹理档位。
- DeepSeek 日夜侧边栏效果：使用包含此功能的新版插件，挂载「DeepSeek 日夜」后，普通悬停显示蓝色背景，选中项显示深色鱼剪影游动；品牌按钮除外。系统开启「减少动态效果」时剪影静止。效果随插件提供，无需替换 DWP 包；仅更新壁纸包不会为旧版插件增加此功能。
- 139 登录（桌面端）：安装 / 更新油猴登录态同步助手，在浏览器登录139网盘并打开文件列表或分享页；从油猴菜单点击「复制 139 登录态（用于桌面端粘贴）」，回到启动器粘贴139分享链接，在自动显示的「139登录态」区域粘贴并保存。随后点击「下载安装」，安装后从应用栏启动（每次确认）。Web端仍可自动同步；其他网盘需提供可下载的直链。

快捷键设置

在「视觉效果」与「壁纸读取位置」之间找到「快捷键设置」，点击对应功能右侧的键位按钮，再按下新按键或组合键即可替换；录制中按 Esc 取消。录制期间不会触发沉浸或专注切换，设置会自动保存。组合键需要完整匹配，例如绑定 Ctrl+K 后单按 K 不会触发。在输入框或可编辑文本区域内，普通字符及编辑键让位于输入；F10、F11 和组合键仍可触发。

当前版本已移除侧边栏 / 右上角状态圆点及桌面悬浮球；专注模式的任务状态响应保留。

壁纸同步界面

壁纸同步界面

专注模式演示

壁纸库界面

壁纸库界面

设置面板

设置面板

截图用于介绍界面，可能来自旧版本；其中若有状态圆点或桌面悬浮球，已不适用于 26.10.6-D。具体布局以当前版本为准。

配置

常用设置在 wallpaper_share 面板中调整。开发或自定义部署可修改 src/index.ts 顶部 CONFIG 后重新构建：

| 配置项 | 默认值 | 用途 |
| wallpaperEngineDir | '' | 自动检测 WE 安装目录，失败时手动指定 |
| workshopContentDir | '' | 自动推导工坊目录 |
| pollIntervalMs | 2000 | WE 状态轮询间隔，毫秒 |
| sceneRendererPath | '' | 自动发现随包捕获器，或指定外部 renderer |
| wallpaperEngineAssetsDir | '' | 默认使用 <weDir>/assets |
| sceneRenderWidth / sceneRenderHeight | 1920 / 1080 | 捕获输出分辨率，低于原生尺寸时降采样 |
| sceneRenderFps / sceneRenderQuality | 30 / 80 | 目标帧率与 JPEG 质量 |
| sceneRenderMode | 'auto' | 后端通路选择：auto / browser / external |
| particleRateScale / particleSizeScale | 1 / 1 | 浏览器粒子发射率与尺寸倍率 |
| effectStrengthScale | 0.6 | 浏览器图层效果强度倍率 |
| puppetMeshRender | true | 骨骼网格渲染 |
| workspaceDir | '' | 工作区脉搏扫描根，默认插件进程工作目录 |
| workspacePulseWindowMs | 90000 | 工作区变化保留时长，毫秒 |
| workspacePulseAutoInstall | true | 自动安装内置工作区脉搏包 |

后端 sceneRenderMode 与面板的三档渲染按钮是不同设置。其余开发配置见源码。

限制与排查

- 原生捕获仅支持 Windows；捕获取的是桌面壁纸层，可能包含桌面图标。
- WE 暂停渲染时，捕获动画也暂停；窗口移动仍可重绘最后一帧。实际帧率受 WE 自身帧率、输出分辨率和编码耗时影响。
- 浏览器「完整」模式对复杂 shader、SceneScript 或特定效果的支持仍有限；需要匹配 WE 原始效果时优先选择捕获。
- DWP 挂载期间会暂停 WE 背景同步；眼动追踪依赖摄像头及浏览器安全上下文（localhost 或 HTTPS）。
- 市场和模型资源的网络加载可能失败；本地已安装内容不依赖市场缩略图加载。

出现背景空白、版本未更新或标签页缺失时：

1. 安装或升级后重启 DSH，并刷新页面。
2. 确认 wallpaper_share 标签页出现，检查浏览器控制台有无插件加载错误。
3. 查看 /we-sync/diag 的显示器、捕获器版本和当前渲染状态；捕获模式下确认 WE 已运行。
4. Windows 显示缩放下背景错位时，确认捕获器为 0.4.3 或更新版本；桌面端 Capture 无法连接时，确认已安装包含桌面连接修复的 26.10.6-D，并重启宿主以加载新版本。
5. 安装目录检测失败时配置 wallpaperEngineDir；反馈问题时附上插件版本、harness 版本和错误信息。

开发与验证

pnpm install --frozen-lockfile
npm run typecheck
npm test
npm run build
npm run check:package
npm run test:package
npm pack

修改原生源码后，在 Windows 上先运行 npm run build:native。原生版本与源码指纹必须和 bin/ 程序一致；含非 ASCII 字符的工具链路径可能导致 GNU 链接器失败，可使用 ASCII 路径并配置 RUSTUP_HOME / CARGO_HOME。

Chrome 像素回归：

node tools/test-shake-browser.mjs
node tools/test-particle-browser.mjs
node tools/test-capture-browser.mjs
Windows + WE 运行时：验证真实捕获帧
node tools/test-capture-browser.mjs --native

lib/index.js 和 lib/client.js 是随包预构建入口。面板版本由 package.json 在构建时注入，因此更新版本后必须重新构建。

- src/scene/：场景协议、捕获中继、素材解析与骨骼模型。
- src/client/：面板、背景层、图层效果、粒子与窗口裁切。
- native/we-capture/：Windows 捕获器源码；bin/ 是随包程序。
- vendor/dwp/：DWP 运行时快照；src/market/、src/launcher/ 管理壁纸库与应用。
- docs/：格式与实现记录，包括 scene-fallback.md 和 effect-shake.md。

提交与打包前遵守 AGENTS.md 和 编码与发布规范。package.json 必须为 UTF-8 无 BOM；发布验证应使用实际安装包，并确认新会话的前端标签可见。

关于我 / 赞助

我是 YRN-playmaker，这个插件的开发者。感谢你使用、反馈问题和分享这个项目。

如果这个插件对你有帮助，欢迎通过 Ko-fi 支持我，为后续维护、兼容适配与新功能开发提供支持。赞助完全自愿，插件功能免费使用。

许可

GPL-3.0

DeepSeek 日夜 1.3.2

新版日夜 DWP 包含 wallpaper_share 页面的入水、水花、倒置人物渐变、滚轮深度与退出动画，最低需要插件 26.10.13-D。预览页面保持白天蓝色，完整模式按本地时间切换柔和暖红夜色，并提供 1.35 倍气泡细节窗口。水面光斑固定在顶部并随下潜淡出；「完整」模式增加折射焦散与泡泡照明，专注 + 完整时有 1–4px 呼吸模糊。人物、水花素材与参数随 DWP 分发。扩展说明 · 壁纸下载。