mcf171/dsh-session-delete ↗★ 0
@mcf171/dsh-session-delete
在菜单中提供永久删除会话并清理日志目录的功能 适合需要彻底抹除会话记录、物理删除本地日志文件的Web端用户。
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:mcf171/dsh-session-delete说明文档
阅读完整 README ↗@mcf171/dsh-session-delete
给 DeepSeek Harness(dsh)Web GUI 补上永久删除会话的动作。
官方 0.2.x 的会话行菜单只有 rename / fork / pin / archive,没有删除;这个插件加一项「删除会话」:确认后归档该会话、移除它的日志目录,并让那一行立刻从侧边栏消失。
零编译:lib/ 里是手写 JavaScript(host 端是 Cordis 插件,client 端是 __ModuleLoader__ 客户端包),改完文件重启 DSH 即生效。
结构
| 文件 | 作用 |
|---|---|
lib/index.js | host 端插件:注册同源路由 POST /_dsh/dsh-session-delete/delete,依次执行「归档 → 删日志目录 → 广播 api-session/removed」 |
lib/client.js | client 端包:注册 sidebar.workspaces.session.menu.item 菜单项「删除会话」+ 运行中守卫 + 确认框 |
cordis.patch.yml | bundle patch:声明 host 插件行(由 profile 的 dsh.profile.bundles 自动应用) |
test/format-check.mjs | 自测:路径算法是否与本机真实会话目录吻合 |
test/client-check.mjs | 自测:client 端的加载、注册、渲染、点击(取消/确认/运行中)全流程 |
行为
一次删除按固定顺序做三件事,顺序不能换:
- 先归档(
workspaceRegistry.archiveSession(id))——这是官方持久化的隐藏机制:主列表不再显示该会话,后续任何列表刷新都不会把它带回来。它同时自带活动检查,正在跑回合的会话会被拒绝(提示「该会话正在运行,请先停止后再删除」)。 必须先归档:archiveSession会检查会话是否仍然"已知",日志删掉之后再归档会抛WorkspaceUnknownSessionError。 - 再删日志目录(
/sessions/ //);目录已不存在时跳过,因此重复删除是幂等的,不会报错。 - 广播
api-session/removed——复用官方session/disposed → api-session/removed那条中继,client 收到后立刻把该行从 UI 移除。
- 内存残留:
SessionStore(ctx.sessions)只有 create/prepare/enter/announce/flush/get/list/fork,没有移除;enter()虽然返回"含 store removal 的 detach disposer",但只接受尚未入册的会话。所以打开过的会话对象会常驻到进程重启。这不影响使用——行已移除(归档 + 广播双重生效),也没有写入会去碰已删的日志。 - 不要调
sessions.refresh():列表 = 持久化扫描 + 内存中的活会话,删除后立刻刷新会把刚移除的行重新加回来。清理靠归档与广播,不靠刷新。
界面与快捷键
- 菜单项:会话行
⋯菜单里增加「删除会话」,左侧是官方IconTrashOutlineRegular的垃圾桶图标(路径数据逐条内联,与内置条目像素一致),右侧显示快捷键提示Delete。危险色标注。 - 快捷键
Delete:作用于当前选中的会话,走的是与鼠标点击完全相同的流程(运行中拒绝 → 确认框 → 删除)。三种情况下不触发:焦点在输入框/可编辑区域、按的是带修饰键的 Delete(Ctrl/Shift/Alt/Cmd)、当前没有选中会话。 - 不可撤销的操作由确认框把关,而不是靠组合键防误触。
设计取向
只使用官方扩展点,不劫持界面:
- UI:注册到官方插槽
sidebar.workspaces.session.menu.item,不监听也不改写侧边栏 DOM(DOM 注入式实现会随官方 UI 改版失效)。 - "运行中"的判断:读官方会话列表计算运行状态点的同一信号
agents.get(id).status === 'running'——只拦真正在跑回合的会话;打开过但已空闲的会话仍可删除。 - 删除动作:走
node:fs,不经 shell;目标目录用持久化后端自己的projectKey/encodeSegment规则定位,并遵循DSH_HOME(自定义 home 目录同样正确)。 - 顺序:先调官方
workspaceRegistry.archiveSession(持久隐藏),再删日志,最后广播官方的api-session/removed。 - 零新增依赖:整份 client 端只
require("react")——图标是内联 SVG(官方 artwork),快捷键是原生keydown监听。这既是体积考虑,也是可靠性考虑:官方dsh-client-ui-primitives只是组件库(没有dsh.client、也没有./client导出),把它写进dsh.client.inject/external会让整个 entry 无法激活。
安装(挂到某个 profile)
以 profile web(\profiles\web)为例:
-
把包放进 profile 的 node_modules(scoped 包位于
@\子目录下)。复制最稳妥:$dest = '\profiles\web\node_modules\@mcf171\dsh-session-delete' New-Item -ItemType Directory -Path (Split-Path $dest) -Force | Out-Null Copy-Item '' $dest -Recurse -Force Remove-Item "$dest\.git" -Recurse -Force -ErrorAction SilentlyContinue也可以用目录链接(改源码即时生效、不用重复复制):
New-Item -ItemType Junction -Path $dest -Target ''但部分 Windows 环境会拒绝在该位置创建链接(
Access denied,mklink /J同样失败)——遇到就退回复制,代价是改完代码要重新复制一次再重启。 -
登记依赖 + bundle(
\profiles\web\package.json):{ "dependencies": { "@mcf171/dsh-session-delete": "link:" }, "dsh": { "profile": { "bundles": [ // …已有项… "@mcf171/dsh-session-delete" ] } } }bundle-patch 型插件只登记
bundles,不要再在 profile 的cordis.patch.yml里写同名insert行(重复挂载会导致插件重复注册、整个插件树加载失败)。 -
重启 DSH(host 插件代码只在启动时加载)。
卸载
从 profile 的 dsh.profile.bundles 移除 @mcf171/dsh-session-delete,再删除 node_modules\@mcf171\dsh-session-delete 即可。
维护提示
-
pnpm install/ 插件市场重装可能清掉 profile 里的这份拷贝(它不在 lockfile 的解析结果里)。若重启后菜单项消失,按上面的「安装」重做第 1、2 步即可。 -
升级 DSH 后先确认插件仍在:重启后菜单里有没有「删除会话」;没有就重新挂载。
-
删除目标目录的算法必须与
@deepseek-ai/dsh-session-persistence-jsonl的format.ts(projectKey/encodeSegment)保持一致。升级后如怀疑路径规则变了,先跑自测:node test/format-check.mjs # 路径算法 vs 本机真实目录 node test/client-check.mjs # 客户端全流程 -
插件只删日志目录;workspace 归属里可能留下已删会话的死 id,这是无害的垃圾数据(会话列表的成员来自持久化扫描 + 内存会话,不读它)。
相关
- 重启脚本:
\restart-dsh-020.ps1(等待全部会话空闲后停服重建启动,启动失败自动回滚 profile)。 - DSH web 的授权栅栏:根路径无 token 返回 401,启动日志里会打印
?token=…;验证插件请用带 token 的请求。