dsh-preview-market 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.1.5
+
+- Catalog version for `dsh-preview-media` follows the media transport fallback release `0.1.5`.
+
+## 0.1.4
+
+- Catalog entries can now be `kind: "tool"` (preview enhancements with no file extensions); `dsh-preview-snip` is the first one.
+- Cards show `Type: Tool` instead of a formats line for tool entries; install/toggle/configure stay the same.
+
 ## 0.1.3
 
 - Catalog entries now live in `catalog/plugins/<owner>__<repo>.json` — one file per plugin, so third parties can submit a PR without editing market code.

package/README.md

@@ -23,7 +23,7 @@ Upgrading from `dsh-media-preview` / `dsh-blend-preview` / `dsh-stl-preview`? Se
 - **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.3)
+## Catalog (0.1.5)
 
 Every plugin is **one file** under [`catalog/plugins/`](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`](catalog/README.md).
 
@@ -32,6 +32,7 @@ Every plugin is **one file** under [`catalog/plugins/`](catalog/plugins/), named
 | `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
 
@@ -85,4 +86,4 @@ The client bundle is `lib/client.js` (classic `__ModuleLoader__.load` factory, n
 
 ## Status
 
-`0.1.3` — 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/`, 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.
+`0.1.5` — 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.

package/README.zh.md

@@ -23,7 +23,7 @@ dsh plugin --profile <profile> add dsh-preview-market
 - **安装/更新** — 检测到 dsh-market 时委托给它；没有时显示可复制的 `dsh plugin --profile <profile> add <包>@<版本>` 命令。
 - **独立插件** — media、Blender、STL 仍是独立包；本页不注册渲染器，也不合并它们的代码。
 
-## 目录（0.1.3）
+## 目录（0.1.5）
 
 每个插件是 [`catalog/plugins/`](catalog/plugins/) 下的**一个文件**，命名为 `<owner>__<repo>.json`。三方收录只需新增一个文件 + 重新生成 `catalog.json`，不用改市场代码；Host 启动时读取、校验并合并全部文件。字段与 PR 步骤见 [`catalog/README.md`](catalog/README.md)。
 
@@ -32,6 +32,7 @@ dsh plugin --profile <profile> add dsh-preview-market
 | `dsh-preview-media` | mp4/mov/webm/mkv + mp3/flac/wav/… | — |
 | `dsh-preview-blender` | `.blend` | Blender 3.6+ |
 | `dsh-preview-stl` | `.stl` | — |
+| `dsh-preview-snip` | 工具：图片/PDF 圈选或引用选中 | — |
 
 ## 配置
 
@@ -59,4 +60,4 @@ node --test test/*.test.js
 
 ## 状态
 
-`0.1.3` — 顶层「设置 → 预览市场」+ 发现/已安装两个 tab，同时保留「设置 → 插件」里的入口。目录改为 `catalog/plugins/` 下一插件一文件，三方收录只需一个文件 PR。启用/停用走 dsh-market；一键安装要求对应包已进入所连接 dsh-market 的 registry，否则用可复制命令。配置仍在各子插件自己的 设置 → 插件 页面。
+`0.1.5` — 顶层「设置 → 预览市场」+ 发现/已安装两个 tab，同时保留「设置 → 插件」里的入口。目录改为 `catalog/plugins/` 下一插件一文件，支持预览插件和 `kind: "tool"` 的增强工具（如预览圈选），三方收录只需一个文件 PR。启用/停用走 dsh-market；一键安装要求对应包已进入所连接 dsh-market 的 registry，否则用可复制命令。配置仍在各子插件自己的 设置 → 插件 页面。

package/VERIFY.md

@@ -1,4 +1,4 @@
-# Verification record — dsh-preview-market 0.1.3
+# Verification record — dsh-preview-market 0.1.4
 
 ## Unit tests (2026-10-23)
 
@@ -7,7 +7,7 @@
 | File | Covers |
 |---|---|
 | `test/config.test.js` | defaults, `/api` route fence, route normalization, boolean normalization |
-| `test/catalog.test.js` | one file per entry, required fields, filename/repository match, duplicates, payload shape |
+| `test/catalog.test.js` | one file per entry, preview/tool schema, filename/repository match, duplicates, payload shape |
 | `test/catalog-file.test.js` | `catalog.json` snapshot matches the files |
 | `test/installed.test.js` | profile `package.json` + `node_modules` inventory, missing profile, `profileContext` resolution |
 | `test/client.test.js` | bundle registers the `settings.section` and `settings.plugins.tab` entries |
@@ -32,7 +32,7 @@
 node scripts/e2e-section.mjs --base http://127.0.0.1:59010 --token <token>
 ```
 
-Result: **PASS** — the Settings nav contains `预览市场` immediately after `插件市场`; opening it shows the `发现` / `已安装` tabs and the three catalog cards (`dsh-preview-media`, `dsh-preview-blender`, `dsh-preview-stl`). No page errors. Screenshot: `docs/preview-market-section.png`.
+Result: **PASS** — the Settings nav contains `预览市场` immediately after `插件市场`; opening it shows the `发现` / `已安装` tabs and the four catalog cards (`dsh-preview-media`, `dsh-preview-blender`, `dsh-preview-stl`, and the `kind: "tool"` entry `dsh-preview-snip`). No page errors. Screenshot: `docs/preview-market-section.png`.
 
 ## Settings tab e2e (2026-10-23, preview-test)
 

package/catalog/README.md

@@ -29,13 +29,15 @@ The filename must match the repository URL: `https://github.com/<owner>/<repo>`
 }
 ```
 
-Required: `name`, `npm`, `capability`, `kind`, `repo`, `version`, `extensions`, `formats`, `description.zh`, `description.en`.
+Required: `name`, `npm`, `capability`, `kind`, `repo`, `version`, `description.zh`, `description.en`.
 
-Optional: `minDsh`, `requires` (defaults to `[]`).
+Required for preview kinds (`media`, `three`): `extensions` (non-empty), `formats`.
 
-- `kind` is currently `media` or `three`; `three` entries get the shared WebGL viewport.
-- `extensions` drives the document-preview registration in the child plugin; the catalog only displays it.
-- `formats` groups extensions for the card, e.g. `{ "video": [...], "audio": [...] }`.
+Optional: `minDsh`, `requires` (defaults to `[]`). `tool` entries omit `extensions` and `formats`; the loader normalizes them to `[]` / `{}`.
+
+- `kind` is `media`, `three`, or `tool`; `three` entries get the shared WebGL viewport, `tool` entries are preview enhancements with no file extensions.
+- `extensions` drives the document-preview registration in the child plugin; the catalog only displays it. It is required for preview kinds and omitted for `tool`.
+- `formats` groups extensions for the card, e.g. `{ "video": [...], "audio": [...] }`. Also omitted for `tool`.
 
 ## Submit a plugin
 

package/catalog/plugins/439436269-ctrl__dsh-preview-media.json

@@ -4,7 +4,7 @@
   "capability": "media",
   "kind": "media",
   "repo": "https://github.com/439436269-ctrl/dsh-preview-media",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "minDsh": "0.2.0-rc.2",
   "requires": [],
   "extensions": [

package/catalog/plugins/439436269-ctrl__dsh-preview-snip.json

@@ -0,0 +1,14 @@
+{
+  "name": "dsh-preview-snip",
+  "npm": "dsh-preview-snip",
+  "capability": "snip",
+  "kind": "tool",
+  "repo": "https://github.com/439436269-ctrl/dsh-preview-snip",
+  "version": "0.1.0",
+  "minDsh": "0.2.0-rc.2",
+  "requires": [],
+  "description": {
+    "zh": "图片/PDF 预览圈选截图，或引用选中文字，直接插入输入框。",
+    "en": "Circle an image/PDF preview region or quote selected text into the composer."
+  }
+}

package/catalog.json

@@ -31,7 +31,7 @@
       "capability": "media",
       "kind": "media",
       "repo": "https://github.com/439436269-ctrl/dsh-preview-media",
-      "version": "0.1.4",
+      "version": "0.1.5",
       "minDsh": "0.2.0-rc.2",
       "requires": [],
       "extensions": [
@@ -97,6 +97,22 @@
         "en": "Video and audio in the right-Sidebar document preview, streamed with HTTP Range and seekable in the desktop app."
       }
     },
+    {
+      "name": "dsh-preview-snip",
+      "npm": "dsh-preview-snip",
+      "capability": "snip",
+      "kind": "tool",
+      "repo": "https://github.com/439436269-ctrl/dsh-preview-snip",
+      "version": "0.1.0",
+      "minDsh": "0.2.0-rc.2",
+      "requires": [],
+      "description": {
+        "zh": "图片/PDF 预览圈选截图，或引用选中文字，直接插入输入框。",
+        "en": "Circle an image/PDF preview region or quote selected text into the composer."
+      },
+      "extensions": [],
+      "formats": {}
+    },
     {
       "name": "dsh-preview-stl",
       "npm": "dsh-preview-stl",

package/lib/catalog.js

@@ -22,8 +22,6 @@ const REQUIRED = [
   "kind",
   "repo",
   "version",
-  "extensions",
-  "formats",
   "description"
 ];
 
@@ -61,15 +59,20 @@ function loadCatalog() {
       for (const key of REQUIRED) {
         if (entry[key] === undefined) throw new Error(`catalog/plugins/${file}: missing ${key}`);
       }
-      if (!Array.isArray(entry.extensions) || entry.extensions.length === 0) {
-        throw new Error(`catalog/plugins/${file}: extensions must be a non-empty array`);
-      }
-      if (typeof entry.formats !== "object" || entry.formats === null) {
-        throw new Error(`catalog/plugins/${file}: formats must be an object`);
-      }
       if (typeof entry.description?.zh !== "string" || typeof entry.description?.en !== "string") {
         throw new Error(`catalog/plugins/${file}: description.zh/en must be strings`);
       }
+      if (entry.kind === "tool") {
+        entry.extensions = [];
+        entry.formats = {};
+      } else {
+        if (!Array.isArray(entry.extensions) || entry.extensions.length === 0) {
+          throw new Error(`catalog/plugins/${file}: extensions must be a non-empty array`);
+        }
+        if (typeof entry.formats !== "object" || entry.formats === null) {
+          throw new Error(`catalog/plugins/${file}: formats must be an object`);
+        }
+      }
       if (seen.has(entry.name)) throw new Error(`duplicate catalog name: ${entry.name}`);
       seen.add(entry.name);
       entry.requires = Array.isArray(entry.requires) ? entry.requires : [];

package/lib/client.js

@@ -38,6 +38,8 @@ window.__ModuleLoader__.load({
       empty: "目录为空。",
       requires: "需要",
       formats: "格式",
+      type: "类型",
+      tool: "工具",
       profile: "当前 profile",
       market: "dsh-market",
       marketOn: "已连接，可一键安装",
@@ -78,6 +80,8 @@ window.__ModuleLoader__.load({
       empty: "The catalog is empty.",
       requires: "Requires",
       formats: "Formats",
+      type: "Type",
+      tool: "Tool",
       profile: "Profile",
       market: "dsh-market",
       marketOn: "connected, one-click install available",
@@ -131,7 +135,8 @@ window.__ModuleLoader__.load({
       const newer = current !== "" && current !== item.version;
       const formats = item.formats !== undefined
         ? Object.values(item.formats).flat().slice(0, 10)
-        : item.extensions.slice(0, 10);
+        : (item.extensions ?? []).slice(0, 10);
+      const isTool = item.kind === "tool";
       return React.createElement(
         "article",
         { className: "dsh-pm-card", "data-installed": current !== "" ? "true" : "false" },
@@ -149,7 +154,9 @@ window.__ModuleLoader__.load({
         React.createElement(
           "div",
           { className: "dsh-pm-meta" },
-          React.createElement("span", null, `${t("formats")}: ${formats.join(", ")}`),
+          formats.length > 0
+            ? React.createElement("span", null, `${t("formats")}: ${formats.join(", ")}`)
+            : React.createElement("span", null, `${t("type")}: ${isTool ? t("tool") : item.kind}`),
           item.requires.length > 0
             ? React.createElement("span", { className: "dsh-pm-requires" }, `${t("requires")}: ${item.requires.join(", ")}`)
             : null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-preview-market",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Vertical preview market for DeepSeek Harness: discover, install and configure preview plugins (media, Blender, STL, ...) from one panel.",
   "type": "module",
   "license": "MIT",