dsh-plugin-image-tools 0.4.0 → 0.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pasumao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,11 @@
 # dsh-plugin-image-tools
 
-给 DeepSeek Harness Web GUI 增加**图片能力**的插件，三个工具覆盖三种场景：
+![npm version](https://img.shields.io/npm/v/dsh-plugin-image-tools)
+![License](https://img.shields.io/github/license/Pasumao/dsh-plugin-image-tools)
+![AI Assisted](https://img.shields.io/badge/AI-Assisted-8A2BE2)
+
+**dsh 插件市场里唯一支持「图片选择卡」的插件**：给 DeepSeek Harness Web GUI 增加图片能力，
+三个工具覆盖三种场景——模型让你在选项里挑图、在回复正文里展示图、你把图发给盲模型。全部零 token 本地渲染：
 
 | 工具 | 场景 | 效果 |
 |---|---|---|
@@ -88,33 +93,17 @@ cordis.patch.yml      bundle 补丁（挂载行）
 docs/                 效果图（README 展示用）
 ```
 
-## 安装（web profile）
+## 安装
 
 ```powershell
-# 1. 把插件 link 进 profile（已写入 package.json 时跳过这步的编辑）
-cd C:\Users\18303\.dsh\profiles\web
-pnpm install
-
-# 2. 重启 dsh（launcher），然后刷新浏览器页面
-```
-
-profile 的 `package.json` 需要包含：
-
-```jsonc
-{
-  "dependencies": {
-    "dsh-plugin-image-tools": "link:D:/dsh/plugins/dsh-plugin-image-tools"
-  },
-  "dsh": {
-    "profile": {
-      "bundles": [ /* ... */, "dsh-plugin-image-tools" ]
-    }
-  }
-}
+# npm（推荐）
+dsh plugin --profile web add dsh-plugin-image-tools
+# 或 GitHub
+dsh plugin --profile web add github:Pasumao/dsh-plugin-image-tools
 ```
 
-`dsh.profile.bundles` 里的包会自动应用其自带 `cordis.patch.yml` 的挂载行
-（与 dsh-notify 同机制）。
+装完重启 dsh（launcher），然后刷新浏览器页面。包自带 `cordis.patch.yml` 挂载行，
+经 `dsh.profile.bundles` 自动应用（与 dsh-notify 同机制），无需手动改配置。
 
 ## 模型用法示例
 
@@ -176,4 +165,4 @@ profile 的 `package.json` 需要包含：
 
 ## 许可证
 
-MIT
+[MIT](./LICENSE)

package/lib/index.js

@@ -462,12 +462,35 @@ export function choiceTool(ctx, opts = {}) {
       const now = Date.now()
       prunePicks(now)
 
+      // 与浏览器端 askUserQuestionItemSchema（muxFrameSchema）对齐的必填/类型校验：
+      // 模型偶发漏传 question 等必填字段时，若原样转发，浏览器 zod 解析会把
+      // question/requested 整帧丢弃，选择卡静默不渲染（用户只见"图呢，看不到啊"，
+      // 最终 ASK_ABORTED）。这里在服务端提前校验并抛面向模型的错误，让模型自我修正。
+      const questions = Array.isArray(args.questions) ? args.questions : []
+      for (let qi = 0; qi < questions.length; qi++) {
+        const q = questions[qi]
+        if (q === null || typeof q !== 'object') throw new Error(`questions[${qi}] 必须是对象`)
+        if (typeof q.id !== 'string' || q.id === '') throw new Error(`questions[${qi}].id 缺失或不是非空字符串（必填，稳定问题 id，随答案原样回传）`)
+        if (typeof q.question !== 'string' || q.question === '') throw new Error(`questions[${qi}].question 缺失或不是非空字符串（必填，用户看到的问题文本；请补上后重新调用 ask_user_choice）`)
+        if (q.header !== undefined && typeof q.header !== 'string') throw new Error(`questions[${qi}].header 必须是字符串`)
+        if (q.detail !== undefined && typeof q.detail !== 'string') throw new Error(`questions[${qi}].detail 必须是字符串`)
+        if (q.multi_select !== undefined && typeof q.multi_select !== 'boolean') throw new Error(`questions[${qi}].multi_select 必须是布尔值`)
+        const options = Array.isArray(q.options) ? q.options : []
+        for (let oi = 0; oi < options.length; oi++) {
+          const o = options[oi]
+          if (o === null || typeof o !== 'object') throw new Error(`questions[${qi}].options[${oi}] 必须是对象`)
+          if (typeof o.label !== 'string' || o.label === '') throw new Error(`questions[${qi}].options[${oi}].label 缺失或不是非空字符串（必填，选项文字/答案值）`)
+          if (o.description !== undefined && typeof o.description !== 'string') throw new Error(`questions[${qi}].options[${oi}].description 必须是字符串`)
+          if (o.image !== undefined && o.image !== null && (typeof o.image !== 'object' || o.image === null)) throw new Error(`questions[${qi}].options[${oi}].image 必须是对象（path / url / data 三选一）`)
+        }
+      }
+
       // 本次 ask 创建的 pickId，无论成功/失败/中止都统一释放（含中途加载报错）。
       const batches = []
       try {
         // 1) 逐题归一化图片，生成带图问题的 pickId 与标记。
         const askQuestions = []
-        for (const question of args.questions ?? []) {
+        for (const question of questions) {
           const options = Array.isArray(question.options) ? question.options : []
           const imageIndexes = []
           const normalized = []
@@ -485,7 +508,12 @@ export function choiceTool(ctx, opts = {}) {
           let detail = typeof question.detail === 'string' ? question.detail : ''
           if (imageIndexes.length > 0) {
             const pickId = randomUUID()
-            picks.set(pickId, { createdAt: now, images: normalized.filter((o) => o.image !== undefined).map((o) => o.image) })
+            // 按原始选项下标存图片（无图选项留空），保证客户端
+            // `/pickId/<原始下标>` 的 URL 与服务端索引一一对应；
+            // 紧凑数组会让带图选项下标不连续时错位/404。
+            const images = new Array(options.length).fill(undefined)
+            for (const index of imageIndexes) images[index] = normalized[index].image
+            picks.set(pickId, { createdAt: now, images })
             batches.push(pickId)
             detail = buildPickMarker(pickId, imageIndexes) + detail
           }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-image-tools",
   "description": "DSH 图片插件：ask_user_choice 图片/图文混合选项（Web GUI 渲染图片选择卡，可放大查看）+ show_images 在回复中内嵌图片（图片与文字混排）。图片来源支持本地路径 / http(s) URL / base64 data URI。纯插件实现，不改核心包。",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -15,6 +15,7 @@
     "docs",
     "cordis.patch.yml",
     "README.md",
+    "LICENSE",
     "设计说明.md"
   ],
   "scripts": {