会话清理 stansz/dsh-session-delete

dsh-session-delete

把 DSH 会话彻底删掉，同时不把 Host 一起拖下水。

为什么需要插件

DSH 会话不止一个文件：

| 部分 | 路径 |
| 日志目录（log + session.lock） | $DSH_HOME/sessions/<encoded-cwd>/<session-id>/ |
| 投影检查点 | $DSH_HOME/storages/session_projcache/sessions/<session-id>.json |
| 工作区行（就是侧边栏） | $DSH_HOME/storages/workspace.json |

在 Finder 里删掉目录，只清掉第一行，另外两行还在，所以会话仍然列在侧边栏，点开却打不开。另一种翻车方式是删掉 Agent 还活着的会话：Agent 会继续往一个已经不存在的日志目录里追加内容。

注册了什么

向已有服务做全局贡献，不覆盖任何已发布的东西。

- 工具 session_admin（action: list | inspect | delete）
- 命令 /session-list —— 列出每个已存会话，以及决定能否删除的各项标记。
- 命令 /session-delete <session-id> [force] —— 在输入框里执行同样的操作。

三者调用同一份实现（index.js 里的 deleteSession）。

用法

/session-list
/session-delete session-1a2b3c4d-... # refuses if live/locked
/session-delete session-1a2b3c4d-... force # cancels the turn, then deletes

也可以直接问智能体，或者用工具：

session_admin action="list"
session_admin action="inspect" sessionId="session-..."
session_admin action="delete" sessionId="session-..." dryRun=true
session_admin action="delete" sessionId="session-..." force=true

dryRun: true 会准确报告哪些路径和哪些行会被清掉、删除会不会被拦下，全程不碰任何东西。

几道防线

1. 自身 —— 删除当前调用正在运行的会话，永远拒绝。这种情况会把 Host 搞崩，所以放在最前面检查。
2. 存活或锁被占用 —— 除非 force: true，否则拒绝。「存活」来自 sessionController.list()；「锁被占用」从 session.lock 解出来，再用 process.kill(pid, 0) 探测，所以另一个 Host 或终端里的 Agent 也算数。
3. 删除顺序 —— 先取消回合，刷写存活日志，忘掉工作区行，清掉投影缓存，最后 unlink 日志目录。先释放所有权，再删字节。
4. 路径围栏 —— rmSync 之前，每个要删的路径都验证过位于 $DSH_HOME/sessions 之内，所以存储值再离谱也删不到别处。桶靠扫描目录名是否恰好等于会话 id 来发现，绝不重建 cwd 编码。
5. 结果无损 —— 每个字段都实体化，因为 Host 会拒绝不是无损 JSON 的工具结果。也正因如此，一串 undefined 值会被省略，而不是发出去。

delete 注册为非并发安全：两次删除不能在 inspect 和 unlink 之间交错。

配置

没有。存储根目录依次取 DSH_HOME、$DSH_PROFILE_DIR/../..、~/.dsh。

重启说明

这个包以 link: 方式安装。Desktop Host 加载内置插件的 JavaScript 只加载一次，在 set_plugin 启用/禁用时不会重新导入已链接包的模块生成结果——所以改了 index.js 之后，必须重启 DSH 才会生效，即使 install_bundle 报告 application: applied 也一样。