d![]()
dsh-conversation-flow
Manifest valid★ 1DSH Plugin with Chinese Priority: Conversation Rewind / Regenerate (Keep Historical Versions) / Edit and Resend / Delete This Round / Delete Session (with Workspace File Recovery)
UI (client)hasBundlePatch
dsh-conversation-flow
中文优先的 DSH 插件:对话倒带 / 重新生成(保留历史版本)/ 编辑并重发 / 删除本轮 / 删除会话,面向 DeepSeek Harness(DSH)0.2.2-rc.1。
仓库:https://github.com/JadeL-Kemo/dsh-conversation-flow
一个插件覆盖五种能力中的四种;「分支」与「归档」继续用 DSH 原生功能(二者语义不同,不重复实现)。
动作对照
| 动作 | 含义 | 对话 | 文件 |
|---|---|---|---|
| 倒带 ↶ | 回到某条提问之前(问题本身没问好 / 需求写错) | 截断到该提问之前 | 恢复到提问时的状态 |
| 重新生成 ⟳ | 对 AI 产出不满意,重跑一遍 | 截断后用同样的提问重跑 | 不动 |
| 历史版本 ◷ N | 多次重新生成后想对比、挑一个继续 | 只读弹窗列出被隐藏的旧回答;切换版本一律开新分支,旧答案不进当前上下文 | 不动 |
| 编辑并重发 ✎ | 打错字 / 提问本身要改 | 弹窗改完提问后截断重发;可选删除后续、归档为分支或保留文件 | 按选项恢复或保留 |
| 删除本轮 ✕ | 这一轮没有参考价值,不留记录 | 只截断 | 不动 |
| 删除会话(⋯ 菜单) | 整个会话没有价值(测试会话 / 旧分支) | 会话移入回收站,列表消失 | 不动 |
| 分支 | 两条线都满意,分开发展 | DSH 原生「分叉会话」 | 不动 |
| 归档 | 对话完成,存档备用 | DSH 原生「归档会话」 | 不动 |
使用
- 重启 DSH 后:
- 每条用户消息右侧:
↶(倒带)、✎(编辑重发);有历史版本时再加◷ N。 - 每条 AI 回答下方:
⟳(重新生成)、✕(删除本轮)直接出现在回答底部的原生操作条里(复制与分叉图标之间),与原生按钮同尺寸(28×28 按钮、17px 图标)。 - 如果这一问被重新生成/编辑/倒带截断过,
◷ N点开是这一问的历史回答(旧版本只从上下文移除,日志仍保留;弹窗只读,不会把旧回答加进当前对话)。 - 历史回答弹窗里每版都有全文、「复制」和「新建分支并继续」;后者用 DSH 原生 fork 在该回答处开一个新分支会话——切换版本只发生在新分支里,原会话以及它后面的对话保持完整(不会出现「第 5 轮换成第 4 版导致 6-9 轮全部失效」的上下文爆炸)。
- 会话行
⋯菜单底部出现红色「删除会话」。
- 每条用户消息右侧:
- 点击后均有确认弹窗:对话截断是表层 replace(日志 append-only,旧记录仍可审计),被隐藏的消息从界面消失。
✎会打开编辑弹窗,预填原始提问;改完点「重新发送」时三选一:- 删除后续并重发:回退对话并恢复工作区文件(之后的修改丢弃);
- 归档为分支后重发:先用 DSH 原生 fork 把当前会话整段复制成独立分支(保留后续对话可查),主线再回退并恢复文件;
- 保留文件改动后重发:只回退对话上下文,工作区文件保持现状。
- 命令行等价物:
/flow-rewind、/flow-regen、/flow-drop(不带参数列出候选,带@seq或序号执行)。 - 「删除会话」是软删除:会话目录移入
<sessions root>/.sessions-trash/,24 小时内可手工还原(payload 去掉.trash后缀、目录移回原位),超时自动清理。
安装 / 卸载
dsh plugin --profile desktop add file:H:/AgentWorkspace/Other/dsh-conversation-flow
dsh plugin --profile desktop remove dsh-conversation-flow
重启 DSH 后生效。插件自带宿主删除路由(POST /api/dsh-conversation-flow/delete-session),不依赖其它插件。
实现要点
- 对话截断:
Session.append('user/message', marker, {surfaceOp:{op:'replace',startSeq,endSeq}, sourceEventSeqs}),与官方 /compact 同款表层机制;日志 append-only。 - 文件恢复:插件自有的检查点存储(默认
%USERPROFILE%\.dsh\conversation-flow\<sessionId>\):每条用户消息生成一份密集清单,第一次 write/edit 前补录前值;恢复时按目标清单对照实时磁盘原子写/删。单文件上限 8 MiB,保留最近 100 份检查点。 - 删除会话:宿主
sessionPersistence的config.root+ 后端目录布局(<root>/<projectKey>/<encodeSegment(id)>/);先给 canonical payload 加.trash后缀(宿主列表扫描立即不可见),再把目录移入.sessions-trash/并写manifest.json;活动会话仅在宿主提供cancel({kind:'disposed'}) + whenIdle()时先停后删,否则 409 session-busy;同时尽力清理 workspace 记账与投影缓存。 - 客户端:提问侧(↶/✎/◷)用纯 DOM 读取
data-chat-turn行属性 + Host 轮次锚点接口;回答侧(⟳/✕)注册官方conversation.chat.assistant-actions列表 slot,由 turn-tail 的原生操作条渲染在复制与分叉按钮之间;删除项走官方contextMenus注册表(target: 'session')。无构建步骤。 - 重新生成 / 编辑并重发:都是先按倒带方式截断,再用
agent.followup()把同一(或用户改过的)提问作为新回合发出去;旧产出留在 append-only 日志里可审计。 - 历史版本:
GET/POST /api/dsh-conversation-flow/versions把被 rewind 记录遮蔽的assistant/message找回来,并按所属轮次的首条人类提问归组;客户端只显示当前仍可见提问(promptText相同)的历史回答。该接口只读(只读snapshotEvents()与 rewind 记录,不 append、不写会话),弹窗文本也不会进入上下文。切换版本 =sessions.fork({sessionId, atSeq: answerSeq, increaseTitle:true})→uiWorkspace.openSession(childId):一律创建新分支,原会话(含该版本之后的对话)不变。 - 子代理会话(
delegationDepth > 0)不参与检查点与倒带。
已知限制
- 倒带/重新生成/删除本轮只对已打开的会话生效(Host 通过
agents.get(sessionId)找活动 agent)。 - 删除会话只能删宿主启动时已知的会话(
persistence.list()为启动缓存;刚新建、尚未重启的会话可能 404)。 - 删除当前打开的会话会先停止它,界面回到新会话;确认框有提示。
- 历史版本只覆盖本插件截断过的旧回答(原生 DSH 操作不看);同一提问文本出现多次时会归到同一组。
- 「新建分支并继续」会新建分支会话,工作区文件不回滚到旧版本状态;原会话及后续轮次完整保留,不会因切换旧答案而失效。
- 运行中的回合会先被取消;倒带操作不可撤销(只能再倒带回去,日志仍在)。
- 文件恢复只覆盖本会话记录过的工作区文件;工作区之外、超过 8 MiB 或非本地后端的文件不恢复。
- 附件是内容寻址共享存储,删除会话不会删除附件字节。
开发
npm test # node --test tests/plan.test.mjs tests/store.test.mjs tests/delete.test.mjs tests/host-smoke.test.mjs
Comments
Loading…