Saltar al contenido principal
A

dsh-session-manager-delete

anheon/dsh-session-manager-delete

Permanently deletes archived DSH sessions in one pass: stops their running work, unregisters them from the host, removes the logs, projection cache and spill directories, detaches workspace accounting and clears browser-side drafts, tabs and layout, then reloads the list; only archived sessions qualify, path and origin checks guard each step, and a session whose work will not stop is not deleted. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Instalar

dsh plugin --profile web add github:anheon/dsh-session-manager-delete

README

dsh-session-manager-delete

DSH 会话删除插件。 把已经归档的会话从侧栏、磁盘、工作区登记和浏览器本地状态里彻底删掉;删完不需要手动刷新,也不会留下「未分组」幽灵。

删除不可撤销。插件不碰工作区目录里的任何文件,也不删附件。


让 agent 帮你部署

不想自己找 DSH profile、改依赖、重启应用?把下面这段话交给你的编程 agent(DSH 自带的 agent、Claude Code、Codex 都可以):

请帮我安装 DSH 插件 dsh-session-manager-delete。

  1. 先读 https://github.com/anheon/dsh-session-manager-delete 的 README,按「安装」一节操作;
  2. 安装前备份 ~/.dsh/profiles/desktop/package.json;
  3. 装完告诉我怎么重启 DSH、怎么验证插件已经加载;
  4. 不要删除我的任何会话,也不要改我的工作区文件。

Agent 会读文档、找到你的 DSH profile、安装包并把插件加进 bundle 列表。你只需要确认它要改的文件,然后重启 DSH。


它解决什么问题

DSH 的一个会话不只是一份日志。它同时存在于五个地方:

  1. 宿主进程的 ctx.sessions / ctx.agents 内存表;
  2. $DSH_HOME/sessions/<工作区>/<会话 id>/ 下的对话日志;
  3. $DSH_HOME/storages/session_projcache/ 下的投影缓存;
  4. 工作区登记(workspace.json 里的归属、归档、置顶);
  5. 浏览器 localStorage 里的草稿、页签、布局、当前选中。

只删日志,宿主内存还记着它;只注销内存,磁盘上还留着;先摘工作区登记、后删文件,侧栏旧快照就会把它显示成一条「未分组」。本插件按「关终端 → 注销宿主内存 → 删磁盘 → 摘登记 → 清本地状态 → 重拉列表」的顺序一次做完,并且在每一步之后复核。


能做什么

  • 只对已归档的会话开放删除;未归档时确认框会直接告诉你怎么归档。
  • 删除前给出完整清单:会话 id、文件与字节数、登记变更、浏览器本地状态、悬空引用、可选连带删除的派生会话。
  • 有工作在跑时,给一个默认勾选的「先停掉正在跑的工作」;停完再验一次,停不下来就拒删。
  • 子代理会话随父会话一起删(它们在侧栏里本来就没有入口);fork 出来的可见会话默认保留,可在确认框里勾选一并删除。
  • 删除后自动重拉会话列表,不需要手动刷新。
  • 旧版本留下的「未分组」幽灵条目,可以在确认框里点「现在清理」,只清登记、不碰磁盘。
  • 路径三道校验、同源校验、确认标记、失败即拒删(fail closed)。

不做什么

  • 不删工作区目录里的代码、文档、附件。
  • 不删跨会话共享的 attachments/、cache/、凭据、profile。
  • 不顺着软链/联接去删目标。
  • 不碰其他会话的日志、缓存、登记、本地状态。
  • 不提供回收站或撤销:删除就是删除。

安装

从 npm 安装(推荐)

要求:DSH desktop,Node.js 22 或更高(DSH 自带运行时也可以)。

  1. 打开 DSH 的插件管理器(设置里的插件/扩展入口)。

  2. 安装 spec 填:

    dsh-session-manager-delete
    
  3. 安装完成后完全退出并重启 DSH。宿主半区只有在重启后才会加载。

  4. 重启后,在侧栏找一个已归档的会话,点它的「…」菜单;能看到「删除会话…」就说明装好了。

如果插件管理器用的是国内镜像、暂时搜不到这个包,可以先把 npm registry 切到官方源再装:

npm config set registry https://registry.npmjs.org/

装完可以切回原来的镜像。

从源码安装(开发/本地修改)

git clone https://github.com/anheon/dsh-session-manager-delete.git
cd dsh-session-manager-delete
npm test

然后在 DSH 插件管理器里安装:

link:<这个目录的绝对路径>

安装后重启 DSH。之后改代码的流程是:

npm run build          # 改了 lib/client.js 必须重新构建
# 重启 DSH

更新与卸载

  • 更新:在插件管理器里更新/重装,然后重启 DSH。
  • 卸载:在插件管理器里卸载即可。插件不写自己的状态文件,卸载后没有额外残留。

使用

  1. 在侧栏把要删的会话归档(「…」→「归档」)。
  2. 再点「…」→「删除会话…」。
  3. 读完确认框里的清单,勾选底部的确认框,点危险按钮。

确认框里会写清楚:

  • 会话标题、id、归档状态、占用空间、记录条数、创建时间、工作目录;
  • 要删的日志、投影缓存、spill 临时目录、空目录;
  • 要摘的工作区登记、要清的浏览器本地状态;
  • 旧幽灵的悬空引用(如果有),以及「现在清理」入口;
  • 有工作在跑时的「先停掉」勾选;
  • 可选连带删除的 fork 列表(勾了才会删,且 fork 自己也必须已归档);
  • 哪些东西不会被删。

删除成功后,插件会调用 DSH 的 ctx.sessions.refresh() 重拉权威列表。正常情况下侧栏里的那一行会直接消失,不需要刷新页面。

如果重拉失败(宿主服务掉线等),完成页会明确写「侧栏列表没有刷新成功……刷新页面就会消失」,不会把已经完成的删除说成失败。

已经删过、但界面还留着「未分组」怎么办

那是旧版本留下的悬空登记。打开任意一个已归档会话的删除确认框,点「现在清理」;它只走工作区登记的官方接口,不删任何会话。也可以重启一次 DSH,之后不会再产生新的。


删除范围

位置处理
宿主内存从 ctx.sessions 与 ctx.agents 注销,发出配对的 disposed 事件
对话日志递归删除 $DSH_HOME/sessions/<工作区>/<会话 id>/
投影缓存删除 $DSH_HOME/storages/session_projcache/sessions/<id>.json 及其备份
spill 临时目录按会话 id 的 sha256 前缀精确指认,尽力删除
空工作区目录只收走这次删完确实变空的 slug 目录
工作区登记取消置顶、取消归档、移出工作区;再清悬空引用
浏览器本地状态删会话私有键,定点摘共享键里的引用
侧栏列表调用 ctx.sessions.refresh() 重拉

不会删:attachments/、cache/、凭据、profiles、工作区里的代码/文档、其他会话、软链/联接的目标、<TEMP>/dsh-workspace-changes-*。

完整的键名与清理规则见 docs/DESIGN.md。


安全设计

闸门规则不过时
身份与路径会话 id 必须是小写 (session-)?<uuid>;拼出的路径要过字符串、lstat、realpath 三道校验拒绝,什么都不动
归档只删已归档会话;归档状态读不到也拒删409
活动对删除集合里每个会话问一次官方活动瀑布;有工作在跑时先停再验409
注销能力两个宿主注册表必须是 store Map + detachEntered 形状拒绝,什么都不动
确认POST 必须带 confirm: 'delete-session',界面还要勾选确认框400
同源Sec-Fetch-Site 只接受 same-origin/none;删除要求 Origin/Host 同源且 Host 是 IP 字面量或 localhost403
清单只删查询时算出来、并给用户看过的路径和 id清单外的东西不碰
复核注销后复核内存,删完复核磁盘,摘完复核登记409 / 500,如实报告

删除顺序本身也是安全设计:

flowchart LR
  A[已归档会话] --> B[生成并展示清单]
  B --> C[关闭会话名下终端]
  C --> D[注销宿主内存]
  D --> E[删投影缓存]
  E --> F[删对话日志]
  F --> G[摘工作区登记]
  G --> H[清浏览器本地状态]
  H --> I[重拉侧栏列表]
  • 先关终端再注销:终端按属主对象身份匹配,注销后就找不到那个对象了。
  • 先删可重建的缓存,最后删日志:中途失败时尽量保住一条完整、可重试的会话。
  • 删干净才摘登记:否则会留下「界面里没有、磁盘上还在」的孤儿。
  • 注销没生效就拒删:宁可不让删,也不硬删之后留一颗刷新去不掉的幽灵。

HTTP 接口

插件注册一条同源路由:/dsh-session-manager-delete/api。

请求作用
GET /dsh-session-manager-delete/api?id=<sessionId>只读预览:能不能删、会删什么、有什么阻断项
POST /dsh-session-manager-delete/api {id, confirm, dangling, extraRoots?, stop?}删除
POST /dsh-session-manager-delete/api {repair: true, confirm}只清工作区登记里的悬空引用,不删磁盘

返回状态:

状态含义
200全部复核通过
400id/请求体/清单形状不对,或超过 200 条;什么都没动
403跨站或 Host 不是 IP 字面量/localhost;什么都没动
404会话已经不存在;没什么可删的
409没归档、注销能力不可用、注销没生效、还有工作在跑且没停、目标超过 200;文件与登记保持原样
413请求体过大;什么都没动
500文件没删净;登记保持原样,但终端可能已关、宿主内存已注销,残留路径会逐条列出

成功不是「试过了」,而是注销后复核、删完扫盘、摘完查登记都通过才回 200。


开发与验证

要求 Node.js 22+。项目没有运行时依赖,测试也不需要安装依赖。

# 构建浏览器半区(改了 lib/client.js 必须重跑)
npm run build

# 检查 bundle 是否过期(不写文件)
npm run check:bundle

# 宿主端到端测试(315 项)
npm run check:host

# 浏览器半区行为测试(201 项)
npm run check:client

# 全部:构建 + 宿主 + 浏览器
npm test

scripts/verify-host.mjs 在临时 DSH_HOME 里搭真实形状的夹具:父会话、子代理、fork、未归档、运行中、未落盘、软链、被占用、悬空引用,外加附件/凭据/工作区登记做诱饵。它像浏览器一样调路由,逐条验证删除范围、闸门、失败语义和复核。

scripts/verify-client.mjs 在微型 React、假 DOM、会记账的 localStorage 里跑构建产物,验证菜单、确认框、勾选、删除、本地状态清理、超时、迟到响应、焦点归还和卸载清理。

GitHub Actions 用 Node 22 + Windows 跑同一套,并且先跑 npm run check:bundle 防止 client.bundle.js 漂移。


已知边界

  • 只能删已归档会话;归档状态读不到时也会拒删。
  • 只看得到当前宿主进程:同机另一个进程共享 DSH_HOME 时,它跑的回合、它持有的会话不在保护范围内。
  • 日志在软链/联接后面时拒删:插件不顺着链接删,会明确说明让你手动处理。
  • 附件不回收:附件是跨会话共享的内容寻址对象,DSH 没有按会话回收的机制。
  • <TEMP>/dsh-workspace-changes-* 认不出来:目录名是随机串、不带会话 id,插件不猜。
  • 自定义域名/反向代理下删除会被拒:Host 必须是 IP 字面量或 localhost,用来挡 DNS rebinding;查询不受影响。
  • 一次最多 200 条:待删目标或悬空引用超过 200 时,请分批处理;超出会明确报错,不会静默截断。
  • 删除不可撤销:没有回收站,也没有撤销。
  • 重拉列表失败不算删除失败:文件已经删了,完成页会提示手动刷新。

设计说明

为什么用一条 HTTP 路由、为什么必须让宿主忘掉会话、为什么先删缓存后删日志、为什么共享键只做定点摘除、为什么并发删除要占住整批目标——这些取舍写在 docs/DESIGN.md。


许可证

MIT。Copyright (c) 2026 anheon。

Plugins relacionados