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.

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.

Catalog (0.1.4)

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.

Package	Formats	Host requirement
dsh-preview-media	mp4/mov/webm/mkv + mp3/flac/wav/…	—
dsh-preview-blender	.blend	Blender 3.6+
dsh-preview-stl	.stl	—
dsh-preview-snip	Tool: circle/quote in image or PDF preview	—

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.4 — 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.