dsh-session-hygiene
English | 中文
一个插件,补上 DSH 侧边栏的三个缺口:
- 会话只能归档,不能删除。「删除会话(移入回收站)」把日志移出会话
存储放进回收站,而不是直接 unlink,所以还能还原。 - 删除工作区会把它的会话留在磁盘上。这些会话的
cwd已经对不上任何
工作区,侧栏没地方显示它们。设置 → 会话清理能把它们找出来,归档或
移入回收站。 - 工作区没法分组。设置 → 工作区分类提供分类、侧栏分类标题、拖拽
归组和折叠。
全部是增量改动:不替换、不隐藏任何自带行,也不重写这些组件以外的 DOM。
它出现在哪
| 位置 | 你会看到什么 |
|---|---|
会话行 ... 菜单 |
删除会话(移入回收站) |
| 侧栏工作区列表 | 分类标题,拖拽归组 |
| 设置 → 会话清理 | 孤儿扫描、回收站、还原、彻底删除 |
| 设置 → 工作区分类 | 分类、归属、排序、标题开关 |
安装
从 npm 装,走 DSH 的 Plugins 页面,或者直接让 agent 装:
plugin_manager install_bundle dsh-session-hygiene
装本地 checkout 的话,传它的绝对路径:
plugin_manager install_bundle <当前 checkout 的路径>
宿主侧 JavaScript 不热重载:装完重启一次宿主。
删除一个会话
- 在侧栏指向某个会话,打开它的
...菜单。 - 选 删除会话(移入回收站)。
- 这一行立刻消失;数据是被移动了,不是被删除。
内部按这个顺序做:停掉正在跑的工作并隐藏该行 → 把它从所有工作区 detach 并
取消置顶 → 把 /sessions/// 重命名进回收站 → 记一条
preview → 发 api-session/removed,已经打开的页面不用刷新就会移除这一行。
投影缓存会保留,所以还原之后标题和开场提示都还在。
如果移动失败并提示 「会话数据仍被占用。先切到另一个对话,再回来删除。」,
说明还有别的视图开着这个目录:切到另一个对话再重试。移动失败时归档会回滚,
会话仍按原样显示。
清理被删除工作区遗留的会话
打开 设置 → 会话清理。页面打开就会扫描一次;重新扫描可以重来。
孤儿会话指的是磁盘上还在、但 header.cwd 对不上任何已注册工作区的会话。
每一行显示标题、开场片段、原本属于哪个工作区、目录名和体积。
- 行内:移入回收站。
- 批量:归档 N 项 —— 收进宿主自己的归档列表,会跳过子代理会话,因为
它们通常由父会话持有。 - 批量:全部移入回收站 —— 包含子代理,操作前要确认一次。
未挂载是另一类情况:会话的 cwd 对得上某个工作区,但那个工作区没把它
列进去,于是侧栏把它归到「未分组」。这类会话会在标签页上方单独出一条提示,
配一个 全部挂回 按钮——比直接删掉一个本身健康的会话更划算。
回收站:还原或彻底删除
回收站标签页列出已经移进去的内容。
- 恢复会把目录重命名回它记录的原始路径,并按
cwd重新挂回对应的工作区。
如果原位置已经被占用,会拒绝操作(409)——先移走或删掉占位的东西。如果
原工作区已经不存在了,会话会回来,但显示为未分组,因为已经没有东西持有它的
cwd。 - 彻底删除会删掉目录,并清掉它的投影缓存。这是唯一不可逆的操作,而且它
每次都明确指名删哪些;需要再点一次确认。
批量操作对应 全部还原 和 全部彻底删除(后者要求确认条数)。
给工作区分组
打开 设置 → 工作区分类。
- 新增分类,行内改名,用 上移 / 下移 调顺序,删除(被删分类
下的工作区回到未分类)。 - 用下拉框给工作区选分类,或者直接把侧栏的工作区行拖到分类标题上。
- 保存并聚拢 会写入归属并重排工作区注册表,让同一分类的行连续;未分类的
排在最后。宿主自带的行拖拽排序照常可用——这里只在保存时重排一次。 - 清空归属 把所有工作区退回未分类,但保留分类本身。
- 分类标题右侧的 + 会打开宿主的目录选择窗口,把选中的目录登记为工作区,
直接归到这个分类下并聚拢到位。 - 点分类标题可以折叠或展开,折叠状态会持久化。折叠时,分类下每个长列表末尾的
展开其余 N 个会话 也会一并收起,所以折叠后屏幕上只剩分类标题。
在侧边栏显示分类标题 可以整组隐藏标题,归属关系不受影响。
分类下的行会内缩一级,让标题看起来是它们的分组,而不是同级项。分类只有在它的行
连续成块时才会显示标题;被拆散的分类不显示标题,而不是把标题画到属于别处的
行上方。标题带和内缩都是插件自己加的改动,卸载时会一并还原,侧栏回到宿主原本
渲染的样子。
数据在哪
/storages/session-hygiene/
categories.json
trash/__/
entry.json
session.v4.jsonl.zstd ...
entry.json 记录 sessionId、cwd、from(原始目录)、title、preview、
createdAt、sizeBytes 和 deletedAt。它是这个插件唯一自己写的文件,也是
能还原的原因。
想手工清空回收站,直接删掉那棵目录树即可。投影缓存是故意在移入回收站时保留
的(它是派生数据,保留才能让还原后的会话仍然显示标题),彻底删除时才清掉。
卸载
在 DSH 的 Plugins 页面移除这个 bundle。侧栏会立刻失去分类带,也没有任何自带
行会停留在被改过的状态。
先把回收站清空或还原完。卸载后 /storages/session-hygiene/ 会留在
磁盘上,但已经在回收站里的会话不再有任何界面能还原它们——只能照着各自的
entry.json,手工把目录改回原路径。
已知限制
- 孤儿判定是拿会话的
header.cwd和注册表里记录的工作区目录做比较。如果一个
会话的cwd在磁盘上被改过名,它会被判成孤儿,哪怕工作区其实还在。 - 删除工作区时依然不会提示它还有多少会话;这个插件只能在事后、在设置里把它们
列出来。想在删除那一刻拦截,就得接管sidebar.workspaces,而那是宿主自己的
single槽。 - 子代理会话会被列出并单独标记,归档 N 项 会跳过它们,批量移入回收站则
包含它们。 - 分类标题依赖行连续;把一行拖到两行之间时,它的分类是从上方标题推出来的,
当一个分类只有一行时这只是个猜测。 - 分类标题的 + 依赖宿主的原生目录选择能力(
directoryPicker的native);
只有浏览模式的 profile 会被拒绝并提示,不会打开浏览器里的选择器。 - 宿主侧 JavaScript 不热重载:安装或更新后重启宿主。
开发
node tests/host-smoke.mjs
这个冒烟测试用真实的请求处理器,把一个临时 DSH_HOME 从头跑到
scan → trash → restore → purge,不会碰任何真实 profile。它通过 files 排除
在发布包之外。
维护者参考,各界面注册在这些位置:
| 槽 | Id | 用途 |
|---|---|---|
sidebar.workspaces.session.menu.item |
session-hygiene-trash |
删除行,排在自带 Archive 正上方 |
settings.section |
session-hygiene |
会话清理页 |
settings.section |
workspace-categories |
分类页 |
settings.section.icon |
session-hygiene、workspace-categories |
导航图标 |
sidebar.footer.action |
session-hygiene-labels |
本身不渲染,只挂载画分类带的 DOM 观察器 |