dsh-tool-session-delete
English | 中文
DeepSeek Harness (DSH) 侧边栏永久彻底删除会话插件，并在删除前提供详尽的状态与日志占用确认弹窗。
DSH 原生自带的「归档」（Archive）是可逆操作，会将记录保存在归档列表中。本插件为侧边栏补充了彻底删除功能。与普通的 rm 删除日志不同，本插件深入解绑内存活体与注册表，真正让已删会话从侧边栏与磁盘中永久消失，杜绝复活与死锁。
功能特点
在左侧边栏每个会话条目的 … 菜单中增加一项 「删除会话」（排序在置顶 / 重命名 / 分叉 / 归档之后）。点击后会弹出确认模态框，详细展示：
- 该会话是否仍在本机处于打开/驻留状态（删除后无法再打开或恢复）；
- 即将被移除的磁盘日志实际大小；
- 绑定到该会话的进行中轮次（turns）、子智能体（subagents）、后台任务（jobs）与定时提醒（schedules）；
- 会一并删除多少个绑定的定时提醒。
点击「永久删除」后，系统会平稳停止会话工作，删除其会话磁盘目录与投影快照缓存（session_projcache），并从所有活跃与持久化注册表中释放该 ID。随后侧边栏平滑刷新，会话条目彻底消失。
操作不可逆，且不会放入回收站。
为什么不仅是简单的 rm
在 DSH 中，会话不仅仅是由磁盘上的目录定义的。Host 端的会话池是由 persistence ∪ live（持久化数据与内存活跃实例的并集）构成的。因此，如果仅在磁盘上删除了文件，Host 内存中仍然驻留该会话的活跃实例，它就会在刷新时“死而复生”：
- 浏览器临时移除了该条目；
- 随后的
sessions.refresh()从 Host 重新拉取会话列表，并将内存活跃实例折叠回列表中； - 已删条目再次复活。
这导致的典型现象是：连续删除多个会话时，先前删除的会话会重新冒出；或者被删除的会话 ID 永久堆积在 workspace.json 的归档列表中成为死引用。
本插件的 release() 严格遵循宿主 Fiber 的解绑顺序：
- 先解绑 Agents，再解绑 Sessions（防止 agent/disposed 意外反向重新广播 api-session/added）；
- 从工作区归档集合中调用 unarchiveSession(id) 并解除置顶 unpinSession(id)；
- 从当前工作区调用 workspace.detachSession(id)；
- 针对 Windows 文件锁与反病毒软件扫描，内置退避重试（rmWithRetry）与延迟落盘缓冲（STOP_SETTLE_MS），杜绝 EBUSY / EPERM 报错。
浏览器端同时维护 retired 集合，在每次列表刷新后自动补全移除，确保界面平滑、零复活、零闪烁。
安装指南
本插件遵循标准的 dsh.bundle 清单规范，dsh plugin 会自动将其装载为 profile 层，无需手动修改 cordis.patch.yml。宿主会自动解析所需的 @deepseek-ai/* 依赖，因此本插件自身为 0 运行时依赖。
# 推荐：通过 DSH 插件命令安装
dsh plugin --profile web add dsh-tool-session-delete
# 或通过 npm / pnpm 安装
npm install dsh-tool-session-delete
pnpm add dsh-tool-session-delete
若是本地源码调试，也可使用 file: 路径：
dsh plugin --profile web add file:/path/to/dsh-tool-session-delete
验证插件是否已成功合入配置树（必须出现在插件自带的 banner 标识下方）：
dsh --profile --dump-config | grep -B1 tool-session-delete
# == …/dsh-tool-session-delete/cordis.patch.yml
- id: tool-session-delete
name: dsh-tool-session-delete
最后重启 Harness：
dsh web
设计亮点
- 采用 Typert
Remote原生 RPC 协议，而非 HTTP 路由：Host 端注册为sessionDelete远程服务（提供describe与deleteSession接口）。Gateway 自动声明并通过/apiWebSocket RPC 信道通信。因此天然适配 Web 与 Electron 桌面客户端，绝不会因 Origin 拦截报 403 权限错误。 - 磁盘物理删除实测探测：删除目录后，插件会主动通过
stat验证文件是否确实已从磁盘消失。若遇 Windows 文件占用等导致删除失败，会显式向前端抛出提示，绝不假装成功。 - 投影缓存同步清理：除删除会话目录外，还会一并清除
storageDomain("session_projcache")中的快照，不留任何脏数据。
多语言支持
插件内部自带完整的简体中文（zh）与英文（en）双语字典，语言会跟随 DSH 客户端界面设置自动切换，开箱即用。
许可证
MIT © Jaylor-Wang
