dsh-session-purge
Verifieddsh-session-purge · v0.5.8 · MIT · Web UI
A recycle bin for DSH session deletion: deleting a session moves it to a bin where it can be restored, and space is reclaimed on permanent delete or on a retention schedule.
Install
dsh plugin add dsh-session-purge Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-session-purge
给 DeepSeek Harness (DSH) 的会话删除加一个回收站:删除不再不可恢复,而是把会话原样移入 回收站,可以随时复原、也可以真实删除;回收站不会无限增长——默认保留 30 天,到期自动清理。
上游的「归档」只是把会话从默认列表里藏起来,日志永远留在磁盘上;这个插件管的是删除, 而且把「删掉」和「腾出磁盘」拆成了两件事:前者随时可逆,后者交给按时间的自动清理。
版本与逐版变更见 CHANGELOG.md;npm 上的最新版本见上方 badge。
功能一览
- 会话行菜单:
⋯→ 移入回收站(原来的「删除会话」)。带二次确认,运行中的会话会被拒绝。 - 侧边栏「工作区」行(图标形态):搜索 / 视图选项 / 添加工作区 之后的第 4 个图标——回收站。 点开是面板:列出全部已删除会话(标题、原目录、删除时间、大小、会话 id),每条都能 复原或真实删除,底部还有清空回收站与自动清理策略。
- 也可以放到顶部文字菜单:设置里的「入口位置」选菜单,回收站就变成与 插件 / 自动化任务并列的一行,点开是整页:行更宽、信息分三层(标题 / 元信息 / 完整会话 id),适合逐条比对;默认仍是图标 + 弹窗。两种形态随时切换,立即生效。
- 账号菜单 → 设置 → 回收站(0.2.1 起;旧版是侧边栏「设置」按钮):导航项带垃圾桶图标; 入口位置、自动清理开关、保留时长(7/30/90/365 天 / 永久)、启动时清理一次、清理周期(1–168 小时)、 回收站用量统计、立即清理、打开回收站;页脚显示当前版本并在有新版本时提示。
- 默认策略:自动清理开、保留 30 天、每次启动 + 每 6 小时各扫一次。改完立即生效,不用重启。
安装
# npm(推荐)
dsh plugin --profile web add dsh-session-purge
# GitHub 仓库
dsh plugin --profile web add github:verdana/dsh-session-purge
# Release 预构建 tarball(免构建授权)
dsh plugin --profile web add <release-tarball-url>
装完重启 dsh web(Host 侧插件只在启动时装载),然后按 Ctrl+Shift+R 刷新页面。
升级与卸载:
dsh plugin --profile web update dsh-session-purge
dsh plugin --profile web remove dsh-session-purge
使用
把会话移入回收站
鼠标悬停任意会话行 → 点 ⋯ → 移入回收站 → 确认。该行立即从列表消失,
回收站(弹窗或整页)里出现这条记录。菜单项、弹窗、整页与设置页都跟随 DSH 的界面语言
(中文界面显示中文,英文界面显示英文)。
打开回收站
点侧边栏「工作区」行右侧的垃圾桶图标,弹窗列出全部已删除会话,按删除时间倒序。
入口位置选了菜单的用户没有这个图标:点顶部的回收站一行,同样的列表会开在中间栏的 整页里。两种形态共用同一份数据与同一套操作,差别只在容器:
| 弹窗(图标形态) | 整页(菜单形态) | |
|---|---|---|
| 每行层级 | 标题与元信息挤在同一行(12px) | 标题 15px/600 主色、元信息 12px 次级色、会话 id 11px 等宽三层 |
| 会话 id | 截断到 16 位 | 完整显示、不截断,前面带 ID 小标签 |
| 滚动 | 列表在卡片内滚动,「清空回收站」所在底栏固定 | 整页随内容滚动,底栏跟到内容末尾 |
| 窗口变窄 | 弹窗按视口自适应,始终 760px 上限 | 行内宽度不足 780px 时堆成单列(标题 → 元信息 → id → 按钮) |
- 每一行:标题(没有标题时显示「未命名会话」)、原工作目录、
删除于 3 天前、占用大小、会话 id; 超过保留期的条目会额外标注「将在下次自动清理时删除」。目录只显示文件夹名,整页里鼠标 悬停可以看到完整路径。 - 整页里「真实删除」是红字按钮(悬停才上底色),不像弹窗那样是实心红块——一屏几十个实心红 按钮会盖过标题;确认条和弹窗里的同名按钮仍是实心红。
- 复原:把会话目录原样移回原来的位置(逐字节还原),侧边栏立即出现该行(无需刷新页面), 并弹出 toast 报告结果。
- 真实删除:二次确认后永久删除,不可恢复。
- 清空回收站:二次确认(会显示条目数与占用体积)后永久删除全部。
- 条目超过 50 条时先显示一页,底部给「加载更多」。
- 弹窗里条目超过一屏时,列表在卡片内部滚动,「清空回收站」所在的底栏与策略提示始终留在原位; 整页形态没有这层内部滚动,标题和底栏跟着内容一起滚(与「插件 / 自动化任务」两页一致)。
设置
左下角 账号菜单 → 设置 → 回收站(0.2.1 起;更早版本是侧边栏「设置」按钮):
| 选项 | 默认 | 说明 |
|---|---|---|
| 入口位置 | 图标 | 图标:工作区行的小图标,点开是弹窗;菜单:与「插件 / 自动化任务」并列的一行,点开是整页 |
| 自动清理回收站 | 开 | 关闭后回收站不再自动删除任何条目,只能手动清理 |
| 保留时长 | 30 天 | 7 / 30 / 90 / 365 天或「永久」;超过保留期的条目在下一次清理时被永久删除 |
| 启动时清理一次 | 开 | 每次启动 dsh web 时按保留期清理一次 |
| 清理周期 | 6 小时 | 1–168 小时;自动清理关闭时这两项置灰 |
| 立即清理 | — | 立刻按保留期清理一次,并报告删掉了几个条目 |
| 打开回收站 | — | 按当前「入口位置」打开:图标形态开弹窗,菜单形态跳到整页 |
设置页底部有一条分隔线,下面显示当前正在运行的插件版本号。打开页面时还会向 npm 查一次
最新版本:有新版本会给出可点击的提示,已是最新则显示「已是最新版本」;离线、被网络策略阻断或
registry 不可达时静默跳过,只留下版本号,不影响任何设置。版本号由宿主提供,所以升级插件后
需要先重启一次 dsh web,只刷新页面还看不到新的页脚。
需要知道的
- 删除是可逆的,磁盘不是立刻回收的。 移入回收站只是把会话目录换个位置; 真正占用的空间在「真实删除」、清空或自动清理时才释放。
- 运行中的会话移不进去。 菜单项可以点,但确认按钮会置灰并给出原因(Host 侧还会再校验 一次)。先停止该会话或等它跑完。
- 恰好开着的空闲会话:插件会先安全释放它再移动。如果当时无法安全释放(运行时正在收尾等),
会排进「重启后移入回收站」队列,下次启动
dsh web时执行(想反悔见下面「排查」)。 - 已归档的会话默认不在列表里,用列表的「视图选项 → 全部对话(显示已归档)」或
「仅显示已归档」翻出来即可。归档行的菜单是「置顶 / 重命名 / 分叉会话 / 取消归档」,
没有「归档会话」这一内置锚点,插件不会在归档行注入「移入回收站」;需要删除时先
「取消归档」,再在普通会话行的
⋯菜单里操作。 - 只动能证明身份的目录。 插件只移动由会话持久层定位到、并且文件名确实是会话日志
(
session[.vN].jsonl[.zstd])的目录;宁可拒绝,也不会动错目录。 - 菜单形态的几处边界:侧边栏折叠成轨道时那一列只显示图标(上游只在该列展开时渲染文字); 整页的标题与「插件 / 自动化任务」同字号(20px)、不带图标,只有「回收站」与右侧的计数胶囊 ——图标在侧栏那一行和弹窗标题里就够了;菜单行固定是「回收站」,本身不带条目数 (计数在图标形态的 tooltip 与整页标题右侧); 该列里除「插件」外的条目都能被用户收进「更多」菜单,这是 DSH 自己的入口定制,插件同样适用。 整页没有关闭按钮,点任意会话或「新会话」即可返回,与「插件 / 自动化任务」两页一致; 改「入口位置」时如果人正在回收站页面里,切回图标会退出页面、回到会话。
- 复原会尽量把会话接回原工作区。 删除只是把目录挪走,工作区里的归属记录还在;
复原时插件会按会话自己的
cwd找回工作区并重新登记,重启dsh web之后再复原也一样, 不需要刷新页面。只有原始目录已被改名、删除,或会话本来就没有cwd时,才会落在 「未分组」(见「排查」)。 - 回收站位置:
~/.dsh/session-purge/trash/,每条记录是「原会话目录 + 一个同名元数据文件」。 元数据里记着原始路径、删除时间、大小和归档状态,所以复原是位级还原。 - 设置存在插件自己的文件里:
~/.dsh/session-purge/settings.json(原子写入,损坏时自动回退 默认值并把坏文件留成.bak)。它不走 DSH 的插件配置体系,因此本插件保持零依赖、免构建。
排查
看不到「移入回收站」菜单项或垃圾桶图标,先确认插件装上了、
dsh web重启过、页面也刷新过 (Ctrl+Shift+R)。菜单里只要出现「重命名 / 分叉会话 / 归档会话」(0.2.1 起归档后还会多出 「复制 Session ID」,归档行上是「取消归档」),插件就应该在归档那一项下面插入「移入回收站」; 图标则紧跟在「添加工作区」之后;如果「入口位置」选的是菜单,本来就没有这个图标, 该看顶部那列「插件 / 自动化任务」里有没有「回收站」一行。找不到设置页:0.2.1 起设置入口在左下角 账号菜单 → 设置,不再有独立的侧边栏「设置」 按钮;回收站底部的策略行也直接提供入口。更早的 DSH 版本仍是侧边栏「设置」按钮。
想确认后台到底是什么状态:
curl http://127.0.0.1:<端口>/session-purge/state # 磁盘现状 + 回收站摘要 + 设置 curl http://127.0.0.1:<端口>/session-purge/trash # 回收站条目 curl http://127.0.0.1:<端口>/session-purge/settings # 设置与统计state里的sessions[].title恒为 null:会话标题是日志里的事件,不在持久层元数据里; 界面上显示的标题是插件从会话行上读得的,并随移入操作记进回收站条目。还没执行、只是排进「重启后移入回收站」队列的会话,可以在下次启动
dsh web之前撤下来:curl -X POST http://127.0.0.1:<端口>/session-purge/undo \ -H 'content-type: application/json' -d '{"sessionId":"<会话 id>"}'会话 id 从
/session-purge/state的pending里取。这个接口只取消排队;已经移入回收站的 请用回收站里的「复原」,已经真实删除的撤不回来。改设置不想开界面:
curl -X POST http://127.0.0.1:<端口>/session-purge/settings \ -H 'content-type: application/json' -d '{"autoClean":false,"retentionDays":90}' curl -X POST http://127.0.0.1:<端口>/session-purge/sweep清空回收站后还剩几条没删掉:说明宿主拒绝了这几条(最常见的是载荷目录被改成了指向回收站 之外的链接,安全闸门会拦下)。这些行会留在列表里、在行内标出原因,并提示还剩几个; 关掉再打开(或切到别的页面再回来)也还在。确认没问题就先「复原」取回会话,或修好目录再删。
复原后仍显示「未分组」:先确认会话的原始目录还在、且没有被改名或移动——归属是按
cwd找回的,路径对不上时插件和 DSH 都无法把它放回原工作区,这类属于「路径漂移」而不是复原失败。 目录正常却仍未分组,就看启动dsh web的那个终端里有没有[session-purge]开头的 warn:is still unaccounted by workspace …(工作区写入没有生效)、workspace re-attach failed(宿主拒绝登记,例如目录不可读)、或cannot republish the workspace projection … on this DSH version(旧版 DSH 无法让已打开的页面即时收到新分组,刷新页面后即可归位)。 带DSH_PURGE_DEBUG=1启动还有更细的过程日志。详细日志:启动
dsh web时带上DSH_PURGE_DEBUG=1。
环境要求
- DSH,
dsh web能正常运行。0.2.1-rc.5、0.2.1-rc.4、0.2.1-rc.2 与 0.2.0-rc.2 上已完整 实机验证:回收站面板、设置页的自动清理设置、端到端「移入 → 复原 → 真实删除 → 清扫」, 入口的两种形态(图标 + 弹窗、菜单 + 整页,含来回切换与窄窗口布局), 以及 0.2.1 的账号菜单设置入口与 0.2.1 插件式 JSONL 后端下的开发脚本。rc.3 没有单独跑过, 它与相邻两版只差 tooltip 与日志输出层面;rc.2 → rc.5 之间插件依赖的契约面全程未变(详见 docs/compat-0.2.1-rc.5.md)。 0.1.7-rc.2 / 0.1.5-rc.3 的菜单与侧边栏注入沿用同一套 DOM 识别,预期可用,但这一轮没有重新 实机验证;0.1.5-rc.3 没有设置扩展点,设置页不可用,此时请用上面的 HTTP 路由读写设置。 - Node.js
^22.19.0 || >=24(package.json的engines;实际以dsh web用的 那份 Node 为准)。 - 零依赖、零编译,Windows / Linux / macOS 同一份代码。
开发
代码结构、测试与发布流程见 DEVELOPING.md; 产品规格与实现记录(含已知边界与后续增强)见 docs/recycle-bin/。
MIT License.