dsh-plugin-message-edit
UI & ExperienceSpookySandwich/dsh-plugin-message-edit
DSH plugin to edit a sent message and branch the conversation from that point, with version counters, a version tree view, and placement presets.
- ai-chat
- chat-ui
- conversation-branching
- cordis-plugin
- deepseek
- deepseek-harness
- dsh
- dsh-plugin
- llm
- message-editing
- react
- tree-view
- ux
- web-ui
Verification and compatibility
This section shows evidence collected by the catalog. Undeclared information is labeled as unknown.
- Current-version compatibility
- Verified on the catalog Harness version
- Declared Harness range
- Not declared
- Declared platforms
- Not declared
- Profiles
- web
- Build approval
- Unknown
- Permissions
- Not declared
- External services
- Not declared
- Telemetry
- Unknown
This is not a security endorsement. Review source, permissions, and configuration before installing.
View evidence and scope
Verification covers only the named source, version, and Harness environment. It does not guarantee future compatibility.
dsh-plugin-message-edit@1.1.0- The manifest and static structure passed checks; a runtime load check has not completed.
README
dsh-plugin-message-edit
English | 简体中文
编辑一条已经发出的消息，对话会从那一刻 真正回溯并分叉——和 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.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；官方 dsh 0.2.0-rc.2 满足该范围。旧版 DSH 请保留上一插件版本。验证记录。
已发布版本可从 npm 安装。测试当前源码时，先运行 npm ci 和 npm pack，再运行 dsh plugin --profile desktop add ./dsh-plugin-message-edit-1.2.1.tgz。发布完整性检查见 发布流程。
1.1.0 已在 DSH 0.1.5-rc.2 的隔离 Web 环境验证：插件加载、图片显示、编辑与重试、深层分支，以及持久会话的恢复读取。模型回复使用本地测试实现，未调用远程模型服务。
兼容层保留了旧版 events / seedLength 接口支持，并由自动测试覆盖。本版本对应官方 dsh 0.2.0-rc.2。更新插件后请重启 DSH。
可与 dsh-plugin-smooth-stream、dsh-plugin-rollout-scout 共存。
许可
MIT © SpookySandwich。宿主端部分逻辑源自 dsh-message-edit（MIT © Moeblack）。
