dsh-chat-editor-plus

DeepSeek Harness 消息编辑器：改写 / 删除 / 折叠任意一条消息，或从任意一轮之前分叉会话。 本仓库是 WZZNNE/DSH-CyberWorkStation 中 plugins/dsh-chat-editor（MIT）针对 DSH 桌面端 0.2.1-rc.2 的二次开发版本。

An edited fork of dsh-chat-editor from DSH-CyberWorkStation, adapted for the DeepSeek Harness desktop client 0.2.1-rc.2. Same features, same MIT license.

适配范围：实测可用 DSH 桌面端 0.2.1-rc.2；package.json 的 engines.dsh 声明为 >=0.2.1-rc.2 <0.3.0（覆盖 0.2.x 全部正式版与预发布版，不含 0.2.1-rc.2 之前与 0.3.0 及以后； 0.2.2 及以上尚未实测）。安装与启动时由插件管理器校验，不满足会拒绝加载，详见适配范围。

Supported range: verified against DSH desktop 0.2.1-rc.2; engines.dsh is >=0.2.1-rc.2 <0.3.0 (all 0.2.x releases and prereleases). Checked by the plugin manager before install and at startup; see adapter range.

功能

• 会话头部 ✎ 按钮打开消息面板：列出整段会话（用户、助手、注入上下文、工具结果、压缩摘要）；
• 每条完成的助手消息旁边有内联 ✎，直接定位到那条；
• 工具结果也可改：面板里工具结果行的「改」走上下文投影，只替换内容块，toolCallId / source / 配对关系全部不动，模型会把改后的文本当成工具的原始返回；
• 三种模式，按操作选择：
  • 显示（display）：只改你看到的内容，日志与模型上下文不动（$DSH_HOME/chat-edits.json）；
  • 上下文（context）：改模型真正收到的东西。用户消息的改写、助手回复的改写、工具结果内容的改写、以及任意删除 都走核心的消息投影（registerMessageProjection + plugin:chat-editor-plus/rewrite 记录， 由 appendPluginRecord 写入）：模型侧 deriveMessages() 看到的就是新文本，删除则整条消失—— surface 节点、seq、messageId 全部保持不变，没有占位符，也没有「用户更正了回复」之类的前缀。 改助手回复时，文本块原位替换，role / id / source 不变；thinking 默认原样保留，也可以在同一个编辑框里 一起改（编辑助手消息时会多出一个「思考」输入框）。改思考只替换 reasoning 块的 text，replay 签名保持不变—— 实测 DeepSeek Messages 端不校验「签名 ↔ 思考文本」的一致性，核心的 replay 校验也只比较块数量与类型， 所以签名照发即可。原文仍在日志里：改写可以再改成原文本撤销， 删除在面板里没有撤销按钮（模型那份已经没了，日志里仍然保留原文）。
  • 分叉（fork）：在该轮之前复制会话（ctx.agents.create({ seed }) + 工作区挂接），可选把编辑文本作为分叉后的第一条消息。
• 折叠只影响显示，点一下展开。

与原版的差异（桌面端适配）

改动	原因
客户端改用 useChat 读会话节点（保留旧字段回退）	原版读 useSession(s => s.chat.nodes)，SessionSnapshot 从来没有 chat 字段——在 0.1.5 和 0.2.1 上这段都是死的，导致显示层的改/藏/折叠永远不生效
DOM 行锚点优先读 data-chat-node-key	0.2.x 的推理分组行 data-chat-flow-key 是 JSON 编码的渲染 key，不再等于节点 key
删掉 kind === 'tool' 分支	0.2.x 的 chat node 没有 tool 这种 kind（工具结果在 turn-process / assistant-step 的 data 里）
助手改写改用消息投影：文本块原位替换，保留 thinking 与签名	原来只能落成带前缀的 user 更正节点，模型一眼看穿；投影按 seq 换 message，角色/id/来源不变
思考（thinking）可在面板里改：只换 reasoning 文本，签名照旧	核心只校验块数量/类型，端点不校验签名与文本，所以改思考不需要重新生成
思考（thinking）改完后，折叠摘要与展开正文同步显示新文本	记录同时驱动模型请求和你的界面，两边不再各说各话；按原生紧凑行距呈现，字面 \n 归一成换行
工具结果内容可改（只动 content 块，toolCallId/source 不变）	核心自己的 surface 替换也规定 tool/result 只允许改 content，说明这是受支持的操作；投影路径不需要额外占位
用户改写 / 删除改用消息投影（lib/projection.js）	surface replace 必须插入一个节点、且助手消息不能以助手身份被替换；投影不挪节点、可删除、可撤销
删除助手消息时级联删除它发起的工具结果	请求里不能出现「调用过但没返回」的 call；单独删工具结果会被拒绝
dsh-cyberworkstation-kit 的两个文件 vendored 进 lib/kit/	该包只存在于原仓库、未发布 npm，桌面端 profile 无法解析
包名 / 插件 id / 路由 / 槽位 id 加 -plus	可与原版并存安装，互不抢路由和 slot
补 LICENSE、README、仓库元数据	MIT 义务 + 区分上游
编辑后的正文原位替换消息气泡里的文本节点	旧做法隐藏整行再插一个裸 div，气泡样式、对齐和行内时间都不见了；现在只换文字，气泡与动作栏保持原生渲染
去掉 window.confirm 确认框	桌面端把原生确认框画成与主题不匹配的系统对话框；面板行本身已写明操作后果

安装（桌面端）

DSH 桌面端没有 dsh CLI 在 PATH 上，用自带的那份：

# 把本仓库放到任意目录，例如 D:\workplace\dsh-chat-editor-plus
D:\dsh\resources\runtime\cli\bin\dsh.cmd plugin --profile desktop add file:D:\workplace\dsh-chat-editor-plus

也可以走应用内「插件管理器」：本地路径安装，装完会自动把包登记进 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles（因为本包声明了 dsh.bundle.patch）。 装好后重启桌面端，会话头部就会出现 ✎。

适配范围

• DSH 运行时：>=0.2.1-rc.2 <0.3.0（声明在 package.json 的 engines.dsh）。 桌面端在导入插件前会拿它和运行时版本做兼容性检查：不满足时安装/启动会被拒绝， 可用 dsh plugin allow-version <package@version> --dsh-version <runtime> --accept-risk 逐版本豁免。 该范围覆盖 0.2.x 的全部正式版与预发布版，不包含 0.2.1-rc.2 之前的版本和 0.3.0 及以后。
• 为什么不支持更早的版本：0.1.5-rc.2 的核心只有一个同名不同义的 session-projection——那是面向客户端的 日志派生状态注册表（todo / goal / 统计等），没有消息投影需要的 registerMessageProjection 与 appendPluginRecord。缺这两个 API 时，上下文改写/删除只能退回 surface replace（助手消息无法以助手身份替换、 删除必须留一个占位节点），也就是本插件最早那版的行为。0.2.0 未验证。
• 实测环境：DSH 桌面端 0.2.1-rc.2（Windows x64），profile desktop；0.2.2 及以上未验证。
• 依赖的核心契约（按 0.2.1-rc.2 逐个核对）：SessionStore.registerMessageProjection、 appendPluginRecord、Session.surface / deriveMessages / snapshotEvents / eventAt / flush、webServer.register({kind:'prefix'})、ctx.agents.get/create/resume、 agent.runMaintenance / send / status、agentPresets.resolve/mount、 workspaceRegistry.list/attachSession、tokenMeter.estimateMessage、 toolPairingBalancedBefore/After、llm.createUserMessage。 其中投影契约（project(event, {events, baseSeq, messages, nodes}) 的形状、投影被移除时的 fail-closed 行为） 一旦变化，本插件需要同步适配。
• 依赖包：@deepseek-ai/dsh-home-paths（必需，进程启动时读取）、@deepseek-ai/dsh-session （改写/删除必需，运行时加载）；@deepseek-ai/dsh-llm、@deepseek-ai/dsh-compaction 为可选 （只影响 fork 的首条消息与 token 估算，缺失时相应功能返回 503）。

要求

见上一节 适配范围：运行时要求已写进 engines.dsh，安装与启动时由插件管理器校验； 必需的核心包与可选 peer 也都在那一节列出。

已知限制

• 改的是「模型看到的那一份」，不是全库替换：删除或改写一条消息，不会顺带清理其他消息里对它的引用。 最常见的坑是保留下来的助手消息的 thinking ——它可能原样写着被删内容（实测过：删掉一轮问答后， 模型仍能从另一条回复的 thinking 里说出被删的字符串）。要彻底无痕，得把引用它的思考也一起改掉。
• thinking 的块结构不能变：只能替换已有 reasoning 块的文本，不能新增或删除 thinking 块。 核心的 replay 校验要求块数量与类型和记录的 replayState 一一对应，多一个或少一个都会让签名降级。 同理，只发起了工具调用的助手步骤不能补正文（会多出 text 块），只能改它的思考。
• 改思考后界面同步显示：折叠摘要与展开正文都会换成新文本，但按原生紧凑行距呈现——原生的空行分段 会被压成单行换行；发给模型的仍是你在输入框里写的那份文本。
• token meter 仍按原文计费，不统计投影后的文本；压缩摘要则按投影后的文本。
• 旧版本写入的「助手更正节点」是真实 user 消息（带 [The user corrected …] 前缀），新代码不会追溯改写它； 在面板里重新编辑一次即可改为投影记录。
• 上下文模式要求会话空闲（agent 未在生成），否则返回 409；子代理会话只读。
• 运行中卸载插件时，已经用过投影的活跃会话会在下一次请求前报 session message projection "…" was removed or replaced（核心 fail-closed：不能在缺少解释器时继续沿用 缓存消息，否则模型会突然看到未改写/未删除的原文）。这不是日志损坏：重启一次即可恢复， 冷重放会把 plugin: 记录当作不可解释事件跳过，会话正常打开，但改写/删除的效果随之消失。 要长期保留效果，就别卸插件，或用后续的 projection-only companion 包。

License

MIT。原始版权：Copyright (c) 2026 DSH Suite contributors（DSH-CyberWorkStation）； 本仓库修改部分：Copyright (c) 2026 rumengyihua。详见 LICENSE。