架构。 浏览器半部分以官方用户消息渲染器的视觉克隆(conversation.chat.node 槽位、key user 与 steering、priority -1)替换默认渲染并新增操作行,同时注册四个 ConversationNodeDefinition:撤回投影为可展开的「已撤回 N 条消息」分隔线(N = 区间隐藏的用户可见消息数),编辑替换投影为带「已编辑」徽标的原位气泡,恢复条目投影为「已恢复」组里的重放行。Host 半部分是 messageTools Typert Remote 服务(withdraw / edit / restore);客户端经 ctx.remote.$mount 自行挂载生成的 Remote contribution,无需改动任何核心包。

编辑即原位替换:host 追加一条 user/message replacement,其内容就是编辑后的新文本(区间覆盖目标消息及 surface 尾部——编辑旧消息就是放弃其后的一切),随后经 agent.followup 投递一条极简插件来源触发消息启动重新生成。模型上下文里新文本只出现一次;旧内容留在日志里作审计。会话有运行中的轮次时先取消它并等待完全落定——落定指被取消轮次的收尾(工具结果、turn/end)全部落盘,而不是 running 翻转;等待有界,迟迟不落定的轮次以「编辑失败」拒绝,取消失败则不编辑。支持编辑链:已编辑气泡可再次编辑,目标是上一个 replacement 的 seq。编辑框的模型 chip 与 composer、/model 弹层共享按会话的 ModelDirectory(ctx.get('modelDirectories'),可选服务)——组合里没有 ui-model-selection 就不渲染 chip——切换经 host 校验后作用于重新生成的轮次。

撤回是真撤回,不是打标记:host 追加一条 user/message surface replacement(与 compaction 同一机制),区间覆盖目标消息及之后的所有 surface 节点,该区间由此离开 session.surface,不再进入模型上下文;与编辑同款的 cancel-and-settle 编排保证流式内容不会落到 replacement 之后。事件为插件来源,sourceEventSeqs 引用每一个被遮蔽节点,方法返回前经 SessionStore.flush 落盘——它本身就是审计轨迹。不引入新事件类型:harness 之外的类型无法携带 ignorable: true,持久化的未知类型会让 session-persistence 重载时拒绝整个日志。撤回成功后把目标原文回填到 composer 草稿(空草稿直接填入、非空换行追加、落 info 提示)——绝不自动发送,失败则不回填;编辑路径不触发回填。

投影与隐藏。 插件的 Definition 把 replacement 认领为锚定在其 seq 上的分隔线节点。隐藏分两层:被遮蔽的用户渲染器对区间内用户消息渲染为空;一张动态样式表把 data-chat-flow-key(ChatNodeSeat.tsx)锚点落在区间内的聊天行一律隐藏,覆盖助手步骤、工具调用、turn 尾部。隐藏器在首个非空规则集探测这个未文档化属性,探测落空进入有界重试(MutationObserver 加截止时限),避免聊天区尚未挂载时误停用;只有窗口耗尽仍探不到行才停用——console.warn 一次,退化为仅渲染器隐藏——且 observer 在停用后仍存活,行晚到会重新生效,绝不报错。分隔线可就地展开只读回放撤回区间(用户原文加助手文本,从实时节点存储折叠)并提供「恢复到对话末尾」;行已掉出加载窗口的区间显示「撤回的内容不在当前已加载的历史中」。

恢复是整个被撤回区间的尾部重放,不是原位修复:surface 折叠是位置性的——被替换区间只接续成一个节点(applySurfacePlan)——区间无法回到模型上下文原位,其模型侧隐藏也永不回退。host 沿撤回 replacement 自身划定的日志区间 [start, seq) 把可重放内容按原始顺序逐条追加到尾部:用户消息逐字重放(编辑替换的内容就是最后一次编辑的新文本,恢复时即以此为准),每条助手回复的文本以带框架的插件来源用户消息重放——assistant/message 无法携带插件来源,且轨迹不允许在 step 之外追加助手消息,因此角色保真由框架 (以下是先前被撤回、现随恢复放回的助手回复) 承担,UI 上不显示该框架。未落成 assistant/message 的中断步骤从其 assistant/chunk 片段合并重放(只有 reasoning 时保留 reasoning)。工具调用/结果永不重放:配对无法重新进入,副作用不可重放。重放行渲染为「已恢复」组——用户气泡带完整操作行,助手文本走官方 MarkdownText——分隔线在存在引用该区间的存活恢复行期间显示「已恢复」徽标;再次撤回这些恢复行会清掉徽标并重新启用恢复操作(恢复事件始终留在日志里)。

为什么投影层做不到(彻底修复所需的上游 seam)。 组装器对每个事件运行所有已注册 Definition 的 match,没有否决机制(conversation-assembler.ts:370),且 match(event) 只能读当前事件;被遮蔽事件在日志里仍保持 surfaceOp: 'append'(区间元数据只存在于 replacement 自身),因此依然命中各内置 Definition——内置 Definition 排除的是 replacement 事件,不是被遮蔽事件。节点的 visibility 只能由产出它的 Definition 设置,组装器禁止把已物化节点撤回为 null,节点 key 又与其 Definition 的 kind 绑定——插件既无法翻转也无法冒充官方节点。遮蔽其余 conversation.chat.node key 同样行不通:官方组件没有导出,command/turn-tail/tool-call 声明了子槽位而遮蔽无法重复声明(tool-call 还持有 key 空间无界的按工具名 keyed 的 tool.call.toolview 槽位)。官方 compaction 流水线在设计上就做了同样选择——被替换的区间保留在 transcript 里。

模型体验。

• 编辑替换——模型读到编辑后的文本,原消息之后的内容全部消失;其后跟一条短触发消息((用户编辑了上一条消息，请按编辑后的内容重新回答))。Token 影响:被遮蔽区间的全部 token 离开后续请求,新增编辑后消息与触发消息。KV Cache:prompt 前缀从编辑点失效。
• 撤回替换——区间被一条占位消息((用户撤回了这条消息及其后的所有内容))取代。Token 影响:区间的全部 token 离开,只新增一条短消息。KV Cache:前缀从替换点失效——取舍与 compaction 相同;撤回越早的消息,失效的缓存前缀越多。
• 恢复重放——区间的可重放内容(用户消息逐字、助手文本带框架)按原始顺序追加到尾部,插件标记并引用原事件;工具调用/结果的 token 不进入。KV Cache:不超出普通尾部追加的范围。

导出。 /client 导出插件本体(apply/inject)与 MessageToolsRemote 类型;host 侧导出 MessageToolsService 类,/types 子路径提供线上类型。