🚀 首个公开版本
为 DeepSeek Harness (dsh) 打造的环境清理引擎：把"删除插件残留"这件危险的事，做成可验证、可撤销、可审计的事务系统。
✨ 核心能力
- 事务引擎 — ACID 批量清理：WAL 预写日志（CRC 完整性校验）+ 备份区 + Saga 反向补偿
- 崩溃自恢复 —
nuke_recover自动重放未终结事务；restore 失败/孤儿产物时拒绝 purge，绝不说删就删 - 审计不可篡改 — hash chain 操作日志，任何篡改可被
verify()检出 - 并发安全锁 — O_EXCL 原子获取 + bootToken 归属核验 + 固定名 guard 目录互斥（读写锁，shared/exclusive）
- 三级策略守卫 — safe / balanced / aggressive；保护名单 / 回收上限 / 黑窗期作为 pre-hook veto
- 硬链接去重 — 三级瀑布（size 分桶 → 头尾采样 → SHA-256）+ verify-then-link 原子替换 + journal undo
- TOCTOU 复验 — 分析与执行是两个时刻，执行前重验指纹（size + hash + mtime）
- 趋势预测 — JSONL 快照 + Theil-Sen 稳健回归（29.3% breakdown point）+ MAD 3σ̂ 异常检测 + 磁盘写满预测
- 守卫巡检 — 一键 patrol：磁盘 / 趋势异常 / 健康 / 未终结事务 → 带建议告警
- 空间台账 — 双式记账，每字节回收可溯源，按动作/profile/日聚合
🛡️ 安全纪律
- fail-closed：校验/健康检查失败即拒绝，绝不"查不到就放行"
- 路径 Containment：txId 白名单 + 路径穿越防护
- 诚实记账：bytesSaved 只计真正释放的空间
- 回收区代替删除：原子改名进回收区，commit 后才允许 purge
✅ 质量门
| 检查 | 结果 |
|---|---|
tsc --noEmit |
0 错误 |
vitest run |
206/206 通过（25 文件） |
| 构建 | tsdown 194 kB (gzip 55 kB) |
📦 安装
dsh plugin add beijingwahw/dsh-nuke-plugin完整变更: https://github.com/beijingwahw/dsh-nuke-plugin/commits/v3.0.0