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
English | 中文
中文
功能
| 入口 | 菜单项 | 行为 |
|---|
会话行 … 菜单 | 删除会话 | 永久删除该会话的全部本地记录，不可恢复 |
要点：
- 危险操作，红色菜单项 + 独立确认对话框（明示「不可恢复」并显示会话标题）。
- 运行中的会话一律拒绝删除（含当前会话）——宿主端返回
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 }。
- 删除顺序（先删文件，后记账，失败绝不留下「已隐藏但未删除」的半删状态）：
- 拒绝 live / 已创建未落盘的会话；
ctx.sessionPersistence.stat(id) 定位日志，locate(header).path 取路径，
删除其所在目录（含 session.lock）；- 安全校验：文件名必须匹配后端自己的
session.v<N>.jsonl[.zst|.zstd|.gz]，
且目录必须位于持久化后端的 root 之内，否则拒绝；
- 清理
session_projcache 投影缓存；
- 从 workspace 账目
detachSession，并清除归档标记；
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"
然后手动复制文件也可以，步骤：
-
把整个包目录复制到 <profile>/node_modules/dsh-session-delete-next/
（<profile> 默认为 ~/.dsh/profiles/desktop）。
-
在 <profile>/cordis.patch.yml 追加一行挂载（此文件被 HMR 监听，保存后即热加载）：
- insert:
- id: dsh-session-delete-next
name: dsh-session-delete-next
-
浏览器刷新一次即可看到菜单项。
不写入 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 才在运行实例中生效；之前的运行实例行为一致。
English
Adds the missing Delete session action to the sidebar session row menu of DSH
0.2.0-rc.2, replacing the marketplace dsh-session-delete whose peer range
(^0.1.0-rc.5) no longer resolves.
- Permanently removes the session's local records; red danger styling plus a
confirmation dialog that states the action is irreversible.
- Running/open sessions are refused (
409 live) — they are never deleted.
- The row disappears immediately, with no refresh, by re-emitting the official
api-session/removed forwarded event.
- Localized through the client locale service (zh/en).
Unlike the original plugin this uses the official slots rather than DOM
injection: sidebar.workspaces.session.menu.item for the menu row and
shell.overlay for the dialog. Files are removed before any bookkeeping, so a
failure never leaves a session that is hidden but still on disk.
Install: clone this repository straight into the profile's plugin directory —
git clone https://github.com/ljp888/dsh-session-delete-next.git ~/.dsh/profiles/desktop/node_modules/dsh-session-delete-next
— then append the - insert: row to <profile>/cordis.patch.yml and refresh the
page. The profile package.json is deliberately left untouched because this
package is not published to npm.
License
MIT
