dsh-tool-vision 0.10.2 → 0.10.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +46 -38
  2. package/README.zh.md +12 -4
  3. package/cordis.patch.yml +8 -8
  4. package/package.json +104 -102
package/README.md CHANGED
@@ -1,17 +1,25 @@
1
1
  # dsh-tool-vision
2
-
3
- ## DSH 0.2.1-rc.1
4
-
5
- Supports DSH 0.2.1-rc.1. Compatibility is declared through `engines.dsh` and matching peer ranges, including this exact prerelease. The existing 0.2.0-rc.2 support is retained.
6
2
 
7
- The plugin follows the DSH language setting (Chinese and English in DSH 0.2.0-rc.2), including configuration, status messages and plugin-list metadata. Language-pack locales use the host fallback chain. Switching languages preserves unsaved settings; there is no separate plugin language selector.
8
-
3
+ ## DSH 0.2.1-rc.3
4
+
5
+ Supports DSH 0.2.1-rc.3, including explicit prerelease engines.dsh and peer ranges. This host update adds More navigation menus, keeps unsent drafts on New Session, and follows the official /models listing on the DeepSeek API-key route; the tool, settings and pi-ai interfaces used here remain unchanged, and no removed host API (`ctx.layout.entryVisibility`, `agentPresetNavigation`) was in use.
6
+
7
+ ## DSH 0.2.1-rc.2
8
+
9
+ Supports DSH 0.2.1-rc.2, including explicit prerelease engines.dsh and peer ranges. This host update adds DeepSeek V4.1 Flash 1017 and Search/Fetch APIs; the plugin APIs used here remain unchanged. Existing reasoning settings and the opt-in augmentation policy are preserved.
10
+
11
+ ## DSH 0.2.1-rc.1
12
+
13
+ Supports DSH 0.2.1-rc.1. Compatibility is declared through `engines.dsh` and matching peer ranges, including this exact prerelease. The existing 0.2.0-rc.2 support is retained.
14
+
15
+ The plugin follows the DSH language setting (Chinese and English in DSH 0.2.0-rc.2), including configuration, status messages and plugin-list metadata. Language-pack locales use the host fallback chain. Switching languages preserves unsaved settings; there is no separate plugin language selector.
16
+
9
17
  ## Configuration page (DSH 0.2.0-rc.2 and later)
10
18
 
11
19
  Open **Plugins → Installed → dsh-tool-vision** from the homepage sidebar to configure and save this plugin. The page uses the official `plugins.bundle.config` interface, without a duplicate entry in global Settings. Web and Desktop share the page. This version requires DSH 0.2.0-rc.2 or a later 0.2.x host; existing configuration is retained.
12
20
 
13
- Choose **Automatic images and previews** to enable image bridging, automatic admission and thumbnails together, or **Vision tools only** for explicit tool calls. Enter the endpoint, key and model on the main page; model overrides and request tuning live under **Advanced**. Existing mixed switch values appear as **Custom combination** and are retained until you change them. Selecting a mode edits a draft; click Save to apply it. Only edited fields are written, blank keys are preserved, and rejected writes keep the draft.
14
-
21
+ Choose **Automatic images and previews** to enable image bridging, automatic admission and thumbnails together, or **Vision tools only** for explicit tool calls. Enter the endpoint, key and model on the main page; model overrides and request tuning live under **Advanced**. Existing mixed switch values appear as **Custom combination** and are retained until you change them. Selecting a mode edits a draft; click Save to apply it. Only edited fields are written, blank keys are preserved, and rejected writes keep the draft.
22
+
15
23
  [![中文文档](https://img.shields.io/badge/%E4%B8%AD%E6%96%87%E6%96%87%E6%A1%A3-blue)](README.zh.md)
16
24
 
17
25
  **GitHub**: [Scorp1o117/dsh-tool-vision](https://github.com/Scorp1o117/dsh-tool-vision) · **npm**: [dsh-tool-vision](https://www.npmjs.com/package/dsh-tool-vision)
@@ -50,30 +58,30 @@ bridge keeps its conversion inside that durable path:
50
58
  call `inspect_image`.
51
59
  - **Web UI settings section (v0.3.0)**: Settings → 视觉模型 edits the
52
60
  `tool-vision` namespace (API endpoint, write-only key, model, bridge
53
- options) in the active Profile patch; changes hot-apply without a restart. The API
54
- key lives in that patch. Mount by package name
61
+ options) in the active Profile patch; changes hot-apply without a restart. The API
62
+ key lives in that patch. Mount by package name
55
63
  (`name: 'dsh-tool-vision'`) so the web client bundle is discovered.
56
64
 
57
- ## Compatibility (v0.9.7)
58
-
59
- Verified with DSH `0.1.7-rc.2` (Web) and `0.2.0-rc.2` (Desktop runtime) in isolated profiles. The Desktop app uses its own `desktop` profile. Other DSH prereleases remain unverified.
60
-
61
- ## Desktop install
62
-
63
- Use the Desktop-installed `dsh` command (Application → Manage dsh Command), or the app’s Plugins page. Then install into the Desktop profile:
64
-
65
- ```powershell
66
- dsh plugin --profile desktop add dsh-tool-vision@0.9.7
67
- ```
68
-
69
- Restart the Desktop app to load the client bundle. Desktop keeps its profile under `$DSH_HOME/profiles/desktop`.
70
-
71
-
72
- ## v0.9.4: Windows bridge export filenames
73
-
74
- - Export filenames now derive from a stable hash of the complete attachment ID. IDs such as `sha256:...` no longer create NTFS alternate data streams and zero-byte visible files.
75
- - The export directory is created before writing; the in-process cache now respects changes to `bridgeExportDir`.
76
- - Passed install, Web boot, homepage and client-bundle HTTP checks, and uninstall in a disposable DSH `0.1.5-rc.3` Profile.
65
+ ## Compatibility (v0.9.7)
66
+
67
+ Verified with DSH `0.1.7-rc.2` (Web) and `0.2.0-rc.2` (Desktop runtime) in isolated profiles. The Desktop app uses its own `desktop` profile. Other DSH prereleases remain unverified.
68
+
69
+ ## Desktop install
70
+
71
+ Use the Desktop-installed `dsh` command (Application → Manage dsh Command), or the app’s Plugins page. Then install into the Desktop profile:
72
+
73
+ ```powershell
74
+ dsh plugin --profile desktop add dsh-tool-vision@0.9.7
75
+ ```
76
+
77
+ Restart the Desktop app to load the client bundle. Desktop keeps its profile under `$DSH_HOME/profiles/desktop`.
78
+
79
+
80
+ ## v0.9.4: Windows bridge export filenames
81
+
82
+ - Export filenames now derive from a stable hash of the complete attachment ID. IDs such as `sha256:...` no longer create NTFS alternate data streams and zero-byte visible files.
83
+ - The export directory is created before writing; the in-process cache now respects changes to `bridgeExportDir`.
84
+ - Passed install, Web boot, homepage and client-bundle HTTP checks, and uninstall in a disposable DSH `0.1.5-rc.3` Profile.
77
85
 
78
86
  ## Install
79
87
 
@@ -110,7 +118,7 @@ Or load it from a local path without npm:
110
118
  | `maxImageBytes` | `10MB` | Largest accepted local image. |
111
119
  | `description` | default | Tool description shown to the model. |
112
120
  | `bridgeTextOnly` | `true` | Bridge pasted images to text hints on models that cannot see images. |
113
- | `bridgeExportDir` | temp | Export dir for bridged images (`os.tmpdir()/dsh-vision-bridge`). Filenames use a portable hash of the attachment ID. |
121
+ | `bridgeExportDir` | temp | Export dir for bridged images (`os.tmpdir()/dsh-vision-bridge`). Filenames use a portable hash of the attachment ID. |
114
122
  | `multimodalModels` | `[]` | Model list (comma-separated). Each entry is matched case-insensitively against the full id, its bare id after the last `/`, and `provider/id`, with `*` / `?` globs (`*vl*`, `deepseek/*`). What the list *means* is set by the mode below. |
115
123
  | `multimodalListMode` | `whitelist` | **List mode (v0.9.0).** `whitelist`: listed models receive image blocks directly (the historical behaviour). `blacklist`: listed models are forced through the bridge — the correction layer for a model that claims image support it does not have. `off`: the list is ignored. An unknown value falls back to `whitelist`. |
116
124
  | `autoDetectMultimodal` | `true` | **Auto-detect (v0.9.0).** Decide from the current route's own declared `inputModalities`, then combine with the list (whitelist unions, blacklist subtracts). On by default: a text-only route is bridged, a multimodal one is treated like a whitelist member and gets images directly. The declaration is always read *before* this plugin's admission wrap, so `bridgeAutoImage` can never feed its own claim back in as evidence. Set false for the hand-maintained "list only" behaviour. |
@@ -354,12 +362,12 @@ looked completely dead. Nothing below the DOM can catch that class of bug.
354
362
 
355
363
  ## Capability probe: `vision_probe_model` (v0.9.0)
356
364
 
357
- Each request defaults to a 60-second deadline and 2048 output tokens. Response
358
- bodies are limited to 1 MiB while streaming; an oversized body stops the read
359
- and yields `unknown`. Authentication, rate-limit and server errors remain
360
- `unknown` even if their messages mention image input. Only HTTP 400, 415 or
361
- 422 image-rejection errors yield a negative verdict from an error response.
362
-
365
+ Each request defaults to a 60-second deadline and 2048 output tokens. Response
366
+ bodies are limited to 1 MiB while streaming; an oversized body stops the read
367
+ and yields `unknown`. Authentication, rate-limit and server errors remain
368
+ `unknown` even if their messages mention image input. Only HTTP 400, 415 or
369
+ 422 image-rejection errors yield a negative verdict from an error response.
370
+
363
371
  Every other signal here rests on what a model **says** about itself. This tool
364
372
  sends a real image to the route and reports what it **does** — the only
365
373
  ground truth in the plugin.
@@ -428,7 +436,7 @@ if (containsImage && !model.input.includes("image"))
428
436
 
429
437
  `this.modelOf` resolves from the adapter's own `snapshot.models` catalog, which
430
438
  defaults to `input: ["text"]` unless the user explicitly declared
431
- `input: [text, image]` in the Profile patch. When admitted by `v0.9.2`, the raw image
439
+ `input: [text, image]` in the Profile patch. When admitted by `v0.9.2`, the raw image
432
440
  reached `streamWithSnapshot` and triggered `UNSUPPORTED_CONTENT`. Since the image
433
441
  was already in the session's durable transcript, every subsequent turn failed.
434
442
 
package/README.zh.md CHANGED
@@ -1,8 +1,16 @@
1
1
  # dsh-tool-vision
2
-
3
- ## DSH 0.2.1-rc.1
4
-
5
- 支持 DSH 0.2.1-rc.1，通过 `engines.dsh` 和一致的 peer 范围声明兼容，明确包含该预发布版本，并保留已有 0.2.0-rc.2 支持。
2
+
3
+ ## DSH 0.2.1-rc.3
4
+
5
+ 适配 DSH 0.2.1-rc.3，明确声明该预发布版本的 engines.dsh 与 peer 范围。宿主新增侧栏/会话「更多」导航菜单、修复新建会话丢失未发送草稿、DeepSeek API Key 路由改跟随官方 /models 模型列表；本插件使用的工具、settings 与 pi-ai 接口保持不变，也未使用任何被移除的宿主 API（`ctx.layout.entryVisibility`、`agentPresetNavigation`）。
6
+
7
+ ## DSH 0.2.1-rc.2
8
+
9
+ 适配 DSH 0.2.1-rc.2，明确声明该预发布版本的 engines.dsh 与 peer 范围。宿主新增 DeepSeek V4.1 Flash 1017 及 Search/Fetch API，本插件使用的接口保持不变。保留已有推理配置及自动补齐显式开启策略。
10
+
11
+ ## DSH 0.2.1-rc.1
12
+
13
+ 支持 DSH 0.2.1-rc.1，通过 `engines.dsh` 和一致的 peer 范围声明兼容，明确包含该预发布版本，并保留已有 0.2.0-rc.2 支持。
6
14
 
7
15
  插件跟随 DSH 的语言设置（DSH 0.2.0-rc.2 内置中文和 English），配置页面、状态提示和插件列表名称/简介同步切换。扩展语言使用宿主的回退链。切换语言保留未保存的设置，无需单独选择插件语言。
8
16
 
package/cordis.patch.yml CHANGED
@@ -1,8 +1,8 @@
1
- # dsh-tool-vision — bundle patch layer
2
- #
3
- # Declares the plugin as a Cordis loader entry, making the package a standard
4
- # profile bundle: `dsh plugin --profile <p> add dsh-tool-vision` installs and
5
- # mounts it without manual cordis.patch.yml edits.
6
- - insert:
7
- - id: tool-vision
8
- name: 'dsh-tool-vision'
1
+ # dsh-tool-vision — bundle patch layer
2
+ #
3
+ # Declares the plugin as a Cordis loader entry, making the package a standard
4
+ # profile bundle: `dsh plugin --profile <p> add dsh-tool-vision` installs and
5
+ # mounts it without manual cordis.patch.yml edits.
6
+ - insert:
7
+ - id: tool-vision
8
+ name: 'dsh-tool-vision'
package/package.json CHANGED
@@ -1,102 +1,104 @@
1
- {
2
- "name": "dsh-tool-vision",
3
- "version": "0.10.2",
4
- "description": "DeepSeek Harness 外置视觉模型插件：inspect_image 把本地图片或 http(s) 图片 URL 发给任意 OpenAI 兼容端点，视觉模型看图的文字回答直接带回对话；附 Web UI 设置栏。",
5
- "type": "module",
6
- "main": "index.js",
7
- "scripts": {
8
- "test": "node tests/preview-regex.test.mjs && node tests/preview-route.test.mjs && node tests/auto-image.test.mjs && node tests/dispatch-image.test.mjs && node --test tests/bridge-export.test.mjs tests/vision-tools.test.js tests/vision-tools-tools.test.js && node --test tests/settings-scope-compat.test.mjs tests/settings-atomic-write.test.mjs tests/switch-behaviour.test.mjs tests/model-lists.test.mjs tests/model-probe.test.mjs && node --test tests/plugin-page.test.mjs && node --test tests/locale.test.mjs",
9
- "test:render": "node tests/render-panel.test.mjs"
10
- },
11
- "exports": {
12
- ".": "./index.js",
13
- "./client": "./client.js",
14
- "./package.json": "./package.json",
15
- "./locale/*.json": "./locale/*.json"
16
- },
17
- "dsh": {
18
- "bundle": {
19
- "patch": "./cordis.patch.yml"
20
- },
21
- "client": {
22
- "platform": "web"
23
- },
24
- "compatibility": {
25
- "dsh": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1",
26
- "dshReleases": {
27
- "0.1.5-rc.2": "incompatible",
28
- "0.1.5-rc.3": "incompatible",
29
- "0.1.6-alpha.1": "unknown",
30
- "0.1.6-alpha.2": "unknown",
31
- "0.1.7-alpha.1": "unknown",
32
- "0.1.7-alpha.2": "unknown",
33
- "0.1.7-rc.1": "incompatible",
34
- "0.1.7-rc.2": "incompatible",
35
- "0.2.0-rc.2": "compatible",
36
- "0.2.1-rc.1": "compatible"
37
- },
38
- "node": ">=20.18",
39
- "profiles": [
40
- "web",
41
- "desktop"
42
- ]
43
- }
44
- },
45
- "files": [
46
- "locale",
47
- "index.js",
48
- "client.js",
49
- "cordis.patch.yml",
50
- "README.md",
51
- "README.zh.md",
52
- "LICENSE",
53
- "lib",
54
- "vendor"
55
- ],
56
- "homepage": "https://github.com/Scorp1o117/dsh-tool-vision",
57
- "keywords": [
58
- "dsh",
59
- "dsh-plugin",
60
- "deepseek-harness",
61
- "vision",
62
- "multimodal",
63
- "image",
64
- "openai-compatible",
65
- "qwen-vl",
66
- "glm-4v",
67
- "ollama"
68
- ],
69
- "license": "MIT",
70
- "engines": {
71
- "node": ">=20.18",
72
- "dsh": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1"
73
- },
74
- "repository": {
75
- "type": "git",
76
- "url": "git+https://github.com/Scorp1o117/dsh-tool-vision.git"
77
- },
78
- "bugs": {
79
- "url": "https://github.com/Scorp1o117/dsh-tool-vision/issues"
80
- },
81
- "dependencies": {
82
- "@deepseek-ai/schemastery": "^3.18.4"
83
- },
84
- "peerDependencies": {
85
- "@deepseek-ai/dsh-settings": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1",
86
- "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1",
87
- "react": "^18.2.0"
88
- },
89
- "optionalDependencies": {
90
- "potrace": "^2.1.8",
91
- "puppeteer-core": "^25.6.0",
92
- "sharp": ">=0.35.3 <1"
93
- },
94
- "devDependencies": {
95
- "@deepseek-ai/dsh": "0.2.1-rc.1",
96
- "@deepseek-ai/dsh-settings": "0.2.1-rc.1",
97
- "@deepseek-ai/dsh-tools": "0.2.1-rc.1",
98
- "jsdom": "^30.0.1",
99
- "react": "^18.3.1",
100
- "react-dom": "^18.3.1"
101
- }
102
- }
1
+ {
2
+ "name": "dsh-tool-vision",
3
+ "version": "0.10.4",
4
+ "description": "DeepSeek Harness 外置视觉模型插件：inspect_image 把本地图片或 http(s) 图片 URL 发给任意 OpenAI 兼容端点，视觉模型看图的文字回答直接带回对话；附 Web UI 设置栏。",
5
+ "type": "module",
6
+ "main": "index.js",
7
+ "scripts": {
8
+ "test": "node tests/preview-regex.test.mjs && node tests/preview-route.test.mjs && node tests/auto-image.test.mjs && node tests/dispatch-image.test.mjs && node --test tests/bridge-export.test.mjs tests/vision-tools.test.js tests/vision-tools-tools.test.js && node --test tests/settings-scope-compat.test.mjs tests/settings-atomic-write.test.mjs tests/switch-behaviour.test.mjs tests/model-lists.test.mjs tests/model-probe.test.mjs && node --test tests/plugin-page.test.mjs && node --test tests/locale.test.mjs",
9
+ "test:render": "node tests/render-panel.test.mjs"
10
+ },
11
+ "exports": {
12
+ ".": "./index.js",
13
+ "./client": "./client.js",
14
+ "./package.json": "./package.json",
15
+ "./locale/*.json": "./locale/*.json"
16
+ },
17
+ "dsh": {
18
+ "bundle": {
19
+ "patch": "./cordis.patch.yml"
20
+ },
21
+ "client": {
22
+ "platform": "web"
23
+ },
24
+ "compatibility": {
25
+ "dsh": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
26
+ "dshReleases": {
27
+ "0.1.5-rc.2": "incompatible",
28
+ "0.1.5-rc.3": "incompatible",
29
+ "0.1.6-alpha.1": "unknown",
30
+ "0.1.6-alpha.2": "unknown",
31
+ "0.1.7-alpha.1": "unknown",
32
+ "0.1.7-alpha.2": "unknown",
33
+ "0.1.7-rc.1": "incompatible",
34
+ "0.1.7-rc.2": "incompatible",
35
+ "0.2.0-rc.2": "compatible",
36
+ "0.2.1-rc.1": "compatible",
37
+ "0.2.1-rc.2": "compatible",
38
+ "0.2.1-rc.3": "compatible"
39
+ },
40
+ "node": ">=20.18",
41
+ "profiles": [
42
+ "web",
43
+ "desktop"
44
+ ]
45
+ }
46
+ },
47
+ "files": [
48
+ "locale",
49
+ "index.js",
50
+ "client.js",
51
+ "cordis.patch.yml",
52
+ "README.md",
53
+ "README.zh.md",
54
+ "LICENSE",
55
+ "lib",
56
+ "vendor"
57
+ ],
58
+ "homepage": "https://github.com/Scorp1o117/dsh-tool-vision",
59
+ "keywords": [
60
+ "dsh",
61
+ "dsh-plugin",
62
+ "deepseek-harness",
63
+ "vision",
64
+ "multimodal",
65
+ "image",
66
+ "openai-compatible",
67
+ "qwen-vl",
68
+ "glm-4v",
69
+ "ollama"
70
+ ],
71
+ "license": "MIT",
72
+ "engines": {
73
+ "node": ">=20.18",
74
+ "dsh": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3"
75
+ },
76
+ "repository": {
77
+ "type": "git",
78
+ "url": "git+https://github.com/Scorp1o117/dsh-tool-vision.git"
79
+ },
80
+ "bugs": {
81
+ "url": "https://github.com/Scorp1o117/dsh-tool-vision/issues"
82
+ },
83
+ "dependencies": {
84
+ "@deepseek-ai/schemastery": "^3.18.4"
85
+ },
86
+ "peerDependencies": {
87
+ "@deepseek-ai/dsh-settings": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
88
+ "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2 <0.3.0 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3",
89
+ "react": "^18.2.0"
90
+ },
91
+ "optionalDependencies": {
92
+ "potrace": "^2.1.8",
93
+ "puppeteer-core": "^25.6.0",
94
+ "sharp": ">=0.35.3 <1"
95
+ },
96
+ "devDependencies": {
97
+ "@deepseek-ai/dsh": "0.2.1-rc.3",
98
+ "@deepseek-ai/dsh-settings": "0.2.1-rc.3",
99
+ "@deepseek-ai/dsh-tools": "0.2.1-rc.3",
100
+ "jsdom": "^30.0.1",
101
+ "react": "^18.3.1",
102
+ "react-dom": "^18.3.1"
103
+ }
104
+ }