dsh-nuke-plugin

DeepSeek Harness 的工业级 Nuke 环境清理引擎 — 事务回滚 · 崩溃自恢复 · 审计链 · 先知推演 · 混沌演习 · 贝叶斯自学习

把"删除插件并清理残留"这件危险的事，做成一套可验证、可撤销、可审计的事务系统。

为什么需要它

dsh 的一切皆插件 —— 但插件的装卸会在 .dsh/、Nuke 目录、系统 TEMP 等处留下残留。手工清理容易误删，脚本清理不可逆，出了事无从追溯。本插件用数据库级的纪律来做这件事：

痛点	解法
删错无法挽回	每个动作自带 validate / preview / execute / undo，目录删除 = 原子改名进回收区
清理途中崩溃	WAL 预写日志 + 备份区，nuke_recover 重放并反向补偿；nuke_drill 随时实战验证这条退路
出事无从追责	hash chain 审计日志，任何篡改可被 nuke_verify 检出
并发清理打架	跨进程读写锁（O_EXCL + bootToken 归属核验 + guard 目录互斥）
不知道能删多少	五因子评分 + 趋势回归 + 磁盘写满预测，先预演后执行
不知道"删了会怎样"	nuke_oracle 先知推演：基于历史执行数据预测事务成功率、期望回收、最脆弱步骤

安装

dsh plugin add beijingwahw/dsh-nuke-plugin --profile web

安装后直接对话即可，例如：

帮我扫描一下 web profile 的插件残留，先预演不要真删

安全纪律（设计原则）

1. fail-closed — 校验器/健康检查自身失败时同样拒绝操作，绝不"查不到就放行"
2. 路径 Containment — 所有路径操作限制在授权目录内；txId 白名单 [A-Za-z0-9_-]{1,64} 防穿越注入
3. TOCTOU 复验 — 分析与执行是两个时刻，执行前重验指纹（size + SHA-256 + mtime）
4. 诚实记账 — bytesSaved 只计真正释放的空间（nlink>1 的硬链接替换不虚增）
5. 保护名单 + 限额 + 黑窗 — 作为引擎 pre-hook veto，超限即拒绝（纵深防御，不依赖单层检查）
6. 回收区代替物理删除 — commit 后才允许 purge；restore 失败或存在孤儿产物时绝不 purge

工具速查（21 个）

所有工具注册为 dsh Agent 工具，安装后直接让 Agent 调用即可。

感知 — 先看清现状

工具	说明
nuke_list	列出 profile 下已安装的第三方插件
nuke_scan	残留扫描（配置引用/目录/TEMP），五因子评分 + 可回收空间统计；省略插件名进入全局模式
nuke_deps	依赖关系检测：谁引用了目标插件（删除前必查）
nuke_orphans	全局孤儿扫描：node_modules 未声明包 / 无主附件 / TEMP 过期条目
nuke_health	健康检查：config/dependency/runtime/residue 四组，critical 失败自动阻断清理

决策 — 评估风险与收益

工具	说明
nuke_blastradius	爆炸半径沙盘推演（what-if，零副作用）：删除会损坏谁、可级联谁、风险几级
nuke_strategies	查看三级策略（safe / balanced / aggressive）的动作集
nuke_policy	查看守卫配置：保护名单 / 批量上限 / 回收上限 / 磁盘下限 / 时间黑窗
nuke_trend	历史趋势：字节/天变化率、30 天外推、3σ̂ 异常检测（失控写盘早期信号）
nuke_forecast	磁盘写满预测：趋势 × 实时余量 → 倒计时与分级建议
nuke_oracle	先知推演：概率化后果预测——事务成功率、期望回收（校准分布修正）、最脆弱步骤、爆炸半径、磁盘倒计时延长；基于历史执行数据贝叶斯自学习，零副作用不拿锁

执行 — 事务化清理

工具	说明
nuke_clean	事务化强力卸载：健康闸门 → 独占锁 → 计划 → 预演/提交；失败自动 Saga 回滚
nuke_dedup	内容寻址去重：三级瀑布（尺寸 → 采样指纹 → SHA-256）分析，apply=true 时硬链接实收
nuke_restorepoint	配置还原点：list / create / restore / prune

恢复与审计 — 出事有退路

工具	说明
nuke_status	查询事务状态（活跃/已终结，含步骤明细与回收统计）
nuke_recover	崩溃恢复：扫描未终结事务的 WAL，反向补偿恢复到执行前状态
nuke_verify	审计链完整性校验（hash chain 任何篡改均可定位）

运维 — 日常保养

工具	说明
nuke_doctor	一键全科体检：健康 + 残留 + 孤儿 + 评分 → P1/P2/P3 优先级处方
nuke_guardian	守卫者巡检：磁盘倒计时 / 趋势异常 / 未终结事务 → 带建议的分级告警
nuke_ledger	空间台账：每字节回收可溯源，按动作/profile/日聚合，freed/pending 双轨
nuke_drill	混沌演习：沙箱中执行真实事务 → 第 N 步后模拟"断电"（不回滚、锁悬挂）→ 走真实恢复路径 → 逐项验证数据字节级还原 / 审计链完整 / WAL 终结 → 签发崩溃安全证书

典型工作流

第一次清理（推荐路径）

1. nuke_scan                    # 看清残留与可回收空间
2. nuke_oracle                  # 先知推演：做了会怎样（成功率/期望回收/最脆弱步骤）
3. nuke_blastradius [插件]       # 零副作用推演：会不会误伤
4. nuke_clean --dry_run true    # 预演：只出计划，不动文件
5. nuke_clean                   # 执行：失败自动回滚，全程审计

aggressive 策略（需要确认令牌）

nuke_clean --strategy aggressive \
           --confirmation_token "CONFIRM:web:<plugin-a>,<plugin-b>"

崩溃后恢复

1. nuke_status                  # 查看未终结事务
2. nuke_recover                 # WAL 重放 + 反向补偿
3. nuke_verify                  # 校验审计链完整性

日常保养

nuke_guardian                   # 一键巡检，输出带建议的告警
nuke_forecast                   # 磁盘还能撑几天
nuke_drill                      # 定期混沌演习，确认崩溃退路始终有效

…