para-memory-files

PARA记忆文件

基于文件的持久化记忆，按Tiago Forte的PARA方法组织。三层：知识图谱、每日笔记和隐性知识。所有路径相对于$AGENT_HOME。

三个记忆层

第一层：知识图谱（$AGENT_HOME/life/ -- PARA）

基于实体的存储。每个实体有一个文件夹，包含两个层级：

1. summary.md -- 快速上下文，优先加载。
2. items.yaml -- 原子化事实，按需加载。

$AGENT_HOME/life/
  projects/          # 有明确目标/截止日期的活跃工作
    <name>/
      summary.md
      items.yaml
  areas/             # 持续的责任，无截止日期
    people/<name>/
    companies/<name>/
  resources/         # 参考资料，感兴趣的主题
    <topic>/
  archives/          # 其他三个类别中的非活跃项目
  index.md

PARA规则：

• 项目 -- 有目标或截止日期的活跃工作。完成后移至归档。
• 领域 -- 持续的责任（人、公司、职责）。无截止日期。
• 资源 -- 参考资料，感兴趣的主题。
• 归档 -- 任何类别中的非活跃项目。

事实规则：

• 立即将持久性事实保存到items.yaml。
• 每周：根据活跃事实重写summary.md。
• 永不删除事实。改为取代（status: superseded，添加superseded_by）。
• 当实体变为非活跃时，将其文件夹移动到$AGENT_HOME/life/archives/。

何时创建实体：

• 被提及3次或以上，或者
• 与用户有直接关系（家人、同事、伴侣、客户），或者
• 用户生活中的重要项目或公司。
• 否则，在每日笔记中记录。

关于原子化事实YAML模式和记忆衰减规则，请参见references/schemas.md。

第二层：每日笔记（$AGENT_HOME/memory/YYYY-MM-DD.md）

事件的原始时间线——"何时"层。

• 在对话期间持续写入。
• 在心跳期间将持久性事实提取到第一层。

第三层：隐性知识（$AGENT_HOME/MEMORY.md）

用户如何操作——模式、偏好、经验教训。

• 不是关于世界的事实；而是关于用户的事实。
• 每当学到新的操作模式时更新。

写下来——不要记在脑子里

记忆在会话重启后无法存活。文件可以。

• 想记住某事 -> 写入文件。
• "记住这个" -> 更新$AGENT_HOME/memory/YYYY-MM-DD.md或相关实体文件。
• 学到教训 -> 更新AGENTS.md、TOOLS.md或相关技能文件。
• 犯错误 -> 记录下来，以便未来的你不会重复。
• 磁盘上的文本文件总是比临时上下文更好。

记忆回忆——使用qmd

使用qmd而不是grep文件：

qmd query "圣诞节发生了什么"   # 带重排序的语义搜索
qmd search "特定短语"              # BM25关键词搜索
qmd vsearch "概念性问题"         # 纯向量相似度

索引你的个人文件夹：qmd index $AGENT_HOME

向量 + BM25 + 重排序即使措辞不同也能找到内容。

计划

将计划保存在项目根目录的plans/文件夹中（时间戳文件），位于个人记忆之外，以便其他代理可以访问。使用qmd搜索计划。计划会过时——如果存在更新的计划，不要用旧版本混淆自己。如果发现过时，更新文件以注明其被取代。