会话删除 ljp888/dsh-session-delete-next

dsh-session-delete-next

DSH（DeepSeek Harness）侧栏会话删除插件 —— 为当前运行时（0.2.0-rc.2）重写的版本，替代插件市场里因 peer 版本范围（^0.1.0-rc.5）不兼容而装不上的 dsh-session-delete。

仓库：<https://github.com/ljp888/dsh-session-delete-next>

功能

| 入口 | 菜单项 | 行为 |
| 会话行 … 菜单 | 删除会话 | 永久删除该会话的全部本地记录，不可恢复 |

要点：

- 危险操作，红色菜单项 + 独立确认对话框（明示「不可恢复」并显示会话标题）。
- 运行中的会话一律拒绝删除（含当前会话）——宿主端返回 409 live，对话框给出提示。
- 删除后立即从侧栏消失，无需刷新（复用官方已转发的 api-session/removed 事件）。
- 菜单文案跟随 GUI 语言（中文 / 英文），走官方 locale 服务。

技术实现

与旧版插件的关键差异：不再用 DOM 注入。0.2.0-rc.2 已开放官方扩展点，本插件走标准 slot 机制，不会随侧栏结构变化而静默失效。

Host 半（index.js，纯 ESM）

- 只 inject: ['webServer']，其余服务（sessionPersistence / workspaceRegistry / sessions / storageDomain）按请求用 ctx.get() 惰性获取，缺失时降级而不是拒绝加载。
- 注册同源路由 POST /dsh-session-delete-next/delete，请求体 { sessionId }。
- 删除顺序（先删文件，后记账，失败绝不留下「已隐藏但未删除」的半删状态）：
1. 拒绝 live / 已创建未落盘的会话；
2. ctx.sessionPersistence.stat(id) 定位日志，locate(header).path 取路径，删除其所在目录（含 session.lock）；
3. 安全校验：文件名必须匹配后端自己的 session.v<N>.jsonl[.zst|.zstd|.gz]，且目录必须位于持久化后端的 root 之内，否则拒绝；
4. 清理 session_projcache 投影缓存；
5. 从 workspace 账目 detachSession，并清除归档标记；
6. ctx.emit('api-session/removed', id) 通知浏览器。
- 同源校验：跨站 Origin 直接 403。

Client 半（client.js，手写浏览器 bundle，无需构建）

- window.__ModuleLoader__.load({ id: '<包名>', factory }) 懒注册。
- 注册到官方 slot：
- sidebar.workspaces.session.menu.item（会话 … 菜单，order: 500，排在 pin/rename/fork/archive 之后）；
- shell.overlay（确认对话框，独立于菜单生命周期）。
- 复用宿主注入的 useMenuOpenState() 关闭菜单；t() 来自 ctx.locale.register。
- 若宿主缺少所需 UI primitives，只告警并跳过注册，不会让 slot 渲染崩溃。

安装

最省事的方式是直接 clone 成 profile 的插件目录（<profile> 默认为 ~/.dsh/profiles/desktop）：

git clone https://github.com/ljp888/dsh-session-delete-next.git \
~/.dsh/profiles/desktop/node_modules/dsh-session-delete-next

Windows PowerShell 对应写法：

git clone https://github.com/ljp888/dsh-session-delete-next.git
"$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-session-delete-next"

然后手动复制文件也可以，步骤：

1. 把整个包目录复制到 <profile>/node_modules/dsh-session-delete-next/ （<profile> 默认为 ~/.dsh/profiles/desktop）。
2. 在 <profile>/cordis.patch.yml 追加一行挂载（此文件被 HMR 监听，保存后即热加载）：

- insert:
- id: dsh-session-delete-next
name: dsh-session-delete-next

3. 浏览器刷新一次即可看到菜单项。

不写入 profile 的 package.json：本包不在 npm 上，写成 dependencies 会让后续
pnpm install / dsh plugin 操作去 registry 拉取而失败。代价是将来在 profile 里跑
pnpm install 可能把这个目录剪掉，重装即可。

已知限制

- 不能删除 live 会话。 官方没有公开的「驱逐运行中会话」API，所以正在运行或已打开的会话会被拒绝。先关掉它（或重启 DSH）再删。
- 子智能体会话也可删除；删除后父会话的子智能体目录会少一项，界面会随 api-session/removed 自行收敛。
- 附件不删。 ~/.dsh/attachments/** 是内容寻址、跨会话共享的，删除会话不会动它。
- Windows 上若另一个进程仍持有 session.lock，rm 可能报 EBUSY；此时对话框会显示原始错误且磁盘状态不变，重试即可。
- 全量删除（按工作区批量）未实现——只做单个会话删除，减少不可验证的失败路径。

实测验证状态（本机）

| 项目 | 结果 |
| 宿主端加载 + 路由注册 | ✅ ~/.dsh/logs/desktop-next.log：[dsh-session-delete-next] host ready: POST /dsh-session-delete-next/delete |
| profile 热加载（无需重启） | ✅ 追加 patch 行后 Loader 自动刷新，日志即出现上述行 |
| 侧栏 … 菜单出现「删除会话」 | ✅ 红色危险样式 + 分隔线，排在官方「归档会话」之后 |
| 中文 locale 解析 | ✅ 显示「删除会话」，不是原始 key |
| 确认对话框 | ✅ 标题、含会话名插值的正文、红色「永久删除」、取消 |
| 执行真正删除（成功路径） | ⚠️ 未执行 —— 原因见下 |

为什么没做破坏性实测：验证时侧栏只有一条会话，正是承载那次对话的活跃会话。
官方在 0.2.0-rc.2 没有公开「驱逐运行中会话」的 API，所以插件会拒绝删除它；跑通「删除成功」路径需要一个非活跃会话当靶子，我不拿真实对话历史去赌。
想自行确认：新开一个会话 → 随便发一条消息 → 切回原会话 → 对那个测试会话执行删除。
删除成功的判据是 ~/.dsh/sessions/<项目目录>/<会话 id>/ 整个目录消失，且侧栏该行立即消失。

注：index.js 的 fail-closed 安全加固（sessions 服务不可用时拒绝删除）不在 HMR 模块监听根内，需重启 DSH 才在运行实例中生效；之前的运行实例行为一致。

给 DSH 0.2.0-rc.2 的侧栏会话行菜单补上缺失的 Delete session 操作，替代市场里的 dsh-session-delete——它的 peer 范围（^0.1.0-rc.5）已经解析不到了。

- 永久删除会话的本地记录；红色危险样式，外加一个确认对话框，明确说明此操作不可撤销。
- 运行中／已打开的会话会被拒绝（409 live）——绝不删除。
- 重新发出官方转发的 api-session/removed 事件，该行立即消失，无需刷新。
- 通过客户端 locale 服务本地化（zh/en）。

与原插件不同，这里用的是官方插槽，而不是 DOM 注入：菜单行用 sidebar.workspaces.session.menu.item，对话框用 shell.overlay。删除文件先于任何记账操作，所以一旦失败，绝不会留下一个已隐藏但仍在磁盘上的会话。

安装：把本仓库直接克隆进 profile 的插件目录—— git clone https://github.com/ljp888/dsh-session-delete-next.git ~/.dsh/profiles/desktop/node_modules/dsh-session-delete-next ——然后把 - insert: 行追加到 <profile>/cordis.patch.yml，刷新页面。profile 的 package.json 刻意不动，因为这个包没有发布到 npm。

License

MIT