| name | nmem-maintenance |
| description | 周期性巡检 Nowledge Mem 知识库,分类处理后台积累的待办事件。 |
| disable-model-invocation | true |
nmem-maintenance - Nowledge Mem 知识库巡检
周期性巡检 nmem 知识库,处理后台积累的待办事件。核心是先分类再处理,关键裁定交给用户。
前置条件
流程
Step 1:服务健康检查
确认 nmem 服务在线,记录版本和模式:
nmem --json status
健康响应:status: ok,有 server_version,database: true。
完成标记:服务在线,或已报告故障。
Step 2:拉取近期事件
nmem feed --days 7 -j
筛选出 severity: action_required 且 resolved: false 的事件。
⚠️ feed 事件的 resolved 字段是只读标记--即使底层记忆已修复,该字段也不会自动变为 true。后续核查必须直接用 nmem memories show 验证记忆状态,不能依赖事件状态。
完成标记:列出所有待处理事件及其 ID。若无待处理事件,结束巡检。
Step 3:分类事件
将每个 action_required 事件归入以下三类之一:
| 事件类型 | 分类 | 特征 |
|---|
flag_stale | 陈旧结晶 | 结晶有新源记忆,建议补充更新 |
flag_merge_candidate | 重复记忆 | 多条记忆标题/内容高度重复 |
flag_contradiction | 矛盾裁定 | 两条记忆给出相反指引,需用户裁定 |
insight_generated | info | 后台自动洞察,无需处理 |
crystal_created | info | 新结晶生成,无需处理 |
pattern_detected | info | 模式发现,非紧急,可后续讨论 |
注意:事件类型和分类并不总是 1:1。info 级别的 insight_generated 可能包含需要关注的建议,但不需要立即处理。按 action_required 筛选是安全的起点。
完成标记:全部待处理事件已打上分类标签。
Step 4:分类处理
4a. 陈旧结晶(flag_stale)
- 读出结晶内容:
nmem memories show <crystal_id> -j
- 读出新源记忆:
nmem memories show <new_memory_id> -j
- 对比差异:
- 新源记忆是否增加了结晶未覆盖的信息?
- 新信息是补充性(结晶的核心内容仍然准确)还是替代性(结晶的核心结论已过时)?
- 如果是补充性的,执行更新:
nmem memories update <crystal_id> -c '<new_content>'
- 如果是替代性的,标记为
deprecate:nmem memories deprecate <crystal_id> --supersede <new_memory_id>
完成标记:每个陈旧结晶已处理--要么更新,要么标记废弃,要么向用户报告"无需处理"。
4b. 重复记忆(flag_merge_candidate)
-
读取全部候选记忆的完整内容,不得只看标题就做决定:
nmem memories show <id1> -j
nmem memories show <id2> -j
-
比较内容完整度(长度、覆盖的细节数量、是否包含验证方法等独有信息)
-
保留最完整的一条
-
删除其余:
nmem memories delete <id_to_delete1> <id_to_delete2>
安全规则:先读全文再删。标题相同的记忆可能内容略有差异,合并时取内容最完整的。
完成标记:每组重复记忆已处理--合并重复项保留最完整的一条,或读全文后确认无需合并并在报告中标注。
4c. 矛盾裁定(flag_contradiction)
- 读出两条矛盾记忆的完整内容
- 识别两条记忆各自的核心论断--矛盾的具体位置是什么?
- 以结构化方式向用户呈现矛盾(同类矛盾合并到一次问卷):
- 两条记忆的各自立场
- 矛盾的具体位置
- 你分析后的建议(如果有倾向性)
- 获取用户裁定后,按裁定执行:更新被推翻方、删除/标记废弃、或保留双方(裁定同成立)
- 矛盾裁定必须交给用户--涉及领域知识和设计决策
注意:知识库记忆可能出现关于 _BIN 路径原则的矛盾--裁定前先确认矛盾双方讨论的是同一类工具(调度器 vs 数据处理工具)。
完成标记:每组矛盾已获用户裁定并按裁定执行--更新被推翻方、删除/废弃、或保留双方(裁定同成立)。
Step 5:呈现清理报告
输出结构化摘要:
## nmem 巡检报告
**服务状态**: ✅ xxx
### ✅ 已处理
- 陈旧结晶 × N - 已更新/已废弃
- 重复记忆 × N - 已合并
- 矛盾裁定 × N - 已裁定+更新
### ⏸️ 仍需用户裁定
- ...
### ℹ️ info 仅参考
- ...