BakaCirno233/dsh-session-delete

DeepSeek Harness (DSH) 插件：在 设置 → 会话管理 中列出所有会话，并永久删除不需要的会话。

功能

删除语义

• 删除该会话的持久化日志（~/.dsh/sessions/<项目>/<session-id>/）
• 从所有工作区的会话账目中摘除（workspaceRegistry.detachSession）
• 搜索索引（SQLite FTS）在下一次查询时自动同步清理
• 两步确认防误删；删除前后都会校验，删除后验证持久化列表不再包含该会话
• 每次删除都写日志（成功 info、异常 warn）；工作区账目摘除失败会作为 warnings 回传界面，而不是被静默吞掉

活动会话限制：本次启动中打开过的会话（包括正在查看的当前会话）会被拒绝删除——活动 Agent 会重写日志，删除不彻底。重启应用后这些会话变成冷会话，即可正常删除。历史会话（此前运行留下的）随时可直接删除。

列表与批量操作

• 子代理会话：DSH 的会话列表默认隐藏 origin: "subagent" 的会话。勾选 「显示子代理会话 (N)」 即可列出它们（N 是当前被隐藏的数量）。
• 侧边对话隔离：better-sidebar 的 Side Chat 线程同样带 subagent 标记，但它们不是子代理。本插件按 Side: 标题前缀识别，永远不显示——删掉它会让侧边栏那个对话标签页变成孤儿。
• 搜索：匹配标题、会话 ID、类型标签（子代理 / subagent、主会话 / main）、工作区路径、以及 agent preset（qq-chat、cordis 等）。输入 子代理（或其前缀 agent）会自动放开隐藏，一次列出全部子代理会话。
• 分组：下拉切换 按时间（今天 / 近 7 天 / 近 30 天 / 更早）或 按工作区（会话创建时的 cwd，按会话数量降序；无 cwd 的归入「未知工作区」）。
• 批量选中：整组勾选 / 全选 / 单行勾选三级。选中范围严格跟随屏幕上可见的条目——被搜索词或隐藏开关过滤掉的会话不会混进批量删除。分组标题右侧显示该组数量与合计占用。
• 批量删除：逐个串行请求并显示进度（删除中 12/357），单条失败只计入失败数、不中断整批，结束后汇总成功与部分失败。
• 占用大小：每行显示该会话日志文件的体积，便于判断先清理哪个。

安全设计

• 删目录有守卫：递归删除会话目录前校验「目录名 == 会话 id」（DSH 一直如此命名）。一旦路径形态变化导致不匹配，就只删日志文件并记一条 warn，绝不盲目 rm -r——那可能带走整个工作区分组。
• 定位失败不再假装成功：sessionPersistence.locate() 抛错时返回失败，而不是当成「没有产物」。
• 状态未知即禁用：host 列表接口不可用时，界面显示错误提示并禁用所有删除按钮，不会把「拿不到活动状态」当成「全都是冷会话」。
• 请求有超时：前端请求 20 秒超时（AbortController），host 无响应不会把界面永久锁死。

兼容性

宿主	状态
DSH Desktop 2.0.18 / 内核 0.2.1-rc.2	✅ 已验证（安装门禁与所用 API 均通过）
DSH Desktop 2.0.10 / 内核 0.1.5-rc.2	✅ 已验证（sessionPersistence.list() 返回 snapshot，本插件按 snapshot.header 读取）
内核 < 0.1.5-rc.2	❌ 不支持。该代 list() 返回的是裸 header，本插件取不到 id

宿主代次由 package.json 的 engines.dsh（>=0.1.5-rc.2 <0.3.0-0）统一声明。DSH 的安装门禁优先读 engines.dsh，存在该字段时 peerDependencies 里的 @deepseek-ai/dsh-* 不再参与判断——内核升代只改这一处即可，不必逐条改 peer。

这条下界来自 2.0.10 的服务语义变化：sessionPersistence 改为按 SessionHandle（create/open）寻址，list() 返回 { header, sizeBytes, revision } 快照。若你的 DSH 更老，请先确认 list() 的返回结构再装。

安装

在目标 profile 的 package.json（例如 ~/.dsh/profiles/desktop/package.json）中加入依赖与 bundle：

{
  "dependencies": {
    "dsh-session-delete": "github:BakaCirno233/dsh-session-delete"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "…其他插件…",
        "dsh-session-delete"
      ]
    }
  }
}

然后在 profile 目录执行 pnpm install，重启 DSH 应用。

使用：设置（齿轮）→ 会话管理。

本地开发（file: 依赖）

"dependencies": {
  "dsh-session-delete": "file:<本仓库的绝对路径>"
}

pnpm install 后改 lib/ 里的代码，重启应用即可生效。

注意：file: 依赖在 profile 的 node_modules 下是副本而不是符号链接。改完仓库代码后需要重新 pnpm install（或手动把 lib/*.js 复制过去），否则运行的仍是旧代码。

结构

• lib/index.js — Host 半部：在本地 webServer 注册两个路由
  • POST /api/session-delete/list → { sessions: [{ sessionId, live, running, sizeBytes?, agentPreset?, cwd? }] }
  • POST /api/session-delete/delete → { ok, code?, message?, warnings? }
  • 文件删除直接使用 node:fs/promises（rm），无需子进程
  • 列表结果带 5 秒缓存，避免反复刷新时重复扫描全部会话；删除成功后立即失效
• lib/client.js — 浏览器半部：settings.section 的「会话管理」页，通过 fetch 调用宿主路由
• cordis.patch.yml — 把宿主插件行插入组合（宿主半部）
• package.json 的 dsh.client 声明让 Web 端自动发现 lib/client.js

更新记录

2026-10-26 — 兼容 DSH 2.0.18（内核 0.2.1-rc.2）

修复

• 安装被拒（界面提示宿主版本不对）：peerDependencies 里的 ^0.1.0-rc.5 在语义化版本下封顶于 0.2.0-0，而 DSH 2.0.18 的内核是 0.2.1-rc.2，6 条 @deepseek-ai/dsh-* peer 全部不满足，安装 preflight 因此拒绝。现在改用 engines.dsh（>=0.1.5-rc.2 <0.3.0-0）统一声明宿主代次；6 条 peer 同步更新为 ^0.1.5-rc.2 || ^0.2.0-rc.2（仅供包管理器参考，门禁以 engines.dsh 为准）。
• 版本号 1.0.0 → 1.0.1：宿主按精确版本判断是否更新，不 bump 的话 pnpm 会认为装上的还是旧版。

验证

• 用宿主自带的 evaluatePluginCompatibility()（@deepseek-ai/dsh-app-boot，运行版本 0.2.1-rc.2）实测：旧 manifest 被上述 6 条拒绝，新 manifest 通过。
• 复核 0.2.1-rc.2 的相关 API：sessionPersistence.list() 仍返回 { header, sizeBytes, revision }、locate() 仍返回 { kind, path }、webServer.register({ kind: "exact", path, handler })、workspaceRegistry.detachSession()、客户端 settings.section 槽位与 window.__ModuleLoader__ 协议均未变。

2026-09-14 — 兼容 DSH 2.0.10（内核 0.1.5-rc.2）

兼容

• DSH 2.0.10 改动了 sessionPersistence.list() 的返回结构：从 header 数组变为 snapshot 对象数组（{ header, sizeBytes, revision }）。直读 snapshot 的 id 会拿到 undefined。现在改走 snapshot.header 取出 id／cwd／agentPreset，sizeBytes 则直接取 snapshot 自带的（后端已经 stat 好了，删掉了独立的 sizeOf 函数）。

修复

• 递归删除会话目录缺少守卫：现在要求目录名等于会话 id，否则只删日志文件并记录警告
• sessionPersistence.locate() 失败不再被当作「没有产物」而静默返回成功
• 工作区账目摘除（detachSession）失败不再被吞掉，改为回传 warnings 并写日志
• host 状态探测失败时，不再把全部会话渲染成可删除

新增

• 「显示子代理会话 (N)」开关；Side Chat 线程始终隐藏
• 批量选中（整组 / 全选 / 单行）与批量删除，带实时进度与失败计数
• 搜索：标题、会话 ID、类型标签、工作区路径、agent preset
• 分组：按时间或按工作区，均支持整组选中并显示组合计
• 列表显示会话占用大小；host 列表接口新增 sizeBytes / agentPreset / cwd
• 删除操作写日志（成功 info / 异常 warn）

改进

• 前端请求加 20 秒超时，避免 host 无响应时界面锁死
• host 列表接口加 5 秒缓存，删除后立即失效

License

MIT