用途:为智能体提供跨会话的持久记忆,采用 Tiago Forte 的 PARA 方法,以文件形式保存、检索和整理长期知识。所有路径相对于 $AGENT_HOME。
主要能力分三层。第一层知识图谱位于 $AGENT_HOME/life/,按实体建文件夹,每个实体含 summary.md(先加载的快速上下文)和 items.yaml(按需加载的原子事实)。目录分为 projects(有目标或截止日期的活跃工作)、areas(无结束日期的持续职责,如 people、companies)、resources(参考资料与兴趣主题)、archives(前三类中已不活跃的内容),另有 index.md。实体在满足以下条件时创建:被提及 3 次以上、与用户有直接关系(家人、同事、伙伴、客户),或是用户生活中的重要项目或公司;否则记入每日笔记。事实规则:持久事实立即写入 items.yaml;每周根据活跃事实重写 summary.md;不删除事实,而是用 status: superseded 与 superseded_by 取代;实体不活跃时把文件夹移入 archives。
第二层每日笔记位于 $AGENT_HOME/memory/YYYY-MM-DD.md,是事件的原始时间线,记录“何时”发生,对话中持续写入,并在心跳时把持久事实提取到第一层。第三层隐性知识位于 $AGENT_HOME/MEMORY.md,记录用户如何运作——模式、偏好、经验教训,属于关于用户而非世界的事实,学到新的运作模式时更新。
使用方式:记忆不会跨会话重启保留,文件会,因此要写下来而非记在脑中。想记住某事就写入文件;“记住这个”就更新当日笔记或相关实体文件;学到教训就更新 AGENTS.md、TOOLS.md 或相关技能文件;犯错就记录下来避免重犯。检索时使用 qmd 而非 grep:qmd query "what happened at Christmas" 做带重排序的语义搜索,qmd search "specific phrase" 做 BM25 关键词搜索,qmd vsearch "conceptual question" 做纯向量相似度搜索;用 qmd index $AGENT_HOME 为个人文件夹建索引。计划保存在项目根目录的 plans/ 中带时间戳的文件里(放在个人记忆之外以便其他智能体访问),用 qmd 搜索;计划会过时,若存在更新版本不要混淆,发现过时就在文件中注明 supersededBy。
限制:原子事实的 YAML 结构与记忆衰减规则见 references/schemas.md;资料未提供具体安装命令、收费或平台信息。