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