会话备份删除 device1999/dsh-session-archive-delete

dsh-session-archive-delete

给 DeepSeek Harness（DSH）的会话列表加一个安全的「删除」入口：先完整备份到本地，校验通过后才删除。

装上之后，在侧栏任意会话的「…」菜单最下方会多出删除选项：

为什么需要它

DSH 只有「归档」，没有删除。想真正释放磁盘空间，就得手动去找 ~/.dsh/sessions/<工作区>/<uuid>/ 删目录，同时还要手动清理 workspace.json 和投影缓存——漏一步，侧栏就会留下点不开的空壳会话。

本插件把这件事做成一条安全的流水线：

确认 → 复制会话目录 + 缓存 + 元数据快照 → 逐文件校验 → 删除原件 → 清理账本

任何一步失败都会中止，原会话保持完好。

功能

| 功能 | 说明 |
| 备份删除 | 把会话完整备份到指定文件夹，校验通过后再删 |
| 彻底删除 | 不备份，直接删除 |
| 两种模式并存 | 菜单可同时显示两个选项，也可只显示其一 |
| 子代理会话 | 自动找出该会话派生的所有子代理，一起备份、一起删除 |
| 自定义备份位置 | 系统文件夹对话框选择，或直接输入路径 |
| 四种命名方式 | 日期+主题 / ID前八位+主题 / 纯主题 / 前八位+主题+日期 |
| 路径校验 | 无效路径当场提示，不会写入设置 |
| 一键恢复 | 每个备份文件夹带 RESTORE.txt，按说明复制回去即可 |

安装

方式一：在 DSH 界面里装（推荐）

左侧栏 插件 → 右上角 添加插件 → 输入包名安装：

@device1999/dsh-session-archive-delete

装完重启 DSH。

方式二：命令行

dsh plugin --profile <profile> add @device1999/dsh-session-archive-delete

<profile> 通常是 desktop 或 web，可在 ~/.dsh/profiles/ 下看到。

方式三：从源码本地开发

git clone https://github.com/device1999/dsh-session-archive-delete.git
dsh plugin --profile desktop add file:/path/to/dsh-session-archive-delete

或在 profile 的 package.json 里写 link: 依赖，然后在 node_modules 里建一个指向源码目录的 junction（Windows）或 symlink（macOS / Linux）。

使用

删除一个会话

1. 侧栏会话行点「…」
2. 选「备份删除」或「彻底删除」
3. 确认框里核对会话名、ID 和备份路径
4. 点「确认」

删除成功后侧栏会立即刷新；如果删的是当前会话，会自动跳到下一个。

设置

设置 → 备份删除：

| 设置项 | 选项 |
| 删除模式 | 两个菜单项同时显示 / 只显示「备份删除」/ 只显示「彻底删除」 |
| 备份位置 | 点击选择文件夹，或直接编辑地址栏；留空 = 默认位置 |
| 备份文件夹命名 | 四种格式任选 |

设置保存在 ~/.dsh/dsh-session-archive-delete.json。

默认备份位置

按以下优先级确定：

1. 设置里填写的路径
2. 环境变量 DSH_ARCHIVE_ROOT
3. 插件配置 workspaceRoot
4. 自动推断：从会话记录里选出使用最多的工作区目录
5. 都拿不到时：<用户主目录>/DSH-归档会话

备份位置不能设在 ~/.dsh 内部，否则 DSH 会把它当成数据目录重新扫描。

备份结构

<备份位置>/<按命名规则生成的文件夹>/ sessions/<工作区目录>/<会话id>/ 会话原始文件（保留原名） projcache/<会话id>.json 界面投影缓存 meta/workspace.json 删除前的元数据快照 meta/session_projcache.json manifest.json 清单：完整 id、标题、大小、子代理列表 RESTORE.txt 恢复步骤

子代理会话也备份在同一个文件夹的 sessions/ 下，清单里列在 subagents 字段。

恢复一个会话

详见每个备份文件夹里的 RESTORE.txt，大意是：

1. 完全退出 DSH
2. 把 sessions/<工作区>/<会话id> 复制回 ~/.dsh/sessions/<工作区>/
3. 把 projcache/<会话id>.json 复制回 ~/.dsh/storages/session_projcache/sessions/
4. 在 ~/.dsh/storages/workspace.json 里把会话 id 加回对应工作区的 sessionIds
5. 启动 DSH

安全性

- 不删未校验的内容：复制后逐文件比对大小与数量，不一致就中止
- 删前先摘账本：先把引用从 workspace.json 移除并落盘，再删文件，避免 DSH 内存状态把引用写回
- 删后复查：目录删除后检查 3 次，防止文件句柄重建目录
- 路径边界校验：会话目录必须位于 ~/.dsh/sessions 下，且目录名与会话 id 完全一致
- 运行中会话：先取消当前轮次再删除，不会留下半截日志

系统要求

- DSH 0.2.x（Web / 桌面客户端）
- Windows / macOS / Linux
- 系统文件夹对话框依赖 PowerShell 7（Windows）。没有 pwsh 时会自动回退到页面内目录浏览

已知限制

- 默认备份位置依赖宿主提供的 sessionQuery 服务来推断工作区；取不到时回退到用户主目录
- 子代理关系来自会话 header 的 parentSession 字段，会话文件是 zstd 压缩，无法纯读盘解析
- 备份是完整复制，大会话会占用相应磁盘空间

卸载

dsh plugin --profile <profile> remove dsh-session-archive-delete

重启 DSH。已生成的备份文件夹不会被删除，可按需自行清理。

License

MIT