前言¶
在使用 DeepSeek Harness (DSH) 及相关 AI 终端工具（如 Claude Code、Codex CLI、WorkBuddy）时，本地会话文件会持续积累。手动管理这些文件不仅繁琐，且容易误删重要数据。dsh-session-sweeper 插件旨在提供一个安全的会话管理入口，让你在 DSH Web 界面中扫描、查看并清理这些本地历史记录。
这是什么¶
这是由 HrxSpace 维护的一个 DSH 插件。它扫描并管理电脑本地所有终端的会话（Claude Code、Codex、WorkBuddy、DSH 等）。
核心功能¶
该插件提供以下核心能力：
- 会话扫描与列表：扫描并列出会话，包含标题、项目、消息数、大小、最后活跃时间。
- 内容查看：查看会话内容，支持包含 DSH 日志在内的预览。
- 安全清理：默认采用隔离优先策略，将文件移动到回收站，并附带 SHA-256 清单；支持一键批量恢复。
- 硬删除：提供硬删除功能，但需输入确认短语
DELETE。 - 目录读取：支持读取特定目录下的会话（Claude Code、Codex、WorkBuddy、DSH）。
- API 与隐私：提供同源 JSON API (
/sweeper/api/*)，且无网络访问权限。
安装与启用¶
使用官方提供的命令进行安装：
dsh plugin --profile web add github:HrxSpace/dsh-session-sweeper
安装完成后，重启 dsh web，然后在 Web UI 中打开 设置 -> 会话清道夫。
典型用法¶
在 会话清道夫 页面，你可以看到本地所有会话的列表。若要执行硬删除，系统会要求输入确认短语 DELETE。
对于测试环境或自定义路径，可以使用以下环境变量：
* DSH_SWEEPER_HOME：重定向扫描的源目录
* DSH_SWEEPER_RECYCLE：重定向回收站根目录
适用场景与注意¶
该插件运行在当前 dsh 进程的权限上下文中，操作前建议检查源码与许可证。
- 数据安全模型：默认隔离窗口为 24 小时，活跃会话会被跳过。当前正在被使用的会话不可清理。
- 文件操作范围：插件仅触碰会话文件，不会修改配置、凭据、记忆或待办事项。
- 目录读写：
- 读取：
~/.claude/projects/**、~/.codex/sessions/**、~/.workbuddy/projects/**、~/.dsh/sessions/** - 写入：仅回收站目录（默认为
~/.hist-sweeper/recycle）
- 读取：
- 卸载行为：回收目录和审计日志在卸载后仍会保留，手动删除
~/.hist-sweeper即可彻底清理。
短结尾¶
更多详情请访问 GitHub 仓库。
