DDDMUC/dsh-delete-session

dsh-delete-session

DeepSeek Harness 会话删除插件 —— 在侧边栏会话菜单里直接删除会话。 给 DeepSeek Harness (dsh) Web 侧边栏的会话 ... 菜单（重命名 / 分叉 / 归档）补上「删除会话」：确认一次后可直接删除，真正删除会话日志、工作区记账与宿主内存中的会话状态。

中文 · English

中文

▲ 侧边栏会话菜单里的「删除会话」（红色）

为什么需要它

DSH 侧边栏的会话菜单只有重命名 / 分叉 / 归档——归档只是把会话藏起来，不删数据；而插件dsh-web里的全家桶里的「会话归档管理」在设置深处，删一个会话要跳好几个界面。

这个插件把「删除」放回你最常点的位置：会话行的 ... 菜单。

特性

- 菜单内删除 —— 侧边栏会话 ... 菜单直接多出「删除会话」；会话 ID 从菜单的 React fiber 读取，永远作用于你点的那一行，不会切换当前会话
- 风险确认 —— 首次删除弹出确认对话框：显示会话标题与 ID，勾选「我已了解，永久删除」后确认按钮才可用
- 确认一次后可跳过 —— 对话框里勾选「不再询问，以后直接删除」，之后点菜单项直接删除（左下角 toast 提示）；按住 Shift 点击可临时恢复弹窗；清除 localStorage['dsh-delete-session:skip-confirm'] 可永久恢复
- 多选批量删除 —— 会话菜单里的「多选」进入选择模式：每行左侧出现勾选圈，点整行即勾选（不会打开会话），底部操作条显示「已选 N 个 / 取消 / 删除」；点删除立即批量执行（无确认弹窗、无全选、所有行都可选）：被选中的行乐观隐藏、操作条实时显示「正在删除 x/N…」、客户端以 6 路并发请求宿主（不同会话并行、工作区记账串行），完成后 toast 汇总并刷新列表；失败的行立即恢复显示并保持选中，方便直接重试；Esc 或「取消」退出
- 真正的删除 —— 停止运行中的 agent（cancel + 等待空闲）→ flush / detach 活跃会话 → 删除磁盘会话目录（原始 ID 与 session- 前缀两种写法）→ 持久化服务复核 → 清理工作区记账，侧栏不会残留「未分组」孤儿，并连带清理项目缓存行（$DSH_HOME/storages//sessions/.json），不留无法再显示的幽灵记录
- 删除后回到新会话 —— 若删除的正是当前打开的会话，自动切到一个全新会话（不再落到已不可用的邻居页——那种页面 composer 会被禁用、侧栏也列不出来，看起来像「没删掉」）
- 默认安全 —— 宿主路由仅限本机回环（回环 socket + 回环 Host 头 + 同源校验）；被 DSH 打开占用的会话会被明确拒绝（409），绝不与活跃写者竞争
- 中英双语 —— 菜单项与对话框跟随 DSH 界面语言（zh / en）
- 零依赖 —— 不引入任何 DSH SDK，所有服务（sessions / sessionPersistence / agents / workspaceRegistry / webServer）都在调用时通过 cordis 上下文获取

安装

npm（推荐）：

dsh plugin --profile web add dsh-delete-session

或从 GitHub 仓库直接安装：

dsh plugin --profile web add github:DDDMUC/dsh-delete-session

重启 dsh web 后生效。

使用

1. 把鼠标移到侧边栏的会话行，点 ...（会话操作）
2. 选择底部的「删除会话」
3. 首次：勾选「我已了解，永久删除」（想省事可同时勾选「不再询问，以后直接删除」）→ 点「删除」
4. 之后：直接删除，左下角出现 toast 提示
5. 批量删除：会话菜单 →「多选」→ 勾选多个会话 → 底部「删除」；Esc 或「取消」退出选择模式

▲ 删除确认对话框（首次删除）

工作原理

- src/index.js（宿主）：注册一条仅限回环的路由 POST /dsh-delete-session/delete { sessionId }，执行删除链路
- src/client.js（浏览器）：经典客户端 bundle——监听 portal 到 body 的会话菜单（body > [role="menu"]），沿 React fiber 链读取会话节点（props.node.id），克隆原生菜单行保持样式，弹出确认对话框
- 删除链路：停 agent → flush / detach 活跃会话 → 写所有权探测（被占用 → 409）→ 删除目录（两种 ID 写法 + 复核）→ 清理工作区记账

已知限制

- 被 DSH 当前打开占用的会话：删除会自动等待写所有权释放（通常几秒）后完成；极少数仍被占用的情况会提示稍后重试或重启 DSH
- 菜单注入是 DOM shim：核心 UI 若调整菜单结构或行 fiber 形状，可能不再注入菜单项（不影响其他功能）
- 删除不可恢复：没有回收站，也没有撤销
- 批量删除为客户端 6 路并发 + 乐观隐藏：不同会话并行删除，宿主端写所有权等待缩短为 200ms × 12（单条最长约 2.2s），多个被占用的会话也并行等待；同一工作区记账变更仍串行，避免并发写交错

兼容性

- DSH 0.1.5-rc.1 / 0.1.7-alpha.2 实测通过（0.1.7 起不再导出 SettingsProvider；本插件不依赖 DSH SDK，无需改动）
- 宿主链路对缺少服务的旧版本会退化为纯文件系统清理

如果这个插件帮到了你，欢迎给仓库点个 ⭐（GitHub）——星标是开发者继续维护的最大动力，感谢支持！

License

MIT

English

▲ "Delete session" (red) in the sidebar session menu

为什么你需要它

DSH 侧边栏的会话菜单只提供 重命名 / 派生 / 归档——归档只是隐藏会话，磁盘上的每一个字节都原样保留，而 dsh-web 插件套件里的会话归档管理器深藏在设置中，要翻好几屏才能找到。

本插件把删除功能放回你本来就会点击的地方：会话行的 ... 菜单。

功能特性

- 从菜单删除——侧边栏会话 ... 菜单中会出现一行“删除会话”；会话 id 从菜单的 React fiber 中读取，因此操作始终针对你点击的那一行，绝不会切换当前活动会话
- 风险确认——首次删除会弹出确认对话框，显示会话标题和 id；只有勾选“我明白”后确认按钮才会解锁
- 确认一次，之后跳过——勾选“不再询问”后，之后的删除会直接从菜单执行（通过 toast 报告结果）；按住 Shift 点击可强制唤回对话框，或清除 localStorage['dsh-delete-session:skip-confirm'] 以永久恢复
- 多选批量删除——会话菜单中的“选择多个”会进入选择模式：每一行都会出现一个圆形复选框，点击行即可切换选中状态（绝不会打开会话），底部栏显示“已选 N 项 / 取消 / 删除”。删除会立即执行（无确认对话框、无全选、每一行都可选）：选中的行会被乐观隐藏，底部栏显示实时进度（“正在删除 x/N...”），客户端以 6 路并发发起请求（独立会话并行，工作区记账串行），随后弹出 toast 汇总报告；失败的行会立即重新出现并保持选中，方便快速重试；按 Esc 或点击取消即可退出
- 真实删除——停止正在运行的 agent（取消 + 静默等待），刷新并分离活动会话，移除磁盘上的会话目录（原始 id 和带 session- 前缀的 id 都会移除），通过持久化服务进行验证，然后清理工作区记账，确保“未分组”下不会出现孤儿项，并移除该会话的投影缓存行（$DSH_HOME/storages//sessions/.json），从而不会留下侧边栏再也无法显示的幽灵条目
- 留下一个全新会话 — 当被删除的会话正是主视图当前显示的会话时，应用会切换到一个全新会话，而不是一个陈旧的相邻会话（一个不可用的行，带有被禁用的输入框，侧边栏甚至无法列出它，这读起来像是“删除没有生效”）
- 默认安全 — 宿主路由仅限回环（回环套接字、回环 Host 头、同源检查）；仍被 DSH 保持打开的会话会以 409 被拒绝，而不是与活跃写入者竞争
- 双语 — 菜单项和对话框跟随 DSH 界面语言（zh / en）
- 零依赖 — 不导入 DSH SDK；每个服务（sessions、sessionPersistence、agents、workspaceRegistry、webServer）都在调用时通过 cordis 上下文解析

安装

从 npm（推荐）：

dsh plugin --profile web add dsh-delete-session

或直接从 GitHub 仓库安装：

dsh plugin --profile web add github:DDDMUC/dsh-delete-session

重启 dsh web 以应用。

用法

1. 将鼠标悬停在侧边栏中的某个会话行上，然后点击 ...（会话操作）
2. 在底部选择“Delete session”
3. 首次使用时：勾选“I understand - delete permanently”（如果愿意，也可以勾选“Don't ask again”）并确认
4. 之后：会话会被直接删除，并显示一条提示
5. 批量删除：会话菜单 -> “Select multiple” -> 勾选各行 -> 在底部栏中点击“Delete”；按 Esc 或 Cancel 退出

▲ 确认对话框（首次删除）

工作原理

- src/index.js（宿主）：一个仅限回环的路由 POST /dsh-delete-session/delete { sessionId } 运行删除流水线
- src/client.js（浏览器）：一个经典客户端 bundle — 监视被传送的会话菜单（body > [role="menu"]），沿 React fiber 链向上走到会话节点（props.node.id），克隆一个原生菜单行用于样式，并打开确认对话框
- 流水线：停止 agent → 刷新 / 分离活动会话 → 写入租约探测（忙碌 → 409）→ 删除目录（两种 id 拼写 + 验证）→ 清理工作区记账

已知限制

- DSH 当前保持打开的会话：删除会等待写入租约释放（通常几秒钟），然后完成；在极少数情况下它一直保持忙碌，对话框会要求你稍后重试或重启 DSH
- 菜单注入是一个 DOM shim：核心 UI 对菜单标记或行 fiber 形状的更改可能会阻止该项被注入（其他功能不会受影响）
- 删除是永久性的：没有回收站，也没有撤销
- 批量删除采用 6 路客户端并发，并配合乐观隐藏：独立会话并行删除，宿主写租约等待缩短为 200ms x 12（每项最多约 2.2s），因此繁忙会话也会并行等待；工作区记账保持串行化，因此并发删除绝不会在同一存储上交错执行

兼容性

- 已在 DSH 0.1.5-rc.1 和 0.1.7-alpha.2 上测试
- 在没有这些服务的旧版本上，宿主流水线会降级为文件系统清理

如果这个插件对你有帮助，在 GitHub 上点一个 ⭐ 将意义重大——这是开发者继续维护它的最大动力。谢谢！

许可证

MIT