Y
dsh-session-delete
yukre/dsh-session-delete
从侧栏菜单永久删除会话及其对话日志,带二次确认,并拒绝删除正在运行的会话。归档只是隐藏,这个才真正删掉。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
dsh plugin --profile web add github:yukre/dsh-session-deleteREADME
会话删除插件 (dsh-session-delete)
给 DeepSeek Harness 的侧栏会话右键菜单新增一项 「删除会话…」,永久删除该会话及其对话日志。
为什么需要它
DSH 内置的 归档 (Archive) 与真正的 删除 (Delete) 是两件不同的事。归档只往工作区注册表写一个隐藏标记,会话日志一字不动、可随时取消归档恢复。DSH 也没有提供删除单个会话的 API:
SessionPersistence只有create / open / flush / stat / list,没有 deleteWorkspaceRegistry.delete(id)删的是工作区,且注释明确「保留目录与全部会话日志」
本插件补上这个缺口,并与归档严格分开:归档是隐藏,删除是清除。
| 归档(内置) | 删除(本插件) | |
|---|---|---|
| 效果 | 从侧栏隐藏 | 从磁盘移除 |
| 会话日志 | 完整保留 | 永久删除 |
| 可恢复 | 可以 | 不可撤销 |
| 释放磁盘 | 否 | 是 |
使用方法
- 鼠标移到左侧会话列表中的目标会话上,点行尾 「…」 菜单
- 选择 「删除会话…」
- 确认框显示该会话标题,确认后立即删除
安全设计
- 必须在确认框中确认:显示会话标题,并明确提示不可撤销、同时提示"只想隐藏请用归档"
- 运行中的会话禁止删除(
SESSION_RUNNING),避免在日志仍被写入时删除导致损坏 - 当前打开的会话禁止删除(
SESSION_OPEN),避免界面持有已消失的会话 - 会话 ID 白名单校验:只允许单段安全字符,拒绝
..、/、绝对路径 - 路径越界防护:解析后必须仍在会话根目录内
- 同源校验:要求 JSON Content-Type 且 Origin 与 Host 一致,跨站请求被拒
删除的是什么
~/.dsh/sessions/<工作区编码>/<会话ID>/
session.v4.jsonl.zstd 对话日志
session.lock 写入锁文件(无数据)
删除即移除该会话目录。会话列表由扫描该目录树得出,因此删除后无需重建索引;Host 端还会发出 api-session/removed 通知,让侧栏立即移除该行。
安装状态
已作为 bundle 安装进 desktop profile,并写入正式配置(dsh.profile.bundles)。
- Host 端(删除接口):已生效并实测通过
- Client 端(菜单入口):需重启 DeepSeek Harness 后才会出现在浏览器中
验证记录
Host 删除接口在真实运行环境中验证通过(使用独立测试目录,验证后已清理):
| 场景 | 结果 |
|---|---|
| 正常删除测试会话 | ✅ 200 {"ok":true,...},目录已移除 |
| 不存在的会话 | ✅ 409 NOT_FOUND |
| 无 Origin 头 | ✅ 403 BAD_ORIGIN |
| 跨站 Origin | ✅ 403 BAD_ORIGIN |
路径穿越 ../../etc | ✅ 409 BAD_SESSION_ID |
| 非 JSON Content-Type | ✅ 403 |
| GET 方法 | ✅ 405 METHOD_NOT_ALLOWED |
| 运行中会话 | ✅ 409 SESSION_RUNNING,未删除 |
限制
- 删除不可恢复,没有回收站
- 被删会话的附件、worktree 等关联数据不会被连带清理
- 会话级搜索索引可能残留指向已删日志的条目(不影响正常使用)
- 若后端不是 JSONL(Desktop 默认是),本插件不适用
卸载
在插件管理中停用或移除 dsh-session-delete 即可,不影响 DSH 本体,也不影响已归档/未归档的任何会话。