dsh-session-delete-ui

English | 中文

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 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 路由：

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

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) 得到绝对路径；
   退化路径是扫描 //；
3. 路径校验（assertRemovable）：必须是 // 恰好两段、目录名等于会话 id、
   不是符号链接/junction、realpath 后仍在 sessions 根内 —— 校验通过才进入删除；
4. rmSync(目录, { recursive: true }) 删除日志目录；
5. 删除 ~/.dsh/storages/session_projcache/sessions/.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 半需要重启 DSH：DSH 的插件 JS 是「一个进程一份模块代」，改了 index.js 后运行中的进程仍跑旧代码
> （实测：改完后路由仍返回旧的 live 字段）。浏览器半会随文件变更重新下发，两个半版本不一致时，
> 对话框会明确提示「Host 半需要重启 DSH」，不会把旧版的误判当成结论。

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

同类项目调研

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

已知限制

• 没有回收站：删除不可恢复（对话框已明示）。需要可恢复请改用回收站类插件；
• 只清理本插件的关注面：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

English

A DSH (DeepSeek Harness) plugin that adds the missing Delete session action to the sidebar
session row menu (sidebar.workspaces.session.menu.item, order 500, its own danger group) plus a
confirmation dialog in shell.overlay.

The shipped Harness has no deletion API, so the Host half performs that out-of-band maintenance:
it refuses only running work (turn / subagent / job / schedule, asked through the Harness's own
workspace/session-activity waterfall and stoppable through workspace/session-stop), resolves the
artifact through ctx.sessionPersistence, validates the path (exactly //,
never a symlink, still inside the real root), removes the log directory and the projection cache, and
only then drops workspace accounting. A session that is merely still resident in the process — an
archived, idle session, for example — is deletable; it keeps its archive gate so the in-memory
instance cannot write a fresh log into the directory just removed. Subagent descendants cascade;
forked sessions never do. Files first, bookkeeping second.

Verified locally: 35/35 host checks (real read-only planning + destructive run on an isolated
fixture, including resident-idle, running, stop-then-delete, and ghost-cleanup cases), 46/46 client
checks (registration, rendering, guards, confirm flow), the live Host route
(GET /session-delete/api/health → 200, live session delete → 409), and the served browser bundle
(combo URL computed from dsh-client-modules' revision rule → 200). Visual appearance in the page
was not verified: this session has no browser control.