dsh-session-tool

给 DeepSeek Harness（DSH）补上删除会话能力的宿主插件。

DSH 官方只有「归档」—— 归档只是把会话从界面隐藏，日志文件原封不动躺在磁盘上，没有删除入口。本插件补上这个能力。

特性

斜杠命令：/sessions-archived 查看、/sessions-delete 删除（/ 菜单自动出现，无需客户端界面）
agent 工具：session_archived_list / session_delete，模型可直接调用
默认安全：删除先进回收目录，--purge 才永久删除；--yes 显式确认；拒绝删除当前会话
运行中的会话默认拒绝删除，--stop 才先取消回合并等待静默
完整清理链路：日志目录 + 投影缓存 + 工作区记账（含归档集合）一起清，走活的 storageDomain，内存与磁盘一致
零依赖：只用 Node 内置模块 + DSH 宿主服务，不 import 任何 @deepseek-ai 的值

安装

⚠️ 下面命令里的是占位符，请替换成你自己的 profile 名， 不要把尖括号一起输入。常见值：Web / TUI 端用 web，桌面端用 desktop。

一行搞定（Web 端，可直接复制粘贴）

dsh plugin --profile web add dsh-session-tool

桌面端把 web 换成 desktop；其他 profile 换成你自己的名字。

其他安装方式

从 GitHub 安装（npm 镜像尚未同步时可用）：

dsh plugin --profile web add github:immortal-akx/dsh-session-tool

从本地开发目录安装：

dsh plugin --profile web add file:C:/path/to/dsh-session-tool

装完重启

安装后重启 DSH 生效（Host 插件在启动时加载）。

图形界面（推荐）

重启 DSH 后，侧栏每个会话行都会多出删除入口：

位置	操作
会话行的 "..." 菜单	鼠标移到会话行 → 点行尾的 ⋯ → 菜单底部「删除会话」（红色，带垃圾桶图标）
会话行悬停按钮	鼠标停在会话行上 → 行尾出现 🗑 删除按钮

点击后会弹出确认框，确认即删除。安全设计：

默认移入回收目录（$DSH_HOME/session-trash//），可手动搬回恢复
运行中的会话会二次确认，确认后先停止其任务再删除
删除后侧栏那一行自动消失（若未消失，刷新页面即可）

命令（不想用鼠标时）

在任意会话输入框敲 /：

命令	作用
`/sessions-archived`	列出已归档会话：标题 / 创建时间 / 占用 / id / 是否运行中 / 文件是否还在
`/sessions-delete`	删除已归档会话

/sessions-delete                            预览：将删哪些（不动手）
/sessions-delete all --yes                  删除全部 → 移入回收目录
/sessions-delete 1,3 --yes                  按序号删
/sessions-delete 6cf4aa57 --yes             按 id 前缀删
/sessions-delete all --stop --yes           连"正在运行"的会话也删（先停止其任务）
/sessions-delete all --purge --yes          永久删除（不进回收目录）

删除后文件在 $DSH_HOME/session-trash//，想恢复就把 session- 文件夹搬回 $DSH_HOME/sessions//。

agent 工具

工具	参数
`session_archived_list`	无
`session_delete`	`sessionIds`（必填）、`purge`（默认 false = 进回收目录）、`stop`（默认 false = 拒绝运行中的会话）

安全设计

默认不真删 —— 移到 $DSH_HOME/session-trash//，可手动恢复
必须显式确认 —— 不带 --yes 只预览
拒绝删当前会话 —— 正在对话的这个会被跳过
运行中的会话默认拒绝 —— --stop 才先 agent.cancel() + 等静默（15 秒上限）
删前先 flush + detach —— 把会话从内存表摘除，避免 dispose 阶段把日志目录重建回来
先删文件、后动记账 —— 文件确认删净才清记账，半删的会话不会掉进「未分组」
走活的 storageDomain 清账 —— 投影缓存行、工作区 sessionIds、归档集合三处一起改
陈旧登记 —— 归档表里有 id 但文件早没了的，只清理登记

实现

宿主插件：ctx.commands.register() 注册斜杠命令，ctx.get('tools').register() 注册工具
只依赖宿主服务：commands / tools / agents / sessions / storageDomain / workspaceRegistry
入口 lib/index.js，挂载声明 cordis.patch.yml

为什么不做侧栏按钮：DSH 客户端↔宿主是代码生成的 Typert RPC，第三方插件无法新增接口。斜杠命令 + agent 工具是插件可用的官方入口。

卸载

dsh plugin --profile 
 remove dsh-session-tool

许可

MIT

致谢

删除链路的部分设计（先删文件后动记账、走 live storageDomain 清账、运行中会话处理）参考了 @pepsi-ai/dsh-plugin-session-delete。
图形界面与宿主通信的思路同样受其启发：第三方插件无法新增 Typert RPC namespace，因此用同源 HTTP 路由做宿主↔浏览器桥接。本项目改用官方插槽（sidebar.workspaces.session.menu.item / .row.action）实现菜单项，未使用 DOM 注入。

自定义界面

改 profile 的 cordis.patch.yml（路径：~/.dsh/profiles/ /cordis.patch.yml），加一段 config，重启 DSH 后生效：

- id: dsh-session-tool
  name: dsh-session-tool
  config:
    menu:
      label: "删除会话"   # ⋯ 菜单里的文案（留空 = 跟随语言）
      order: 500         # 在 ⋯ 菜单里的位置（越小越靠前）
      hidden: false      # 隐藏这一项
      danger: true       # 红色危险样式
      icon: true         # 显示垃圾桶图标
    rowAction:
      order: 200
      hidden: false      # 隐藏会话行悬停时的垃圾桶按钮
    header:
      order: 30
      hidden: false      # 隐藏会话头部的垃圾桶按钮
    trash:
      menu: true         # 在 ⋯ 菜单里加一条「打开回收站」
      label: ""          # 自定义它的文案

例子：只保留头部按钮、隐藏侧栏两项，并把文案改成「删掉这个会话」：

- id: dsh-session-tool
  name: dsh-session-tool
  config:
    menu: { label: "删掉这个会话", hidden: true }
    rowAction: { hidden: true }

回收站

删除默认只是搬家（$DSH_HOME/session-trash//session-xxx-…/），不是销毁：

操作	方式
查看回收站	`/sessions-trash`
打开回收站目录	弹窗成功页的「打开回收站」按钮 · `/sessions-trash --open` · ⋯ 菜单里的「打开回收站」
恢复某个会话	把该批次里的 `session-xxx-…` 文件夹搬回 `$DSH_HOME/sessions//`
永久删除	删除时加 `--purge`（不可恢复）

官方那几行也能改（置顶 / 重命名 / 分叉 / 归档）

官方项由 @deepseek-ai/dsh-client-ui-workspace 注册，文案来自它的 locale 字典（不可覆盖）。本插件用插槽契约允许的方式接管：复用官方 id 注册（pin / rename / fork / archive），行为仍走工作区服务（pinSession / unpinSession / archiveSession / unarchiveSession / forkSession）。

- id: dsh-session-tool
  name: dsh-session-tool
  config:
    shippedRows:
      pin:
        label: "钉住"          # 未置顶时的文案（默认「置顶会话」）
        activeLabel: "取消钉住" # 已置顶时的文案（默认「取消置顶」）
        order: 120             # 默认 100
      fork:
        label: "开个分支"       # 默认「分叉会话」
        order: 350             # 默认 300
      archive:
        hidden: true           # 直接隐藏这一行
      rename:
        hidden: false          # rename 只支持 hidden（重命名对话框是官方内部实现）

字段	pin	rename	fork	archive
`hidden`	✅	✅	✅	✅
`label` / `activeLabel`	✅ / ✅	❌	✅ / ❌	✅ / ✅
`order`	✅	❌	✅	✅

默认顺序：pin 100 · rename 200 · fork 300 · archive 400（本插件的「删除会话」默认 500）。

安装

说明文档