会话编辑器 wodebilu/dsh-session-editor

会话编辑器（Session Editor for DSH）

非官方 DeepSeek Harness（DSH）插件，与 DeepSeek 官方无关。

给 DSH 网页端加上会话删除，以及类似 SillyTavern 的“直接改、直接删”对话编辑。

删除是永久的：没有回收站，没有撤销。 删除会把会话日志从磁盘抹掉。如果不确定某个会话是否真的必须删，请先归档：归档只是把会话从侧边栏隐藏，数据仍然保留，随时可以取消归档恢复。

功能

| 操作 | 位置 | 行为 |
| 删除会话 | 会话行 … 菜单 →「永久删除会话…」 | 先解析并校验磁盘路径、归档会话、停止进行中的工作，再把目录从磁盘抹掉。必须先勾选“我已了解，删除后无法恢复”。 |
| 重新生成 | 已完成回答的操作行 | 确认 → 在该轮之前 fork 新会话 → 重发同一提问 → 打开新会话 → 原会话永久删除。 |
| 编辑提问并重发 | 同一操作行 | 确认 + 编辑框 → 用新提问创建新会话 → 原会话永久删除。 |
| 删除此轮及之后 | 同一操作行 | 生成截止到该轮之前的新会话 → 原会话永久删除。 |
| 编辑我的输入 | 悬停在用户消息气泡上 | 复制 / 编辑自己的消息；同样走替换并永久删除的流程。 |

删除，还是归档？

| | 删除 | 归档 |
| 会话数据 | 从磁盘永久移除 | 保留 |
| 能否恢复 | 不能 | 可以（取消归档） |
| 从侧边栏消失 | 是 | 是 |
| 释放磁盘空间 | 是 | 否 |

删除只能由你自己决定。如果目的只是“让它从侧边栏消失”，请用归档——数据还在，删除唯一能换来的只有磁盘空间。

“直接改 / 直接删”是怎么实现的

DSH 的会话日志是 append-only 的，不支持原地改写。所以每次编辑会：

1. 在目标轮之前 fork 一个子会话（标题保持不变）；
2. 需要重发时把提问发进子会话；
3. 打开子会话；
4. 永久删除源会话。

你看到的对话立刻变成修改后的内容，原会话从侧边栏消失。

代价：

- 会话 id 会变，侧边栏那一行被替换（标题保留）；
- 没有可回退的分支历史；
- 只能“从这一轮起”截断，不能“只删中间一条、保留后面”；
- 改文字会重新生成回答，不是纯文本替换；
- 消息里的附件（图片 / 文件）不会跟着重发：日志里存的是附件 id，prompt 接口只收新上传的内容。带附件的消息在编辑时会明确警告并要你再勾一次，而不是默默丢掉。

删除的安全性

插件不会猜一个路径然后直接删。任何状态改变之前，它会：

1. 用 sessionPersistence.stat 读会话头；若还有子代理引用它则拒绝删除（fork 出来的子会话允许存在）；
2. 依次尝试解析磁盘路径：
- harness 若提供后端 locate(header)，先用它；
- 再用 JSONL 后端的 listArtifacts()（带校验的 header → path）；
- 最后在候选根目录（sessionPersistence.root、其 config.root、$DSH_HOME/sessions）下扫描 <root>/<project>/<sessionId>；
3. 校验目录恰好位于某个根目录下一层、不是符号链接、且内部有 session*.jsonl[.zstd]；
4. 若会话在运行，先停止并等待空闲（最多 15 秒，超时则什么都不删；停止需要先归档这一行）；
5. sessionPersistence.flush() 之后，把目录从磁盘抹掉，并删掉该会话的投影缓存（<库>/storages/session_projcache/sessions/<id>.json——日志不是对话的唯一副本：这个缓存里存着标题、首条提问和每轮问答的轮廓）；
6. 归档该会话，让侧边栏立刻移除这一行，不需要重启。

顺序很重要：先删文件、后归档。所以删文件失败会直接报错，不会出现“看不见但文件还在”的情况——运行中的会话为了停下来会先被归档，一旦随后的删除失败，这一行会被取消归档、重新出现在列表里。归档只是把这一行隐藏起来；会话 id 会在 DSH 下次启动、按磁盘重建注册表时自动消失。插件从不写入 workspace.json。

路径解析失败发生在任何状态改变之前，所以找不到路径时原会话完全不受影响。

删除之后没有任何恢复途径。如果可能还想找回这段对话，请取消确认框并改用归档。

环境要求

- 在 DSH 0.2.1-rc.2 上测试。
- Host 半使用公开服务（commands、agents、sessionPersistence、workspaceRegistry），另用两个后端细节定位路径：JSONL 后端的 listArtifacts() 与其 root 字段。两者都做了特性检测；未来 harness 移除它们时会回落到 $DSH_HOME/sessions；全都拿不到时安全失败，不删。
- Client 半使用内部 slot key 与 conversation.chat.user.content 工厂，DSH 升级可能导致失效。
- 无第三方运行时依赖、无网络请求、无遥测。

安装

从 GitHub 安装

1. DSH 左侧 插件 → 添加插件。
2. 粘贴仓库地址：

https://github.com/wodebilu/dsh-session-editor

或 github:wodebilu/dsh-session-editor。
包名与仓库名现在都是 dsh-session-editor。
3. 安装后重启一次 DSH。

不要从 npm 安装 dsh-session-toolkit：那个名字属于另一个插件。

从本地文件夹 / ZIP 安装

1. 下载仓库 ZIP，解压到一个以后不会移动的位置。
2. 在 添加插件 里粘贴解压后文件夹的绝对路径（包含 package.json 的那一层）。
3. 安装并重启 DSH。

文件夹安装是 link: 依赖，装完不能移动或删除该文件夹；Git/tarball 安装会把包复制进 profile，移动安全。

先移除旧的本地版本

早期版本使用过 @local/dsh-session-toolkit 或 dsh-session-toolkit 包名。安装本版本前，先在 插件 → Installed plugins 里移除旧的 bundle，否则两个客户端模块会注册同一批 slot。

使用

- 删除会话：会话行 … →「永久删除会话…」→ 勾选“我已了解”→ 确认。
- 编辑/删除某一轮：悬停在已完成回答下的操作行 → 铅笔 / 垃圾桶 / 循环箭头 → 确认。
- 编辑自己的消息：悬停在用户气泡上 → 复制 / 铅笔。
- 手动删除（在任意其他会话里）：/session-editor delete <sessionId> --confirm。菜单和替换流程走的也是这条命令。
手敲的命令没有对话框可勾选，--confirm 就是这个确认：不带它时命令只回一段用法、不碰任何东西，以免误粘贴一条就删掉会话。

删除命令会作为普通命令行记录。会话删除自己时（替换流程），Host 会等命令生命周期落盘后再抹掉目录。

配置

不需要配置。一个常量刻意固定、不开放：等待运行中会话停止的上限 15 秒。

兼容性与风险

- 替换了用户消息渲染器：插件注册 conversation.chat.node 的 user 键来加悬停操作，并复用官方 conversation.chat.user.content 工厂。DSH 一旦改动该节点契约，用户消息渲染可能受影响，直到插件跟进。
- 依赖内部 API：见“环境要求”。这是社区插件，不是稳定的公开扩展点。
- 无担保：请保留备份。

开发

无需构建，纯 ESM Host 代码 + 浏览器 bundle。

npm test
等价于：
node test/host.test.mjs
node test/client.test.mjs

Host 测试使用临时目录，不会触碰真实会话；它故意不提供 locate()，并断言路径解析失败时不会归档会话。

许可证

MIT，见 LICENSE。