DSH Plugins
返回列表
🖥️

dsh-session-purge

客户端 更新于 2026.10.24

在终端中运行以下命令:

dsh plugin install DEVVE-1/dsh-session-purge

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中运行 dsh plugin install DEVVE-1/dsh-session-purge,或从开源地址 https://github.com/DEVVE-1/dsh-session-purge 安装该插件。

插件介绍

在 DeepSeek Harness 里,会话被删掉之后往往并没有真正离开:磁盘上的会话目录、投影缓存记录、工作区记账里的引用、进程内仍被持有的活条目,乃至全文索引中的残留,都可能继续留着。于是用户会看到删掉的会话仍然出现在左侧边栏,点进去内容还在,必须重启才能消失,而 workspace.json 等记录也会一直脏着。

dsh-session-purge 就是为解决这个问题而生的。它给会话列表的右键菜单和行内「⋯」菜单各加一个「删除会话」入口,二次确认后,会先把目标会话的活条目与 Agent 从注册表里摘掉,再依次清理会话目录、投影缓存记录、工作区里的 sessionIds / pinned / archived 引用,并主动触发一次全文索引对账。附件和派生图片缓存因为属于多会话共享,被有意跳过,避免误伤其它会话。删除完成后浏览器只刷新会话列表,内置逻辑会自动挑选下一个主视图会话,只有在主视图仍引用那一行时才退回整页刷新兜底。

安全边界方面,会话 id 要先通过正则校验并映射成单个路径段,删除前还会断言目标确实是会话根目录下的一级目录,杜绝路径穿越与通配删除。插件不拿「运行时还持有这个 Agent」作为拒绝条件,因为 Agent 注册表会把打开过的会话一直留到进程结束;真正拦住删除的是「还有工作在跑」,这时走与归档相同的停止通道,等它清空再删,停不干净就报错且不动文件。活会话的写句柄异步收尾可能再落一次盘,所以删完文件后采用自适应复查,默认每 40ms 探一次会话目录,连续两轮干净即收工,总预算 1.5s 兜底。Host 侧只在 webServer 上注册一条固定路径,并要求 POST、JSON 请求体、Host 为回环地址、Origin 与 Host 同源、Sec-Fetch-Site 非跨站。

这个插件适合长期使用 DeepSeek Harness、会积累大量临时会话、希望随手清理而不必重启应用的用户,也适合关心磁盘与索引整洁、需要确保删除动作不波及其它会话的维护者。

使用场景

  • 会话删除后重启才消失,需要彻底清理它的持久化痕迹。
  • 会积累大量临时会话,想随手删除且不波及其他会话。
  • 工作区记账与全文索引有残留,需要一并整理干净。

适合人员

  • 长期使用 DeepSeek Harness 的日常用户。
  • 关注磁盘与索引整洁的维护者。
  • 需要安全清理会话的团队管理员。