SMWHff
dsh-delete-session
DSH Web client+host plugin: delete a session (durable log + workspace accounting) from the session overflow menu
- Stars
- 0
- Language
- JavaScript
- Created
- Aug 15, 2026
- Updated
- Aug 15, 2026
Introduction
dsh-delete-session
Delete a session from the DSH Web GUI — DeepSeek Harness (dsh) Web 模式的主机 + 客户端插件。
在会话列表每行右侧的省略号菜单(重命名 / 分叉会话 / 归档会话)末尾追加一行
「删除会话」:点击后弹出产品级风险确认对话框(RiskConfirmation,
勾选「我了解此操作不可恢复」后方可确认),随后彻底删除该会话——包括
磁盘上的会话日志目录(sessions/<project>/<sessionId>/)与工作区记录中的
会话登记;成功 / 失败均有 Toast 反馈。
删除行为
- 运行中拒绝:该会话的 agent 正在运行时拒绝删除(提示等待完成)。
- 空闲存活实例:先
flush把缓冲事件落盘,再 detach;detach 发布的session/disposed由 host API proxy 转发为host/session-removed, 已打开的客户端列表自动移除该会话。 - 持久日志:通过
sessionPersistence.findLog定位日志文件,整目录移除。 - 工作区登记:从所有引用了该会话的工作区记录中 detach(触发
host/workspace-changed帧)。 - 客户端收尾:刷新会话基线;若删除的是当前打开会话,清空选择回到空态。
工作原理
- 主机端:按 dsh-open-in-vscode 同款模式注册严格 Typert Remote
(
deleteSession/delete),主机 Gateway 无需@Remote标记表即可解析调用。 - 客户端:当前构建的会话行菜单没有原生 slot,因此按 legacy 适配器模式
注入:识别会话行省略号按钮(aria-label 模板匹配),在 portal 菜单弹出时
用 MutationObserver 把删除行挂进菜单。会话身份解析优先级:当前选中行 →
显示标题唯一匹配;解析失败则不注入(宁缺毋滥)。确认对话框由独立 React
root 渲染(
RiskConfirmation+Toast,均来自 dsh-client-ui-primitives)。
安装
从 GitHub 安装:
# 克隆后以本地路径安装
git clone https://github.com/SMWHff/dsh-delete-session
pnpm dsh plugin --profile web add file:/path/to/dsh-delete-session
或手动:把包链接进 profile 的 node_modules,并在 profile manifest 登记:
"dependencies": { "dsh-delete-session": "file:/path/to/dsh-delete-session" },
"dsh": { "profile": { "bundles": [..., "dsh-delete-session"] } }
bundle 层增删需重启 web 表面,并刷新页面让浏览器拿到新的
window.__DSH_BOOT__ 图。包内 lib/ 已随源码提交,file: 安装无需重新构建。
构建
npm install # esbuild(一次性)
npm run build # 产出 lib/index.js(host ESM)与 lib/client.js(浏览器 bundle)
文件结构
dsh-delete-session/
├── package.json # dsh.bundle + dsh.client 声明
├── cordis.patch.yml # bundle 层:insert 一行挂载本插件
├── dsh.plugin.json
├── build.mjs # esbuild 构建脚本
├── tsconfig.json
├── src/
│ ├── index.ts # host half:注册 Typert manifest
│ ├── contract.ts # 共享 wire 契约(zod codec)
│ ├── typert.ts # TYPERT_MANIFEST
│ ├── runtime.ts # DeleteSessionRuntime:分层删除逻辑
│ └── client/
│ ├── index.ts # browser half:remote 挂载 + 菜单注入
│ ├── remote.ts # client Remote contribution
│ ├── locales.ts # zh/en 字典
│ └── session-menu.ts # 会话菜单 DOM 适配器
└── lib/ # 构建产物
兼容性
依赖运行时会话列表快照(displayTitle / blank / current)、workspace
locale 的 actions.session.aria / menu.archiveSession 模板,以及会话行
[role="treeitem"] 的 aria-selected 标记。官方后续版本若调整这些契约,
更新 src/client/session-menu.ts 顶部的识别逻辑即可。