@haibala-aii/dsh-extensions-wallpaperskin
使用本地 Wallpaper Engine 图像、视频和场景纹理作为 DeepSeek Harness 网页背景
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:haibala-aii/dsh-extensions-wallpaperskin#91b23249e7428f7b8d477726d9f6c2b52c85b8ffExtensions Wallpaperskin 以 @haibala-aii/dsh-extensions-wallpaperskin 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A DeepSeek Harness web plugin that uses local Wallpaper Engine media as the DSH background. It adds a wallpaper picker to Extensions > External, keeps the DSH workspace readable with translucent surfaces, and stores the selected wallpaper locally.
[!IMPORTANT] Image projects use their original image and video projects play their original local video. Compatible
scene.pkgprojects use the primary texture stored inside the package. Wallpaper Engine particles, SceneScript, puppet rigs, audio visualizers, and web wallpapers are not executed; unsupported projects retain their preview image.
STEAM_PATH, the Steam registry entry, and common installation paths.extensions-wallpaperskin row under Extensions > External instead of adding another Settings page.cover background while keeping DSH content and navigation usable.0-70% surface-transparency control. The default is 36%; the sidebar stays 14 percentage points less transparent for readability.^22.19.0 or >=24.0.0, matching the package engine declaration.If Steam is installed in a non-standard location, set STEAM_PATH to the Steam directory before starting DSH.
Install directly from GitHub into the DSH web profile:
dsh plugin --profile web add github:haibala-aii/dsh-extensions-wallpaperskin
Restart the web application after installation:
dsh web
For a local checkout, clone the repository and link its root directory:
git clone https://github.com/haibala-aii/dsh-extensions-wallpaperskin.git
dsh plugin --profile web add link:E:/path/to/dsh-extensions-wallpaperskin
The repository root is the installable package. There is no nested package directory.
extensions-wallpaperskin row for @haibala-aii/dsh-extensions-wallpaperskin.Closing the dialog before applying restores the saved state. Restore current selection also discards the staged wallpaper and transparency. Disable wallpaper removes the background without deleting any Wallpaper Engine files.
For every discovered Steam library, the host scans:
steamapps/workshop/content/431960
steamapps/common/wallpaper_engine/projects/myprojects
The scanner reads project.json when present. Image projects use the declared original image. Video projects use the declared video or the first supported video in the project directory. Scene projects follow scene.json, model metadata, and material metadata inside scene.pkg to find the primary TEX texture. Preview files remain thumbnails and runtime fallbacks.
Supported image extensions are PNG, JPEG, GIF, WebP, BMP, SVG, and AVIF. Supported video containers are MP4, WebM, M4V, and MOV; playback still depends on codecs supported by the browser.
The Wallpaper Engine tab is a view of Workshop files already downloaded to the machine. The plugin does not download Workshop items itself. Subscribe or create wallpapers in Wallpaper Engine, wait for them to sync, then use Scan local library in the dialog.
The host stores configuration in $DSH_HOME/wallpaperskin.json. When DSH_HOME is unset, DSH's default home is used (~/.dsh). A saved configuration looks like this:
{
"enabled": true,
"selectedId": "workshop/1234567890",
"surfaceTransparency": 36
}
surfaceTransparency is an integer from 0 to 70. 0 keeps the DSH base surface opaque; larger values reveal more of the wallpaper. Invalid or missing values resolve to 36 in the client.
The browser client uses these local endpoints:
| Method | Path | Purpose |
|---|---|---|
GET | /plugins/wallpaperskin/list | Rescan and return available wallpapers, Steam library roots, and saved configuration |
GET | /plugins/wallpaperskin/preview/<id> | Return a wallpaper thumbnail |
GET | /plugins/wallpaperskin/image/<id> | Return the selected background image |
GET | /plugins/wallpaperskin/media/<id> | Return an original image, a ranged video stream, or a decoded scene texture |
GET | /plugins/wallpaperskin/config | Return the saved configuration |
POST | /plugins/wallpaperskin/config | Merge and save configuration fields |
GET | /plugins/wallpaperskin/health | Return plugin health and rendering mode |
The API is intended for the local DSH web client. It is not an authenticated public media service. Apply the same network-access controls to DSH that you use for other local-file capabilities.
The package has two runtime halves:
lib/index.js is the Host plugin. It discovers Steam libraries, selects original project media, provides ranged video responses, exposes the HTTP endpoints, and persists configuration.lib/scene-package.js validates PKGV directories, resolves scene metadata, and decodes the largest TEX mip level without extracting files to disk.lib/client.js is the browser plugin. It registers the Extensions overlay, renders the picker, previews draft changes, and applies image or video backgrounds with translucent DSH theme variables.cordis.patch.yml inserts the Host plugin into the selected DSH profile. The dsh.client fields in package.json register the browser half.
The plugin does not upload wallpapers, send telemetry, or call a remote wallpaper API. Wallpaper metadata, package textures, and video bytes remain on the machine and are read by the local DSH host. The only external navigation is the user-initiated link to the public Wallpaper Engine Workshop.
DSH serves selected media to its connected web client. Do not expose an untrusted DSH instance to the network, because any client that can reach these plugin routes can request discovered wallpaper media by id.
See SECURITY.md for vulnerability reporting.
No build step is required. Edit the ESM sources in lib/, then run:
npm run check
npm pack --dry-run
To exercise the plugin in DSH, link the checkout to a disposable web profile, restart dsh web, and test the complete selection, preview, apply, restore, and disable flows.
Contributions are welcome. Read CONTRIBUTING.md, review the open issues, and include focused verification with behavior changes.
wallpaperskin@haibala-aii/dsh-extensions-wallpaperskinextensions-wallpaperskin/plugins/wallpaperskinReleased under the MIT License.