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 }。
• 删除顺序（先删文件，后记账，失败绝不留下「已隐藏但未删除」的半删状态）：
  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 才在运行实例中生效；之前的运行实例行为一致。

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