消息编辑分叉 SpookySandwich/dsh-plugin-message-edit

dsh-plugin-message-edit

编辑一条已经发出的消息，对话会从那一刻 真正回溯并分叉——和 ChatGPT、Claude、DeepSeek 的做法一致。旧版本不会被覆盖：气泡下方出现 ‹ 2/4 › 计数，「版本」标签页则画出整棵树。

演示

版本树分支展示

无论对话如何深层分叉、编辑多少次，「版本」标签页均会呈现清晰的轮次级分支图，当前会话所在路径实时高亮，点击任意节点即可平滑跳转：

版本树

功能

- 编辑并分叉：修改过去的提问并发送，新分支会带着该轮 之前 的完整上下文重新生成。这是真正的回溯，而不是从末尾继续的 fork。
- 版本计数：一条消息存在多个版本时，下方出现 ‹ n/m ›，左右箭头在各版本间即时切换。
- 版本树：新增「版本」标签页，以图的方式展示所有分支，可平移、缩放、拖动。当前所在分支高亮，点击任意节点即可跳转。
- 零延迟与即时切换：客户端家族级 SWR 缓存与乐观预加载，点击箭头或树节点切换版本 0ms 响应，无指示器闪烁或加载白屏。
- 高性能内存缓存：宿主端内存解析缓存，消除重复磁盘 I/O 与日志重析，即便是深度分叉的庞大家族树也能毫秒级响应。
- 自动中止旧分支：分叉时自动停止同家族中仍在流式生成的回复，避免浪费 Token 与计算资源。
- 重试：不修改内容，直接重跑该轮（Claude 布局）。
- 复制：把消息文本复制到剪贴板。
- 持久可靠：每个分支都是真实会话，版本关系写入持久事件，重启后依旧完整。新分支自动归入父会话的工作区。

界面风格

这三家界面的差别在于 操作按钮放在哪里、有哪些，因此预设只改变这一点，颜色始终沿用 DSH 原生配色。在 设置 → 消息树 中选择，面板内有实时预览。

| 预设 | 气泡下方的按钮 | 显示方式 | 编辑框按钮 |
| ChatGPT | 编辑、复制 | 悬停时显示 | 取消 / 发送 在框 内部 |
| DeepSeek | 编辑、复制 | 始终显示——与 DSH 一致 | 取消 / 发送 在框 内部 |
| Claude | 重试、编辑、复制 | 悬停时显示 | 取消 / 保存 在框 下方 |

只有 Claude 在用户消息上提供重试，与真实界面一致。没有分享按钮——DSH 本身没有，就不自行发明。

安装

dsh plugin --profile web add dsh-plugin-message-edit

安装后请重启 DSH：宿主端随服务器加载。界面跟随 DSH 显示语言（中文 / English / Русский）。可在语言选择器中选择俄语；宿主中尚未翻译的界面使用英语。

工作原理

DSH 的会话是仅追加的事件日志，本身不支持会话内分支，因此回溯需要另行实现：

- 宿主端提供 /message-tree 接口。编辑消息时，会 以目标轮次之前的全部事件为种子创建一个新会话，写入持久的 message-tree/version 标记说明改动内容，并把编辑后的提问送入。
- 之后读取这些标记，还原出整棵版本树、‹ n/m › 计数，以及当前处于哪个分支。
- 标记事件带有信封上的 ignorable 标志。插件自定义的事件类型不在宿主的事件词表内，缺少该标志时读取端会拒绝解释整份日志，会话将直接打不开。
- 只遮蔽普通的 user 消息节点（优先级 -1）；思考、工具调用与引导消息仍由宿主渲染。

宿主端的分支逻辑源自 dsh-message-edit（MIT © Moeblack），在其基础上重做为 ChatGPT 式回溯语义、同级分支展开，以及上述界面预设。

两者名字相近，这里说明一下：这是另一个独立插件。它的路由、cordis id 与持久事件类型都保留了 message-tree 这一套命名，正是为了两个插件可以同时安装而互不冲突。

文档

更多技术细节与开发指南，请参阅：
- 架构概览 (Architecture)：宿主/客户端架构、Cordis 服务注入、持久事件模型与 HTTP 接口。
- 树数据模型与算法 (Tree Data Model)：轮次级消息树构建、同级展开、删除会话（Ghost）桥接与高亮路径计算。
- 开发与测试指南 (Development)：构建流程、单元测试与本地安装说明。

兼容性

版本 1.4.1（当前源码）：在仓库检出环境的 overrides 与锁文件中，将 @deepseek-ai/dsh-mcp-client 的 @modelcontextprotocol/client（及 @modelcontextprotocol/core）固定为 2.3.0，覆盖 GHSA-6qxp-vccf-f47h（CVE-2026-104850，2.2.0 修复）与 GHSA-6prh-2h8m-c8cw（CVE-2026-111769，跨源重定向会转发自定义请求头与 307/308 请求体，2.3.0 修复；2.3.0 在 Node 下仅跟随同源重定向，依赖跨源重定向的 MCP 服务端需配置最终 URL）。该变更仅加固本仓库的开发/测试检出环境；npm 作为依赖安装时会忽略 overrides，且发布包不含 package-lock.json，安装或更新本插件不会修改你现有的 DSH 宿主依赖。

版本 1.4.0：新增俄语（ru / Русский）客户端本地化（完整覆盖全部 37 条界面与图片文案），并在宿主语言选择器中注册 Русский（宿主未翻译界面回退至英语；若未显式保存语言偏好，且浏览器语言顺序将俄语排在中文之前，自动检测会选中俄语，未翻译宿主界面回退为英语；预加载的 ru 语言包会被优先保留，若外部 ru 语言包在本插件之后加载，则会因重复注册冲突）。

版本 1.3.1：当宿主不再传入旧版 renderMessageImages 回调时，通过宿主 conversation.chat.user.content 工厂恢复用户消息图片与原图预览，并提供基于 loadImage / loadImage.peek 的异步缩略图兜底。

版本 1.3.0：在兼容范围中显式纳入官方 dsh 0.2.1-rc.2，并在官方 0.2.0-rc.2 与 0.2.1-rc.2 运行时验证编辑、重试与重启恢复。

版本 1.2.1：修复 DSH 0.2 客户端加载，编辑、重试及版本切换改用 uiWorkspace.openSession 导航。

版本 1.2.0：在官方 dsh 0.2.0-rc.2 上通过 workspaceRegistry.unarchiveSession 取消版本归档。

版本 1.1.0：修复编辑/重试的 seed 边界，发布分支前清空继承的待发送输入，按会话身份识别版本标记，保留推理强度，并通过会话观察接口恢复持久分支。

声明兼容范围为 >=0.2.0-rc.2 <0.3.0-0 || 0.2.1-rc.2；官方 dsh 0.2.0-rc.2 与 0.2.1-rc.2 满足该范围。旧版 DSH 请保留上一插件版本。验证记录。

已发布版本可从 npm 安装。测试当前源码时，先运行 npm ci 和 npm pack，再运行 dsh plugin --profile desktop add ./dsh-plugin-message-edit-1.4.1.tgz。发布完整性检查见 发布流程。

1.1.0 已在 DSH 0.1.5-rc.2 的隔离 Web 环境验证：插件加载、图片显示、编辑与重试、深层分支，以及持久会话的恢复读取。模型回复使用本地测试实现，未调用远程模型服务。

兼容层保留了旧版 events / seedLength 接口支持，并由自动测试覆盖。本版本对应官方 dsh 0.2.1-rc.2。更新插件后请重启 DSH。

可与 dsh-plugin-smooth-stream、dsh-plugin-rollout-scout 共存。

许可

MIT © SpookySandwich。宿主端部分逻辑源自 dsh-message-edit（MIT © Moeblack）。