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

dsh-plugin-session-trash

DeepSeek Harness (DSH) 的会话回收站插件。官方目前只有「归档」（会话留在原位、仅变灰），没有删除入口；本插件补上真正的删除：

- 会话行「...」菜单新增红色 移入回收站（位于「归档」之后）。删除不弹确认框：操作完成后侧栏条目就地消失，同时弹出官方样式的 Toast 提示（3 秒自动消失）——「已移入回收站，可在「设置 → 回收站」中恢复或清空」。
- 被删除的会话目录整体移动到 ~/.dsh/trash/sessions/<sessionId>/，登记信息写入 ~/.dsh/trash/manifest.json——数据不会立即丢失。
- 设置 → 回收站 分区（垃圾桶图标）：恢复到原工作区（侧栏立即更新，无需重启）、单个永久删除、清空回收站（后两者带确认框）、打开回收站文件夹。
- 正在运行（回合进行中）的会话拒绝删除；删除时自动 unarchive / unpin / detach，恢复时自动 attach 回原工作区。

安装

在 DSH 的 desktop profile 里安装（DSH 自带 pnpm，无需全局安装）：

cd ~/.dsh/profiles/desktop
node ~/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/pnpm/bin/pnpm.cjs add github:<你的用户名>/dsh-plugin-session-trash

然后把 "dsh-plugin-session-trash" 加入 profile package.json 的 dsh.profile.bundles 数组，重启 DSH 即可。

也可以通过 DSH 设置里的插件管理器安装（指向本仓库的 git 地址）。

卸载：pnpm remove dsh-plugin-session-trash + 从 dsh.profile.bundles 移除 + 重启。~/.dsh/trash 与 ~/.dsh/sessions 均不受卸载影响，回收站里的数据保持原样。

原理

- 宿主半（lib/index.js）：cordis 服务 sessionTrash，依赖 workspaceRegistry 和 sessions。所有工作区登记变更都走 registry 官方 API（unarchiveSession / unpinSession / detachSession / attachSession），本插件从不手改 workspace.json。
- 文件操作只有两类：rename 会话目录进出 ~/.dsh/trash/sessions/，以及永久删除时的 rm -rf（仅限回收站目录内）。~/.dsh/sessions/ 里只发生过改名进出，没有就地写入。
- 删除后把会话从宿主的 live 会话表里移除（内部路径，带特性检测），会话索引随下次同步丢弃该行；客户端再调用 sessions 服务的 refresh() 让侧栏就地更新——全程无需刷新页面或重启。
- UI 半（lib/client.js）：注册 sidebar.workspaces.session.menu.item（菜单项）、shell.overlay（Toast/确认框）、settings.section（回收站设置页，垃圾桶图标）。
- RPC：手写 Typert 描述（lib/remote.js + lib/typert.host.js），一次式 direct 调用。

已知边界

- 删除/恢复通过客户端 sessions.refresh() 就地更新侧栏；极少数情况下（DSH 内部结构变化导致驱逐失败）提示行要等重启应用后消失。
- 回合进行中的会话会被拒绝（提示「会话正在运行」）；回合间隙的空闲会话可以删除。
- 恢复时若原工作区已不存在：registry create 重建挂接；若工作区目录本身也没了，会话文件恢复但保持未挂接，并给出警告文案。
- 无标题会话删除时，宿主侧会尝试从 session_projcache 读取标题兜底，回收站列表里更好认。

兼容性

在 DSH 0.2.0-rc.2（Electron 44，darwin arm64）上开发并实测。用到的主要接口：cordis 插件体系、workspaceRegistry 服务、sessions 服务（含内部 live 表的 best-effort 驱逐，特性检测 + 降级）、Typert remote、sidebar.workspaces.session.menu.item / settings.section / shell.overlay 槽位、primitives 的 Toast/Modal/MenuItemButton。其他版本未测试，接口变动时以降级行为兜底。

开发

pnpm install # 或用 DSH 自带 pnpm
pnpm build # src/ -> lib/（lib/ 已提交，装包无需构建）
pnpm test # 宿主半冒烟测试（临时 DSH_HOME，不碰真实数据）

迭代流程：改 src/ → pnpm build → 在 profile 里重装 → 重启 DSH。

License

MIT