HrxSpace/dsh-session-sweeper

English

在 DSH Web 界面（设置 → 会话清道夫）中扫描、查看并安全清理本机 AI 终端会话历史——支持 Claude Code、Codex CLI、WorkBuddy 以及 DSH 自身。

截图

会话列表	消息预览
回收站	设置

功能

• 扫描：遍历用户目录下所有受支持来源，列出会话的标题、项目、消息数、 大小与最后活跃时间。
• 查看：分页预览会话内容（用户/助手消息、工具调用）——包括以 zstd 拼接帧存储的 DSH 日志。
• 清理：默认动作是隔离——整个工件（单文件，DSH 为整个会话目录）移入 回收目录，manifest 记录原路径与每个文件的 SHA-256，一键整批恢复、逐字节 校验。
• 永久删除：需要输入确认短语 DELETE，仅保留审计墓碑记录。

数据安全模型

防线	行为
隔离优先	默认清理移入 ~/.hist-sweeper/recycle/<batchId>/，随时可恢复
活跃保护	guardHours（默认 24 小时）内有修改的会话默认跳过，需显式勾选才纳入
当前会话	正在运行的 DSH 进程所服务的会话永不可清理
锁检测	无法独占打开的文件跳过，不中断整批
审计日志	所有操作追加写入 ~/.hist-sweeper/recycle/log.jsonl，回收站页签可查
边界	只动会话工件——绝不碰配置、凭据、memory、todos

安装

tarball（lib/ 已预构建并提交，无需任何构建脚本）：

dsh plugin --profile web add ./dsh-session-sweeper-1.0.0.tgz

git 安装（lib/ 已提交，因此无需 pnpm 构建授权）：

dsh plugin --profile web add github:HrxSpace/dsh-session-sweeper

安装后重启 dsh web，打开 设置 → Session Sweeper 会话清扫。

配置

在 profile 的 cordis.patch.yml 里覆盖插件行的 config: 即可：

选项	默认值	含义
guardHours	24	活跃保护窗口（小时）
recycleDir	~/.hist-sweeper/recycle	隔离回收目录

测试钩子（日常勿用）：DSH_SWEEPER_HOME / DSH_SWEEPER_RECYCLE 重定向 扫描根与回收根——测试套件用它们跑合成目录树。

卸载

dsh plugin --profile web remove dsh-session-sweeper

回收目录与审计日志在卸载后保留（那是你的恢复通道）；确认不再需要后手动删除 ~/.hist-sweeper 即可。

权限与网络

• 读取：~/.claude/projects/**、~/.codex/sessions/**（含 archived_sessions）、~/.workbuddy/projects/**、~/.dsh/sessions/**
• 写入：仅回收目录
• 在 DSH web 服务器上提供仅限同源的 JSON API（/sweeper/api/*），跨源请求一律拒绝
• 无网络访问、无生命周期脚本、除 node 内建外零运行时依赖（react 由 DSH client 运行时提供）

开发

# 构建（tsdown ≥0.22 均可；lib/ 产物提交入库）
npx tsdown

# 测试（node:test + tsx，无需安装任何依赖）
node --import tsx/esm --test tests/sweeper.test.ts

# 用本地构建起一个开发实例
pnpm dsh --profile web --patch ./cordis.dev.yml --port 3180 --no-open

许可

MIT