dsh-plugin-read-image-preview 1.6.0 → 1.7.1

package/README.md

@@ -2,16 +2,19 @@
 
 会话里的图片（read_image 读到的图、computer-use 截图、你自己贴进来的图）共用一个全屏查看器：放大、平移、圈红框、加字、裁剪，然后**回车直接放进输入框**。输入框旁的 `✂ 截图` 抓屏后直接框选，选完回车同样进输入框——给模型看一个前端问题，不用再开外部截图器。
 
+> 兼容性：`engines.dsh` = `>=0.2.0-rc.2 <0.3.0-0`，已在 dsh 0.2.1-rc.3 上实测运行。
+
 ## 接在哪里
 
 | 位置 | 做法 |
 | --- | --- |
-| read_image 行、用户消息里的图、助手消息里的图、轨迹里的图 | 只替换官方的**图库**位置（`tool.call.images`、`conversation.chat.user.images` / `conversation.chat.message.images`，0.2.0 叫 `conversation.message.images`；`conversation.trajectory.images`），priority `-1`。官方行自己的标题、路径、尺寸、Inspect 原样保留 |
-| computer-use 各工具、generate_image | 这些工具没有官方图片行，继续整格认领 `tool.call.toolview`（priority `-1`），渲染同一个图库加一行信息（路径、尺寸、体积、格式、复制路径、在编辑器中打开） |
+| read_image 行 | **整行认领** `tool.call.toolview`（key `read_image`，priority `-1`），图片直接展开显示，下面一行路径/尺寸/体积/格式（v1.7 恢复 1.4 的自动展开；官方行默认折叠所以不再使用官方行头与 Inspect） |
+| 用户消息里的图、助手消息里的图、轨迹里的图 | 只替换官方的**图库**位置（`conversation.chat.user.images` / `conversation.chat.message.images`，0.2.0 叫 `conversation.message.images`；`conversation.trajectory.images`），priority `-1`；官方行自己的标题、路径、尺寸、Inspect 原样保留 |
+| computer-use 各工具、generate_image | 这些工具没有官方图片行，整格认领 `tool.call.toolview`（priority `-1`），渲染同一个图库加一行信息（路径、尺寸、体积、格式、复制路径、在编辑器中打开） |
 | 输入框右侧 | `✂ 截图` 按钮 |
 | 设置 → 截图与标注 | 截图目录管理与按期清理 |
 
-> **v1.6 起 read_image 不再整行接管。** 官方 read_image 行从 0.2.0 起把图片交给 `tool.call.images` 子 slot 渲染，并自带路径与尺寸信息；本插件只填这个图库，和官方重合的部分全部交还。代价是官方行默认折叠，点开才看到图。两版 dsh 的消息图片 slot 名不同，全部注册是安全的：`slots.inject` 会一直等到 slot 被声明，没有的名字永远不会激活。
+> **v1.7：read_image 恢复自动展开。** v1.6 曾把 read_image 行交还官方（只填官方图库 slot），代价是官方行默认折叠、要点开才看到图；v1.7 重新整行接管该工具，图片默认展开显示，同时保留 v1.6 的查看器（缩放/标注/裁剪/发输入框）。官方 read_image 行头与 Inspect 在该工具上不再出现。两版 dsh 的消息图片 slot 名不同，全部注册是安全的：`slots.inject` 会一直等到 slot 被声明，没有的名字永远不会激活。
 
 图库：单张按真实宽高比显示缩略图（`min(420px, 100%)` × `max-height: 300px`），`<img>` 在字节到达前就带好 `width/height`，晚到的图片不会引起布局跳变（v1.4.1 修过的聊天吸底问题）；多张一律平铺成小图，全部可点开，查看器里 `←`/`→` 切换；透明 PNG/WebP/GIF 自动铺棋盘格；加载失败点一下重试。
 

package/client.js

@@ -4,13 +4,17 @@
  * Three surfaces share one full-screen viewer (zoom, pan, annotate, then send
  * to the composer, copy, or save):
  *
- * - Image galleries. The official image positions — `tool.call.images` inside
- *   the read_image row, user and assistant message images, trajectory images —
- *   are filled at priority -1 with this plugin's gallery, so the official rows
- *   keep their own chrome (title, path, sizes, Inspect) and only the pictures
- *   and the viewer are ours. Older and newer hosts name the message slots
- *   differently; registering every name is safe because `slots.inject` waits
- *   for a declaration that never comes.
+ * - Image galleries. The official image positions — user and assistant message
+ *   images, trajectory images — are filled at priority -1 with this plugin's
+ *   gallery, so the official rows keep their own chrome (title, path, sizes,
+ *   Inspect) and only the pictures and the viewer are ours. Older and newer
+ *   hosts name the message slots differently; registering every name is safe
+ *   because `slots.inject` waits for a declaration that never comes.
+ * - The whole `read_image` card (1.7): the official row renders its picture
+ *   inside a collapsed-by-default body, so the plugin claims the `read_image`
+ *   key of `tool.call.toolview` and renders the image expanded with a
+ *   path/size bar. The result content already carries the durable image
+ *   attachment, so the same card renders it without the host route 1.4 used.
  * - Tool cards for image-bearing tools that have no official image row
  *   (computer-use, generate_image): their keyed `tool.call.toolview` cell is
  *   claimed at priority -1 and renders the same gallery plus one metadata line.
@@ -1006,9 +1010,10 @@ window.__ModuleLoader__.load({
 
     /**
      * The claim list: every tool whose whole card this plugin owns, with the
-     * Chinese label shown while the call runs. read_image is not here: its
-     * official row hands its gallery to the `tool.call.images` slot, which this
-     * plugin fills instead. Adding an image-bearing tool = adding one line.
+     * Chinese label shown while the call runs. `read_image` is prepended (1.7):
+     * the official row shows its picture inside a collapsed-by-default body, so
+     * this plugin claims the whole card to render it expanded. Adding an
+     * image-bearing tool = adding one line.
      */
     const TOOL_LABELS = {
       generate_image: '绘图',
@@ -1025,7 +1030,7 @@ window.__ModuleLoader__.load({
       computer_sequence: '连续动作',
     }
 
-    const IMAGE_TOOL_KEYS = Object.keys(TOOL_LABELS)
+    const IMAGE_TOOL_KEYS = ['read_image'].concat(Object.keys(TOOL_LABELS))
 
     /**
      * Every official image position this plugin's gallery fills. The message
@@ -2966,9 +2971,10 @@ window.__ModuleLoader__.load({
      * Wire the plugin into the page.
      *
      * - the image galleries of the official image positions, at priority -1;
-     * - the whole card of every image-bearing tool without an official image
-     *   row, at priority -1 (if one of our entries ever throws, the slot's
-     *   error boundary abdicates it and the previous card returns);
+     * - the whole card of `read_image` and of every image-bearing tool without
+     *   an official image row, at priority -1 (if one of our entries ever
+     *   throws, the slot's error boundary abdicates it and the previous card
+     *   returns);
      * - the composer's ✂ button and the 截图与标注 settings page.
      */
     function apply(ctx) {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "dsh-plugin-read-image-preview",
-  "version": "1.6.0",
+  "version": "1.7.1",
+  "engines": { "dsh": ">=0.2.0-rc.2 <0.3.0-0" },
   "license": "MIT",
   "keywords": ["dsh-plugin", "deepseek-harness", "dsh", "image", "preview", "screenshot", "tool-card", "ui"],
   "publishConfig": { "registry": "https://registry.npmjs.org" },