会话回收站 dsh-plugin-db/dsh-session-trash

dsh-session-trash

从侧边栏删除会话，送进设置里的 回收站 页面，之后可以恢复，也可以永久删除。

一个全局 DeepSeek Harness 插件，以单个 npm 包发布，包含两半：Host 插件由 bundle 补丁挂载，浏览器那一半由同一个包的 ./client 导出提供。

安装

这个包是 DeepSeek Harness 的 bundle：dsh.bundle.patch 是它的 Host 行，dsh.client 是它的浏览器那一半，包本身负责解析两者。用 harness 自带的 Plugin Manager 把它装进配置档——指向这个目录（或仓库 URL），它就会把 bundle 记录到配置档里：

- dsh 命令行，前提是 harness 暴露了 Plugin Manager 界面： dsh plugin --profile <name> add
- 或者直接把它加进配置档的依赖和 bundle 列表，然后启动。

配置档自己的 cordis.patch.yml 在本 bundle 这一层 之后 应用，所以下面的任何配置也都在那里固定。

它加了什么

- 侧边栏每个会话行末尾一个删除按钮，挨着自带的归档和固定按钮。按一下就删：会话直接进回收站，没有确认步骤，因为回收站就是撤销。
- 会话 … 菜单里一行 Delete session，给键盘用户和从不悬停行的人用。
- 设置里一个 回收站 页面，列出每个已删除的会话，每个会话带 Restore 和 Delete permanently，整个列表带 Empty Trash。永久删除会话会丢掉它的日志和派生的投影缓存；活跃会话不能进回收站，也不能清除。这两个操作仍然留在确认之后，因为它们是不可逆的那一半。

删除的行会立刻离开打开的浏览器

把日志挪走，会让会话在下一次列表时从 Host 目录里消失——但没有任何东西安排这次列表。浏览器的会话存储是之前已经发生的一次拉取填进去的，所以删除的行否则会一直留在屏幕上（侧边栏把它渲染成未分组的「stray」），直到页面重新加载。

日志真正挪走之后，Host 因此发出声明的 Remote Event api-session/removed，Cordis 把它转发给每个已连接的客户端。这与自带的 Session 控制器用于自己处置通知的路径相同（dsh-api-session-controller/lib/index.js），所以浏览器通过它平常的列表变更代码清掉这一行——没有客户端侧的列表手术，插件也不需要知道另一个包的内部。如果转发不可用，路由的响应会报告 announced: false，所以没有这个事件的部署就退回到下次加载时清除。

删除是怎么工作的

Harness 不自带会话删除 API：SessionPersistence 创建、打开、列出、刷新句柄，但从不移除句柄，浏览器会话控制器也不暴露删除动词。存储确实公开的是它的寻址规则——只有当会话目录里存在规范生成日志（session.jsonl、session.v<N>.jsonl，两者都可带配置的压缩后缀）时，会话才可见。

所以删除会话，就是在会话自己的目录里，给那个 basename 追加 .trashed。不复制任何东西，日志的字节也原封不动：stat/list/open 都报告会话不存在，于是侧边栏目录、搜索、标题折叠、血缘追踪都当它已经消失，完全不知道这个插件存在。恢复就是再去掉后缀，标题随日志一起回来；永久删除则移除目录和会话的投影缓存记录。

回收站索引是这个插件自己的纯 JSON 文档。索引缺失、为空或被手工改过，每次读取时都会对照会话根目录做一次对账，所以回收站里的会话绝不会因为索引损坏而搁浅。

配置

该行接受可选的 config，在配置档自己的 cordis.patch.yml 里设置（这一层在本 bundle 之后应用）：

- id: session-trash
name: 'dsh-session-trash'
config:
Defaults to $DSH_HOME/sessions, the session-persistence root.
sessionsRoot: /absolute/path/to/sessions
Defaults to $DSH_HOME/storages/dsh-session-trash/index.json.
indexFile: /absolute/path/to/index.json
Defaults to $DSH_HOME/storages/session_projcache/sessions.
projectionCacheDir: /absolute/path/to/session_projcache/sessions

验证

包内附带两套无依赖测试，跑在系统临时目录里的临时会话根目录上：

node verify.mjs # the store: trash, list, restore, purge, empty, recovery
node verify-route.mjs # the route: dispatch, validation, refusals, envelopes

verify.mjs 断言这套设计所依赖的性质——回收站里的会话对规范生成扫描不可见，而它的字节逐字节不变，恢复后拿回的是同一个文件。

升级稳定性

Host 半边不导入任何 Harness 包；它唯一的贡献是在已认证的 /api 通道上挂一条 connection.fetch 精确路由，它依赖的存储知识就是上面的文件名语法——这是存储格式常量，不是模块 API，v<N> 保持开放，将来新的格式代际也能被同一次扫描匹配。浏览器半边同样不导入任何 Harness Client 包：它只用模块加载器工厂契约、ctx.slots.inject/register、插槽标准的 useSessions 钩子、ctx.locale，以及 --dsw-alias-* 主题 token。