dsh-clean-session
Verifieddsh-clean-session · v1.1.1 · MIT · Web UI
DSH Web plugin: a Delete button on every session row. Stops running work, releases the session, removes the log (plus subagent logs) and lets you tick which files the session created should be deleted too.
Install
dsh plugin add dsh-clean-session Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-clean-session
为 DSH Web 界面的每个会话栏右侧添加一个「删除」按钮:停止正在运行的工作、关闭并彻底删除会话, 并由你勾选确认是否连带删除该会话创建的文件。
A DSH Web plugin that adds a Delete button to the end of every session row. It stops running work, releases the session, removes the log for good, and asks you to tick the files the session created before any of them are deleted.
安装 / Install
装好 DSH(Web GUI)后,打开侧边栏 Plugins(插件) 页 → 安装/添加,把下面任意一种地址粘进去:
| 方式 | 输入 |
|---|---|
| npm 包(已发布) | dsh-clean-session |
| GitHub 仓库 | https://github.com/doughnuts/dsh-clean-session |
| 本地打包文件 | D:\创建插件\dsh-session-remove\dsh-clean-session-1.1.0.tgz(或该文件的绝对路径) |
| 本地源码目录 | D:\创建插件\dsh-session-remove |
注意:
dsh-session-remove这个包名被其他作者占用(是另一个插件),本插件的 npm 名是dsh-clean-session(https://www.npmjs.com/package/dsh-clean-session)。
也可以让 agent 用 plugin_manager 工具安装,或命令行:
dsh plugin --profile <profile> add dsh-clean-session
dsh plugin --profile <profile> add https://github.com/doughnuts/dsh-clean-session
安装完成后刷新一次页面(Ctrl+R),侧边栏每个会话行的悬停按钮条里就会出现垃圾桶图标。 插件只影响当前 profile,重启后依然有效。
从 GitHub / 压缩包安装时,包名以
package.json为准(本包为dsh-clean-session)。
使用 / Usage
- 把鼠标移到任意会话行,右侧出现「归档」「置顶」后面的垃圾桶图标。
- 点击后弹出「删除会话」:
- 列出本会话开始后新建、且当前仍存在于磁盘的文件(含大小);
write工具写过的路径会补齐; - 默认一个都不勾选——不勾选则文件全部保留,只删会话;
- 「全选」可一次勾选全部文件;
- 会话正在打开时会提示「会先停止并关闭它」;有子代理会话时会提示将连带删除的数量。
- 列出本会话开始后新建、且当前仍存在于磁盘的文件(含大小);
- 点「删除会话」。会话正在运行或仍被打开时,勾选「强制删除」即可一步完成 (先停止回复、再关闭会话、最后删除)。
- 删除后该行立即消失;删的是当前会话时,主区域会回到空状态。
删除顺序(为什么现在删得掉)
早期版本直接删文件,遇到仍被进程持有的会话时,写句柄会在下一次 flush 时把日志写回来—— 表现就是「有些会话删不掉 / 删了又回来」。现在严格按下面的顺序执行:
释放会话(从进程内会话表摘除)→ 停止回合/子代理/后台任务/定时提醒
→ 等待工作真正清零 → 持久化 flush 屏障 → 删除日志目录
- 会话仍被打开且无法安全释放时拒绝删除,不会留下半删状态;
- 停止后仍有工作没清零时拒绝并提示稍候重试;
- 子代理会话(
origin: "subagent",含多层)随父会话一起停止、释放、删除; fork 出来的会话是独立对话,不连带删除; - 删除完成后向页面发出
api-session/removed,侧栏该行当帧消失,无需刷新。
会删掉什么 / What gets removed
- 会话日志目录(
<DSH_HOME>/sessions/<项目>/<会话 id>/,经持久化后端locate()定位并校验目录名) - 该会话的投影缓存记录(
session_projcache域 + 缓存文件) - 工作区里的会话登记、置顶与归档标记
- 该会话名下每个子代理会话的日志目录与投影缓存
- 你在对话框里勾选的文件(工作区里会话开始后新建的文件)
不会删除:fork 会话、附件内容寻址存储里的共享 blob(可能被其他会话复用)、 其他会话对它的引用、搜索索引(后端按持久化列表自行对账)。
安全边界 / Safety
| 情况 | 行为 |
|---|---|
| 会话仍被打开 | 先安全释放再删;释放接口不可用时拒绝(session-release-unsupported) |
| 回合 / 子代理 / 后台任务 / 定时提醒仍在跑 | 先停止并等待清零;超时拒绝(session-stopping) |
| 子代理会话仍在跑 | 先停止并等待;失败则父会话一个文件都不动(subagent-active) |
| flush 屏障失败 | 拒绝(flush-failed),避免活句柄回写 |
| 目录无法自证属于该会话 | 拒绝(unsafe-location),绝不猜路径 |
| 会话不存在 | 拒绝(session-not-found) |
配置 / Config
写在插件行的 config 下,全部可选:
| 字段 | 默认 | 说明 |
|---|---|---|
deleteSubagentSessions |
true |
连带删除该会话名下的子代理会话;false 只删选中的会话 |
stopWaitMs |
10000 |
停止后等待工作清零的上限(毫秒) |
sessionsRoot |
$DSH_HOME/sessions |
会话根目录覆盖(一般不用填) |
自检 / Tests
仓库内自带 Host 半的行为测试(不随 npm 包分发):
node test/host.test.mjs
覆盖 9 个场景:普通删除、活动会话释放+flush、运行中会话的「释放→停止→等待」顺序、
释放接口缺失时的拒绝、子代理连带删除与 fork 保留、archiveSession 停止回退、
locate 缺失时的目录扫描回退、工作区文件按创建时间筛选、flush 失败拒绝。
开发 / Development
纯 JavaScript,无构建步骤:
- Host 半:
index.js,通过 Typert 网关暴露sessionDeleter/listCreatedFiles与sessionDeleter/deleteSession; - Client 半:
client.js,注册sidebar.workspaces.session.row.action(按钮)与shell.overlay(对话框),经/apiRPC 调 Host。
源码目录直接安装(link)即可边改边看,改完刷新页面:
dsh plugin --profile <profile> add link:D:\创建插件\dsh-session-remove
本仓库同时含:
checks.yml:CI 语法检查 + 打包 dry-runrelease.yml:打v*标签打包并创建 GitHub Release(配置了NPM_TOKEN时同时发布 npm)
发布 / Releasing
- npm:https://www.npmjs.com/package/dsh-clean-session
- GitHub:https://github.com/doughnuts/dsh-clean-session
发布新版本:
- 改版本号:
npm version patch(或手动改package.json); - 在本仓库目录执行
node scripts/publish.mjs—— 它会以package.json的name为准,同步cordis.patch.yml与client.js的模块 id 后发布(需要 2FA 或带 bypass-2FA 的 granular token;也可以双击publish.cmd输入 OTP); git push;- 可选:推
v<版本>标签,CI 会打包并创建 GitHub Release;若仓库配置了NPM_TOKENsecret,CI 也会同时发布 npm。
License
MIT