dsh-plugin-image-tools 0.3.1 → 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,11 +1,17 @@
 # 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 本地渲染：
 
 | 工具 | 场景 | 效果 |
 |---|---|---|
 | `ask_user_choice` | 模型让用户在**选项**里挑图 | Web GUI 渲染图片选择卡，可放大查看，答案协议与原生一致 |
 | `show_images` | 模型在**回复正文**里展示图片 | 图片与文字混排显示在聊天里，点击可放大 |
+| `save_received_images` | 用户**发图给盲模型**（无视觉输入的适配器） | 图片以文件形式保存到工作区，模型可下载/分析 |
 
 图片来源统一支持三种：**本地路径**（相对会话工作区或绝对路径，含 ComfyUI 出图产物）、
 **http(s) URL**（服务端拉取后转存）、**base64 data URI**。纯插件实现，不改核心包。
@@ -24,6 +30,8 @@
 
 模型在回复里调用 `show_images`，把返回的 markdown 片段粘贴进正文，图片就随文字一起显示。
 
+> 两张效果图均为真实 Web GUI 截图（maid-atelier 皮肤）。
+
 ## 功能
 
 - **`ask_user_choice`**（图片 / 图文混合选项）：
@@ -35,6 +43,15 @@
   - 一次展示 1~9 张图，每张可带 `caption` 说明；
   - 工具返回绝对 URL 的 markdown 图片片段，模型原样粘贴进回复正文即随文显示；
   - 客户端插件自动增强这类图片：圆角样式、悬停显示说明、点击放大查看、加载失败降级。
+- **`save_received_images`**（盲模型收图 → 文件）：
+  - 用户往聊天里发图片时，`agent/pre-step` 监听器把消息里的 image 内容块重写为
+    文本占位符（`dshimg:<attachmentId>`）——文本-only 适配器（如 DeepSeek）不再
+    因图片块报 `UNSUPPORTED_CONTENT`，回合照常运行；
+  - 用户气泡里由客户端增强器把占位符替换为可放大的图片回显（附件经
+    `/dsh-plugin-image-tools/attachment/<id>` 路由出字节）；
+  - 模型看到占位符后调用 `save_received_images`，把图片按 attachmentId 保存为
+    工作区文件（默认 `received/`），之后可用文件/命令工具分析（尺寸、像素、哈希等）；
+  - 保存的文件名优先用附件自带的安全文件名，否则按 `image-<n>-<时间戳>.<ext>` 生成。
 - 纯文字问题不带图片时，客户端自动放行给原生 UI，互不影响。
 
 ## 实现要点（为什么是插件而不是改核心）
@@ -44,9 +61,10 @@
 所以图片**不能**塞进 option / content 字段。本插件改为：
 
 1. 服务端把图片字节归一化进内存注册表，通过自定义 web 路由
-   `/dsh-plugin-image-tools/<pickId>/<index>`（选择卡）与
-   `/dsh-plugin-image-tools/show/<showId>/<index>`（回复内嵌）直接提供字节
-   （同源 `<img src>` 加载）；
+   `/dsh-plugin-image-tools/<pickId>/<index>`（选择卡）、
+   `/dsh-plugin-image-tools/show/<showId>/<index>`（回复内嵌）与
+   `/dsh-plugin-image-tools/attachment/<attachmentId>`（盲模型收图回显）
+   直接提供字节（同源 `<img src>` 加载）；
 2. 选择卡：在问题的 `detail`（标准字符串字段，原样透传）开头写入不可见的
    HTML 注释标记 `<!--dsh-pick:v1:<base64url JSON>-->`，携带 pickId 与带图选项下标；
    客户端插件在 `conversation.composer` slot 链注册条目（priority 更小，优先于原生），
@@ -54,49 +72,38 @@
 3. 回复内嵌：`show_images` 返回绝对 URL（宿主 origin 由 `ctx.webServer.host/port`
    推导），模型粘贴进正文，核心 markdown 渲染器原生显示；客户端再对
    `/dsh-plugin-image-tools/show/` 前缀的图片做渐进增强（MutationObserver 发现 +
-   单节点样式/事件注入，纯 DOM，不侵入 React 渲染树）。
+   单节点样式/事件注入，纯 DOM，不侵入 React 渲染树）；
+4. 盲模型收图：注册 `agent/pre-step` waterfall 监听器（与 agent-instructions /
+   time-context 同机制），把进入 LLM 步骤的消息批次里的 image 块重写为文本占位符
+   （登记附件 ref 到 TTL 注册表），会话日志/UI 因此保持纯文本安全；客户端增强器
+   在用户气泡文本里识别 `dshimg:<id>` 占位符并替换为可放大图片；`save_received_images`
+   经 `ctx.attachments.readImage` 取回附件字节落盘。
 
 详见 `设计说明.md`。
 
 ## 目录结构
 
 ```
-lib/index.js          服务端：两个工具注册 + 图片注册表 + web 路由（零运行时依赖）
-lib/client.js         客户端：composer 链条目 + 图片选择 UI + 内嵌图片增强（浏览器模块加载器格式，免构建）
+lib/index.js          服务端：三个工具注册 + pre-step 重写 + 图片/附件注册表 + web 路由（零运行时依赖）
+lib/client.js         客户端：composer 链条目 + 图片选择 UI + 内嵌/收图图片增强（浏览器模块加载器格式，免构建）
 scripts/selfcheck.mjs     纯函数自检（node scripts/selfcheck.mjs）
-scripts/smoke-server.mjs  服务端集成冒烟（假 ctx 跑通工具→路由→回答全链路）
+scripts/smoke-server.mjs  服务端集成冒烟（假 ctx 跑通工具→路由→pre-step 重写→落盘全链路）
 scripts/smoke-client.mjs  客户端冒烟（真实 react 渲染选择卡 + 增强纯函数）
 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 同机制），无需手动改配置。
 
 ## 模型用法示例
 
@@ -158,4 +165,4 @@ profile 的 `package.json` 需要包含：
 
 ## 许可证
 
-MIT
+[MIT](./LICENSE)

package/lib/client.js

@@ -352,6 +352,7 @@ window.__ModuleLoader__.load({
     // 纯 DOM 单节点变更：不插入/移除 React 管理的结构，重渲染时安全。
     // ------------------------------------------------------------------
     var IMAGE_SHOW_PREFIX = '/dsh-plugin-image-tools/show/';
+    var IMAGE_TOKEN_PREFIX = 'dshimg:';
     var ZOOM_CLOSE_LABEL = (typeof document !== 'undefined' && (document.documentElement.lang || '').toLowerCase().indexOf('zh') === 0)
       ? '\u5173\u95ed'
       : 'Close';
@@ -361,6 +362,69 @@ window.__ModuleLoader__.load({
       return typeof src === 'string' && src.indexOf(IMAGE_SHOW_PREFIX) >= 0;
     }
 
+    /** 从文本里提取 dshimg: 占位符的 attachmentId（纯函数，供冒烟测试）。 */
+    function extractImageTokenIds(text) {
+      if (typeof text !== 'string') return [];
+      var seen = {};
+      var ids = [];
+      var re = new RegExp(IMAGE_TOKEN_PREFIX + '([A-Za-z0-9_-]{8,})', 'g');
+      var m;
+      while ((m = re.exec(text)) !== null) {
+        if (seen[m[1]] === void 0) {
+          seen[m[1]] = true;
+          ids.push(m[1]);
+        }
+      }
+      return ids;
+    }
+
+    /** 文本节点扫描去重表：node → 上次扫描到的 nodeValue（React 原位更新文本时重新扫描）。 */
+    var scannedTexts = typeof WeakMap === 'undefined' ? null : new WeakMap();
+
+    /**
+     * 把文本节点里的 dshimg:<id> 占位符替换为可放大的图片元素（盲模型收图回显）。
+     * 只做文本节点级替换，不触碰 React 管理的元素结构。
+     */
+    function upgradeBubbleTexts() {
+      if (typeof document === 'undefined' || scannedTexts === null || typeof document.createTreeWalker === 'undefined') return;
+      var walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+      var node;
+      while ((node = walker.nextNode()) !== null) {
+        var value = node.nodeValue;
+        if (typeof value !== 'string' || value.indexOf(IMAGE_TOKEN_PREFIX) < 0) continue;
+        if (scannedTexts.get(node) === value) continue;
+        var ids = extractImageTokenIds(value);
+        if (ids.length === 0) {
+          scannedTexts.set(node, value);
+          continue;
+        }
+        var parent = node.parentNode;
+        if (parent === null) continue;
+        var re = new RegExp(IMAGE_TOKEN_PREFIX + '([A-Za-z0-9_-]{8,})', 'g');
+        var frag = document.createDocumentFragment();
+        var cursor = 0;
+        var m;
+        while ((m = re.exec(value)) !== null) {
+          if (m.index > cursor) frag.appendChild(document.createTextNode(value.slice(cursor, m.index)));
+          var img = document.createElement('img');
+          img.className = 'dshimg-inline dshimg-received';
+          img.src = '/dsh-plugin-image-tools/attachment/' + m[1];
+          img.alt = '\u7528\u6237\u53d1\u6765\u7684\u56fe\u7247';
+          img.loading = 'lazy';
+          img.addEventListener('click', function (event) {
+            event.preventDefault();
+            event.stopPropagation();
+            openImageZoom(img.src, '\u7528\u6237\u53d1\u6765\u7684\u56fe\u7247\uff08\u70b9\u51fb\u653e\u5927\uff09');
+          });
+          img.addEventListener('error', function () { img.dataset.failed = '1'; });
+          frag.appendChild(img);
+          cursor = m.index + m[0].length;
+        }
+        if (cursor < value.length) frag.appendChild(document.createTextNode(value.slice(cursor)));
+        parent.replaceChild(frag, node);
+      }
+    }
+
     /** 打开命令式 Lightbox 放大查看（复用选择卡的 .dshpick-lightbox 样式）。 */
     function openImageZoom(src, caption) {
       if (typeof document === 'undefined') return;
@@ -417,7 +481,7 @@ window.__ModuleLoader__.load({
       var caption = (img.getAttribute('alt') || '').trim();
       if (caption !== '') img.title = caption;
       var src = img.getAttribute('src') || '';
-      if (!isShowImageSrc(src)) return;
+      if (!(isShowImageSrc(src) || src.indexOf('/dsh-plugin-image-tools/attachment/') >= 0)) return;
       img.addEventListener('click', function (event) {
         event.preventDefault();
         event.stopPropagation();
@@ -436,8 +500,9 @@ window.__ModuleLoader__.load({
       var pending = false;
       var scan = function () {
         pending = false;
-        var images = document.querySelectorAll('img[src^="' + IMAGE_SHOW_PREFIX + '"]');
+        var images = document.querySelectorAll('img[src^="' + IMAGE_SHOW_PREFIX + '"], img[src^="/dsh-plugin-image-tools/attachment/"]');
         for (var i = 0; i < images.length; i++) upgradeInlineImage(images[i]);
+        upgradeBubbleTexts();
       };
       var observer = new MutationObserver(function () {
         if (pending) return;
@@ -856,6 +921,7 @@ window.__ModuleLoader__.load({
     exports.Lightbox = Lightbox;
     exports.IMAGE_SHOW_PREFIX = IMAGE_SHOW_PREFIX;
     exports.isShowImageSrc = isShowImageSrc;
+    exports.extractImageTokenIds = extractImageTokenIds;
     exports.upgradeInlineImage = upgradeInlineImage;
     exports.startInlineEnhancer = startInlineEnhancer;
     return module.exports;

package/lib/index.js

@@ -29,13 +29,13 @@
  *
  * @module dsh-plugin-image-tools
  */
-import { readFile } from 'node:fs/promises'
-import { isAbsolute, join } from 'node:path'
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { basename, isAbsolute, join, normalize } from 'node:path'
 import { randomUUID } from 'node:crypto'
 
 export const name = 'dsh-plugin-image-tools'
-/** 需要的主机端服务：tools（注册工具）、userQuestions（问询）、webServer（图片路由与 origin）。 */
-export const inject = ['tools', 'userQuestions', 'webServer']
+/** 需要的主机端服务：tools（注册工具）、userQuestions（问询）、webServer（图片路由与 origin）、attachments（附件字节存取）、llm（模型能力补丁）。 */
+export const inject = ['tools', 'userQuestions', 'webServer', 'attachments', 'llm']
 
 // ---------------------------------------------------------------------------
 // 常量
@@ -52,6 +52,10 @@ export const FETCH_TIMEOUT_MS = 30 * 1000
 /** detail 里不可见标记的前缀/后缀。 */
 export const MARKER_PREFIX = '<!--dsh-pick:v1:'
 export const MARKER_SUFFIX = '-->'
+/** 盲模型收图：文本占位符里的图片 token 前缀（attachmentId 紧随其后）。 */
+export const IMAGE_TOKEN_PREFIX = 'dshimg:'
+/** save_received_images 的默认保存目录（相对会话工作区）。 */
+export const RECEIVED_DIR = 'received'
 
 /** 支持的图片媒体类型。 */
 const SUPPORTED_MEDIA_TYPES = new Set(['image/png', 'image/jpeg', 'image/webp', 'image/gif'])
@@ -60,12 +64,16 @@ const SUPPORTED_MEDIA_TYPES = new Set(['image/png', 'image/jpeg', 'image/webp',
 // 内存图片注册表（进程生命周期；每次新增/路由命中时顺带做 TTL 清理）
 //   picks：ask_user_choice 的选择卡图片（随回答/取消立即释放）
 //   shows：show_images 的回复内嵌图片（依赖 TTL 清理，需存活到回复渲染完）
+//   attachmentRefs：盲模型收图的附件 ref 登记（pre-step 重写时记录，供
+//       /attachment 路由与 save_received_images 解析；TTL 清理）
 // ---------------------------------------------------------------------------
 
 /** @type {Map<string, { createdAt: number, images: { bytes: Buffer, mediaType: string, name?: string }[] }>} */
 const picks = new Map()
 /** @type {Map<string, { createdAt: number, images: { bytes: Buffer, mediaType: string, caption?: string }[] }>} */
 const shows = new Map()
+/** @type {Map<string, { createdAt: number, ref: object }>} */
+const attachmentRefs = new Map()
 
 function pruneRegistry(registry, now = Date.now()) {
   for (const [id, entry] of registry) {
@@ -81,6 +89,10 @@ function pruneShows(now = Date.now()) {
   pruneRegistry(shows, now)
 }
 
+function pruneAttachmentRefs(now = Date.now()) {
+  pruneRegistry(attachmentRefs, now)
+}
+
 function getPick(pickId) {
   prunePicks()
   return picks.get(pickId)
@@ -91,6 +103,19 @@ function getShow(showId) {
   return shows.get(showId)
 }
 
+/** 登记一次 pre-step 重写见到的附件 ref（供路由与工具解析）。 */
+function recordAttachmentRef(ref) {
+  if (ref === null || typeof ref !== 'object' || typeof ref.attachmentId !== 'string' || ref.attachmentId === '') return
+  pruneAttachmentRefs()
+  attachmentRefs.set(ref.attachmentId, { createdAt: Date.now(), ref })
+}
+
+/** 按 attachmentId 取回登记的 ref；未知/过期返回 undefined。 */
+function resolveAttachmentRef(attachmentId) {
+  pruneAttachmentRefs()
+  return attachmentRefs.get(attachmentId)?.ref
+}
+
 // ---------------------------------------------------------------------------
 // 纯函数：媒体类型探测 / 标记编解码 / 宿主 origin（导出供 selfcheck 测试）
 // ---------------------------------------------------------------------------
@@ -186,6 +211,74 @@ export function safeAlt(caption) {
   return raw.replace(/[\]\n\r]/g, ' ').slice(0, 200)
 }
 
+/**
+ * 媒体类型 → 文件扩展名。
+ * @param {string} mediaType - image/png 等。
+ * @returns {string} 带点扩展名（.png 等）。
+ */
+export function mediaTypeToExt(mediaType) {
+  switch (mediaType) {
+    case 'image/png': return '.png'
+    case 'image/jpeg': return '.jpg'
+    case 'image/webp': return '.webp'
+    case 'image/gif': return '.gif'
+    default: return ''
+  }
+}
+
+/**
+ * 构造盲模型收图的文本占位符（图片块的模型侧表示）。
+ * 含 token `dshimg:<attachmentId>`（客户端据此在用户气泡里回显图片），
+ * 以及一句提示语（引导模型用 save_received_images 保存为文件）。
+ * @param {object} ref - ImageAttachmentRef { attachmentId, mediaType, bytes, width, height, name? }。
+ * @returns {string} 占位符文本。
+ */
+export function imagePlaceholderText(ref) {
+  const id = typeof ref?.attachmentId === 'string' ? ref.attachmentId : 'unknown'
+  const name = typeof ref?.name === 'string' && ref.name !== '' ? `（${ref.name}）` : ''
+  return `📷 用户发来的图片${name} ${IMAGE_TOKEN_PREFIX}${id}`
+}
+
+/**
+ * 从文本里提取图片 token 的 attachmentId 列表（客户端回显与冒烟测试用）。
+ * @param {string} text - 任意文本。
+ * @returns {string[]} attachmentId 列表（去重保序）。
+ */
+export function extractImageTokenIds(text) {
+  if (typeof text !== 'string') return []
+  const seen = new Set()
+  const ids = []
+  const re = new RegExp(`${IMAGE_TOKEN_PREFIX}([A-Za-z0-9_-]{8,})`, 'g')
+  let m
+  while ((m = re.exec(text)) !== null) {
+    if (!seen.has(m[1])) {
+      seen.add(m[1])
+      ids.push(m[1])
+    }
+  }
+  return ids
+}
+
+/**
+ * 把一条消息里的 image 内容块重写为文本占位符（盲模型适配器不接收图片块）。
+ * 重写时登记附件 ref；消息与内容块保持冻结语义（构造新对象）。
+ * @param {object} message - UserMessage { id, role, content, source }。
+ * @returns {object|null} 重写后的新消息；无图片块时返回 null（原样保留）。
+ */
+export function rewriteMessageImages(message) {
+  if (message === null || typeof message !== 'object' || !Array.isArray(message.content)) return null
+  let changed = false
+  const content = message.content.map((block) => {
+    if (block === null || typeof block !== 'object' || block.type !== 'image' || block.attachment === undefined) return block
+    const ref = block.attachment
+    recordAttachmentRef(ref)
+    changed = true
+    return Object.freeze({ type: 'text', text: imagePlaceholderText(ref) })
+  })
+  if (!changed) return null
+  return Object.freeze({ ...message, content: Object.freeze(content) })
+}
+
 // ---------------------------------------------------------------------------
 // 图片加载
 // ---------------------------------------------------------------------------
@@ -369,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 = []
@@ -392,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
           }
@@ -517,14 +638,151 @@ export function showImagesTool(ctx, opts = {}) {
 // 插件入口
 // ---------------------------------------------------------------------------
 
+/**
+ * save_received_images 工具定义：把用户发来的图片附件保存为工作区文件。
+ * 盲模型（无视觉输入的适配器）经 agent/pre-step 重写把图片块替换为
+ * 文本占位符（dshimg:<attachmentId>），模型据此调用本工具把附件字节
+ * 落盘，之后可用文件/命令工具分析（尺寸、像素、哈希等）。
+ * @param {object} ctx - 插件上下文（execute 闭包使用 ctx.attachments.readImage）。
+ * @returns {object} 工具 definition。
+ */
+export function saveReceivedImagesTool(ctx) {
+  return {
+    name: 'save_received_images',
+    description:
+      '把用户发来的图片附件保存为工作区文件（默认保存到 received/ 目录）。' +
+      '当用户消息里出现 "📷 用户发来的图片 dshimg:<attachmentId>" 占位符时，' +
+      '说明用户上传了一张图片（当前模型无法直接查看）。如需查看/分析该图片：' +
+      '调用本工具，把占位符里的 attachmentId 填进 images 数组，工具会把图片写入' +
+      '工作区文件并返回路径；之后可用文件读取/命令工具分析该文件（如尺寸、内容等）。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['images'],
+      properties: {
+        images: {
+          type: 'array',
+          description: '要保存的图片附件列表（attachmentId 来自用户消息里的 dshimg: 占位符）。',
+          items: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['attachmentId'],
+            properties: {
+              attachmentId: {
+                type: 'string',
+                description: '附件 id（用户消息里 dshimg: 后面的那串）。'
+              },
+              mediaType: {
+                type: 'string',
+                description: '可选：image/png|image/jpeg|image/webp|image/gif（占位符未给全时由登记信息补全）。'
+              },
+              width: { type: 'number', description: '可选：像素宽。' },
+              height: { type: 'number', description: '可选：像素高。' },
+              bytes: { type: 'number', description: '可选：字节数。' },
+              name: { type: 'string', description: '可选：显示名（会被清洗为安全文件名）。' }
+            }
+          }
+        },
+        dir: {
+          type: 'string',
+          description: `可选：保存目录（相对会话工作区，默认 ${RECEIVED_DIR}/）。`
+        }
+      }
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['saved'],
+        properties: {
+          saved: {
+            type: 'array',
+            items: {
+              type: 'object',
+              additionalProperties: false,
+              required: ['attachmentId', 'path'],
+              properties: {
+                attachmentId: { type: 'string' },
+                path: { type: 'string' },
+                mediaType: { type: 'string' },
+                bytes: { type: 'number' },
+                width: { type: 'number' },
+                height: { type: 'number' },
+                error: { type: 'string' }
+              }
+            }
+          }
+        }
+      },
+      render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }]
+    },
+    async execute(args, exec) {
+      const cwd = sessionCwd(exec?.agent)
+      pruneAttachmentRefs()
+      const dirName = typeof args.dir === 'string' && args.dir.trim() !== '' ? args.dir.trim() : RECEIVED_DIR
+      const items = Array.isArray(args.images) ? args.images : []
+      if (items.length === 0) throw new Error('images 不能为空')
+
+      const saved = []
+      for (let index = 0; index < items.length; index++) {
+        const item = items[index]
+        const attachmentId = typeof item?.attachmentId === 'string' ? item.attachmentId : ''
+        try {
+          if (attachmentId === '') throw new Error('attachmentId 缺失')
+          // 合并模型传入的字段与登记信息，构造完整 ref（readImage 会校验 mediaType/bytes/尺寸）。
+          const known = resolveAttachmentRef(attachmentId)
+          const ref = {
+            attachmentId,
+            mediaType: item.mediaType ?? known?.mediaType,
+            bytes: item.bytes ?? known?.bytes,
+            width: item.width ?? known?.width,
+            height: item.height ?? known?.height,
+            ...(item.name !== undefined ? { name: item.name } : known?.name !== undefined ? { name: known.name } : {})
+          }
+          if (ref.mediaType === undefined || ref.bytes === undefined || ref.width === undefined || ref.height === undefined) {
+            throw new Error(`附件 ${attachmentId} 的元数据不完整（可能是过期占位符），请提供 mediaType/width/height/bytes 或重新触发对话`)
+          }
+          const stored = await ctx.attachments.readImage(ref, exec?.signal)
+          const data = Buffer.from(stored.data)
+          const targetDir = isAbsolute(dirName) ? dirName : join(cwd, dirName)
+          await mkdir(targetDir, { recursive: true })
+          const ext = mediaTypeToExt(ref.mediaType)
+          const rawName = typeof ref.name === 'string' ? basename(ref.name) : ''
+          const safeName = rawName !== '' && !rawName.includes('..') && !rawName.includes('/') && !rawName.includes('\\') && /^[\w.-]+$/.test(rawName)
+            ? rawName
+            : `image-${index + 1}-${Date.now()}${ext}`
+          const filePath = join(targetDir, safeName)
+          await writeFile(filePath, data)
+          saved.push({
+            attachmentId,
+            path: filePath,
+            mediaType: ref.mediaType,
+            bytes: data.byteLength,
+            width: ref.width,
+            height: ref.height
+          })
+        } catch (error) {
+          saved.push({
+            attachmentId,
+            path: '',
+            error: error instanceof Error ? error.message : String(error)
+          })
+        }
+      }
+      return { saved }
+    }
+  }
+}
+
 export function apply(ctx) {
   // 图片字节服务路由：同源 <img src> 直接加载。
   //   /dsh-plugin-image-tools/<pickId>/<index>        选择卡图片
   //   /dsh-plugin-image-tools/show/<showId>/<index>   回复内嵌图片
+  //   /dsh-plugin-image-tools/attachment/<attachmentId>  盲模型收图的附件回显
   const disposeRoute = ctx.effect(() => ctx.webServer.register({
     kind: 'prefix',
     path: ROUTE_PREFIX,
-    handler: (req, res) => {
+    handler: async (req, res) => {
       try {
         const method = (req.method ?? 'GET').toUpperCase()
         if (method !== 'GET') {
@@ -534,6 +792,24 @@ export function apply(ctx) {
         }
         const url = new URL(req.url ?? '/', 'http://dsh.internal')
         const rest = url.pathname.slice(ROUTE_PREFIX.length).replace(/^\/+/, '')
+        if (rest.startsWith('attachment/')) {
+          const attachmentId = rest.slice('attachment/'.length)
+          const ref = attachmentId !== '' ? resolveAttachmentRef(attachmentId) : undefined
+          if (ref === undefined) {
+            res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' })
+            res.end('not found')
+            return
+          }
+          const stored = await ctx.attachments.readImage(ref, req.signal)
+          res.writeHead(200, {
+            'content-type': ref.mediaType,
+            'content-length': stored.data.byteLength,
+            'cache-control': 'private, max-age=300',
+            'x-content-type-options': 'nosniff'
+          })
+          res.end(Buffer.from(stored.data))
+          return
+        }
         let image
         if (rest.startsWith('show/')) {
           const [, showId, indexRaw] = rest.split('/')
@@ -567,12 +843,56 @@ export function apply(ctx) {
 
   const disposeChoice = ctx.effect(() => ctx.tools.register(choiceTool(ctx)), 'dsh-plugin-image-tools: ask_user_choice tool')
   const disposeShow = ctx.effect(() => ctx.tools.register(showImagesTool(ctx)), 'dsh-plugin-image-tools: show_images tool')
+  const disposeSave = ctx.effect(() => ctx.tools.register(saveReceivedImagesTool(ctx)), 'dsh-plugin-image-tools: save_received_images tool')
+
+  // 盲模型收图：把进入 LLM 步骤的消息批次里的 image 块重写为文本占位符，
+  // 避免文本-only 适配器（如 DeepSeek）对图片内容块直接抛 UNSUPPORTED_CONTENT。
+  const disposePreStep = ctx.effect(() => ctx.on('agent/pre-step', async ({ agent, messages, turn, step, signal }, next) => {
+    const decision = await next()
+    if (decision === null || typeof decision !== 'object' || decision.kind !== 'enter') return decision
+    let changed = false
+    const rewritten = decision.messages.map((message) => {
+      const replaced = rewriteMessageImages(message)
+      if (replaced !== null) {
+        changed = true
+        return replaced
+      }
+      return message
+    })
+    return changed ? { kind: 'enter', messages: rewritten } : decision
+  }), 'dsh-plugin-image-tools: image-to-text pre-step')
+
+  // 模型能力补丁：apiproxy 在 prompt 入队前校验 inputModalities，
+  // 盲模型（未声明 image 输入）会直接拒绝带图消息（MODEL_DOES_NOT_SUPPORT_IMAGES）。
+  // 这里把 resolveModelInfo 的结果补上 image 模态，放行带图消息进入会话；
+  // 图片随后由上面的 pre-step 重写为文本占位符，适配器不会真的收到图片块。
+  const llmService = ctx.llm
+  const originalResolveModelInfo = llmService !== null && llmService !== undefined && typeof llmService.resolveModelInfo === 'function'
+    ? llmService.resolveModelInfo
+    : null
+  if (originalResolveModelInfo !== null) {
+    const patchedResolveModelInfo = async (provider, model, signal) => {
+      const info = await originalResolveModelInfo.call(llmService, provider, model, signal)
+      if (info === null || typeof info !== 'object') return info
+      const modalities = info.inputModalities
+      if (modalities === undefined || modalities.includes('image')) return info
+      return Object.freeze({ ...info, inputModalities: Object.freeze([...modalities, 'image']) })
+    }
+    llmService.resolveModelInfo = patchedResolveModelInfo
+  }
 
   ctx.effect(() => () => {
     disposeRoute()
     disposeChoice()
     disposeShow()
+    disposeSave()
+    disposePreStep()
+    // 卸载时还原 llm 能力补丁
+    if (originalResolveModelInfo !== null && llmService.resolveModelInfo !== originalResolveModelInfo) {
+      llmService.resolveModelInfo = originalResolveModelInfo
+    }
     picks.clear()
     shows.clear()
+    attachmentRefs.clear()
   })
 }

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.3.1",
+  "version": "0.4.1",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -15,6 +15,7 @@
     "docs",
     "cordis.patch.yml",
     "README.md",
+    "LICENSE",
     "设计说明.md"
   ],
   "scripts": {

package/scripts/selfcheck.mjs

@@ -11,6 +11,10 @@ import {
   loadOptionImage,
   originOf,
   safeAlt,
+  mediaTypeToExt,
+  imagePlaceholderText,
+  extractImageTokenIds,
+  rewriteMessageImages,
   MAX_IMAGE_BYTES,
 } from '../lib/index.js'
 
@@ -97,6 +101,48 @@ async function main() {
     assert.equal(safeAlt(undefined), '图片')
   })
 
+  // --- 盲模型收图：媒体类型/占位符/token 提取/消息重写 ---
+  await ok('mediaTypeToExt maps', () => {
+    assert.equal(mediaTypeToExt('image/png'), '.png')
+    assert.equal(mediaTypeToExt('image/jpeg'), '.jpg')
+    assert.equal(mediaTypeToExt('image/webp'), '.webp')
+    assert.equal(mediaTypeToExt('image/gif'), '.gif')
+    assert.equal(mediaTypeToExt('image/bmp'), '')
+  })
+  await ok('imagePlaceholderText embeds token', () => {
+    const text = imagePlaceholderText({ attachmentId: 'abc123def456', mediaType: 'image/png', width: 10, height: 20 })
+    assert.ok(text.includes('dshimg:abc123def456'), '占位符应含 token')
+    assert.ok(text.includes('图片'), '占位符应说明是图片')
+  })
+  await ok('extractImageTokenIds finds ids', () => {
+    assert.deepEqual(extractImageTokenIds('📷 图片 dshimg:aaa111bbb222 和 dshimg:ccc333ddd444 和 dshimg:aaa111bbb222'), ['aaa111bbb222', 'ccc333ddd444'])
+    assert.deepEqual(extractImageTokenIds('没有 token'), [])
+    assert.deepEqual(extractImageTokenIds(undefined), [])
+  })
+  await ok('rewriteMessageImages replaces image block', () => {
+    const ref = { attachmentId: 'abc123def456', mediaType: 'image/png', bytes: 4, width: 10, height: 20, name: 'shot.png' }
+    const message = { id: 'm1', role: 'user', source: { kind: 'direct' }, content: [
+      { type: 'text', text: '看看这张图' },
+      { type: 'image', attachment: ref },
+    ] }
+    const rewritten = rewriteMessageImages(message)
+    assert.ok(rewritten !== null, '应返回重写后的消息')
+    assert.equal(rewritten.id, 'm1', 'id 保留')
+    assert.equal(rewritten.content.length, 2)
+    assert.equal(rewritten.content[0].type, 'text')
+    assert.equal(rewritten.content[1].type, 'text', 'image 块应变为 text 块')
+    assert.ok(rewritten.content[1].text.includes('dshimg:abc123def456'), '占位符应含 token')
+    assert.ok(Object.isFrozen(rewritten), '新消息应冻结')
+    // 原消息不被修改
+    assert.equal(message.content[1].type, 'image')
+  })
+  await ok('rewriteMessageImages leaves text-only messages alone', () => {
+    const message = { id: 'm2', role: 'user', source: { kind: 'direct' }, content: [{ type: 'text', text: 'hi' }] }
+    assert.equal(rewriteMessageImages(message), null)
+    assert.equal(rewriteMessageImages(null), null)
+    assert.equal(rewriteMessageImages({ id: 'x', content: 'not-array' }), null)
+  })
+
   // --- loadOptionImage：data URI / path（url 需要网络，跳过） ---
   await ok('load data URI', async () => {
     const pngBytes = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])

package/scripts/smoke-client.mjs

@@ -50,6 +50,7 @@ assert.equal(typeof mod.selectPickChoice, 'function')
 assert.equal(typeof mod.ImageChoiceComposer, 'function')
 assert.equal(typeof mod.Lightbox, 'function')
 assert.equal(typeof mod.isShowImageSrc, 'function')
+assert.equal(typeof mod.extractImageTokenIds, 'function')
 assert.equal(typeof mod.startInlineEnhancer, 'function')
 
 // 5) 内嵌图片增强纯函数
@@ -59,6 +60,12 @@ assert.ok(!mod.isShowImageSrc('/dsh-plugin-image-tools/abc/0'), '选择卡路由
 assert.ok(!mod.isShowImageSrc('https://example.com/a.png'), '外部图片不应被识别')
 assert.equal(mod.startInlineEnhancer(), null, '无 DOM 环境下不应启动观察器')
 
+// 5b) 盲模型收图占位符 token 提取
+assert.deepEqual(mod.extractImageTokenIds('📷 图片 dshimg:att-aaa111bbb222 和 dshimg:att-ccc333ddd444'), ['att-aaa111bbb222', 'att-ccc333ddd444'])
+assert.deepEqual(mod.extractImageTokenIds('📷 图片 dshimg:att-aaa111bbb222 重复 dshimg:att-aaa111bbb222'), ['att-aaa111bbb222'])
+assert.deepEqual(mod.extractImageTokenIds('没有 token'), [])
+assert.deepEqual(mod.extractImageTokenIds(undefined), [])
+
 // 2) select：认领带标记问题，放过纯文字问题
 const markerDetail = buildPickMarker('pick-1', [0, 2]) + '\n\n请选择一张图'
 const withImage = {

package/scripts/smoke-server.mjs

@@ -13,6 +13,9 @@
  * 运行：node scripts/smoke-server.mjs
  */
 import { strict as assert } from 'node:assert'
+import { mkdtempSync, readFileSync, existsSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
 import { apply, ROUTE_PREFIX } from '../lib/index.js'
 
 const pngBytes = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 1, 2, 3, 4])
@@ -22,7 +25,9 @@ let toolDefs = []
 let route = null
 let capturedAsk = null
 let resolveAsk = null
+let preStepHandler = null
 const askPromise = new Promise((resolve) => { resolveAsk = resolve })
+const storedAttachments = new Map([['att-abc123def456', pngBytes]])
 
 const ctx = {
   effect(fn) {
@@ -43,6 +48,22 @@ const ctx = {
       return askPromise
     },
   },
+  on(event, handler) {
+    if (event === 'agent/pre-step') preStepHandler = handler
+    return () => { if (preStepHandler === handler) preStepHandler = null }
+  },
+  attachments: {
+    async readImage(ref) {
+      const data = storedAttachments.get(ref.attachmentId)
+      if (data === undefined) throw new Error(`attachment not found: ${ref.attachmentId}`)
+      return { ref, data }
+    },
+  },
+  llm: {
+    async resolveModelInfo(provider, model) {
+      return { provider, id: model, name: model, inputModalities: ['text'] }
+    },
+  },
 }
 
 apply(ctx)
@@ -50,6 +71,7 @@ apply(ctx)
 const defByName = (name) => toolDefs.find((def) => def.name === name)
 const choiceDef = defByName('ask_user_choice')
 const showDef = defByName('show_images')
+const saveDef = defByName('save_received_images')
 
 // --- 1) 工具定义 ---
 assert.ok(choiceDef, 'ask_user_choice 未注册')
@@ -58,6 +80,9 @@ assert.ok(choiceDef.parameters.properties.questions.items.properties.options.ite
 assert.equal(typeof choiceDef.execute, 'function')
 assert.ok(showDef, 'show_images 未注册')
 assert.ok(showDef.parameters.properties.images.items.properties.image, 'show_images schema 缺少 image 字段')
+assert.ok(saveDef, 'save_received_images 未注册')
+assert.ok(saveDef.parameters.properties.images.items.properties.attachmentId, 'save_received_images schema 缺少 attachmentId')
+assert.equal(typeof preStepHandler, 'function', 'agent/pre-step 监听器未注册')
 assert.equal(typeof showDef.execute, 'function')
 
 // --- 2) ask_user_choice 执行：data URI 图片 + 纯文字选项混排 ---
@@ -191,4 +216,71 @@ await assert.rejects(() => showDef.execute({ images: [] }, exec), /不能为空/
 await assert.rejects(() => showDef.execute({ images: [{ caption: '没有图' }] }, exec), /image 字段/)
 await assert.rejects(() => showDef.execute({ images: [{ image: {} }] }, exec), /path \/ url \/ data/)
 
+// --- 6) 盲模型收图：pre-step 重写 → 附件路由 → save_received_images ---
+const imgRef = { attachmentId: 'att-abc123def456', mediaType: 'image/png', bytes: pngBytes.byteLength, width: 12, height: 12, name: 'shot.png' }
+const userMsg = {
+  id: 'm-img-1',
+  role: 'user',
+  source: { kind: 'direct' },
+  content: [
+    { type: 'text', text: '看看这张截图' },
+    { type: 'image', attachment: imgRef },
+  ],
+}
+const decision = await preStepHandler(
+  { agent: { id: 'a1' }, messages: [userMsg], turn: 1, step: 1, signal: undefined },
+  async () => ({ kind: 'enter', messages: [userMsg] }),
+)
+assert.equal(decision.kind, 'enter', 'pre-step 应返回 enter')
+assert.equal(decision.messages.length, 1)
+const rewritten = decision.messages[0]
+assert.equal(rewritten.id, 'm-img-1', '重写后消息 id 保留')
+assert.equal(rewritten.content[1].type, 'text', 'image 块应被重写为 text')
+assert.ok(rewritten.content[1].text.includes('dshimg:att-abc123def456'), '占位符应含 token')
+assert.equal(userMsg.content[1].type, 'image', '原消息不被修改')
+
+// 附件路由：重写登记的 ref 可出字节
+let attServed = null
+await route.handler(
+  { url: `${ROUTE_PREFIX}/attachment/att-abc123def456` },
+  {
+    writeHead(status, headers) { attServed = { status, headers } },
+    end(body) { attServed.body = body },
+  },
+)
+assert.equal(attServed.status, 200)
+assert.equal(attServed.headers['content-type'], 'image/png')
+assert.deepEqual(attServed.body, pngBytes)
+// 未知附件 → 404
+let attNotFound = null
+await route.handler(
+  { url: `${ROUTE_PREFIX}/attachment/att-nope000000` },
+  { writeHead(status) { attNotFound = { status } }, end() {} },
+)
+assert.equal(attNotFound.status, 404)
+
+// save_received_images：保存到临时 cwd
+const tmpCwd = mkdtempSync(join(tmpdir(), 'dsh-img-tools-'))
+const saveExec = { agent: { session: { header: { cwd: tmpCwd } } }, signal: undefined }
+const saveResult = await saveDef.execute({
+  images: [{ attachmentId: 'att-abc123def456' }],
+}, saveExec)
+assert.equal(saveResult.saved.length, 1)
+assert.equal(saveResult.saved[0].error, undefined, `保存不应出错：${saveResult.saved[0].error ?? ''}`)
+assert.ok(saveResult.saved[0].path.startsWith(tmpCwd), '应保存到工作区')
+assert.ok(existsSync(saveResult.saved[0].path), '文件应落盘')
+assert.deepEqual(readFileSync(saveResult.saved[0].path), pngBytes, '文件内容应为附件字节')
+assert.equal(saveResult.saved[0].mediaType, 'image/png')
+// 未知附件 → 返回 error 字段而非抛错
+const badSave = await saveDef.execute({ images: [{ attachmentId: 'att-nope000000' }] }, saveExec)
+assert.ok(badSave.saved[0].error, '未知附件应返回 error')
+// 参数校验
+await assert.rejects(() => saveDef.execute({ images: [] }, saveExec), /不能为空/)
+
+// --- 7) 模型能力补丁（放行盲模型收图） ---
+const patchedInfo = await ctx.llm.resolveModelInfo('deepseek', 'deepseek-v4-flash')
+assert.ok(Array.isArray(patchedInfo.inputModalities), '补丁后 inputModalities 应为数组')
+assert.ok(patchedInfo.inputModalities.includes('image'), '补丁后应声称支持 image 输入')
+assert.equal(patchedInfo.id, 'deepseek-v4-flash', '其余元数据应保留')
+
 console.log('[dsh-plugin-image-tools] server smoke passed')

package//350/256/276/350/256/241/350/257/264/346/230/216.md

@@ -95,15 +95,32 @@
 - 工具 `show_images`：
   - schema：`images: [{ image: {path|url|data|mediaType}, caption? }]`（1~9 张）；
   - execute：归一化 → 注册 shows → 返回绝对 URL markdown 片段 + 提示语。
+- 工具 `save_received_images`（盲模型收图 → 文件）：
+  - schema：`images: [{ attachmentId, mediaType?, width?, height?, bytes?, name? }]` + `dir?`（默认 `received/`）；
+  - execute：合并模型传入字段与 pre-step 登记的 ref → `ctx.attachments.readImage` 取回
+    附件字节 → 落盘工作区（文件名优先附件安全名，否则 `image-<n>-<时间戳>.<ext>`）→
+    返回路径与元数据；单个失败记入 error 字段不中断。
 - web 路由 `ROUTE_PREFIX = /dsh-plugin-image-tools`（`ctx.webServer.register`，kind=prefix）：
   - `/dsh-plugin-image-tools/<pickId>/<index>` → 选择卡图片；
   - `/dsh-plugin-image-tools/show/<showId>/<index>` → 回复内嵌图片；
+  - `/dsh-plugin-image-tools/attachment/<attachmentId>` → 盲模型收图的附件回显
+    （`ctx.attachments.readImage` 出字节，需要 pre-step 重写时登记过 ref）；
   - bytes + content-type（nosniff + 短缓存），越界/未知 id → 404。
 - 图片来源归一化（两种工具共用 `loadOptionImage`）：
   - `data`：data URI 解析（声明类型优先，魔数兜底，两者冲突报错）；
   - `url`：`fetch`（30s 超时），content-type 或魔数定类型；
   - `path`：相对会话 cwd（`agent.session.header.cwd`）解析，`readFile` 读取。
   - 上限 20 MiB/张；类型限 PNG/JPEG/WebP/GIF（魔数校验）。
+- **盲模型收图链路**（`agent/pre-step` + `llm` 能力补丁）：
+  - 补丁：保留 `ctx.llm.resolveModelInfo` 原方法，返回结果里把 `inputModalities`
+    补上 `image` —— apiproxy 的 prompt 入队校验（`MODEL_DOES_NOT_SUPPORT_IMAGES`）
+    据此放行带图消息；卸载时还原原方法；
+  - `agent/pre-step` waterfall 监听器（与 agent-instructions/time-context 同机制）：
+    把进入 LLM 步骤的消息批次里的 `{type:'image', attachment}` 块重写为文本占位符
+    `📷 用户发来的图片（name） dshimg:<attachmentId>`，同时把完整 ref 登记进
+    `attachmentRefs`（TTL 清理）——会话日志/UI 保持纯文本安全，文本-only 适配器
+    不再抛 `UNSUPPORTED_CONTENT`；
+  - 重写是无条件的（插件定位即盲模型收图）；使用视觉模型的原生看图需停用本插件。
 
 ### 客户端 lib/client.js（浏览器模块加载器格式，免构建）
 
@@ -125,7 +142,11 @@
   - `startInlineEnhancer()`：`MutationObserver(document.body, childList+subtree)`
     + rAF 合帧扫描；无 DOM 环境返回 null（优雅降级）；
   - `openImageZoom(src, caption)`：命令式 Lightbox（复用 `.dshpick-lightbox` 样式），
-    带 Esc / 点遮罩 / 关闭按钮。
+    带 Esc / 点遮罩 / 关闭按钮；
+  - **盲模型收图回显**：`extractImageTokenIds(text)` 提取 `dshimg:<id>` 占位符；
+    `upgradeBubbleTexts()` 用 TreeWalker 扫文本节点，把占位符替换为
+    `<img src="/dsh-plugin-image-tools/attachment/<id>">`（可放大、失败降级），
+    用 WeakMap 记录已扫描的 nodeValue（React 原位更新文本时会重新扫描）。
 - 注册：
   - `ctx.slots.inject("conversation.composer", ...)`（priority -100，先于原生）；
   - `ctx.effect(() => startInlineEnhancer())`（随插件卸载停止观察器）。

package/docs/gen-mockups.ps1

@@ -1,185 +0,0 @@
-# dsh-plugin-image-tools 效果图生成脚本（README 展示用）
-# 用法：powershell -ExecutionPolicy Bypass -File docs\gen-mockups.ps1
-# 输出：docs/mockup-choice.png（图片选择卡）、docs/mockup-inline.png（回复内嵌图片）
-Add-Type -AssemblyName System.Drawing
-
-$docs = Join-Path $PSScriptRoot '.'
-$sunset = [System.Drawing.Image]::FromFile((Join-Path $docs '..\..\..\.tmp\pickdemo\sunset.png'))
-$stars  = [System.Drawing.Image]::FromFile((Join-Path $docs '..\..\..\.tmp\pickdemo\stars.png'))
-$whale  = [System.Drawing.Image]::FromFile((Join-Path $docs '..\..\..\.tmp\pickdemo\whale.png'))
-$font = New-Object System.Drawing.Font('Microsoft YaHei UI', 20, [System.Drawing.FontStyle]::Regular)
-$fontBold = New-Object System.Drawing.Font('Microsoft YaHei UI', 22, [System.Drawing.FontStyle]::Bold)
-$fontSmall = New-Object System.Drawing.Font('Microsoft YaHei UI', 13, [System.Drawing.FontStyle]::Regular)
-$fontTiny = New-Object System.Drawing.Font('Microsoft YaHei UI', 11, [System.Drawing.FontStyle]::Regular)
-
-$bg = [System.Drawing.Color]::FromArgb(255, 14, 17, 23)
-$panel = [System.Drawing.Color]::FromArgb(255, 27, 32, 43)
-$border = [System.Drawing.Color]::FromArgb(255, 43, 51, 69)
-$thumbBg = [System.Drawing.Color]::FromArgb(255, 35, 41, 54)
-$text1 = [System.Drawing.Color]::FromArgb(255, 237, 240, 246)
-$text2 = [System.Drawing.Color]::FromArgb(255, 154, 163, 181)
-$text3 = [System.Drawing.Color]::FromArgb(255, 107, 116, 136)
-$accent = [System.Drawing.Color]::FromArgb(255, 76, 125, 255)
-$warnBg = [System.Drawing.Color]::FromArgb(255, 58, 46, 20)
-$warnText = [System.Drawing.Color]::FromArgb(255, 232, 163, 61)
-$white = [System.Drawing.Color]::FromArgb(255, 255, 255, 255)
-
-function New-Brush($c) { New-Object System.Drawing.SolidBrush($c) }
-function RoundedPath([float]$x, [float]$y, [float]$w, [float]$h, [float]$r) {
-  $p = New-Object System.Drawing.Drawing2D.GraphicsPath
-  $d = $r * 2
-  $p.AddArc($x, $y, $d, $d, 180, 90)
-  $p.AddArc($x + $w - $d, $y, $d, $d, 270, 90)
-  $p.AddArc($x + $w - $d, $y + $h - $d, $d, $d, 0, 90)
-  $p.AddArc($x, $y + $h - $d, $d, $d, 90, 90)
-  $p.CloseFigure()
-  return $p
-}
-function Draw-Rounded([System.Drawing.Graphics]$g, $brush, $rect, [float]$radius) {
-  $p = RoundedPath $rect.X $rect.Y $rect.Width $rect.Height $radius
-  $g.FillPath($brush, $p)
-  $p.Dispose()
-}
-function Draw-ImageCrop([System.Drawing.Graphics]$g, [System.Drawing.Image]$img, $rect) {
-  # object-fit: cover 的近似：按目标矩形等比裁剪
-  $ratio = [Math]::Min($rect.Width / $img.Width, $rect.Height / $img.Height)
-  $w = $img.Width * $ratio; $h = $img.Height * $ratio
-  $sx = ($rect.Width - $w) / 2; $sy = ($rect.Height - $h) / 2
-  $src = New-Object System.Drawing.Rectangle(0, 0, $img.Width, $img.Height)
-  $dst = New-Object System.Drawing.RectangleF(($rect.X + $sx), ($rect.Y + $sy), $w, $h)
-  $g.DrawImage($img, $dst, $src, [System.Drawing.GraphicsUnit]::Pixel)
-}
-function Text-Len($g, $text, $font) { return $g.MeasureString($text, $font).Width }
-
-# ============================================================
-# 效果图 1：图片选择卡（mockup-choice.png）
-# 布局对齐修复后的真实卡片：标题/说明/图片网格/选项行统一左缩进 24px
-# ============================================================
-$W = 1240; $H = 860
-$bmp = New-Object System.Drawing.Bitmap($W, $H)
-$g = [System.Drawing.Graphics]::FromImage($bmp)
-$g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
-$g.TextRenderingHint = [System.Drawing.Text.TextRenderingHint]::ClearTypeGridFit
-$g.Clear($bg)
-
-# 卡片
-$cardX = 120.0; $cardY = 60.0; $cardW = 1000.0; $cardH = 720.0
-$inner = $cardX + 24.0          # 统一 24px 左缩进
-$right = $cardX + $cardW - 24.0 # 右侧对称
-Draw-Rounded $g (New-Brush $panel) (New-Object System.Drawing.RectangleF($cardX, $cardY, $cardW, $cardH)) 24
-$g.DrawPath((New-Object System.Drawing.Pen($border, 1.5)), (RoundedPath $cardX $cardY $cardW $cardH 24))
-
-# 头部：eyebrow + 标题（24px）
-$g.DrawString('封面选择', $fontTiny, (New-Brush $text3), $inner, 92.0)
-$g.DrawString('选一张封面图', $fontBold, (New-Brush $text1), $inner, 114.0)
-
-# 说明文字（与标题左对齐，24px）
-$g.DrawString('三张候选图，点击卡片或放大镜可查看大图。', $fontTiny, (New-Brush $text2), $inner, 158.0)
-
-# 图片卡片（3 张，网格左缩进 24px；列宽按可用宽度均分）
-$thumbW = 298.0; $thumbH = 298.0; $gap = 29.0
-$x0 = $inner; $y0 = 210.0
-$imgs = @($sunset, $stars, $whale)
-$labels = @('深海鲸鱼', '星空', '手绘风')
-for ($i = 0; $i -lt 3; $i++) {
-  $tx = $x0 + $i * ($thumbW + $gap)
-  $tRect = New-Object System.Drawing.RectangleF($tx, $y0, $thumbW, $thumbH)
-  # 选中态：第一张带 accent 边框
-  if ($i -eq 0) {
-    $selPen = New-Object System.Drawing.Pen($accent, 3)
-    $g.DrawPath($selPen, (RoundedPath $tx $y0 $thumbW $thumbH 16))
-    $selPen.Dispose()
-  }
-  Draw-Rounded $g (New-Brush $thumbBg) $tRect 16
-  # 图（内缩 2px 让边框可见）
-  $inner2 = New-Object System.Drawing.RectangleF(($tx + 2), ($y0 + 2), ($thumbW - 4), ($thumbH - 4))
-  $clip = New-Object System.Drawing.Region((RoundedPath ($inner2.X) ($inner2.Y) ($inner2.Width) ($inner2.Height) 14))
-  $g.SetClip($clip, [System.Drawing.Drawing2D.CombineMode]::Replace)
-  Draw-ImageCrop $g $imgs[$i] $inner2
-  $g.ResetClip(); $clip.Dispose()
-  # 放大镜提示（第一张）
-  if ($i -eq 0) {
-    $hintRect = New-Object System.Drawing.RectangleF(($tx + 10), ($y0 + 10), 30, 30)
-    $g.FillEllipse((New-Brush ([System.Drawing.Color]::FromArgb(140, 145, 160, 180))), $hintRect)
-    $g.DrawEllipse((New-Object System.Drawing.Pen($white, 2)), ($tx + 17), ($y0 + 17), 10, 10)
-    $g.DrawLine((New-Object System.Drawing.Pen($white, 2.5)), ($tx + 25), ($y0 + 25), ($tx + 30), ($y0 + 30))
-  }
-  # 选中对勾（第一张）
-  if ($i -eq 0) {
-    $checkRect = New-Object System.Drawing.RectangleF(($tx + $thumbW - 40), ($y0 + 10), 24, 24)
-    $g.FillEllipse((New-Brush $accent), $checkRect)
-    $g.DrawString('✓', (New-Object System.Drawing.Font('Microsoft YaHei UI', 15, [System.Drawing.FontStyle]::Bold)), (New-Brush $white), ($tx + $thumbW - 33.5), ($y0 + 9))
-  }
-  # label + 推荐徽标（24px 对齐）
-  $ly = $y0 + $thumbH + 14
-  $g.DrawString($labels[$i], $font, (New-Brush $text1), $tx, $ly)
-  if ($i -eq 0) {
-    $badgeX = $tx + (Text-Len $g $labels[$i] $font) + 12
-    $badgeRect = New-Object System.Drawing.RectangleF($badgeX, ($ly + 3), 48, 22)
-    Draw-Rounded $g (New-Brush $warnBg) $badgeRect 11
-    $g.DrawString('推荐', $fontTiny, (New-Brush $warnText), ($badgeX + 11), ($ly + 2))
-  }
-  $g.DrawString('点击可放大查看', $fontTiny, (New-Brush $text3), $tx, ($ly + 34))
-}
-
-# 页脚：进度 + 按钮（右侧对称 24px）
-$g.DrawString('1 / 1', $font, (New-Brush $text2), $inner, 700.0)
-$skipRect = New-Object System.Drawing.RectangleF(($right - 86 - 12 - 86), 686.0, 86, 36)
-$g.DrawPath((New-Object System.Drawing.Pen($border, 1.5)), (RoundedPath $skipRect.X $skipRect.Y $skipRect.Width $skipRect.Height 18))
-$g.DrawString('跳过', $fontSmall, (New-Brush $text1), ($skipRect.X + 23), 692.0)
-$submitRect = New-Object System.Drawing.RectangleF(($right - 86), 686.0, 86, 36)
-Draw-Rounded $g (New-Brush $accent) $submitRect 18
-$g.DrawString('提交', $fontSmall, (New-Brush $white), ($submitRect.X + 28), 692.0)
-
-$g.Dispose()
-$bmp.Save((Join-Path $docs 'mockup-choice.png'), [System.Drawing.Imaging.ImageFormat]::Png)
-$bmp.Dispose()
-Write-Host 'mockup-choice.png saved'
-
-# ============================================================
-# 效果图 2：回复内嵌图片（mockup-inline.png）
-# ============================================================
-$W2 = 1240; $H2 = 900
-$bmp2 = New-Object System.Drawing.Bitmap($W2, $H2)
-$g2 = [System.Drawing.Graphics]::FromImage($bmp2)
-$g2.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
-$g2.TextRenderingHint = [System.Drawing.Text.TextRenderingHint]::ClearTypeGridFit
-$g2.Clear($bg)
-
-# 助手身份行
-$g2.FillEllipse((New-Brush $accent), 120.0, 84.0, 40, 40)
-$g2.DrawString('D', (New-Object System.Drawing.Font('Microsoft YaHei UI', 20, [System.Drawing.FontStyle]::Bold)), (New-Brush $white), 131.0, 88.0)
-$g2.DrawString('DeepSeek Harness', $fontSmall, (New-Brush $text1), 172.0, 90.0)
-$g2.DrawString('刚刚', $fontTiny, (New-Brush $text3), 340.0, 96.0)
-
-# 消息正文（markdown 风格）
-$g2.DrawString('这是为你生成的两张候选图，点图片可以放大查看：', $font, (New-Brush $text1), 122.0, 152.0)
-
-# 图片（限宽 560，圆角）
-$imgW = 560.0; $imgH = 360.0; $imgX = 122.0; $imgY = 214.0; $imgGap = 34.0
-for ($i = 0; $i -lt 2; $i++) {
-  $iy = $imgY + $i * ($imgH + $imgGap)
-  $iRect = New-Object System.Drawing.RectangleF($imgX, $iy, $imgW, $imgH)
-  Draw-Rounded $g2 (New-Brush $thumbBg) $iRect 16
-  $g2.DrawPath((New-Object System.Drawing.Pen($border, 1.5)), (RoundedPath $imgX $iy $imgW $imgH 16))
-  $clip2 = New-Object System.Drawing.Region((RoundedPath $imgX $iy $imgW $imgH 16))
-  $g2.SetClip($clip2, [System.Drawing.Drawing2D.CombineMode]::Replace)
-  Draw-ImageCrop $g2 $imgs[$i] $iRect
-  $g2.ResetClip(); $clip2.Dispose()
-  # caption（alt 说明，悬浮可见的语义）
-  $capY = $iy + $imgH + 10
-  $g2.DrawString(('图片说明：' + $labels[$i]), $fontTiny, (New-Brush $text3), $imgX, $capY)
-}
-
-# 下方继续文字
-$g2.DrawString('需要调整配色或构图，或者换成横版，随时告诉我。', $font, (New-Brush $text1), 122.0, 664.0)
-
-# 用户消息气泡
-$bubble = New-Object System.Drawing.RectangleF(760.0, 764.0, 360, 52)
-Draw-Rounded $g2 (New-Brush ([System.Drawing.Color]::FromArgb(255, 59, 98, 214))) $bubble 26
-$g2.DrawString('选第 1 张，谢谢！', $fontSmall, (New-Brush $white), 794.0, 780.0)
-
-$g2.Dispose()
-$bmp2.Save((Join-Path $docs 'mockup-inline.png'), [System.Drawing.Imaging.ImageFormat]::Png)
-$bmp2.Dispose()
-Write-Host 'mockup-inline.png saved'