dsh-tool-vision 0.9.4 → 0.9.6

package/README.md

@@ -38,14 +38,15 @@ bridge keeps its conversion inside that durable path:
   call `inspect_image`.
 - **Web UI settings section (v0.3.0)**: Settings → 视觉模型 edits the
   `tool-vision` namespace (API endpoint, write-only key, model, bridge
-  options) in `settings.yaml`; changes hot-apply without a restart. The API
-  key lives in `settings.yaml`, not the profile patch. Mount by package name
+  options) in the active Profile patch; changes hot-apply without a restart. The API
+  key lives in that patch. Mount by package name
   (`name: 'dsh-tool-vision'`) so the web client bundle is discovered.
 
-## Compatibility (v0.9.4)
+## Compatibility (v0.9.6)
 
-DSH `0.1.5-rc.3` is the current npm `latest` and `next`. Alpha releases remain
-`unknown` until tested.
+Tested with DSH `0.1.7-rc.1` and `0.1.7-rc.2` (`next`); npm `latest` is `0.1.5-rc.3`.
+This version uses Profile patch settings and browser `configForms`.
+Older hosts require an older plugin release. Alpha builds remain `unknown`.
 
 ## v0.9.4: Windows bridge export filenames
 
@@ -400,7 +401,7 @@ if (containsImage && !model.input.includes("image"))
 
 `this.modelOf` resolves from the adapter's own `snapshot.models` catalog, which
 defaults to `input: ["text"]` unless the user explicitly declared
-`input: [text, image]` in `settings.yaml`. When admitted by `v0.9.2`, the raw image
+`input: [text, image]` in the Profile patch. When admitted by `v0.9.2`, the raw image
 reached `streamWithSnapshot` and triggered `UNSUPPORTED_CONTENT`. Since the image
 was already in the session's durable transcript, every subsequent turn failed.
 

package/README.zh.md

@@ -15,17 +15,17 @@ DSH 0.1.1 已为 DeepSeek 视觉模型目录加入原生图片输入。本插件
 
 - 除 dsh SDK 外零依赖 —— 兼容任意端点：OpenAI GPT-4o、Qwen-VL（DashScope）、GLM-4V（智谱）、Moonshot、Gemini 兼容端点、本地 Ollama 等。
 - 注册在**全局工具层**：进程内所有 Agent 都能调用 `inspect_image`。
-- **Web UI 设置栏（v0.3.0）**：设置 → 视觉模型 编辑 `tool-vision` 命名空间（API 地址、只写密钥、模型、桥接选项），写入 `settings.yaml`，**改动即时生效无需重启**。API 密钥存放在 `settings.yaml` 而非 profile patch；插件按包名挂载（`name: 'dsh-tool-vision'`）以便 web 端发现客户端 bundle。
-
-## 兼容性（v0.9.4）
-
-DSH `0.1.5-rc.3` 现为 npm 的 `latest` 和 `next`。alpha 版本未经验证前继续标记 `unknown`。
-
-## v0.9.4：修复 Windows 图片桥导出文件名
-
-- 导出文件名改为从完整附件 ID 生成稳定哈希；`sha256:...` 等 ID 不再写入 NTFS 备用数据流，避免出现可见主文件为 0 字节的情况。
-- 写入前确保导出目录存在；进程内缓存按 `bridgeExportDir` 区分。
-- 已通过 DSH `0.1.5-rc.3` 一次性 Profile 的安装、Web 启动、首页与客户端 Bundle HTTP 检查，以及卸载验证。
+- **Web UI 设置栏（v0.3.0）**：设置 → 视觉模型 编辑 `tool-vision` 配置（API 地址、只写密钥、模型、桥接选项），写入当前 Profile patch，**改动即时生效无需重启**。插件按包名挂载（`name: 'dsh-tool-vision'`）以便 web 端发现客户端 bundle。
+
+## 兼容性（v0.9.6）
+
+已验证 DSH `0.1.7-rc.1` 与 `0.1.7-rc.2`（npm `next`）；npm `latest` 是 `0.1.5-rc.3`。旧宿主请使用插件旧版；alpha 构建仍标记 `unknown`。
+
+## v0.9.4：修复 Windows 图片桥导出文件名
+
+- 导出文件名改为从完整附件 ID 生成稳定哈希；`sha256:...` 等 ID 不再写入 NTFS 备用数据流，避免出现可见主文件为 0 字节的情况。
+- 写入前确保导出目录存在；进程内缓存按 `bridgeExportDir` 区分。
+- 已通过 DSH `0.1.5-rc.3` 一次性 Profile 的安装、Web 启动、首页与客户端 Bundle HTTP 检查，以及卸载验证。
 
 ## 安装
 
@@ -62,7 +62,7 @@ DSH `0.1.5-rc.3` 现为 npm 的 `latest` 和 `next`。alpha 版本未经验证
 | `maxImageBytes` | `10MB` | 本地图片大小上限 |
 | `description` | 默认描述 | 工具描述（模型可见） |
 | `bridgeTextOnly` | `true` | 把粘贴图片转成文本指引（发给看不懂图片的模型时） |
-| `bridgeExportDir` | 临时目录 | 桥接图片导出目录（`os.tmpdir()/dsh-vision-bridge`）；文件名使用附件 ID 的安全哈希 |
+| `bridgeExportDir` | 临时目录 | 桥接图片导出目录（`os.tmpdir()/dsh-vision-bridge`）；文件名使用附件 ID 的安全哈希 |
 | `multimodalModels` | `[]` | 模型名单（逗号分隔）。每项按「完整 id / 末段裸 id / `provider/id`」三种写法匹配，大小写不敏感，支持 `*` `?` 通配（如 `*vl*`、`deepseek/*`）。含义由下面的模式决定 |
 | `multimodalListMode` | `whitelist` | **名单模式（v0.9.0）**：`whitelist` 名单内模型直收图片块（旧行为）；`blacklist` 名单内模型强制走桥接（用来纠正"声明支持图片但实际不支持"的模型）；`off` 忽略名单。未知值一律回退 `whitelist` |
 | `autoDetectMultimodal` | `true` | **自动识别（v0.9.0）**：按当前路由自己声明的 `inputModalities` 判定，再与名单合成（白名单取并集、黑名单取差集）。默认开启＝识别到纯文本就交给桥接、识别到多模态就等同白名单成员直发图片；声明永远读"包装前"的真值，不会被 `bridgeAutoImage` 的假声明污染。设为 `false` 可退回"只认名单"的纯手工行为 |

package/client.js

@@ -72,7 +72,7 @@ window.__ModuleLoader__.load({
 
     // ── locale ────────────────────────────────────────────────────────────
     var NS = "toolVision";
-    var inject = ["slots", "locale", "settingsScope"];
+    var inject = ["slots", "locale", "configForms"];
     var zh = {
       nav: "视觉模型",
       intro: "外置视觉模型配置：Agent 通过 inspect_image 工具把图片发给该端点分析。修改后即时生效（settings.yaml 热重载）。",
@@ -939,7 +939,7 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       var t = ctx.locale.bind(NS);
       ctx.effect(function () { return ctx.locale.register(NS, { zh: zh, en: en }); }, "dsh-tool-vision: dictionaries");
-      var scope = ctx.settingsScope.bind({ namespace: "tool-vision" });
+      var scope = ctx.configForms.get("tool-vision");
       attachBridgePreview(ctx, scope);
       ctx.slots.inject("settings.section", function () {
         return ctx.slots.register({

package/cordis.patch.yml

@@ -1,8 +1,8 @@
-# dsh-tool-vision — bundle patch layer
-#
-# Declares the plugin as a Cordis loader entry, making the package a standard
-# profile bundle: `dsh plugin --profile <p> add dsh-tool-vision` installs and
-# mounts it without manual cordis.patch.yml edits.
-- insert:
-    - id: tool-vision
-      name: 'dsh-tool-vision'
+# dsh-tool-vision — bundle patch layer
+#
+# Declares the plugin as a Cordis loader entry, making the package a standard
+# profile bundle: `dsh plugin --profile <p> add dsh-tool-vision` installs and
+# mounts it without manual cordis.patch.yml edits.
+- insert:
+    - id: tool-vision
+      name: 'dsh-tool-vision'

package/index.js

@@ -221,7 +221,7 @@ const Config = z.object({
   /** Fixed session id override for callers without a dsh session context.
    * Empty = auto (per-process stable id). */
   sessionId: z.string().default(""),
-});
+}).volatile();
 
 const MIME_BY_EXT = {
   ".png": "image/png",
@@ -1165,7 +1165,7 @@ function apply(ctx, config) {
   // would be undefined (apiKey included).
   let current = config;
   let sourceGetter = null;
-  const getConfig = () => (sourceGetter ? sourceGetter() : current);
+  const getConfig = () => (sourceGetter ? sourceGetter() : typeof current.get === "function" ? current.get() : current);
   // The registered settings scope, kept so tools can PERSIST what they measure.
   // Null whenever no settings provider is mounted (composition-entry-only runs),
   // in which case a probe still reports its verdict but cannot record it.
@@ -1435,22 +1435,12 @@ function apply(ctx, config) {
   // `installSettingsSection` export (the provider now lives at ctx.settings).
   // Inline the same logic via ctx.inject(["settings"]) — works on both
   // 0.1.1 (module export wrapper) and 0.1.2 (ctx.settings) hosts.
-  ctx.inject(["settings"], (sctx) => {
-    const scope = sctx.settings.register(NS, Config, { base: config });
-    sourceGetter = () => scope.get();
-    settingsScope = scope;
-    sctx.effect(() => () => {
-      sourceGetter = null;
-      settingsScope = null;
-    });
-    // Hot-apply: `enabled` switches the child fiber, and any field that gates a
-    // registration re-installs it, so none of them needs a dsh restart anymore.
-    scope.watch(() => syncFeatures());
-    sctx.effect(() => () => uninstallFeatures());
-    // The stored value governs from here on; the composition entry was only a
-    // placeholder until the provider answered.
-    syncFeatures();
+  sourceGetter = () => typeof config.get === "function" ? config.get() : config;
+  settingsScope = { update: (patch) => ctx.settings.update(NS, patch) };
+  ctx.on("settings/document-updated", (id) => {
+    if (id === NS) syncFeatures();
   });
+  ctx.effect(() => () => uninstallFeatures());
 
   // ── model catalog route: settings support, so it lives on THIS fiber ───────
   // The master switch disposes the feature fiber on purpose (tools, bridge,

package/package.json

@@ -1,11 +1,11 @@
 {
     "name": "dsh-tool-vision",
-    "version": "0.9.4",
+    "version": "0.9.6",
     "description": "DeepSeek Harness 外置视觉模型插件：inspect_image 把本地图片或 http(s) 图片 URL 发给任意 OpenAI 兼容端点，视觉模型看图的文字回答直接带回对话；附 Web UI 设置栏。",
     "type": "module",
     "main": "index.js",
     "scripts": {
-        "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",
+        "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",
         "test:render": "node tests/render-panel.test.mjs"
     },
     "exports": {
@@ -17,22 +17,26 @@
         "bundle": {
             "patch": "./cordis.patch.yml"
         },
-        "client": {
-            "platform": "web"
-        },
-        "compatibility": {
-            "dsh": ">=0.1.0-rc.7 <0.2.0",
-            "dshReleases": {
-                "0.1.5-rc.2": "compatible",
-                "0.1.5-rc.3": "compatible",
-                "0.1.6-alpha.1": "unknown",
-                "0.1.6-alpha.2": "unknown",
-                "0.1.7-alpha.1": "unknown",
-                "0.1.7-alpha.2": "unknown"
-            },
-            "node": ">=20.18",
-            "profiles": ["web"]
-        }
+        "client": {
+            "platform": "web"
+        },
+        "compatibility": {
+            "dsh": ">=0.1.7-rc.1 <0.2.0",
+            "dshReleases": {
+                "0.1.5-rc.2": "incompatible",
+                "0.1.5-rc.3": "incompatible",
+                "0.1.6-alpha.1": "unknown",
+                "0.1.6-alpha.2": "unknown",
+                "0.1.7-alpha.1": "unknown",
+                "0.1.7-alpha.2": "unknown",
+                "0.1.7-rc.1": "compatible",
+                "0.1.7-rc.2": "compatible"
+            },
+            "node": ">=20.18",
+            "profiles": [
+                "web"
+            ]
+        }
     },
     "files": [
         "index.js",
@@ -69,11 +73,11 @@
         "url": "https://github.com/Scorp1o117/dsh-tool-vision/issues"
     },
     "dependencies": {
-        "@deepseek-ai/schemastery": "^3.18.1"
+        "@deepseek-ai/schemastery": "^3.18.4"
     },
     "peerDependencies": {
-        "@deepseek-ai/dsh-settings": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
-        "@deepseek-ai/dsh-tools": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
+        "@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
+        "@deepseek-ai/dsh-tools": "^0.1.7-rc.1",
         "react": "^18.2.0"
     },
     "optionalDependencies": {
@@ -82,6 +86,9 @@
         "sharp": ">=0.35.3 <1"
     },
     "devDependencies": {
+        "@deepseek-ai/dsh": "0.1.7-rc.2",
+        "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
+        "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
         "jsdom": "^30.0.1",
         "react": "^18.3.1",
         "react-dom": "^18.3.1"