Ralph Memories 是 ralph-orchestrator 提供的持久化学习系统，用于跨会话积累项目经验，数据存储在 .agent/memories.md。
用途：在进入不熟悉代码区、遇到错误、做架构决策或感觉情况似曾相识时，先搜索已有记忆；在发现代码库模式、做出或了解架构选择、解决可能复现的问题、获得项目专属知识时，创建记忆。会话状态、通用常识和临时方案不应记录。
记忆类型与标记：pattern（-t pattern）用于代码库惯例，如 barrel exports；decision（-t decision）用于架构选择及其原因；fix（-t fix）用于可复现问题的解决方案；context（-t context）用于项目专属背景。
常用命令： ralph tools memory search "area-name" ralph tools memory search -t fix "error message" ralph tools memory search -t decision "topic" ralph tools memory add "content" -t pattern --tags tag1,tag2 ralph tools memory list ralph tools memory list -t fix --last 10 ralph tools memory show mem-1737372000-a1b2 ralph tools memory delete mem-1737372000-a1b2 ralph tools memory prime --budget 2000 ralph tools memory prime --tags api,auth ralph tools memory prime --recent 7
搜索时建议先广后窄，例如先 search "api"，再用 -t pattern --tags api 收窄；遇错优先检查 fix；改架构前先查看 decision。可用 ralph tools memory list 查看已有标签，或用 grep -o 'tags: [^|]*' .agent/memories.md | sort -u 提取唯一标签，并复用组件名、关注点、工具等常见标签。
最佳实践：描述具体、说明原因、每条记忆只含一个概念、标签保持一致。
限制：官方资料未提供关于收费、价格、平台支持范围或效果保证的说明。