dsh-recall-plugin 2.4.10 → 2.4.11

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 本文件格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
 
+## [2.4.11] - 2026-10-15
+
+### 兼容
+
+- **dsh 0.2.1-alpha.3 兼容（首个破坏性版本：chat.node 图片渲染入口换代）**（升级核查见 [docs/upgrade-assessments/dsh-0.2.1-alpha.3.md](docs/upgrade-assessments/dsh-0.2.1-alpha.3.md) 与 [docs/compat-audit.md](docs/compat-audit.md) 头部 0.2.1-alpha.3 段）：官方移除 `chat.node` 的 `renderMessageImages`、把 `conversation.message.images` 拆为 `conversation.chat.message.images` + `conversation.chat.user.images`，图片渲染改经 `renderFactorySlot`（`PropsRenderFactories`）+ `loadImage` 的 `conversation.chat.user.content` Factory——插件原图片重绘链在新版静默失效（用户消息图片无声空白，issue #9 的第二次形态，零报错）。
+- **修复为运行时双面探测**（`src/client/recall-node.ts`）：旧面（≤0.2.1-alpha.2）沿用 `renderMessageImages` 闭包；新面（≥0.2.1-alpha.3）经 `renderFactorySlot('conversation.chat.user.content', …)` 只渲染附件行（`content.text` 传空串保官方 `showBubble=false`，正文仍由插件自绘气泡、不重复出官方气泡），`loadImage` 原样透传——peer 全窗口（0.1.2–0.2.x）行为一致。
+- 探针改双面契约断言（`test:probe` 52/52），`test:client` +2（旧面闭包 / 新面 Factory 载荷与 `text:''` 契约要点 / 两入口双缺降级）；其余契约零漂移：`sessions.fork`（仅 `create` 加可选 `agentPreset`）/`updateQueue`/`setDraft`/`archiveSession` 均未动，事件集 60 → 62（仅增 `job/registered`/`job/settled`，零删除）。观察项：exact Fetch 路由明确「仅 owner Peer 可达」——远程非 owner 访问场景插件 API 403（本机 web/desktop 零影响）。
+- **密钥脱敏对齐（同日跟进）**：官方新增 `dsh-client-ui-secret-mask`（`userText.register` 规则 + `conversation.user.text.node` key=`secret`）只在官方文本投影层打码，插件自绘气泡原本绕过、密钥明文。文本行改经新面 `renderFactorySlot('conversation.user.text', { text, facts: {}, interactive: false, ellipsis: false })` 投影——仅继承脱敏（`facts` 空对象令官方 whitespace 折叠/裁剪规则读不到 flag 即禁用、显示与旧面逐字一致；引用 chip 仅在显式 wire 格式下出现）；旧面（≤0.2.1-alpha.2，无 `renderFactorySlot`）保持纯字符串渲染。探针 +1、`test:client` +1（**probe 53/53、client 93/93**）。
+
+### 文档
+
+- `docs/reference/` 镜像按 tag `dsh-v0.2.1-alpha.3` 重拉：13 源中 2 份差异（`05-publish.md` 的 `--from-default-profile` 重置语义；`11-cookbook-conversation-node.md` 的 `exclusive` 认领与 `groupTree` 位置表）。
+- `docs/dsh-contract.md` / `docs/compat-audit.md`（I2 重写）/ `AGENTS.md`（I2 行）/ README 双语兼容范围与徽章同步至 0.2.1-alpha.3。
+
 ## [2.4.10] - 2026-10-07
 
 ### 修复

package/README.en.md

@@ -7,7 +7,7 @@
 ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-blue)
 ![Build](https://img.shields.io/badge/pure%20JS-green)
 
-[![DSH](https://img.shields.io/badge/DSH-0.2.1--alpha.1-blue)](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-alpha.1)
+[![DSH](https://img.shields.io/badge/DSH-0.2.1--alpha.3-blue)](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-alpha.3)
 ![DSH](https://img.shields.io/badge/DSH-Desktop-blue)
 
 Under any message you've sent, click "↶ Recall" — **your workspace files and the conversation history roll back to just before that message was sent**.
@@ -73,7 +73,7 @@ Prerequisites:
 
 - git CLI: without it the recall button won't appear (a notice shows at the top of the page); DSH itself keeps running.
 - Shell: PowerShell 5.1 / 7 on Windows; bash on Linux/macOS.
-- DSH version: `0.1.2-alpha.1` through `0.2.1-alpha.1`; later versions within a verified minor line are admitted automatically, while unverified new minor lines are blocked by the startup compatibility gate (window mechanics in the fold below).
+- DSH version: `0.1.2-alpha.1` through `0.2.1-alpha.3`; later versions within a verified minor line are admitted automatically, while unverified new minor lines are blocked by the startup compatibility gate (window mechanics in the fold below).
 - **0.1.7-alpha.1 is a breaking release** (the shell execution and settings interfaces changed); the plugin ships both seams side by side — the same release works on every 0.1.2–0.1.6 line and on 0.1.7+, with unchanged behaviour on older DSH versions.
 - `0.1.1-rc.2` and earlier are not supported: their client runtime lacks the `sessions`/`workspaces`/`uiWorkspace` services, so the plugin UI silently fails to render.
 

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/dsh-recall-plugin?style=flat-square&label=npm&color=3178C6)](https://www.npmjs.com/package/dsh-recall-plugin)
 [![npm downloads](https://img.shields.io/npm/dm/dsh-recall-plugin?style=flat-square&label=downloads&color=1F883D)](https://www.npmjs.com/package/dsh-recall-plugin)
 ![License](https://img.shields.io/badge/license-MIT-blue)
-[![DSH](https://img.shields.io/badge/DSH-0.2.1--alpha.1-blue)](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-alpha.1)
+[![DSH](https://img.shields.io/badge/DSH-0.2.1--alpha.3-blue)](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-alpha.3)
 
 在任意一条你发过的消息下方点「↶ 撤回」——**工作区文件和对话历史一起回到那条消息发出之前的状态**。
 
@@ -70,7 +70,7 @@
 
 - git CLI：未安装时撤回按钮不出现（页面顶部会提示安装 git），不影响 DSH 运行。
 - shell：Windows 上 PowerShell 5.1 / 7 均可；Linux/macOS 需 bash。
-- DSH 版本：`0.1.2-alpha.1` 至 `0.2.1-alpha.1`；已核验 minor 线内的后续版本自动放行，未核验的新 minor 线会被启动期兼容门禁拦截（开窗机制见下方折叠块）。
+- DSH 版本：`0.1.2-alpha.1` 至 `0.2.1-alpha.3`；已核验 minor 线内的后续版本自动放行，未核验的新 minor 线会被启动期兼容门禁拦截（开窗机制见下方折叠块）。
 - **0.1.7-alpha.1 是破坏性版本**（shell 执行与 settings 面接口更换），插件内置双分支共存适配：同一发布同时兼容 0.1.2–0.1.6 各线与 0.1.7+，老版本 DSH 上行为不变。
 - `0.1.1-rc.2` 及更早不支持：那条线的客户端运行时没有 `sessions`/`workspaces`/`uiWorkspace` 服务，插件 UI 会静默不渲染。
 

package/lib/client.js

@@ -1359,6 +1359,8 @@
     function UserRecallNode(props) {
       const node = props && props.node;
       const renderMessageImages = props && props.renderMessageImages;
+      const renderFactorySlot = props && props.renderFactorySlot;
+      const loadImage = props && props.loadImage;
       const sessionId = props && props.sessionId;
       const data = node && node.data ? node.data : {};
       const messageId = node ? String(node.id || node.key || "") : "";
@@ -1557,13 +1559,31 @@
         setRecall({ stage: "idle" });
       };
       const bubbleChildren = [];
-      if (imageBlocks.length && typeof renderMessageImages === "function") {
-        const render = renderMessageImages;
-        bubbleChildren.push(React.createElement(
-          React.Fragment,
-          { key: "images" },
-          render({ images: imageBlocks, align: "end" })
-        ));
+      if (imageBlocks.length) {
+        if (typeof renderMessageImages === "function") {
+          const render = renderMessageImages;
+          bubbleChildren.push(React.createElement(
+            React.Fragment,
+            { key: "images" },
+            render({ images: imageBlocks, align: "end" })
+          ));
+        } else if (typeof renderFactorySlot === "function" && typeof loadImage === "function") {
+          const render = renderFactorySlot;
+          bubbleChildren.push(React.createElement(
+            React.Fragment,
+            { key: "images" },
+            render("conversation.chat.user.content", {
+              content: {
+                text: "",
+                attachments: imageBlocks.map((b) => ({ type: "image", image: { attachment: b.attachment } })),
+                extraBlocks: []
+              },
+              loadImage,
+              interactive: false,
+              facts: {}
+            })
+          ));
+        }
       }
       for (let i = 0; i < fileBlocks.length; i++) {
         const info = fileCardInfo(fileBlocks[i], t);
@@ -1580,7 +1600,18 @@
           )
         ));
       }
-      if (text !== "") bubbleChildren.push(React.createElement("div", { className: "dsh-recall-bubble", key: "text" }, text));
+      if (text !== "") {
+        if (typeof renderFactorySlot === "function") {
+          const render = renderFactorySlot;
+          bubbleChildren.push(React.createElement(
+            "div",
+            { className: "dsh-recall-bubble", key: "text" },
+            render("conversation.user.text", { text, facts: {}, interactive: false, ellipsis: false })
+          ));
+        } else {
+          bubbleChildren.push(React.createElement("div", { className: "dsh-recall-bubble", key: "text" }, text));
+        }
+      }
       for (let i = 0; i < rest.length; i++) {
         bubbleChildren.push(React.createElement("pre", { className: "dsh-recall-json", key: "rest-" + i }, JSON.stringify(rest[i], null, 2)));
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-recall-plugin",
-  "version": "2.4.10",
+  "version": "2.4.11",
   "description": "在 DSH 中撤回自己发过的消息：工作区文件与对话历史一起回到那条消息发出之前，消息的文本与附件自动放回输入框，改完即可重发。文件走独立影子 git 快照（不碰项目自身的 git），对话走官方 sessions.fork，原会话归档可找回。",
   "icon": "assets/icon.svg",
   "type": "module",
@@ -68,7 +68,9 @@
         "0.1.7-rc.2": "compatible",
         "0.2.0-rc.1": "compatible",
         "0.2.0-rc.2": "compatible",
-        "0.2.1-alpha.1": "compatible"
+        "0.2.1-alpha.1": "compatible",
+        "0.2.1-alpha.2": "compatible",
+        "0.2.1-alpha.3": "compatible"
       }
     }
   },