前言¶

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