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///）两层上同步删除，实现"自由删除每一个工作区里的对话"。

快速开始

# 1. 先停止 GUI（工具检测到 3080 端口/进程时自动拒绝删除）
#    Windows: 在 deepseek-harness 仓库根目录运行 stop-dsh.cmd
#    macOS / Linux: 在运行 dsh web 的终端按 Ctrl+C，或 kill 对应进程

# 2. 交互式：选工作区 → 输入编号勾选（1,3 / 2-5 / all）→ 输入 DELETE 确认
node dsh-session-cleaner.mjs

# 3. 重新启动 GUI（重启后侧边栏即为最新状态）

CLI 版本：

node dsh-session-cleaner.mjs list                  # 只读列出全部工作区与会话
node dsh-session-cleaner.mjs delete  [id...]   # 删除指定会话（--yes 跳过确认）
node dsh-session-cleaner.mjs restore        # 恢复某次删除
node dsh-session-cleaner.mjs trash list            # 查看回收站
node dsh-session-cleaner.mjs prune-ghosts          # 摘除账目中数据已丢失的幽灵 id

安装 / 卸载

零依赖，Node.js ≥ 18 即可：

# 方式一：直接从 GitHub 用 npx 运行（无需克隆）
npx github:ChenChen913/dsh-session-cleaner-cli list

# 方式二：克隆
git clone https://github.com/ChenChen913/dsh-session-cleaner-cli.git
cd dsh-session-cleaner-cli
node dsh-session-cleaner.mjs

卸载就是删除仓库/脚本文件；若不再需要回收数据，可一并清空 ~/.dsh/trash 与 ~/.dsh/storages/backups。

命令一览