xohmai/dsh-session-delete

Plugin插件 Native原生 ⭐ 16 Apache-2.0 Sessions & Context会话与上下文

DeepSeek Harness 会话删除插件:设置页管理归档会话,真正删除磁盘日志(回收站可还原)+ 批量清理——官方归档只隐藏不删盘,这里补上。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that adds full session deletion functionality. The native DSH archiving feature only removes sessions from the sidebar, leaving session log files stored permanently on local disk, which takes up unnecessary storage over time. This plugin fills that gap by enabling true permanent deletion, with an intermediate recycle bin step that lets users restore deleted sessions if needed. It can be installed directly from GitHub using DSH's built-in plugin CLI command, and requires no local build steps since it is written entirely in plain JavaScript.

After installing the plugin, users need to restart the DSH web service for changes to take effect. Once restarted, users can access the session management interface by navigating to DSH's Settings > Archived Sessions page. Archived sessions are listed here, and users can either restore them directly to their original sidebar groups or delete them permanently. All sessions, regardless of archive status, can be easily viewed, filtered, selected, and deleted in bulk from the All Sessions tab, which groups sessions by workspace. Users can click any row to quickly select the session for deletion or restoration.

The plugin is released under the open-source Apache-2.0 license, and is compatible with both new and old versions of DSH's session persistence API. For older versions of DSH that do not support online unarchiving, the plugin includes an offline Node.js tool to retrieve hidden sessions. It supports both online installation directly from the GitHub repository and offline installation via a npm-packed tarball, which works well for internal network environments where external GitHub access is restricted. Any known compatibility issues with older DSH versions have been patched in recent stable releases.

这是一个专为 DeepSeek Harness (DSH) 开发的原生会话管理插件,用于解决官方 DSH 仅归档会话、不永久删除磁盘日志文件的问题,补上了真正彻底删除会话的功能,同时支持删除后送入回收站还原。插件支持批量勾选删除会话,可按工作区分组管理、搜索过滤会话,禁止删除正在运行的会话,可以通过 DSH 官方的插件命令直接从 GitHub 安装,无需额外构建步骤。

典型工作流是用户安装插件重启 DSH 后,进入设置页的「归档会话」标签页管理会话。已归档的会话会列在这里,用户可以选择直接还原到侧栏原分组,也可以选择删除;所有会话都可以在「全部会话」标签页批量处理,删除操作会先把会话文件移到回收站,需要时可以还原,确定不需要后可彻底删除。

本插件采用 Apache-2.0 开源协议,同时兼容新版和旧版 DSH 的会话持久化接口,已知的旧接口兼容问题已经修复。对于不支持在线解除归档的旧版 DSH,提供了离线工具找回隐藏会话。插件安装后需要重启 DSH web 服务才能生效,也支持通过 npm 打包后离线安装,满足内网环境部署需求。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 16 stars - an early-stage project星标 16,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 xohmai/dsh-session-delete 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-session-delete

DSH(DeepSeek Harness)会话删除插件:官方「归档」只把会话移出侧栏,磁盘日志永久堆积——本插件补上真正的删除,先进回收站可还原。

  • 归档会话:已归档会话行内「还原」解除归档(侧栏原分组立即可见),或一键真删,支持勾选批量
  • 全部会话:按工作区分组,支持搜索、过滤、全选、批量删除,点击整行即可选中
  • 回收站:按会话名称识别被删条目,多选批量还原(自动解除归档,一步回到侧栏)/ 彻底删除,或一键清空
  • 正在运行的会话拒绝删除;删除当前打开的会话时自动切到空白会话

安装

dsh plugin add 会自动完成依赖链接与 profile 注册,装完重启 dsh web 生效。卸载:dsh plugin --profile web remove dsh-session-delete。

方式一:GitHub 直装(推荐)

dsh plugin --profile web add github:xohmai/dsh-session-delete
# 锁定版本更安全:github:xohmai/dsh-session-delete#<commit-sha>

本插件零构建(纯 JS,无 TypeScript / 无打包步骤),git 安装不会踩「源码拉下来没跑 build」的坑,也无需 pnpm allowBuilds 授权。

方式二:tarball 离线分发(内网场景)

npm pack                                               # 产出 dsh-session-delete-0.5.0.tgz
dsh plugin --profile web add ./dsh-session-delete-0.5.0.tgz

使用

  1. 打开 设置 → 归档会话
  2. 首次加载为流式拉取:居中过渡动画实时显示「已加载 N / M 个会话」,会话很多时也能看到进度;重新加载(已有数据)则静默刷新,旧列表保持可操作。标题优先走 DSH 投影缓存(与侧栏同源、零解压),几百个会话也是亚秒级;仅缓存未命中的会话批量补一次解压
  3. 在侧栏右键归档的会话出现在「归档会话」页签:行内「还原」解除归档(侧栏原分组立即可见),或删除;「全部会话」页签可处理任意会话
  4. 删除先入回收站(~/.dsh/trash/sessions/),「还原」时文件归位并自动解除归档;确定不要再「彻底删除」
  5. 删除后不会回到侧栏:会话的归档 id 在运行期间有意保留(它只是侧栏的隐藏标记;没有行数据的 ghost id 在官方 UI 里不渲染任何东西)。运行期间摘除它会广播归档变更,把已连接客户端列表缓存里的残留行重新显示出来——因此 ghost 统一在重启 DSH 时由启动 reconcile 清理(此刻所有客户端都用全新基线,摘除绝对安全)
  6. 回收站还原不受此限制:文件归位 + 自动解除归档,会话立即回到侧栏原分组

旧版 DSH 回退:在线解除归档走 workspaceRegistry 内部状态机,插件启动时自动探测能力;不可用时隐藏还原入口,可在 DSH 停止时运行 node tools/unhide.mjs <sessionId> 离线找回。旧版同样无法在重启时清理归档 ghost(能力缺失时 reconcile 静默跳过)。

兼容性:同时支持新版(0.1.5+,sessionPersistence.list() 返回 {header, revision, sizeBytes} 快照)与旧版(≤0.1.1-rc.x,直接返回 header 数组)两代持久化接口——v0.4.0 在 DSH 0.1.5 上 /list、/trash 全部 500("reading 'length'")的问题已在 v0.4.1 修复。

开发

npm test   # node test/smoke.mjs && node test/render.mjs

License

Apache-2.0

← 上一个 Prev agent-guard 下一个 Next deepseek-harness-hello-kitty-suite →