用途:维护 Claude Code 的持久记忆目录,让 MEMORY.md 保持准确、精简、可跨会话使用。MEMORY.md 是唯一自动加载的文件,主题文件仅在被链接时按需读取,因此索引既要小到能整体加载,又要完整到每个主题文件都能从索引到达。
主要能力:MEMORY.md 加载时按 200 行或 25KB 截断,取先到者。技能用 usage = max(size / 25000, lines / 200) 衡量,0.80 告警、0.70 为改写目标,并明确指出哪个上限先触发。资料称大小上限按 UTF-16 代码单元(JavaScript String.length)计算,而非 UTF-8 字节或码点;该结论基于 Claude Code v2.1.238(Windows)与 2.1.237(Linux)的实测,属版本易变信息,文档给出的两个数字才是契约。
使用方式:先评估现状,测量两个上限并清点主题文件;再识别过期条目(计数漂移、路径改名、被取代的写法、相互矛盾);筛选值得新增的条目(持久、不重复、已验证、可操作);把超过约 10-15 行的章节抽取为独立主题文件,用 1-2 行摘要加链接替换;更新 MEMORY.md;最后校验预算、链接与准确性,并在改写前后对比已链接文件名集合,防止主题文件丢失唯一指针。
适用场景:索引接近任一加载上限、会话产生值得保留的洞见、某章节过长需抽取、项目状态变化导致记忆过期、改写索引前后确认链接未丢失、开始新工作前检查是否已有相关记忆、会话之间的定期维护。
限制:需要访问记忆目录(通常为 ~/.claude/projects/<project-path>/memory/,也可能被 settings.json 的 autoMemoryDirectory 移动,应读取而非假定)。约 10-15 行触发抽取、5 行下限均为章节规模启发式,与剩余预算无关。无法核实的声明应标注 (unverified)。HTML 注释在索引送达模型前会被剥离,不能作为保留说明的手段。资料未提供收费、价格、平台支持范围等信息。