前言¶

DSH 插件生態致力於爲智能體開發提供靈活的擴展能力。在 dsh-mnemon 的記憶體治理中，過時記憶（被新事實取代）會與新事實並存積累，導致記憶庫膨脹。本插件基於 dsh-mnemon 的公共 API，接入衝突驅動的正確性糾錯機制，提供自動巡檢報告與分級治理能力。

核心功能¶

本插件提供以下能力：

• 衝突驅動的正確性糾錯：檢測記憶間新事實取代舊事實的情況。
• 分級治理：
  • immune：絕不被刪除（如重要性較高或已標記）。
  • superseded：顯式確認後刪除（衝突檢測命中）。
  • watch：其餘全部，絕不被刪除。
• 默認標記與軟刪除：默認標記 superseded，僅在顯式確認後進行軟刪除。
• 自動巡檢報告：只報告，絕不刪除。

安裝與啓用¶

通過 DSH 插件安裝命令添加插件。

dsh plugin --profile web add ./dsh-mnemon-gc-<version>.tgz

安裝後重啓 dsh web，即可在「設置 → Mnemon GC」看到設置卡片。

典型用法¶

插件支持 CLI 命令、工具調用與 Web 可視化編輯。

1. CLI 命令
   * /mnemon-gc inspect：進行只讀巡檢。
   * /mnemon-gc mark：標記記憶被取代。
   * /mnemon-gc purge-superseded：批量刪除已標記的記憶。

2. 工具
   * mnemon_gc_inspect：只讀巡檢。
   * mnemon_gc_mark_superseded：標記取代關係。
   * mnemon_gc_purge_superseded：批量刪除已標記記憶。

3. 配置與設置
   * 通過 Web UI 訪問「設置 → Mnemon GC」。
   * 在 Web UI 中可視化編輯配置項。
   * 配置項包括：threshold（閾值）、maxAgeDays（最大存活天數）、intervalMs（巡檢間隔）、limit（候選上限）、cliPath、dataDir。

適用場景與注意¶

• 依賴項：需要 dsh-mnemon >=0.2.9 和 schemastery ^3.18.0。
• 安全邊界：
  • 自動巡檢帶 --readonly，絕不寫庫。
  • 自動巡檢只報告，絕不刪除（無 autoPurge 配置項）。
  • 刪除只由 superseded 標記決定。
• 閾值用途：threshold 與 maxAgeDays 僅用於排序與審閱，絕不單獨作爲刪除依據。

結尾¶

本插件通過沖突檢測與顯式確認機制，幫助維護 Mnemon 記憶體的正確性。所有操作均有跡可循，適合需要精細控制記憶生命週期的場景。

GitHub：https://github.com/Zn-Dk/dsh-mnemon-gc
目錄：https://www.skillhub.cn/plugins/Zn-Dk/dsh-mnemon-gc