dsh-blender-preview
Manifest validFiles-tab previews for DeepSeek Harness: .blend (headless local Blender export to a cached GLB), .glb/.gltf/.obj in a WebGL viewport, plus .svg, video and audio; depends on dsh-blender with a read-onl
dsh-blender-preview
English | 中文
A DeepSeek Harness plugin that previews Blender .blend files (and more) in the right sidebar's Files tab: the host half exports a cached GLB headlessly through your local Blender install, and the browser half renders it in an interactive WebGL viewport with scene statistics.
Status: v0.3.0 — the preview works.
.blend/.glb/.gltf/.objopen in a 3D viewport,.svgin a pixel-true vector viewer, and video/audio stream with seek. The package shipsdsh-blender@^0.2.4as a dependency with a non-mutating boot self-check, makes no network calls and collects no telemetry..blendconversion needs a local Blender installation; the other formats work without one.
Install
From npm:
npx @deepseek-ai/dsh plugin --profile web add dsh-blender-preview
Or straight from GitHub:
npx @deepseek-ai/dsh plugin --profile web add github:adithyanraj03/dsh-blender-preview
The package runs no install scripts (no postinstall), so pnpm's ignored-builds prompt does not apply. Installing it also pulls one dependency, dsh-blender@^0.2.4, into the profile alongside — see Works with dsh-blender. Confirm it mounted — the plugin must appear in both dependencies and dsh.profile.bundles:
cd ~/.dsh/profiles/web && node -e "const p=require('./package.json');
console.log(p.dependencies['dsh-blender-preview'],
p.dsh.profile.bundles.includes('dsh-blender-preview'))"
In the desktop app
Open Plugins (settings, left sidebar) → Add plugin, paste the repository address, click Install:
https://github.com/adithyanraj03/dsh-blender-preview
Installed plugins do not update automatically yet — to upgrade, uninstall and install again. The host half loads at startup, so restart the app after installing or upgrading.
What it does
- 3D viewport for
.blend,.glb,.gltf,.obj: drag to orbit, right-drag to pan, scroll to zoom, plus reset-view, spin, wireframe, grid and light-background toggles. Scene chips show triangle / mesh / material counts, animation count and whether the model is rigged. .blendconversion runs your local Blender in the background (blender -b --factory-startup … --python export_glb.py) and caches the GLB under<DSH_HOME>/storages/blender-preview, keyed by path + size + mtime (or by content for uploaded bytes). Reopening the same file is instant; an edited file converts again.- Animation playback: clip picker, play/pause, a scrub bar and speed control when the model carries clips.
.svgrenders as a vector drawing with pixel-true zoom and pan.- Video / audio stream over HTTP ranges, so a multi-gigabyte file seeks without being read into memory.
Row config (all optional, on the blender-preview row):
| Key | Default | Meaning |
|---|---|---|
blenderPath | auto-detected (BLENDER_PATH, common install dirs, PATH) | the Blender executable |
timeoutMs | 180000 | longest one export may take |
cacheDir | <DSH_HOME>/storages/blender-preview | where converted GLBs are kept |
Works with dsh-blender
This package declares dsh-blender (npm dsh-blender) by CheshireJCat as a dependency, so a registry or GitHub install puts dsh-blender@^0.2.4 into the profile next to this plugin. At boot, the host half runs a non-mutating self-check: for every profile that depends on this package it verifies that dsh-blender is installed in that profile and mounted in its dsh.profile.bundles, and when either is missing it logs the exact one-liner that repairs it:
npx @deepseek-ai/dsh plugin --profile web add dsh-blender
The self-check reads; it never installs or edits anything itself. This matters for link: dev profiles, where pnpm does not install the linked package's own dependencies — the check reports the gap instead of assuming it away.
Credit: dsh-blender is a community plugin by CheshireJCat — Blender modelling tools and skills for dsh.
Prior art
dsh-blend-preview on npm is taken and deprecated; its author renamed it to dsh-preview-blender, which already implements headless-GLB + WebGL sidebar preview. This is an independent implementation under the dsh-blender-preview name, verified available on npm when this plugin was created.
Development
npm install # dev deps: three + esbuild-wasm (no native esbuild, no postinstall)
npm run build # bundle src/client -> lib/client.js (esbuild-wasm)
npm test # wiring harness + unit tests + e2e export
BLEND_SAMPLE=/path/to/file.blend npm test # include the real Blender .blend->GLB e2e test
python scripts/make-banner.py # regenerate the README banners (Pillow)
| Path | Role |
|---|---|
src/index.js | host half — dsh-blender boot self-check, convert/media/status routes |
src/convert.js | Blender resolution, headless export, on-disk GLB cache |
src/export_glb.py | the Blender-side export script |
src/client/ | browser half sources — viewport, SVG, media, registration |
lib/client.js | built browser bundle (generated by build.mjs) |
build.mjs | esbuild-wasm bundler wrapped in dsh's module loader |
cordis.patch.yml | mounts the host row; name must equal the package name |
scripts/test-harness.mjs | dependency-free wiring test |
test/preview.test.mjs | unit + cache + Blender e2e tests |
docs/ | GitHub Pages site |
assets/ | icon and banners |
Compatibility
| Host | Status |
|---|---|
| dsh 0.2.x (web + desktop) | working; restart after install/upgrade so the host half loads |
.blend conversion requires a local Blender installation (tested against Blender 5.2 LTS). .glb / .gltf / .obj / .svg / video / audio previews work without Blender.
License
MIT © Adithya N Raj
Comments
Loading…
Similar plugins
Preview Blender .blend files in the DeepSeek Harness right Sidebar: cached headless GLB export plus a dependency-free WebGL viewer with scene statistics.
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-blend-previewby DeveloperYe
Local file manager for DeepSeek Harness Web: browse, preview, download, upload, edit, rename and delete host files from the browser, over the same authenticated DSH web server
★ 0
MIT
HTML
Oct 27, 2026
dsh plugin --profile web add dsh-local-filesby xusuyang030218
DSH (DeepSeek Harness) file preview & editor plugin: in-browser workspace file tree, multi-format preview, online editing, version history, search. DSH 文件预览插件。
★ 0
MIT
JavaScript
Aug 24, 2026
dsh plugin --profile web add dsh-preview-uiOpen .blend files in the right-Sidebar document preview: cached Blender headless GLB export plus a dependency-free WebGL viewport and scene statistics.
★ 0
dsh plugin --profile web add dsh-preview-blenderby Dawn388887
[DEPRECATED] DSH plugin: in-GUI file viewer/editor for remote browsers. Superseded by the built-in DSH 0.1.5+ Web sidebar file preview; last supported DSH: 0.1.2.
★ 0
MIT
JavaScript
Sep 12, 2026
dsh plugin --profile web add dsh-fileviewby donoteatme
Browser-first, LAN-only access to the current DeepSeek Harness Web UI with one-time QR pairing, revocable devices, event-driven diagnostics, and a slot-preserving mobile layout; no companion app, clou
★ 1
↓ 588/wk
MIT
TypeScript
Sep 12, 2026
dsh plugin --profile web add dsh-local-link