@hitzhangjie/dsh-plugin-session-delete
DeepSeek Harness 只提供「归档」:归档的会话永远留在磁盘上。这个插件补上缺失的那一步——真正彻底删除一个会话,入口在侧栏会话行的 ... 菜单里。
一个 DSH bundle(声明了 dsh.bundle.patch),所以 dsh plugin --profile <profile> add <path> 安装后会被自动选入 profile 层,不需要手写 cordis.patch.yml 行。
功能
- 侧栏会话菜单项:
sidebar.workspaces.session.menu.item 槽位里的红色「删除会话…」,和内置的 置顶 / 重命名 / Fork / 归档 用同一套 MenuItemButton 呈现。
- 两步确认:第一次点击把标签变成「确认永久删除「<标题>」?」,5 秒不确认自动复位;第二次点击才真正删除。悬停的提示文字也说明了后果。
- 先停活:删除前通过归档的
stopActivity 瀑布停止运行中的工作(durable archive 集合会挡住这些停止所引发的任何唤醒),再等会话落盘安静后继续。
- 拒绝仍有 fork 子会话的会话:子会话的 header 里记着父 id,删掉父会话会让这条血缘悬空,所以直接拒绝并把子会话 id 返回给界面。
- 本地零残留,按顺序清理:
- 事件日志目录
<persistence root>/<projectKey>/<sessionId>/(先按 header 的 cwd 精确算路径,再扫描 session root 兜底)
- 投影缓存
<home>/storages/session_projcache/sessions/<id>.json
- 会话的 spill 目录
<tmp>/dsh-spill-*/session-<sha256(id)[:12]>/
- 工作区记账
Workspace.detachSession(id)
- 归档 / 置顶集合中的该 id
- 活的 store 条目(如果 store 暴露了 detach)
- 立即从侧栏消失:删除成功后宿主发出
api-session/removed,同时浏览器半区调用客户端 sessions.refresh() 重新拉取权威列表——冷会话(本次进程没打开过)不会发出任何 disposal 帧,只有重新拉取才能让它的行消失。
- 写者占用时不留半成品:文件仍被活的写句柄占住时,id 会记入
<home>/plugins/session-delete.pending.json,下次启动(此时所有会话都是冷的)自动补删。
安装
# 1) 检出
git clone https://github.com/hitzhangjie/dsh-plugin-session-delete.git
# 2) 装进你使用的 profile(桌面版 Harness 固定使用保留 profile desktop)
dsh plugin --profile desktop add "file:<仓库所在路径>/dsh-plugin-session-delete"
dsh plugin 用的是桌面安装自带的那套运行时,它有权管理 desktop profile;npm 全局安装的 CLI 会拒绝针对 desktop 的启动与管理请求。
然后完全退出并重启 Harness。Bundle 的 patch 会把行插进 profile 树:
- insert:
- id: hitzhangjie-session-delete
name: '@hitzhangjie/dsh-plugin-session-delete'
行名必须是裸包名:dsh-client-modules 只把包的浏览器半区挂到「模块说明符正好是裸包名」的 Loader 行上,而 profile 解析层负责把裸包名解析到 profile 自己的 node_modules。写成相对路径(./lib/index.js)只会加载宿主半区,菜单项不会出现。
架构
| 半边 | 文件 | 作用 |
|---|
| Host | lib/index.js | 注册 loopback 精确路由 POST /api/hitzhangjie/session-delete,校验请求来源后执行整套删除。profile 插件没有 harness.handle / host.call 通道,所以浏览器半区用同源 fetch 调这个路由。 |
| Client | lib/client.js | 通过 window.__ModuleLoader__.load({ id, factory }) 注册工厂(bundle id 必须等于包名),往 sidebar.workspaces.session.menu.item 注册菜单项,渲染两步确认,调用宿主路由并刷新会话列表。 |
请求防护:精确路由在 webServer.match() 里优先于应用自己的 /api 前缀路由,因此这个 handler 自带守门——Sec-Fetch-Site 为 cross-site / same-site 一律拒绝;带 Origin 时必须是 loopback 主机且端口等于本进程 webServer.port;没有 Origin 与 Sec-Fetch-Site 的本机进程被接受(web server 只监听 loopback)。会话 id 另有一层严格字符白名单。
删除失败而非静默:not-found(会话不存在)、has-children(有子会话)、list-failed(读不到会话列表,失败关闭而不是假定没有子会话)、invalid-id、forbidden 都会以 409/403 返回结构化原因,界面直接显示。
开发
# 宿主半区冒烟测试:stub ctx + 临时 DSH_HOME,不碰真实会话
node test/host-smoke.mjs
- 宿主半区改动需要重启 Harness;浏览器半区改动
dsh-client-modules 按文件修订号重新服务,刷新页面即可。
- 浏览器半区是纯 JavaScript(无 JSX),只能
require 平台基线模块:react、@deepseek-ai/dsh-client-ui-primitives(Module Loader 包的隐式 external)。
已知边界
- 已经上报的遥测无法撤回,本插件只清理本地状态。
- 别的会话正文里提到该会话的文字属于别的会话,不动。
- 删掉父会话被拒绝,所以子会话 header 里的
parentSession 不会悬空;反过来,子会话被删掉后,父会话的分支记录仍保留。
- 正好处于「活的写句柄仍占文件」的极端时序下会走
deferred 路径:文件在下次启动时补删。
- 投影缓存路径假定默认 storage 根(
<home>/storages);profile 把 storage 根搬到别处时,这一个缓存文件会留下(会话已经没了,没有读者)。
@hitzhangjie/dsh-plugin-session-delete (English)
DeepSeek Harness ships archive only: an archived session stays on disk forever. This plugin adds the missing operation — a real, irreversible session delete — behind one entry in the sidebar session-row ... menu.
It is a DSH bundle (it declares dsh.bundle.patch), so installing it with dsh plugin --profile <profile> add <path> selects it as a profile layer automatically; no hand-written cordis.patch.yml row is needed.
Features. A red Delete session… row registered into sidebar.workspaces.session.menu.item with the same MenuItemButton presentation the built-in actions use; a two-step inline confirmation that disarms itself after five seconds; running work stopped first through the archive stopActivity waterfall; sessions with forked children refused (their child headers name the parent); and local state removed with no residue — event-log directory, projection-cache entry, spill directories, workspace accounting, archive/pin membership, and the live store entry when the store exposes one. A file still held by a live writer is journaled to <home>/plugins/session-delete.pending.json and reaped on the next start.
Install, restart, done. The row name must be the bare package name: dsh-client-modules attaches a package's browser half only to the Loader row whose specifier is exactly the bare package name, and profile resolution maps that name into the profile's own node_modules.
Guards. The exact route wins over the app's /api prefix route, so it guards itself: cross-site / same-site Sec-Fetch-Site is refused, a present Origin must be loopback on this process's webServer.port, and session ids must match a strict character whitelist. Refusals come back as structured JSON (not-found, has-children, list-failed, invalid-id, forbidden) and are shown in the menu.
Verify without a harness: node test/host-smoke.mjs runs the host half against a stub context and a temporary DSH_HOME.
License
MIT
