dsh-session-admin —— 给 DSH 补上删除会话的能力


DSH(DeepSeek Harness)能归档会话,却删不掉。这个插件把「批量取消归档 + 永久删除」做成一个独立的侧栏页面,并把所有边界条件写成显式规则。

为什么需要它

DSH 的官方 API 只有归档(archiveSession)和取消归档(unarchiveSession),没有删除。归档只是把会话从侧栏收起来,日志、投影缓存、附件仍然留在磁盘上——用得久了,~/.dsh/sessions 会一直膨胀。

手删风险很高:一个会话不止一个目录,还牵着投影缓存、定时任务、工作区槽位,以及可能被其他会话共享的附件(内容寻址去重)。漏删是垃圾,多删是数据丢失。

入口为什么不并排放

DSH 原生「工作区」标题栏(搜索 / 视图 / 添加工作区)是 @deepseek-ai/dsh-client-ui-workspace 里的封闭 JSX,没有插件扩展点;sidebar.workspaces 也是已被占用的 single 槽。要「并排」只能整体替换原生浏览区,一升级就碎。

所以最终选了受支持的 sidebar.panellist + main keyed 页面:入口落在侧栏面板列(和 Plugins / Schedules 一列)、工作区列表上方,点开在中央区打开管理页。

删除是混合策略,不是一把梭

会话状态 行为
不在 Host 内存里 确认后立即删除
仍在 Host 内存里(打开过、归档后 Agent 句柄仍驻留) 只登记为「待删除」,不碰任何文件;下次启动 DSH、Agent 存储为空时自动执行完整删除,可随时取消

第二条是刻意的:DSH 没有公开的「关闭会话」接口,活句柄下删日志会得到无头日志或缓存回写。队列存在 $DSH_HOME/session-admin/pending-deletions.json(原子写、上限 500 条),启动执行时会重新校验——会话仍归档、无 live 会话/子代理,不满足就留到下次。

实际删除一个会话(含它的 origin: subagent 派生子会话)时按序执行:

  1. 校验仍在归档集合、无 live agent;
  2. 删整个会话日志目录 sessions/<cwd>/<sessionId>/(含 v3/v4 代际,绝不截断 zstd 日志);
  3. 删投影缓存 storages/session_projcache/sessions/<sessionId>.json;
  4. 删绑定到该会话的定时任务,避免继续向已删会话投递;
  5. detachSession 移除工作区槽位、取消置顶、清归档墓碑;
  6. 附件(默认开):先取被删会话引用的 sha256: 对象,再扫其余全部会话 + 上传索引,只删零引用对象;
  7. 返回逐条结果与释放字节数,失败条目保留归档状态方便重试。

安全护栏

  • 只接受 workspaceRegistry.archivedSessionIds 里的 id,非归档 id 一律拒绝;
  • session id 只接受 ^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$,所有路径做包含性校验;
  • 附件扫描不完整(读失败 / 超预算)时一个附件都不删,并在结果里报原因;
  • 每批最多 100 个 id,串行执行,同一时间只跑一个删除任务;
  • HTTP 路由只对本机回环 Host 开放,叠加同源 / Sec-Fetch-Site 检查。

明确不动:其他会话、workspace.json(只走 registry API)、.credentials.yaml、profiles/**、跨会话的 cache/attachments/request-images、仓库里的 git worktree。

两个踩过的坑

  • agent 工具注册不生效:DSH 的 agent 工具按 agent preset 组合,web 应用层 bundle 里注册的工具不会进入会话工具作用域(实测同层探针工具不出现在 Tool.listTools)。所以本插件不提供 agent 工具——永久删除本来也只该由人点。
  • 多实例最后写入者获胜:JSON 存储域在多开 DSH 时可能互相回写已删记录(日志删除仍生效)。建议单实例操作,删完重启核对。

安装

dsh plugin --profile desktop add github:z1lyA/dsh-session-admin

或本地目录开发:plugin_manager({ action: "install_bundle", target: "<本地路径>" })。装完刷新一次页面(Client 插件清单在启动时收集),Host 改动需重启 DSH。

代码侧:index.js 是 Host(HTTP 路由 + 启动清扫),client.js 是浏览器半(侧栏入口 + 管理页 + 确认弹窗),lib/ 拆成 paths / attachments / archive / pending / http 五块,node --test 覆盖 44 项(路径越界、附件零引用删除、live 会话排队、启动清扫、队列上限等)。

仓库

github.com/z1lyA/dsh-session-admin — MIT,v0.1.0,欢迎 Star / Issue。