彻底删除会话 · DSH Session Purge

一个 DeepSeek Harness（DSH）插件：真正删除会话，而不只是从侧边栏移除。

它会清掉会话在磁盘上的转录目录、投影缓存、spill 文件、工作区记账，以及归档/置顶/收藏记录；也能发现并清理此前删除会话后遗留的孤儿目录。

A DSH plugin that permanently removes a session's transcript folder, projection cache, spill files, workspace accounting and archive/pin/favorite records — not just the sidebar entry.

为什么需要它

DSH 自带删除、以及一些会话管理插件（例如 archive-manager）的「永久删除」，通常只移除会话在列表中的记录。删除之后，类似下面的目录仍会留在磁盘上：

~/.dsh/sessions/--Users-you-project--/session-xxxxxxxx-..../   # 对话正文与附件
~/.dsh/storages/session_projcache/sessions/session-xxxxxxxx....json
~/.dsh/storages/workspace.json                                  # 工作区/归档/置顶记账

这些残留会一直占用空间；某些插件还会因为旧索引反复提示“缺少列表缓存 / 重建失败”。本插件就是用来把这些痕迹一起清干净的。

功能

能力	说明
彻底删除	转录目录、投影缓存、spill、工作区记账、归档/置顶/收藏、空项目目录
自动收尾	挂接 api-session/removed 事件和 workspaceRegistry 的删除方法；archive-manager 等插件删除后自动清理残留
运行中可删	先 flush 并从 Host 分离，再删文件；对仍在写盘的会话用 tombstone 反复清除，直到 Agent 结束
工作区视图	设置页按工作区分组，逐会话删除；一级只显示标题、状态、时间、大小
一键删空白	顶部「删除空白会话（N）」一次删除所有空白会话，不用逐个点
安全清理	只识别 DSH 项目目录；拒绝符号链接路径；没有持久化列表时自动停用残留清理
可审计	删除前支持 dry-run；没有磁盘痕迹时返回 missing，不假报成功
子代理保护	默认隐藏 origin: subagent 的委派会话，避免误删正在运行的子任务
子代理残留清理	父会话已消失的子代理孤儿会话会被识别为残留并清理；删除父会话时级联删除其非运行中的子会话

快速安装

要求 DSH 0.2.x、Node.js 18+，并且至少启动过一次 DSH，让 ~/.dsh（Windows 为 %USERPROFILE%\.dsh）和 profile 生成。

1. 打开 Releases，下载最新的 dsh-session-purge-<version>.zip 并解压。
2. 在解压目录执行：

node install.mjs --dry-run   # 先看会改哪个 profile
node install.mjs             # 复制安装

1. 完全退出 DSH（macOS 按 Cmd+Q）再重新打开。
2. 打开 设置 → 彻底删除会话。

安装器会自动定位 $DSH_HOME 和 profile，把插件复制到 <profile>/local-plugins/@local/session-purge，并更新 profile 的依赖与 bundle 配置。更多参数：

node install.mjs --profile web          # 安装到指定 profile
node install.mjs --home /custom/.dsh    # DSH_HOME 不在默认位置
node install.mjs --link                 # 开发模式：直接链接当前源码目录

从源码安装 / 手动安装

git clone https://github.com/EricZhouziRui/dsh-session-purge.git
cd dsh-session-purge
node install.mjs

不想运行脚本时，也可以把仓库复制到 <profile>/local-plugins/@local/session-purge，再在 <profile>/package.json 中加入：

{
  "dependencies": {
    "@local/session-purge": "file:./local-plugins/@local/session-purge"
  },
  "dsh": {
    "profile": {
      "bundles": ["@local/session-purge"]
    }
  }
}

然后重启 DSH。完整步骤和卸载说明见 INSTALL.md。

使用

设置页

打开 设置 → 彻底删除会话：

• 按工作区分组；没有工作区归属的会话和磁盘残留放在最后一组。
• 一级只显示标题、运行中/残留标记、时间和大小；路径、会话 ID、转录目录与痕迹收在每行「详情」里。
• 点「彻底删除」→「确认删除」即永久删除。运行中的会话也可以删，页面会提示刷新后消失。
• 顶部「删除空白会话（N）」可以一次删除所有空白会话；确认框会显示数量和大小。
• 顶部「清理残留」清理孤儿会话目录、过期投影缓存、失效工作区/收藏记录、archive-manager 失效索引和空项目目录。
• 删除或刷新后页面会停留在原来的滚动位置，不会跳回顶部。

模型工具

session_purge({ "action": "list" })
session_purge({ "action": "purge", "sessionIds": ["session-xxxx"], "dryRun": true })
session_purge({ "action": "cleanup" })
session_purge({ "action": "reconcile", "sessionIds": ["session-xxxx"] })

自动挂接其他删除入口

安装后不需要每次打开本插件。它会：

• 监听官方 api-session/removed；
• 包装 workspaceRegistry 上的 deleteSession / deleteArchivedSessions / cleanOrphanSubagents / deleteSessionCore / publishDeletedSession 等删除方法；
• 对方声明删除后等待约 0.9 秒，确认会话已不在持久化列表中，再清理残留；
• 普通关闭/Agent 释放也会触发事件，但会话仍在列表中，会被安全跳过。

设置页顶部的「自动收尾」状态行可确认是否已挂接、最近一次处理的会话和结果。

自动更新

设置页会检查 GitHub 上的最新 Release：

• 有新版本时显示「更新到 vX」，点击后下载文件、逐个校验 SHA-256，再替换 profile 里的安装副本；
• 版本号不变但发布内容被修复时，会显示「修复安装 vX」，同样一键重新下载替换；
• 更新完成后完全退出并重新打开 DSH 生效；
• 旧版本会保留为 .backup-<timestamp>，便于回滚；
• 只支持复制安装；--link/源码安装请用 git pull + node install.mjs，避免更新器改写开发中的源码。

安全边界

• 删除不可恢复。删除前请确认标题与路径；建议先 dryRun。
• 只删除满足 <sessionsRoot>/<project>/<session-id> 结构、且整条路径不经过符号链接的目录。
• sessions/ 下不是 --<encoded-cwd>-- / _no-cwd 的目录不会被当成 DSH 项目。
• 没有磁盘痕迹、又不在持久化列表里的目标返回 missing，不会假装删除成功。
• 清理孤儿目录时跳过创建不足 60 秒的会话目录，避免误删正在生成的新会话。
• 子代理孤儿会话只有在其父会话（沿 parentSession 链）已不存在时才会被清理；父会话仍在的子代理一律保留。
• 读取不到会话持久化列表时，「清理残留」主动停用，避免把正常会话误判为孤儿。
• 更新文件来自本仓库公开 Release，并逐文件校验哈希；不会执行远程脚本。
• 不删除附件二进制对象、费用统计、模型凭据。

卸载

1. 从 <profile>/package.json 的 dsh.profile.bundles 与 dependencies 中移除 @local/session-purge；
2. 删除 <profile>/local-plugins/@local/session-purge 和 <profile>/node_modules/@local/session-purge；
3. 重启 DSH。

卸载插件不会删除会话数据本身。

开发与测试

node --test test/*.test.mjs
node --check engine.js index.js client.js update.js

测试覆盖引擎扫描/删除、符号链接与路径穿越、工作区记账、archive-manager 索引清理、运行中会话、自动挂接、客户端冷启动 slot 注册、一键删除空白会话、滚动位置保持、自更新和安装器行为。CI 还会重新生成 update-manifest.json 并检查是否有 diff，防止发布旧清单。

发布新版本

1. 修改 package.json 里的 version，在 README 功能表里补充变更（可选）。
2. 运行 npm run manifest 重新生成 update-manifest.json（脚本对文本按 LF 规范化后再计算哈希，Windows 的 CRLF 检出也能得到和 GitHub 一致的结果）。
3. 提交并推送 main，再打同名 tag（例如 v0.1.3）并推送 tag。
4. 从 tag 生成 Release 资源：

git archive --format=zip --prefix=dsh-session-purge/ -o dsh-session-purge-<version>.zip v<version>
sha256sum dsh-session-purge-<version>.zip > SHA256SUMS-<version>.txt
gh release create v<version> dsh-session-purge-<version>.zip SHA256SUMS-<version>.txt --title v<version> --notes-file NOTES.md

注意：0.1.2 及更早的已安装版本只按 Release 的 tag 版本号判断更新（没有内容漂移检测）。所以「原地修复发布内容」老用户看不到，必须提升版本号再发 Release，老用户才能在设置页里一键更新。

目录：

index.js            Host 半：HTTP API + session_purge 工具 + 自动挂接
engine.js           纯 Node 扫描/删除引擎（不依赖 Cordis）
update.js           GitHub Release 检查、哈希校验与安装副本替换
client.js           Web 设置页（settings.section）
cordis.patch.yml    bundle 默认补丁
test/               单元、边界、集成测试
install.mjs         本地安装器
scripts/            update-manifest.json 生成脚本

License

MIT