dsh-wallpaper_share

Wallpaper Engine → DeepSeek Harness Web

中文

把 Wallpaper Engine（WE）当前壁纸同步为 DeepSeek Harness（DSH）Web 界面的背景，在 wallpaper_share 标签页调整渲染模式、透明度、模糊、阴影、专注透镜与壁纸库。已适配 harness 0.1.5。

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

• 26.10.3 更新
• 安装与升级
• 渲染模式与窗口跟随
• 功能与操作
• 配置
• 限制与排查
• 开发与验证

26.10.3 更新

• 捕获模式跟随窗口位置：小窗口显示其在所选显示器上对应的壁纸区域，移动或调整大小时保持桌面比例；WE 暂停出帧时仍能查看最后一帧的对应区域。处理标题栏偏移、网页缩放与模糊留边。
• 完整模式人物形变修复：修正 Ayanami Rei-凌波丽『night』等壁纸的方向场解码与多次 shake 效果串联，恢复局部毛发摆动，解决人物异常平移、动画停滞及部分画面翻转。
• Rainy Day 雨滴优化：修复俄文素材名加载、雨滴与法线图集错位、拖尾方向、旋转折射和透明度；跳过隐藏雨层，并减少无用轨迹记录与背景纹理分配。
• 捕获器与发布检查：随包原生产物已重建；清单编码、入口文件与原生源码指纹在打包前检查，避免发出过期程序。

完整记录见 CHANGELOG.md。本仓库版本为 26.10.3；npm 的实际可用版本以页面徽章和注册表为准。

安装与升级

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

从 GitHub 安装本仓库版本：

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

其他来源：

# npm 当前版本
dsh plugin --profile web add dsh-wallpaper_share

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

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

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

渲染模式与窗口跟随

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

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

需要新版本捕获器和前后端同时更新。旧捕获器、静态预览及浏览器回退仍居中铺满。原生捕获失败时，场景背景依次回退为浏览器渲染、提取纹理、预览图；当前通路显示在面板副标题。

功能与操作

• 视觉效果：调整面板透明度、壁纸模糊和阴影；同步开关与渲染偏好会保存到本地。
• 专注透镜：圆心清晰、圆外模糊，默认跟随鼠标；开启专注后，视觉浓度随任务状态调整。
• 眼动追踪：可选摄像头推断视线，提供 9 点校准、文字吸附与抗抖动；首次使用需要联网加载模型并授予摄像头权限。关闭眼动或专注时释放摄像头。
• 沉浸模式：快捷键切换（默认 F11，可在面板「快捷键设置」里改成任意按键）。开启时先切到新会话并隐藏会话界面、只留壁纸；再按一次、按 Esc，或点侧边栏任意按钮退出。
• 专注模式快捷键：同样可自定义（默认 F10），与面板里的「专注模式」按钮等效。
• 壁纸库：管理本地 DWP、WE 应用与启动器应用；市场支持搜索、筛选、安装与更新。管理模式支持多选卸载 DWP 和启动器应用，Steam 工坊内容不参与批量删除。
• 应用启动器：支持 HTTP(S) 直链及 139 分享链接，导入 .zip、.7z 或 .exe；智能粘贴可从分享文本识别链接、提取码、解压密码和启动文件。应用在「本地 → 应用」启动，列表显示名称、位置与下载时间。
• DWP 背景：挂载自定义壁纸包后由 WebGL2 渲染，低配时回退 Canvas2D；挂载期间暂停 WE 同步。内置工作区脉搏可展示近期文件变化，支持昼夜变量与纹理档位。

壁纸同步界面

专注模式演示

壁纸库界面

设置面板

截图用于介绍界面，具体布局以当前版本为准。

配置

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

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

限制与排查

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

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

1. 安装或升级后重启 DSH，并刷新页面。
2. 确认 wallpaper_share 标签页出现，检查浏览器控制台有无插件加载错误。
3. 查看 /we-sync/diag 的显示器、捕获器版本和当前渲染状态；捕获模式下确认 WE 已运行。
4. 安装目录检测失败时配置 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；发布验证应使用实际安装包，并确认新会话的前端标签可见。

English

Sync the active Wallpaper Engine (WE) wallpaper into the DeepSeek Harness (DSH) Web UI. Use the wallpaper_share tab to adjust rendering, transparency, blur, shadows, the focus lens and the wallpaper library. Adapted for harness 0.1.5.

Wallpaper sync reads WE state without changing your desktop wallpaper. The installation directory is detected automatically. Eye tracking runs locally; camera frames are not uploaded.

• What's new in 26.10.3
• Install and upgrade
• Render modes and window following
• Features and controls
• Configuration
• Limitations and troubleshooting
• Development and validation

What's new in 26.10.3

• Capture follows the window: a smaller window shows the wallpaper region underneath it on the selected display. Moving or resizing preserves the desktop scale, including when WE stops sending new frames. Browser chrome, page zoom and blur padding are handled.
• Character deformation in Full mode: corrected direction-map decoding and chained shake effects for wallpapers such as Ayanami Rei-凌波丽『night』. Local hair movement is restored, with fixes for unwanted character translation, frozen animation and flipped output.
• Rainy Day rain effects: corrected Cyrillic asset loading, separate color and normal atlases, trail direction, rotated refraction and opacity. Hidden rain layers are skipped; unnecessary path histories and background texture allocations are reduced.
• Capture binaries and package checks: the shipped native programs have been rebuilt. Checks reject invalid manifest encoding, missing entry files and native binaries that do not match the source fingerprint.

See CHANGELOG.md for details. The repository version is 26.10.6-D; the npm badge and registry show the version actually available on npm.

Install and upgrade

A DSH Web profile is required. Native scene capture also requires WE to be running with a scene wallpaper on the same Windows computer.

Install this repository version from GitHub:

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

Other sources:

# Current npm version
dsh plugin --profile web add dsh-wallpaper_share

# A locally packed installation archive
dsh plugin --profile web add ./dsh-wallpaper_share-26.10.6-D.tgz

After installing or upgrading, restart the DSH Web profile and refresh the browser page. The default address is http://127.0.0.1:3080; check the startup log for the actual port. Refreshing the page alone does not reload the backend.

Open a new session and find the wallpaper_share tab in the session area. Enable sync and choose a render mode there. With multiple displays, use Background monitor to select the source. The package includes prebuilt frontend, backend and Windows native programs, so users do not need to build it. Its cordis.patch.yml is added to the profile during installation.

Render modes and window following

Full is the mode's name; the browser renderer remains a subset of the WE engine.

Window following applies to native scene capture only, on the computer running WE. A window on the left shows the left desktop region; moving it right shows the right region. Moving the pointer into the page calibrates the browser chrome offset. Fullscreen shows the whole display. Background monitor sets the capture boundary: select the corresponding monitor when moving between displays. Areas beyond the selected display are not filled by stretching its edges.

This requires updating the capture program, frontend and backend together. Older capture programs, static previews and browser fallback still use a centered cover layout. When native capture fails, the scene background falls back through browser rendering, extracted textures and the preview image. The panel subtitle identifies the active path.

Features and controls

• Visual controls: panel transparency, wallpaper blur and shadows. Sync and rendering preferences are saved locally.
• Focus lens: a clear center with a blurred surrounding area, following the pointer by default. Visual intensity adapts to task activity when focus is enabled.
• Eye tracking: optional camera-based gaze tracking with nine-point calibration, text snapping and smoothing. First use needs a network connection to load the model and camera permission. Disabling eye tracking or focus releases the camera.
• Immersive mode: switched by a hotkey (default F11, rebindable in the panel's Keyboard Shortcuts section). Entering switches to a new session and hides the conversation UI, leaving only the wallpaper; press the hotkey again, press Esc, or click any sidebar button to exit.
• Focus mode hotkey: also rebindable (default F10) and equivalent to the panel's Focus Mode button.
• Wallpaper library: manage local DWP packages, WE apps and launcher apps. The market supports search, filters, installation and updates. Management mode allows bulk uninstall of DWP and launcher apps; Steam workshop content is excluded from bulk deletion.
• App launcher: import .zip, .7z or .exe files using HTTP(S) direct links or 139 share links. Smart Paste detects the link, share passcode, archive password and launch file from a share post. Launch apps from Local → Apps; the list shows name, location and download time.
• DWP backgrounds: custom wallpaper packages render through WebGL2 with a Canvas2D fallback. WE background sync pauses while a DWP is mounted. The built-in Workspace Pulse displays recent file changes; day/night variables and texture tiers are supported.

Wallpaper sync

Focus mode demonstration

Wallpaper library

Settings panel

These screenshots illustrate the interface; the current layout may differ.

Configuration

Use the wallpaper_share panel for common settings. For development or custom deployments, edit CONFIG at the top of src/index.ts and rebuild:

Backend sceneRenderMode is separate from the panel's three-mode switch. See the source for additional development options.

Limitations and troubleshooting

• Native capture requires Windows. Capture mirrors the desktop wallpaper layer and may include desktop icons.
• When WE pauses rendering, captured animation pauses too; moving the window still redraws the corresponding region of the last frame. Actual frame rate depends on WE's own frame rate, output resolution and encoding cost.
• The browser Full renderer has limited support for some complex shaders, SceneScript and effects. Prefer Capture when matching WE's original output matters.
• Mounting a DWP pauses WE background sync. Eye tracking needs a camera and a secure browser context such as localhost or HTTPS.
• Market and model assets may fail to load over the network. Installed local content does not depend on loading market thumbnails.

If the background is blank, the version looks old or the tab is missing:

1. Restart DSH after installing or upgrading, then refresh the page.
2. Check that wallpaper_share appears and inspect the browser console for plugin-loading errors.
3. Check /we-sync/diag for monitors, capture version and render status. Make sure WE is running when using Capture.
4. Set wallpaperEngineDir if detection fails. Include the plugin version, harness version and error text when reporting a problem.

Development and validation

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

After changing native source, run npm run build:native on Windows first. Native versions and source fingerprints must match the programs in bin/. Non-ASCII toolchain paths can break the GNU linker; use an ASCII path and configure RUSTUP_HOME / CARGO_HOME if needed.

Chrome pixel regressions:

node tools/test-shake-browser.mjs
node tools/test-particle-browser.mjs
node tools/test-capture-browser.mjs
# Windows with WE running: validate actual captured frames
node tools/test-capture-browser.mjs --native

lib/index.js and lib/client.js are the shipped prebuilt entry points. The panel version is injected from package.json at build time, so rebuild after changing it.

• src/scene/: scene protocol, capture relay, asset parsing and skeletal models.
• src/client/: panel, background layers, effects, particles and viewport cropping.
• native/we-capture/: Windows capture source; bin/ contains shipped programs.
• vendor/dwp/: DWP runtime snapshot; src/market/ and src/launcher/ manage wallpapers and apps.
• docs/: format and implementation notes, including scene-fallback.md and effect-shake.md.

Follow AGENTS.md and the encoding and release rules before committing or packaging. package.json must be UTF-8 without a BOM. Validate the actual installation archive and confirm that the frontend tab appears in a new session.

License

GPL-3.0