Back to Details

para-memory-files

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PARA Memory Files

PARA 记忆文件系统

Persistent, file-based memory organized by Tiago Forte's PARA method. Three layers: a knowledge graph, daily notes, and tacit knowledge. All paths are relative to 
$AGENT_HOME
.
基于Tiago Forte的PARA方法构建的持久化文件式记忆系统，包含三层结构：知识图谱、每日笔记和隐性知识。所有路径均相对于
$AGENT_HOME
。

Three Memory Layers

三层记忆结构

Layer 1: Knowledge Graph (
$AGENT_HOME/life/
-- PARA)

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

Entity-based storage. Each entity gets a folder with two tiers:
  1. summary.md
    -- quick context, load first.
  2. items.yaml
    -- atomic facts, load on demand.
text
$AGENT_HOME/life/
  projects/          # Active work with clear goals/deadlines
    <name>/
      summary.md
      items.yaml
  areas/             # Ongoing responsibilities, no end date
    people/<name>/
    companies/<name>/
  resources/         # Reference material, topics of interest
    <topic>/
  archives/          # Inactive items from the other three
  index.md
PARA rules:
  • Projects -- active work with a goal or deadline. Move to archives when complete.
  • Areas -- ongoing (people, companies, responsibilities). No end date.
  • Resources -- reference material, topics of interest.
  • Archives -- inactive items from any category.
Fact rules:
  • Save durable facts immediately to 
    items.yaml
    .
  • Weekly: rewrite 
    summary.md
    from active facts.
  • Never delete facts. Supersede instead (
    status: superseded
    , add 
    superseded_by
    ).
  • When an entity goes inactive, move its folder to 
    $AGENT_HOME/life/archives/
    .
When to create an entity:
  • Mentioned 3+ times, OR
  • Direct relationship to the user (family, coworker, partner, client), OR
  • Significant project or company in the user's life.
  • Otherwise, note it in daily notes.
For the atomic fact YAML schema and memory decay rules, see references/schemas.md.
基于实体的存储方式。每个实体对应一个文件夹，包含两个层级：
  1. summary.md
    -- 快速上下文信息，优先加载。
  2. items.yaml
    -- 原子化事实，按需加载。
text
$AGENT_HOME/life/
  projects/          # 具有明确目标和截止日期的活跃工作项
    <name>/
      summary.md
      items.yaml
  areas/             # 持续进行的职责，无截止日期
    people/<name>/
    companies/<name>/
  resources/         # 参考资料、感兴趣的主题
    <topic>/
  archives/          # 来自其他三类的非活跃项
  index.md
PARA规则：
  • Projects（项目） -- 带有目标或截止日期的活跃工作项。完成后移至archives（归档）。
  • Areas（领域） -- 持续进行的事务（人员、公司、职责），无截止日期。
  • Resources（资源） -- 参考资料、感兴趣的主题。
  • Archives（归档） -- 来自任意分类的非活跃项。
事实规则：
  • 立即将持久化事实保存至
    items.yaml
    。
  • 每周：根据活跃事实重写
    summary.md
    。
  • 绝不删除事实，而是标记替代（
    status: superseded
    ，添加
    superseded_by
    字段）。
  • 当实体变为非活跃状态时，将其文件夹移至
    $AGENT_HOME/life/archives/
    。
创建实体的时机：
  • 被提及3次及以上，或
  • 与用户存在直接关系（家人、同事、伴侣、客户），或
  • 是用户生活中重要的项目或公司。
  • 否则，记录在每日笔记中。
关于原子化事实YAML schema和记忆衰减规则，请查看references/schemas.md。

Layer 2: Daily Notes (
$AGENT_HOME/memory/YYYY-MM-DD.md
)

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

Raw timeline of events -- the "when" layer.
  • Write continuously during conversations.
  • Extract durable facts to Layer 1 during heartbeats.
事件的原始时间线——即“时间”层。
  • 对话过程中持续记录。
  • 在心跳周期内将持久化事实提取至第一层。

Layer 3: Tacit Knowledge (
$AGENT_HOME/MEMORY.md
)

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

How the user operates -- patterns, preferences, lessons learned.
  • Not facts about the world; facts about the user.
  • Update whenever you learn new operating patterns.
用户的行为方式——模式、偏好、经验教训。
  • 并非关于世界的事实，而是关于用户的事实。
  • 每当了解到新的行为模式时进行更新。

Write It Down -- No Mental Notes

记录下来——不要依赖大脑记忆

Memory does not survive session restarts. Files do.
  • Want to remember something -> WRITE IT TO A FILE.
  • "Remember this" -> update 
    $AGENT_HOME/memory/YYYY-MM-DD.md
    or the relevant entity file.
  • Learn a lesson -> update AGENTS.md, TOOLS.md, or the relevant skill file.
  • Make a mistake -> document it so future-you does not repeat it.
  • On-disk text files are always better than holding it in temporary context.
记忆无法在会话重启后保留，但文件可以。
  • 想要记住某事 -> 写入文件。
  • “记住这个” -> 更新
    $AGENT_HOME/memory/YYYY-MM-DD.md
    或相关实体文件。
  • 学到经验 -> 更新AGENTS.md、TOOLS.md或相关技能文件。
  • 犯了错误 -> 记录下来，避免未来的自己重复犯错。
  • 磁盘上的文本文件永远比临时上下文存储更可靠。

Memory Recall -- Use qmd

记忆召回——使用qmd

Use 
qmd
rather than grepping files:
bash
qmd query "what happened at Christmas"   # Semantic search with reranking
qmd search "specific phrase"              # BM25 keyword search
qmd vsearch "conceptual question"         # Pure vector similarity
Index your personal folder: 
qmd index $AGENT_HOME
Vectors + BM25 + reranking finds things even when the wording differs.
使用
qmd
而非直接搜索文件：
bash
qmd query "what happened at Christmas"   # 带重排序的语义搜索
qmd search "specific phrase"              # BM25关键词搜索
qmd vsearch "conceptual question"         # 纯向量相似度搜索
索引你的个人文件夹：
qmd index $AGENT_HOME
向量+BM25+重排序的组合，即使表述不同也能找到目标内容。

Planning

规划管理

Keep plans in timestamped files in 
plans/
at the project root (outside personal memory so other agents can access them). Use 
qmd
to search plans. Plans go stale -- if a newer plan exists, do not confuse yourself with an older version. If you notice staleness, update the file to note what it is supersededBy.
将规划存储在项目根目录的
plans/
文件夹下的带时间戳文件中（位于个人记忆之外，以便其他Agent访问）。使用
qmd
搜索规划。规划会过期——如果存在更新的规划，不要混淆旧版本。如果发现规划过期，更新文件并注明它被哪个版本替代（supersededBy）。