DeepSeek Harness 插件

yukre/dsh-session-delete

Star 数 ★ 0 分类 会话与消息 收录于 2026-11-16

从侧栏菜单永久删除会话及其对话日志,带二次确认,并拒绝删除正在运行的会话。归档只是隐藏,这个才真正删掉。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:yukre/dsh-session-delete

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

给 DeepSeek Harness 的侧栏会话右键菜单新增一项 「删除会话…」,永久删除该会话及其对话日志。

为什么需要它

DSH 内置的 归档 (Archive) 与真正的 删除 (Delete) 是两件不同的事。归档只往工作区注册表写一个隐藏标记,会话日志一字不动、可随时取消归档恢复。DSH 也没有提供删除单个会话的 API:

  • SessionPersistence 只有 create / open / flush / stat / list,没有 delete
  • WorkspaceRegistry.delete(id) 删的是工作区,且注释明确「保留目录与全部会话日志」

本插件补上这个缺口,并与归档严格分开:归档是隐藏,删除是清除。

归档(内置) 删除(本插件)
效果 从侧栏隐藏 从磁盘移除
会话日志 完整保留 永久删除
可恢复 可以 不可撤销
释放磁盘 否 是

使用方法

  1. 鼠标移到左侧会话列表中的目标会话上,点行尾 「…」 菜单
  2. 选择 「删除会话…」
  3. 确认框显示该会话标题,确认后立即删除

安全设计

  • 必须在确认框中确认:显示会话标题,并明确提示不可撤销、同时提示"只想隐藏请用归档"
  • 运行中的会话禁止删除(SESSION_RUNNING),避免在日志仍被写入时删除导致损坏
  • 当前打开的会话禁止删除(SESSION_OPEN),避免界面持有已消失的会话
  • 会话 ID 白名单校验:只允许单段安全字符,拒绝 ..、/、绝对路径
  • 路径越界防护:解析后必须仍在会话根目录内
  • 同源校验:要求 JSON Content-Type 且 Origin 与 Host 一致,跨站请求被拒

删除的是什么

~/.dsh/sessions/<工作区编码>/<会话ID>/
  session.v4.jsonl.zstd   对话日志
  session.lock            写入锁文件(无数据)

删除即移除该会话目录。会话列表由扫描该目录树得出,因此删除后无需重建索引;Host 端还会发出 api-session/removed 通知,让侧栏立即移除该行。

安装状态

已作为 bundle 安装进 desktop profile,并写入正式配置(dsh.profile.bundles)。

  • Host 端(删除接口):已生效并实测通过
  • Client 端(菜单入口):需重启 DeepSeek Harness 后才会出现在浏览器中

验证记录

Host 删除接口在真实运行环境中验证通过(使用独立测试目录,验证后已清理):

场景 结果
正常删除测试会话 ✅ 200 {"ok":true,...},目录已移除
不存在的会话 ✅ 409 NOT_FOUND
无 Origin 头 ✅ 403 BAD_ORIGIN
跨站 Origin ✅ 403 BAD_ORIGIN
路径穿越 ../../etc ✅ 409 BAD_SESSION_ID
非 JSON Content-Type ✅ 403
GET 方法 ✅ 405 METHOD_NOT_ALLOWED
运行中会话 ✅ 409 SESSION_RUNNING,未删除

限制

  • 删除不可恢复,没有回收站
  • 被删会话的附件、worktree 等关联数据不会被连带清理
  • 会话级搜索索引可能残留指向已删日志的条目(不影响正常使用)
  • 若后端不是 JSONL(Desktop 默认是),本插件不适用

卸载

在插件管理中停用或移除 dsh-session-delete 即可,不影响 DSH 本体,也不影响已归档/未归档的任何会话。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。