ChenChen913/dsh-session-cleaner-cli

README 摘要

dsh-session-cleaner-cli 🐳🧹 English 深度清理 DeepSeek Harness（DSH）工作区会话的离线 CLI 工具 ：按工作区列出、勾选删除、回收站恢复，自动同步工作区账目与投影缓存。跨平台（Windows / macOS / Linux），零依赖。 为什么需要它 DSH 的会话持久化是 纯追加式设计 ，GUI 里只有"归档"（仅仅隐藏，数据仍在磁盘），没有任何删除入口（见 SessionPersistence 服务：只有 create/append/load/inspect/list，没有 delete）。测试会话、废弃对话会永远堆积。 本工具在工作区账目（ storages/workspace.json ）与会话日志目录（ sessions/ / / ）两层上同步删除，实现"自由删除每一个工作区里的对话"。 快速开始 CLI 版本： 安装 / 卸载 零依赖，Node.js ≥ 18 即可： 卸载就是删除仓库/脚本文件；若不再需要回收数据，可一并清空 /.dsh/trash 与 /.dsh/storages/backups 。 命令一览 命令 作用 （无参数） 交互式：选工作区 → 勾选会话删除 list 列出全部工作区与会话（只读，服务运行时也可执行） list -w 只看某个工作区 delete [id...] 删除指定会话（默认移入回收站；仍需输入 DELETE 确认） restore 恢复某次删除（批次见 trash list ） trash list / trash empty 查看 / 清空回收站 prune-ghosts 摘除账目中"数据目录已丢失"的幽灵 id 通用参数： --home （默认 $env:DSH HOME 或 /.dsh ）、 --pid-file （额外指定 dsh.pid 位置，服务存活检测用）、 --dry-run 、 --purge （不入回收站直接抹除）、 --yes 、 --force （跳过运行检测）。 工作原理 DSH 默认 JSONL 后端在磁盘上的形态： 删除一个会话 = 四步事务： 1. 备份 ：两份账目复制到 storages/backups/ / 2. 移入回收站 ：日志目录 → .dsh/trash/ / / （ --purge 直接删） 3. 同步账目 ：从 workspace.json 的 sessionIds 与 archivedSessionIds 摘除该 id，盖上 updatedAt 4. 清理缓存 ：删除 session projcache.json 对应条目（会话重新打开后自动重建） restore 是精确逆操作：目录移回、id 挂回原工作区、归档状态还原。 一个关键安全事实：DSH 工作区实体的 sessionIds getter 按"会…

分类