会话删除菜单 ant404/dsh-session-delete-ui

dsh-session-delete-ui

DSH（DeepSeek Harness）插件：在左侧会话行的「⋯」菜单里补上官方的「删除会话」能力。

官方 Harness 只提供归档（Archive），没有删除：dsh-session-persistence 的文档明确写着「No deletion or retention API — pruning stored sessions is out-of-band backend maintenance」。
本插件就是把这个 out-of-band 维护做进 UI，并且做得安全、可确认、可回退。

会话行 ⋯ 菜单 ├─ 置顶 / 重命名 / 分叉 / 归档 ← 官方内置 └─ 删除会话 ← 本插件（order 500，独立分组，红色危险项） ↓ 确认对话框：会话名 + 「不可恢复」警告 + 将删除的子代理数量 + 占用空间 ↓ 永久删除：会话日志目录 + 投影缓存 + 工作区记录（含子代理会话级联）

功能

| 入口 | 文案 | 行为 |
| 会话行「⋯」菜单 | 删除会话 | 永久删除该会话的本地日志目录、session_projcache 投影缓存、工作区账目（成员关系 / 归档 / 置顶标记） |
| 同上 → 确认对话框 | — | 明示不可恢复、列出将级联删除的子代理会话数量与占用空间；只在会话确有在跑的工作时才需要先停止 |

「在跑的工作」≠「进程里还留着这个会话」：官方 session store 会保留打开过的会话实例，一个已归档、完全空闲的会话也可能是 resident。插件只把真正在跑的工作 （进行中的回合 / 运行中的子代理 / 后台任务 / 定时提醒）当作阻断条件，并把这些工作列在对话框里，提供「停止并删除」（等价于官方「停止并归档」的停止路径：workspace/session-stop）。
resident 但空闲的会话直接可删。

子代理会话（origin: 'subagent'）会随其父会话一起删除；分叉出来的会话不会被牵连 （分叉会话没有 origin: 'subagent'，只有 parentSession）。

安装

本插件是一个标准 DSH bundle（dsh.bundle.patch + dsh.client 双半包）。

方式一：在图形界面里安装（推荐，profile 由应用托管时唯一受支持的方式）

设置 → 插件 → 安装 bundle，目标填本目录的绝对路径：

D:\path\to\dsh-session-delete-ui

方式二：手动接入 profile（本仓库当前采用的方式）

desktop profile 被 Electron 应用独占，dsh plugin --profile desktop 会被拒绝（profile "desktop" is managed exclusively by the Electron application）。手动接入等价于 install_bundle 的两步：

1. 在 profile 的 node_modules 里建立软链（hoisted 布局，直接 junction 即可） New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-session-delete-ui" -Target "D:\path\to\dsh-session-delete-ui"

2. 在 profile 的 package.json 里登记依赖 + bundle dependencies: "dsh-session-delete-ui": "link:D:/.../dsh-session-delete-ui" dsh.profile.bundles: 追加 "dsh-session-delete-ui"

应用会实时重组 profile：保存 package.json 后无需重启，Host 半立即挂载（可访问 GET /session-delete/api/health 验证）。浏览器半需要页面刷新一次才能加载新的模块行。

安装不写入 cordis.patch.yml：挂载行由包内的 cordis.patch.yml 随 bundle 层生效。

工作原理

Host 半（index.js）

注册同源 JSON 路由：

| 路由 | 作用 |
| POST /session-delete/api/preview | 只读预检：是否已无记录、active（在跑的工作） 与 resident（进程内仍驻留）、活动工作清单、残留记账（归档/置顶/成员关系）、日志目录、占用空间、级联子代理列表 |
| POST /session-delete/api/delete | 执行删除；stopActivity: true 时先走官方停止路径；日志已不存在时转为残留清理；返回 deleted / cleaned / skippedActive / missing / failed 明细 |
| GET /session-delete/api/health | 挂载自检（返回 sessions 根目录、持久化服务可用性、存活会话数） |

删除顺序（先文件、后账目，任何失败都不会留下「已隐藏但没删掉」的半删状态）：

1. 活动判断：用 Harness 自己的归档准入问题
ctx.waterfall('workspace/session-activity', …) 取工作族（turn / job / subagent / schedule，
与官方「停止并归档」用同一套 provider）；有工作且未要求停止 → 409 active，要求停止则 ctx.parallel('workspace/session-stop', …) 后短暂等待收敛，仍不收敛 → 409 still-active。
ctx.sessions.get(id) 只用来报告 resident，不再作为拒绝依据；
2. 定位：通过 ctx.sessionPersistence.list() 取全部 header，再用后端的 locate(header) 得到绝对路径；退化路径是扫描 <sessions>/<project>/<id>；
3. 路径校验（assertRemovable）：必须是 <sessionsRoot>/<project>/<id> 恰好两段、目录名等于会话 id、不是符号链接/junction、realpath 后仍在 sessions 根内 —— 校验通过才进入删除；
4. rmSync(目录, { recursive: true }) 删除日志目录；
5. 删除 ~/.dsh/storages/session_projcache/sessions/<id>.json；
6. 工作区账目：unarchiveSession / unpinSession / detachSession（仅显示与记账，失败只记日志）， resident 与否都清。曾经为了保住归档闸门而保留归档标记，结果是日志删掉后 id 仍留在 archivedSessionIds 里，形成用户清不掉的「幽灵行」，该做法已回退；
7. 残留清理路径：日志目录已经不存在时，不删文件、只清第 6 步的三种记账，返回 cleanupOnly: true 与 cleaned 明细，不再用 404 把请求打死。删除一个「进程里还开着、但磁盘上已经没了」的会话时，对话框会说明这一行会在关闭该会话或重启 DSH 后消失，并提供「清除残留记录」。

子代理级联由 header 的 origin === 'subagent' + parentSession 推导，深度上限 6 层。
比较 id 时同时接受带与不带 session- 前缀的写法（DSH 两种都在用）。

Client 半（client.js）

window.__ModuleLoader__.load({ id, factory }) 形式的浏览器 bundle，只用官方 Slot 扩展点：

- sidebar.workspaces.session.menu.item（order: 500）→ 菜单项「删除会话」；
- shell.overlay → 确认对话框与结果提示。

删除成功后调用 ctx.get('sessions').refresh() 让会话目录重新拉取，行随即消失，无需刷新页面。
样式从官方 primitives 的 Menu.module.css / Modal.module.css / Button.module.css 复制后改名为 dsd_ 前缀，只引用 --dsw-alias- 主题 token，因此亮/暗主题自动跟随。

不 require 任何 Harness Client 包（@deepseek-ai/dsh-client-ui-），只用浏览器模块表里的 react。

安全设计

- 双重确认：菜单项 → 确认对话框；对话框中的删除按钮在预检完成、且会话可删时才会启用；
- 只在有活时拦截：有在跑的工作时列出工作族并走「停止并删除」；resident 但空闲的会话不再被误判；
- 路径围栏：删除前逐项校验路径，绝不跟随符号链接离开 sessions 根；
- 级联有界：只级联 origin: 'subagent' 的子会话，分叉会话不受影响；
- 先删文件后改账目，失败时行保持可见并把原因回给对话框。

验证

已执行（本机实测）：

| 检查 | 结果 |
| Host 行为测试 node test/host-behavior.test.mjs | 35/35 通过：真实 sessions 根只读预检 + 隔离夹具上的真实删除与级联；resident 空闲可删 / 有活拒绝 / 停止后放行 / 清残留记账 / 幽灵行可清理 / 路径穿越拒绝 / 重复删除 404 |
| Client 渲染测试 node test/client-render.test.mjs | 46/46 通过：模块注册、两个 slot 的 id/order/locale、菜单项与对话框渲染、活动工作清单与「停止并删除」、resident 提示、幽灵行「清除残留记录」、无可清理时禁用、旧版 Host 半的降级提示、确认→刷新→提示 |
| 运行中的应用（Host） | Host 已挂载：GET /session-delete/api/health → 200 |
| 真实路由 | 普通会话 preview → deletable: true 并给出真实目录与体积；有活会话 delete → 409 |
| 浏览器 Bundle | 按 dsh-client-modules 的 rev 规则计算 combo URL 后请求 → 200，说明模块图已包含本插件的行 |

改完 Host 半需要重启 DSH：DSH 的插件 JS 是「一个进程一份模块代」，改了 index.js 后运行中的进程仍跑旧代码（实测：改完后路由仍返回旧的 live 字段）。浏览器半会随文件变更重新下发，两个半版本不一致时，对话框会明确提示「Host 半需要重启 DSH」，不会把旧版的误判当成结论。

尚未验证：浏览器里的视觉呈现（本会话没有浏览器控制能力）。菜单项与对话框的实际外观请在页面中确认；若菜单里暂时看不到，刷新一次页面即可。

同类项目调研

动手前先看了 GitHub / npm 上已有的会话删除插件，取长补短：

| 项目 | 做法 | 本插件的取舍 |
| vtxf/dsh-session-delete（npm dsh-session-delete） | Host 路由 + ctx.shell 执行 rm/Remove-Item，客户端用 DOM 注入克隆菜单项（作者认为菜单没有 Slot） | 保留「Host 路由 + 确认 + 存活拒绝」的思路；改用官方 Slot（sidebar.workspaces.session.menu.item 在现行版本已开放），并用 node:fs 直接删除（无 shell 转义面） |
| masknull/dsh-delete-session | 侧栏「⋯」菜单加「删除会话」，不接管任何官方行 | 同思路，直接落在官方 Slot 上；额外做级联与预检 |
| liuyu-f/dsh-plugin-session-cascade-delete | 日志目录 + 投影缓存 + 工作区账目，级联子代理，先停再删，并提供 session_delete 工具 | 采纳级联边界（只删 subagent 子会话，分叉不碰）与「先删文件后记账」；工具入口留作后续 |
| cckbc/dsh-delete-session / Seetraum/harness-session-delete（npm dsh-session-recycle-bin） | 回收站：先移入回收站，默认保留 15 天，可还原 | 本插件定位是「永久删除 + 对话内确认」；回收站是另一条产品路线，未采用（如需可加 Config 开关） |
| hkkz9522/dsh-session-manager | 完整的会话管理器：删除、归档、跨工作区移动、标签、批量操作 | 功能面大；本插件只做单一职责的删除，避免接管官方行 |
| @linxin666/dsh-session-archive | 集中式归档清单、批量归档/还原、物理删除、自动清理策略，含 node:sqlite 的 rdb 清理 | 其中「路径必须留在 sessions 根内、realpath 复核」的安全写法被本插件吸收 |

已知限制

- 没有回收站：删除不可恢复（对话框已明示）。需要可恢复请改用回收站类插件；
- 只清理本插件的关注面：dsh-cost-meter 等第三方插件自己的账本不会被清理；
- 级联深度上限 6 层；
- 改了 Host 半要重启 DSH：进程内的插件 JS 不会热替换；浏览器半改动需要刷新页面；
- resident 会话的内存实例：删除后进程内仍持有该实例（应用重启后释放），因此那一行可能保留到关闭该会话或重启 DSH；这时再点删除会走「清除残留记录」并明确告知，不会卡在「会话不存在」；
- 删掉一个仍开着的会话会出现「幽灵行」：磁盘已空、内存还在。这是 Harness 没有会话释放接口导致的，插件只能清理记账并如实说明。

目录

dsh-session-delete-ui/
├── index.js Host 半：路由 + 删除实现 ├── client.js 浏览器半：菜单项 + 确认对话框 ├── cordis.patch.yml bundle 挂载行 ├── package.json dsh.bundle.patch + dsh.client（platform/immediately/inject） ├── icon.svg / locale/{zh,en}.json 插件管理器卡片 └── test/ ├── host-behavior.test.mjs Host 行为测试（35 项） └── client-render.test.mjs Client 渲染测试（46 项）

License

MIT

DSH（DeepSeek Harness）插件，为侧边栏会话行菜单（sidebar.workspaces.session.menu.item，order 500，独立 danger 分组）补上缺失的 Delete session 操作，并在 shell.overlay 中提供确认对话框。

Harness 本身没有删除 API，所以 Host 半负责这项带外维护：它只拒绝正在运行的工作（turn / subagent / job / schedule，通过 Harness 自己的 workspace/session-activity waterfall 询问，可通过 workspace/session-stop 停止），经 ctx.sessionPersistence 解析产物，校验路径（必须正好是 <sessionsRoot>/<project>/<id>，不能是符号链接，且仍在真实根目录内），删除日志目录和投影缓存，最后才清理工作区账目。仅仅仍驻留在进程中的会话——比如已归档、空闲的会话——可以删除；它保留归档闸门，这样内存里的实例无法往刚删掉的目录写入新日志。子代理后代级联删除；分叉会话永不级联。先删文件，后记账。

本地已验证：35/35 项 Host 检查（在隔离 fixture 上做真实只读规划 + 破坏性运行，覆盖 resident-idle、running、先停再删、幽灵清理等场景），46/46 项 Client 检查项（注册、渲染、守卫、确认流程）、实时 Host 路由（GET /session-delete/api/health → 200，实时会话删除 → 409），以及提供的浏览器 bundle （组合 URL 由 dsh-client-modules 的修订规则计算得出 → 200）。页面中的视觉外观未验证：本会话没有浏览器控制。