用途:该项目记忆分两处存放且需保持一致——~/.claude/projects/<转义cwd>/memory/(harness,Claude Code 加载,先写)与 .memory/(git 跟踪的权威副本,后写,仅安全文件)。私有内容(密钥、PII、用户偏好)只存在 harness;.memory/ 是公开仓库,不得含私有文件或索引行。consolidate 用于用户手动触发时的记忆整理,默认失败模式是只做表面整理而留下主题冗余和事实上失效的笔记,因此流程为 fail-closed。
主要能力与用法:每次遇到值得记住的决策/偏好/教训应立即写入,不必等待 consolidate;写入前先用 Grep/Read 按主题搜索既有记忆,能编辑就不新建,拒绝纯操作日志(须有持久 Why 与可复用 How)。整理流程要求先产出清单、主题聚类图、过期判定表,再运行脚本校验:pre-mutation 用 python3 "${CLAUDE_PLUGIN_ROOT}/scripts/validate-consolidate.py" --inventory ... --cluster ... --staleness ... --check=cluster,staleness,exit 0 才解除变更冻结;同步后运行完整检查(含 --report/--harness/--public),exit 0 方可宣称完成。还需地面事实核对(用 Grep/Read/find/ls 对照当前仓库)、聚类内合并去重、索引重建(harness 与 .memory/ 分开,公网索引不得含 (harness only) 行)、以及满足条件时启动独立对抗式二次检查。门禁 G1–G8 全部通过才算完成。限制:仅用户调用,无自动整理;rm 只能针对两处记忆目录;不得编造清单/路径/隐私判定;资料未提供脚本的具体实现细节与版本信息。