dsh-session-delete-cascade
给 DeepSeek Harness 补上「删除会话」：点会话旁的 ⋯ → 删除，连子会话一起清干净。
npm 包名与仓库名都是 dsh-session-delete-cascade。
DeepSeek Harness 出于设计考虑只提供归档，不提供删除——会话可以隐藏，但永远不会被移除，日志会一直堆在磁盘上。这个插件把删除能力补回来，作为一个可随时卸载的 bundle，不动官方任何代码。
功能
- 侧栏菜单项：会话行的
⋯ 菜单里新增「删除会话」，排在「归档会话」之后
- 确认弹窗：删之前告诉你到底会删掉什么，并列出将被连带删除的子会话
- 递归删除：连同该会话的全部子代理子孙（孙代理也删），fork 会话不受影响
- 彻底清理：对话日志、投影缓存、搜索索引、工作区记账，一处不留
- 安全护栏：有任务在跑时拒绝删除并指明是哪个会话，不会删一半
安装
包已发布到 npm：https://www.npmjs.com/package/dsh-session-delete-cascade
桌面端（DeepSeek Harness App）
设置 → 插件 → 添加插件，输入包名：
dsh-session-delete-cascade
也可以直接粘贴仓库地址 https://github.com/Changqin1024/dsh-session-delete-cascade。
装完完全退出并重开 App，侧栏会话的 ⋯ 菜单里就会出现「删除会话」。
⚠️ 桌面端的 profile 不能用 CLI 安装。 DSH 对 desktop profile 做了排他保护：
error: profile "desktop" is managed exclusively by the Electron application。
桌面端请走上面的「设置 → 插件」。
Web / CLI profile
dsh plugin --profile <profile> add dsh-session-delete-cascade
例如 dsh plugin --profile web add dsh-session-delete-cascade。装完重启该 profile。
从 GitHub 安装也可以（npm 之外的备选路径，会锁定到具体 commit）：
dsh plugin --profile <profile> add github:Changqin1024/dsh-session-delete-cascade
卸载
桌面端：设置 → 插件，找到本插件点卸载。
CLI：dsh plugin --profile <profile> remove dsh-session-delete-cascade。
版本说明
engines.dsh 声明为 >=0.2.0-rc.2。本插件用到的
ctx.connection.fetch.register 在 DSH 0.2.0-rc.2 上验证通过。
删除范围
在弹窗里点确认后，以下内容会被移除（针对目标会话及其子代理血缘）：
| 内容 | 位置 | 处理方式 |
|---|
| 对话历史 | ~/.dsh/sessions/<项目>/<会话ID>/（append-only JSONL 日志） | 逐个删除目录 |
| 投影缓存（空会话标记、最后提问时间、标题等） | session_projcache 存储域 | 逐行删除 |
| 搜索索引行 | 会话搜索 SQLite 索引 | 日志消失后自动对账清除（索引观测的是持久化列表） |
| 工作区记账 | 每个工作区记录的 sessionIds，以及全局归档集、置顶集 | 逐项移除 |
不删的东西：按会话 ID 无法寻址的缓存，例如附件请求图缓存（~/.dsh/cache/attachments/request-images/）。清它需要先读日志拿内容哈希，代价不成比例；会话删掉后它也不会再出现在任何界面，后续按需重新生成。
血缘规则：什么算「子会话」
子代理（origin: 'subagent'）会被递归删除，包括子代理的子代理。
fork 不算子会话。 fork 出来的会话虽然带 parentSession 字段，但没有 subagent 来源，它是独立对话，会保留。这条规则跟 DSH 自带归档门禁判定会话归属的规则完全一致。
- 弹窗会预览血缘：按标题列出子会话及数量
- toast 会汇报连带删除了几个
- 删子会话只删它自己的子树，父会话和兄弟会话不动
执行顺序与安全
删除严格按以下顺序，保证任何中间状态都不是撕裂的：
- 收集血缘 — 从持久化 header 读，而不是从运行时的 Subagent catalog 读。这样即使中间某个会话读不出来，血缘依然完整。
- 拒绝检查 — 只要血缘里任何一个会话还有工作在跑（进行中的回合、运行中的子代理、后台任务、定时提醒），就以
session/delete-active 拒绝，并在详情里列出每一个出问题的会话 ID 和它的活动类型。拒绝时不会删除任何东西。
- 释放 Agent — 深度优先（先子后父）。子会话的 loop 先排空，父会话的日志才会消失，避免迟到的结算打到已经不存在的父级。
- 清投影缓存行
- 删日志目录
- 从工作区记账中移除
第 3～6 步都是容错的（失败只记日志、不抛错），避免某个派生存储卡死导致日志残留——日志才是侧栏会一直显示的那个东西。
实现说明
插件分 Host / Client 两半，通过 Connection 上的 HTTP 路由通信：
| 文件 | 职责 |
|---|
lib/index.js | Host 半边：注册 POST /api/session-delete.delete，血缘遍历与有序删除 |
lib/client.js | 浏览器半边：菜单行、带血缘预览的确认弹窗、结果提示（控件全部内联，无 Harness 包依赖） |
cordis.patch.yml | 插入唯一一条 Host 插件行 |
package.json | bundle 清单：dsh.bundle.patch + web 端 dsh.client 配置 |
icon.svg、locale/*.json | 插件管理页卡片元数据 |
验证清单
- 侧栏悬停任一有内容的会话行，打开
⋯ 菜单：删除会话是最后一项
- 在一个有子代理的会话上点它：弹窗会写明保留边界，并列出将一并删除的子会话
- 确认后：血缘里每一行都从侧栏消失，对应的
~/.dsh/sessions/<项目>/<会话ID>/ 目录都不在了
- 同一父会话 fork 出来的会话仍在侧栏
- 侧栏搜索只存在于已删会话里的文字：无结果
已知边界
- 附件请求图缓存不清理，理由见上
- 血缘按持久化 header 遍历，因此只覆盖已经落盘的会话；纯内存中尚未 materialize 的子会话若不在
session.list() 里，不会被遍历到（实际使用中子会话总是先落盘）
- 删除是"整条血缘全或无"：任何一个后代在跑，整条都删不了。这是刻意的，半删会留下指向不存在父级的孤儿
- 客户端界面控件是内联实现而非复用宿主组件库。若 DSH 未来改动这些控件的视觉规范，插件需要跟进；代价换来的是不受宿主包变动影响
许可
MIT
相关
