会话彻底删除 hitzhangjie/dsh-plugin-session-delete

@hitzhangjie/dsh-plugin-session-delete

DeepSeek Harness 只提供「归档」：归档的会话永远留在磁盘上。这个插件补上缺失的那一步——真正彻底删除一个会话，入口在侧栏会话行的 ... 菜单里。

一个 DSH bundle（声明了 dsh.bundle.patch），所以 dsh plugin --profile <profile> add <path> 安装后会被自动选入 profile 层，不需要手写 cordis.patch.yml 行。

功能

- 侧栏会话菜单项：sidebar.workspaces.session.menu.item 槽位里的红色「删除会话…」，和内置的 置顶 / 重命名 / Fork / 归档 用同一套 MenuItemButton 呈现。
- 两步确认：第一次点击把标签变成「确认永久删除「<标题>」？」，5 秒不确认自动复位；第二次点击才真正删除。悬停的提示文字也说明了后果。
- 先停活：删除前通过归档的 stopActivity 瀑布停止运行中的工作（durable archive 集合会挡住这些停止所引发的任何唤醒），再等会话落盘安静后继续。
- 拒绝仍有 fork 子会话的会话：子会话的 header 里记着父 id，删掉父会话会让这条血缘悬空，所以直接拒绝并把子会话 id 返回给界面。
- 本地零残留，按顺序清理：
1. 事件日志目录 <persistence root>/<projectKey>/<sessionId>/（先按 header 的 cwd 精确算路径，再扫描 session root 兜底）
2. 投影缓存 <home>/storages/session_projcache/sessions/<id>.json
3. 会话的 spill 目录 <tmp>/dsh-spill-*/session-<sha256(id)[:12]>/
4. 工作区记账 Workspace.detachSession(id)
5. 归档 / 置顶集合中的该 id
6. 活的 store 条目（如果 store 暴露了 detach）
- 立即从侧栏消失：删除成功后宿主发出 api-session/removed，同时浏览器半区调用客户端 sessions.refresh() 重新拉取权威列表——冷会话（本次进程没打开过）不会发出任何 disposal 帧，只有重新拉取才能让它的行消失。
- 写者占用时不留半成品：文件仍被活的写句柄占住时，id 会记入 <home>/plugins/session-delete.pending.json，下次启动（此时所有会话都是冷的）自动补删。

安装

1) 检出
git clone https://github.com/hitzhangjie/dsh-plugin-session-delete.git

2) 装进你使用的 profile(桌面版 Harness 固定使用保留 profile desktop)
dsh plugin --profile desktop add "file:<仓库所在路径>/dsh-plugin-session-delete"

dsh plugin 用的是桌面安装自带的那套运行时，它有权管理 desktop profile；npm 全局安装的 CLI 会拒绝针对 desktop 的启动与管理请求。

然后完全退出并重启 Harness。Bundle 的 patch 会把行插进 profile 树：

- insert:
- id: hitzhangjie-session-delete
name: '@hitzhangjie/dsh-plugin-session-delete'

行名必须是裸包名：dsh-client-modules 只把包的浏览器半区挂到「模块说明符正好是裸包名」的 Loader 行上，而 profile 解析层负责把裸包名解析到 profile 自己的 node_modules。写成相对路径（./lib/index.js）只会加载宿主半区，菜单项不会出现。

架构

| 半边 | 文件 | 作用 |
| Host | lib/index.js | 注册 loopback 精确路由 POST /api/hitzhangjie/session-delete，校验请求来源后执行整套删除。profile 插件没有 harness.handle / host.call 通道，所以浏览器半区用同源 fetch 调这个路由。 |
| Client | lib/client.js | 通过 window.__ModuleLoader__.load({ id, factory }) 注册工厂（bundle id 必须等于包名），往 sidebar.workspaces.session.menu.item 注册菜单项，渲染两步确认，调用宿主路由并刷新会话列表。 |

请求防护：精确路由在 webServer.match() 里优先于应用自己的 /api 前缀路由，因此这个 handler 自带守门——Sec-Fetch-Site 为 cross-site / same-site 一律拒绝；带 Origin 时必须是 loopback 主机且端口等于本进程 webServer.port；没有 Origin 与 Sec-Fetch-Site 的本机进程被接受（web server 只监听 loopback）。会话 id 另有一层严格字符白名单。

删除失败而非静默：not-found（会话不存在）、has-children（有子会话）、list-failed（读不到会话列表，失败关闭而不是假定没有子会话）、invalid-id、forbidden 都会以 409/403 返回结构化原因，界面直接显示。

开发

宿主半区冒烟测试:stub ctx + 临时 DSH_HOME,不碰真实会话
node test/host-smoke.mjs

- 宿主半区改动需要重启 Harness；浏览器半区改动 dsh-client-modules 按文件修订号重新服务，刷新页面即可。
- 浏览器半区是纯 JavaScript（无 JSX），只能 require 平台基线模块：react、@deepseek-ai/dsh-client-ui-primitives（Module Loader 包的隐式 external）。

已知边界

- 已经上报的遥测无法撤回，本插件只清理本地状态。
- 别的会话正文里提到该会话的文字属于别的会话，不动。
- 删掉父会话被拒绝，所以子会话 header 里的 parentSession 不会悬空；反过来，子会话被删掉后，父会话的分支记录仍保留。
- 正好处于「活的写句柄仍占文件」的极端时序下会走 deferred 路径：文件在下次启动时补删。
- 投影缓存路径假定默认 storage 根（<home>/storages）；profile 把 storage 根搬到别处时，这一个缓存文件会留下（会话已经没了，没有读者）。

@hitzhangjie/dsh-plugin-session-delete（English）

DeepSeek Harness 只提供归档：归档后的会话永远留在磁盘上。本插件补上缺失的那一步——真正的、不可逆的会话删除——入口放在侧边栏会话行的 ... 菜单里。

它是一个 DSH bundle（声明了 dsh.bundle.patch），所以用 dsh plugin --profile <profile> add <path> 安装时会自动选为 profile 层，不需要手写 cordis.patch.yml 行。

功能。 往 sidebar.workspaces.session.menu.item 注册一行红色 Delete session…，展示方式与内置操作一样，都用 MenuItemButton；两步内联确认，五秒后自动解除；先通过归档的 stopActivity waterfall 停掉正在跑的工作；带 fork 子会话的会话会被拒绝（子会话 header 里写着父会话）；本地状态清得干干净净——事件日志目录、投影缓存条目、spill 目录、workspace 记账、archive/pin 归属，以及 store 暴露 live store 条目时的那一条。文件仍被活的写句柄占着时，会记到 <home>/plugins/session-delete.pending.json，下次启动再补删。

安装，重启，完事。 行名必须是裸包名：dsh-client-modules 只把包的浏览器部分挂到 specifier 正好是裸包名的 Loader 行上，而 profile 解析会把该名字映射到 profile 自己的 node_modules。

防护。 精确路由优先于应用的 /api 前缀路由，所以它自己守门：Sec-Fetch-Site 为 cross-site / same-site 一律拒绝；带了 Origin 就必须是本进程 webServer.port 上的 loopback；会话 id 必须匹配严格的字符白名单。拒绝以结构化 JSON 返回（not-found、has-children、list-failed、invalid-id、forbidden），并显示在菜单里。

不装 harness 也能验证：node test/host-smoke.mjs 拿桩上下文和临时 DSH_HOME 跑 host 部分。

License

MIT