dsh-preview-market
A vertical preview market for DeepSeek Harness. A top-level settings section (and a Settings → Plugins tab) lists the preview plugins that exist for DSH, shows which ones the active profile already has, and hands installs/updates to dsh-market or the official dsh plugin command.
It is not a general plugin market, and it does not implement previews itself: every preview plugin stays an independent Loader entry with its own repository, version and settings. The market only provides the catalog, the installed view and the entry points.
Preview market in Settings
Install
dsh plugin --profile <profile> add dsh-preview-market
Open Settings → Preview market (the same panel is also under Settings → Plugins).
Upgrading from dsh-media-preview / dsh-blend-preview / dsh-stl-preview? See MIGRATION.md.
What it does
- Catalog — first-party preview plugins with their formats, host requirements and versions.
- Installed view — reads the active profile's
package.json, matching catalog names by default and honouring a package's dsh.preview manifest when present; never imports child plugin code.
- Install / update — delegates to
dsh-market when it is present. Without it, the card shows the exact dsh plugin --profile <profile> add <package>@<version> command to copy.
- Independent plugins — media, Blender and STL remain separate packages; this page has no renderer and does not merge their code.
Screenshots
Preview market
The top-level Settings → Preview market section, next to dsh-market, with the Discover / Installed tabs and the current four entries:
Preview market section
Installed cards and controls
Each installed entry keeps the same controls: status, copyable install command, enable/disable through dsh-market, and a Configure entry.
Installed cards and controls
Current preview plugins
dsh-preview-media
Play video/audio in the right-Sidebar document preview, streamed over an authenticated HTTP Range route. Desktop seeking uses the token-guarded loopback origin; 0.1.5 also retries the authenticated route when the loopback reports a code-4 media error.
Video preview
dsh-preview-blender
A .blend file is exported to a cached GLB by Blender headless, then rendered in a dependency-free WebGL viewport with scene statistics.
Blender preview
dsh-preview-stl
STL is parsed in the browser; the viewport reports size, volume, surface area and watertightness without uploading the mesh.
STL preview
dsh-preview-snip
A preview-header tool: drag a rectangle over an image/PDF to attach a PNG, or quote selected text into the composer.
Preview snip
Catalog (0.1.10)
Every plugin is one file under catalog/plugins/, named <owner>__<repo>.json. A third-party submission adds exactly one file plus the regenerated catalog.json snapshot — no market code change. The Host loads, validates and merges all files at startup; the format and PR steps are in catalog/README.md.
Preview entries use kind: "media" or "three" and declare their extensions; dsh-preview-snip uses kind: "tool", which has no file extensions and is displayed as a tool card.
Configuration
Settings → Plugins → Preview market (namespace preview-market):
| Key | Default | Meaning |
|---|
enabled | true | Register the routes, the top-level section and the Settings → Plugins tab. |
routeRoot | /api/preview-market | Authenticated route root; must stay under /api. |
profileDir | "" | Profile to inspect. Empty uses the Host profileContext, then $DSH_HOME/profiles/desktop. |
debug | false | Reserved for request diagnostics. |
Examples
examples/profile-overrides.yml — a safe starting point for per-profile overrides (media chunk size, Blender path, STL unit scale).catalog.json — machine-readable snapshot of the shipped catalog, enforced by a unit test.
Development
node --test test/*.test.js
catalog.json is a machine-readable snapshot of the shipped catalog; regenerate it with npm run catalog:write and keep it in sync (a test enforces this).
Settings-section end-to-end (requires a running host with the plugin installed):
node scripts/e2e-section.mjs --base http://127.0.0.1:<port> --token <token>
Settings-tab end-to-end (requires a running host with the plugin installed):
node scripts/e2e-settings.mjs --base http://127.0.0.1:<port> --token <token>
Fallback install/copy check (requires a profile where one catalog entry is not installed):
node scripts/e2e-fallback.mjs --base http://127.0.0.1:<port> --token <token>
Toggle/configure check (requires dsh-market and an installed STL preview):
node scripts/e2e-toggle.mjs --base http://127.0.0.1:<port> --token <token>
The client bundle is lib/client.js (classic __ModuleLoader__.load factory, no build step).
Status
0.1.10 — top-level Settings → Preview market section with Discover / Installed tabs, plus the Settings → Plugins tab. The catalog is one file per plugin under catalog/plugins/ (preview plugins and tool entries such as the preview snip), so third-party entries are a one-file PR. Enable/disable goes through dsh-market. One-click install requires the package in the connected dsh-market registry; otherwise use the copyable command. Configuration stays in each child plugin's own Settings → Plugins page.
