byJming/dsh-session-cleaner

README 摘要

dsh-session-cleaner 可视化删除 DeepSeek Harness (dsh) 会话的小工具：本地 Node Web 服务 + 浏览器页面，零第三方依赖。 免责声明 ：本项目是非官方工具，与 DeepSeek / DeepSeek Harness 项目及其开发者 无隶属关系 ，不受其支持。 它直接读写 DeepSeek Harness 的磁盘数据（版本 0.1.0-rc.6 实测），属于 实验性工具 ：上游 pre-1.0 阶段的存储布局无兼容承诺， 后续版本可能变动，使用前请先升级到与本工具声明的兼容版本匹配，并留意删除确认信息。 功能 - 列出 $DSH HOME/sessions 下全部会话：标题、会话 ID、项目目录、创建时间、大小、是否已归档、fork 血缘（被哪些子会话引用） - 空白会话识别 ：采用 dsh 自身元数据（ sessionListMetadata.blank ，缺失时按日志内容兜底）标记由 GUI 页面加载自动创建的占位会话，默认隐藏、可一键显示，顶部横幅给出说明 - 现代 UI/UX：亮/暗主题跟随系统、搜索与排序、分组折叠、行详情展开（可复制 ID/路径）、统计条、Toast 通知、空状态页 - 勾选删除会话，并 自动同步清理 ： - storages/workspace.json ：归档列表 archivedSessionIds 与各工作区记录里的 sessionIds 槽位 - storages/session projcache.json ： tables.sessions 中的缓存行 - 删除后变空的会话项目目录 - 误删防线 ：删除前校验会话目录名与日志 header 中的 id 编码一致；header 缺失或目录名不一致的会话默认拒绝删除，需在确认框勾选豁免 - 安全保护 ：检测到 dsh 进程仍在运行时阻止删除（运行中的服务会把已删记录从内存回写复活）；仅在确认框里勾选强制执行才可绕过 - 删除前可选备份（默认开启，写入 %TEMP%/dsh-session-backup- / ）；删除后自动校验残留并展示报告 使用 前置：Node.js ≥ 22.15（需要 node:zlib 的 zstd 流式解码读取会话 header）。 启动后自动打开浏览器页面 http://127.0.0.1:38211/ 。 重要：删除前必须先完全停止 dsh web （关闭 dsh 窗口 / Ctrl+C）。 工具会检测 dsh 是否在运行，运行时删除按钮会被拦截。 参数： 测试 测试覆盖高风险纯逻辑：路径编码与目录名校验、注册表/缓存文档改写（只删目标、不动其他字段）、 以及用临时 fixture 主目录做的端到端删除（含拒绝未校验会话的分支）。不触碰真实 /.dsh 数据。 兼容性 - 测试于 dsh 0.1…

分类