前言¶
DSH 採用插件架構，插件的裝卸會在 .dsh/、Nuke 目錄、系統 TEMP 等處留下殘留。手工清理容易誤刪，腳本清理不可逆，出了事無從追溯。本插件通過數據庫級的紀律來做這件事，提供可驗證、可撤銷、可審計的清理能力。
核心能力¶
插件將“刪除插件並清理殘留”包裝成一套事務系統。每個動作自帶 validate / preview / execute / undo 閉環，目錄刪除採用原子改名進回收區的方式，commit 後才允許物理刪除。
事務與恢復¶
nuke_clean 執行時，若失敗會自動進行 Saga 回滾。插件支持 WAL 預寫日誌，配合 nuke_recover 可以掃描未終結事務的 WAL，反向補償恢復到執行前狀態。
安全原則¶
安全機制基於以下原則設計：
* fail-closed：校驗器/健康檢查自身失敗時同樣拒絕操作。
* 路徑 Containment：所有路徑操作限制在授權目錄內，txId 白名單防止注入。
* TOCTOU 複驗：分析與執行是兩個時刻，執行前重驗文件指紋（size + SHA-256 + mtime）。
* 誠實記賬：硬鏈接去重不虛增 bytesSaved。
* 保護名單：作爲引擎 pre-hook veto，超限即拒絕。
* 回收區代替物理刪除：commit 後才允許 purge。
審計與校驗¶
插件維護 hash chain 審計日誌，任何篡改均可被 nuke_verify 檢出。安裝後工具註冊爲 dsh Agent 工具，可直接調用。
安裝與啓用¶
執行以下命令安裝插件：
dsh plugin add beijingwahw/dsh-nuke-plugin --profile web
典型用法¶
預演與執行¶
- 掃描現狀：使用
nuke_scan列出 profile 下已安裝的第三方插件，獲取可回收空間統計與五因子評分。 - 先知推演：使用
nuke_oracle進行先知推演，基於歷史數據預測事務成功率、期望回收與最脆弱步驟。 - 風險評估：使用
nuke_blastradius進行爆炸半徑沙盤推演，評估刪除對其他組件的級聯影響。 - 預演：使用
nuke_clean --dry_run true查看計劃，不實際修改文件。 - 執行：使用
nuke_clean執行清理，失敗自動回滾，全程記錄審計鏈。
崩潰後恢復¶
如果在清理途中發生崩潰，先使用 nuke_status 查看未終結事務。使用 nuke_recover 掃描未終結事務的 WAL，反向補償恢復。最後使用 nuke_verify 校驗審計鏈完整性。
進階特性：自我學習的智能引擎¶
插件具備貝葉斯自學習能力，能夠根據歷史執行數據修正預測。
智能決策¶
V5.6 引入了 Thompson 探索（後驗採樣決策）與 CVaR₁₀ 下行風險模型。
* Thompson 探索：通過後驗採樣決策，避免“富者愈富”，爲數據少的動作提供執行機會。
* CVaR₁₀：計算最差 10% 情形下的平均回收，誠實回答“最壞情形我能接受嗎”。
自我校準¶
V5.5 增加了自我校準機制。插件通過 Brier 技能分與 logit 位移，從已對賬的（預測，結局）對中學習系統性偏差，動態修正未來預測，使先知引擎的數字更加可信。
結語¶
該插件爲 DSH 插件管理提供了工業級的清理與恢復能力。使用前請確保安裝命令正確，並檢查源碼與許可證。
