跳过主要内容
A

dsh-plugin-wallpaper-machine

ayanamreiiv/dsh-plugin-wallpaper-machine

把 macOS 上 WallpaperMachine 的壁纸库接入 DeepSeek Harness:场景壁纸由 WebWallGL 实时渲染,视频与图片直接作为聊天背景播放。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。

安装

dsh plugin --profile web add github:ayanamreiiv/dsh-plugin-wallpaper-machine

README

dsh-plugin-wallpaper-machine

Use your local WallpaperMachine library as the DeepSeek Harness background on macOS — no Wallpaper Engine, no Steam, no conversion step.

Open Settings → Wallpaper Machine, pick a wallpaper, and it is applied immediately behind the chat: Scene wallpapers render live through WebWallGL, Video wallpapers play with loop, Image wallpapers are shown as a still background, and Web wallpapers run in a sandboxed iframe.

Wallpaper Machine settings page inside DeepSeek Harness

Features

  • Reads the real WallpaperMachine library (project.json, scene.pkg, preview image, video file).
  • Scene wallpapers are rendered live by the vendored WebWallGL 3.0.1 runtime (MIT), parsed in the browser; the host only serves bytes with HTTP Range support.
  • Video wallpapers use a native <video> (hardware decode, no WebGL texture upload).
  • Fit (cover / contain / stretch), wallpaper opacity, dim overlay, frame rate, mute, pause.
  • State is local (localStorage), so the wallpaper comes back on the next launch.
  • Read-only: the plugin never writes to the WallpaperMachine folder or the user's library.
  • Coexists with full-window skins: while a wallpaper is active, the plugin clears only the skin's painted stage so the wallpaper shows through, and keeps the skin's chrome and character cut-outs.

Requirements

  • macOS.
  • DeepSeek Harness 0.2.0-rc.1 or newer (tested with 0.2.2-rc.5).
  • WallpaperMachine installed, with at least one wallpaper downloaded.

The plugin finds the library automatically:

  1. $WALLPAPER_MACHINE_HOME/Library when WALLPAPER_MACHINE_HOME is set.
  2. The library moved through WallpaperMachine's own storage settings, recorded in ~/Library/Application Support/WallpaperMachine/StorageLocation.json (validated by the .WallpaperMachineStorage marker file).
  3. ~/Library/Application Support/WallpaperMachine/Library by default.

Install

From the DSH desktop app

  1. Open Plugins in the sidebar.
  2. Click Add plugin and enter dsh-plugin-wallpaper-machine.
  3. Wait for the install to finish, then restart DeepSeek Harness if the app asks for it.
  4. Open the account menu at the bottom-left → Settings → Wallpaper Machine.

From the CLI

dsh plugin --profile desktop add dsh-plugin-wallpaper-machine

The dsh CLI prints the profile it changed. Restart DeepSeek Harness afterwards.

From a local checkout (development)

cd ~/.dsh/profiles/desktop
pnpm add link:/absolute/path/to/dsh-plugin-wallpaper-machine

Add "dsh-plugin-wallpaper-machine" to dsh.profile.bundles in that profile's package.json, run pnpm install, then restart DSH. A separate test profile works the same way:

dsh plugin --profile wmt add link:/absolute/path/to/dsh-plugin-wallpaper-machine
dsh --profile wmt --port 50599 --no-open

Use

  • Choose a wallpaper card to apply it. The setting takes effect immediately.
  • Pause stops scene/video frames without unloading the wallpaper; Turn off hides the layer.
  • Dim overlay is the readability knob: raise it for bright scenes, lower it for dark ones.
  • Scene frame rate defaults to 60; 30 or 45 reduces GPU load on laptops.
  • The wallpaper layer is behind the whole app, including the sidebar, when the active theme uses transparent surfaces. Full-window skins keep their own sidebar color by design.

How it works

client.js                    body-level wallpaper layer + Settings page (React, slots)
index.js                     host: resolve library → scan → HTTP routes
scene-live/                  WebWallGL adapter page loaded in the layer iframe
vendor/webwallgl/            pinned WebWallGL 3.0.1 runtime (MIT)

Host routes under /wallpaper-machine:

RoutePurpose
/api/libraryscanned inventory (id, title, kind, preview URL, scene URL)
/api/statusresolved root, source, existence, count
/files/<id>/<path>wallpaper bytes, ETag + Range (206/416), path-fenced
/scene-live/transparent WebWallGL page for one scene
/engine/webwallgl.global.min.jsvendored engine

Video and image payloads go straight to the browser; scene.pkg is fetched with Range requests and decoded by WebWallGL. Nothing leaves the machine.

Development

# standalone host + scene page, no DSH needed
node scripts/serve.mjs        # http://127.0.0.1:7799

# syntax check
node --check index.js
node --check client.js
node --check scene-live/renderer.js

scripts/serve.mjs uses the same createWallpaperHandler() as production. To test the client against a running DSH, use a separate profile as shown above and open the printed ?token= URL.

Known limitations

  • macOS only; the library paths and WallpaperMachine itself are macOS-specific.
  • Scene rendering depends on WebGL2. If the GPU refuses a context, the plugin keeps the preview image and reports the error in the console.
  • Web wallpapers are third-party HTML; they run sandboxed but are not otherwise audited.
  • The plugin does not download wallpapers; manage the library in WallpaperMachine.

License

MIT. WebWallGL is MIT and is redistributed under vendor/webwallgl/ with its license.

相关插件