会话残留清理 FenrirCait/dsh-session-leftover-purge

dsh-session-leftover-purge

删掉一个会话后，DeepSeek Harness 自己的记录清干净了，但 billion-context 的快照和索引、 cost-meter 的账本明细还留着。于是 bili 面板里还能看到那条会话，它的正文也还在 index.db 里。这个插件订阅 DSH 的 api-session/removed 事件，把剩下的部分补完。

安装

最省事：从 npm 装最新版，不需要 git，也不需要访问 GitHub
dsh plugin add dsh-session-leftover-purge

默认：永远装 main 的最新提交（需要本机有 git）
dsh plugin add github:FenrirCait/dsh-session-leftover-purge

需要锁死版本时，把 vX.Y.Z 换成 tags 页里的任意 tag
dsh plugin add github:FenrirCait/dsh-session-leftover-purge#vX.Y.Z

不需要 git：永远取最新一版的 tgz
dsh plugin add https://github.com/FenrirCait/dsh-session-leftover-purge/releases/latest/download/dsh-session-leftover-purge.tgz

四条命令都不会随版本变化，直接抄就行。

第一条走 npm registry，最省事也最稳；中间两条由 pnpm 走 git 协议，目标机器必须有 git；最后一条是普通 HTTPS 下载，只要求能访问 GitHub。每次发版都会同时上传两个附件：带版本号的 …-X.Y.Z.tgz 和固定名的 dsh-session-leftover-purge.tgz，后者就是 latest/download/ 指向的那个。

装完必须完全退出并重新打开 DSH。 host 半侧由 Loader 在进程启动时装载，运行中新装的包不会挂进当前进程。刷新页面只更新设置页里的表单，不会让清理逻辑生效。

依赖

必需：DeepSeek Harness 本身（>= 0.2.0-rc.1 < 0.3.0-0）。插件不跑常驻服务；它唯一 import 的第三方包 @deepseek-ai/schemastery 由宿主提供——在 peerDependencies 里声明为 optional， DSH 自带的 dsh-settings 本来就会装它，不需要额外安装任何东西。

功能上配合（缺了不会报错，只是对应能力自动跳过）：

| 组件 | 缺失时的表现 |
| @michengai/dsh-archive-manager | 没有「删除会话」入口，也不会触发清理，只能靠开机对账 |
| billion-context（bili） | 快照与索引两项跳过，日志记 bili-sessions-root-missing |
| dsh-cost-meter | 账本与明细文件两项跳过，日志记 ledger-missing / cost-files-root-missing |

也就是说：装上就能跑，缺谁就少清谁，不会因为别的插件没装而加载失败。

使用

装好后不需要任何操作。默认只做两件事：清掉 bili 的 JSON 快照和 index.db 里的行。

| 项目 | 默认 | 说明 |
| 总开关 | 开 | 关掉后不再清理，也不再监听删除 |
| bili JSON 快照 | 开 | 删掉 bili 面板里该会话的那一条 |
| bili SQLite 索引 | 开 | 删掉 bili 索引里的行；删前自动备份，可回滚 |
| cost-meter 账本明细 | 关 | 只删 cost-meter 账本里的明细行，总额不动 |
| cost-meter 原始明细文件 | 关 | 删掉 cost-meter 每轮用量的凭证文件 |
| 开机回收 index.db 空间 | 关 | 回收已删行占用的空间；失败不影响数据 |
| 备份保留天数 | 7 天 | 过期即删；0 = 永久保留 |
| 演练模式 | 关 | 只写日志，不移动也不删除 |
| 开机对账 | 开 | 启动时扫描孤儿快照并写报告 |
| 自动清理孤儿 | 关 | 对账发现孤儿就直接清理 |
| 开机延迟 | 8000 ms | 开机对账前等待多久 |

开关在 设置 → 插件 → 插件管理 → dsh-session-leftover-purge。改动即时生效，不用重启。

「恢复最近备份 / 删除全部备份 / 立即备份 cost-meter 账本」三个字段是触发器：填入一个新数字并保存就执行一次（DSH 的表单没有按钮，只能这样表达动作）。

备份与恢复

每次清理都在 ~/.dsh/storages/session-leftover-purge/trash/<时间戳>/ 留一份可还原的副本：

- index.db / index.db-wal / index.db-shm —— 删行前的完整数据库
- session-…__.json —— 移走的 bili 快照
- ledger.json —— 改账本前的完整副本（如果动过账本）
- cost-files/ —— 删掉的 cost-meter 明细文件

恢复入口就是上面那个「恢复最近备份」触发器。恢复时如果 bili 正持有数据库锁，会把文件写成 index.db.restored-<时间戳> 让你手动换，不会强行覆盖。

日志

~/.dsh/storages/session-leftover-purge/：

- purge.log —— 每次启动一行 ready v…，每次清理 / 恢复 / 删备份各一行
- orphans.json —— 最近一次对账结果
- triggers.json —— 已执行过的触发器数字

边界

- 只处理通过 archive-manager 删除会话的场景；其它途径靠开机对账发现。
- bili 的 index.db 属于另一个进程，遇到 SQLITE_BUSY 会跳过，下次再处理。
- 不碰 DSH 的附件、不碰 Electron 的 localStorage。
- 任何失败都只写日志，不抛给 DSH 的删除流程。

MIT License.