dsh-plugin-session-cascade-delete

dsh-plugin-session-cascade-delete

适配 DeepSeek Harness V0.2.0-rc.2 到 0.2.1-rc.2。 槽位名、服务签名会随版本变化，其他版本请自行核对。

简单实用的会话删除工具，在 DeepSeek Harness 中彻底删除会话及其相关数据。

会话头部有一个垃圾桶按钮，侧栏会话行的 "..." 菜单中有一项「删除会话」。确认后会删除该会话的日志目录、投影缓存、工作区记账，以及它拥有的子代理会话；运行中的会话会先停止并释放。删除完成后，该会话立即从界面和会话列表消失，无需重启。适用于 Web 界面及一切基于 Web 外壳的客户端。

同时提供 agent 工具 session_delete。

安装

两种安装方式，任选其一。

UI （推荐）：

打开软件 - 点击左上方插件 - 再点击右上方+ 添加插件，然后输入：

@liuyu-f/dsh-plugin-session-cascade-delete

终端：

• web

dsh plugin --profile web add @liuyu-f/dsh-plugin-session-cascade-delete

• 桌面：

dsh plugin --profile desktop add @liuyu-f/dsh-plugin-session-cascade-delete

怎么用

侧栏菜单项与确认弹窗（截图为深色主题）：

删掉一个父会话时，它拥有的子代理会话会被一并删除（最深者先删）。

• 会话正在运行时：先停止任务、释放运行中的 Agent 和会话，再删除；删除后立即从界面与会话列表移除。
• 分叉会话（fork）是独立的：删掉一个分叉不会连带删除任何东西，也不会牵连子代理。
• 子代理归属"创建它的那个会话"（DSH 机制）：若先在 A 会话里创建了子代理、再从 A 分叉出 B，那么删除 B 对子代理没有影响，删除 A 才会删除它们。分叉只复制对话上下文，不接管子代理的归属。

agent 工具

agent 也能删除会话，并在结果里报告实际删掉了什么：

两条安全约束：

• 拒绝删除本次调用所在的会话（工具结果必须写进那个日志），并拒绝删除"其树中包含本次调用所在会话"的会话。
• 注意区分：被拒绝的是"本次工具调用所在的会话"，不是"你界面上正打开着的会话"——后者可以正常删除。

配置（可选）

写在 profile 的 cordis.patch.yml 里（本插件不导出 Config schema，故设置页没有表单）：

- id: session-delete
  name: "@liuyu-f/dsh-plugin-session-cascade-delete"
  config:
    deleteSubagents: false # 默认 true：删父会话时连子代理会话一起删
    sessionsRoot: "" # 可选：覆盖会话日志根目录，默认 $DSH_HOME/sessions

删掉了什么

一次删除会先停止并释放运行中的 Agent 与会话，再清理：会话日志目录 → 投影缓存（缓存行与磁盘文档）→ 工作区记账（所属工作区成员、归档、置顶）→ 子代理会话（由深到浅）→ 通知界面立即移除对应的行。删除后不需要重启 DSH。

任何一步没做成，都不会静默：结果报告里会有一条 INCOMPLETE，列出是哪一步、什么原因。日志确认删净之后才会动记账，所以不会出现"删一半、会话掉进未分组"的坏行。

更新与卸载

# 换版本：先移除再安装。已安装状态下直接再装会报 ambiguous-install。
dsh plugin --profile desktop remove @liuyu-f/dsh-plugin-session-cascade-delete
dsh plugin --profile desktop add @liuyu-f/dsh-plugin-session-cascade-delete

关于这个插件

@huanlin/dsh-plugin-session-delete（上游仓库）的新 DSH 适配版，改动与增强围绕子代理：级联删除、分支保护、活会话删除、会话 id 两种拼写的处理。维护者文档见 DEVELOPMENT.md。

版本