用途：为多个 AI 编程工具提供共享的跨会话记忆，避免每次会话重复交代项目背景、技术栈与个人偏好。
主要能力：智能分类写入；FSRS 衰减检查；月度压缩归档；三层检索；敏感信息隔离到 .sensitive/ 且不同步；向后兼容旧版记忆结构；支持 GitHub 云同步与数据迁移。
文件结构：记忆存放在 ~/.persistent-memory/，含 INDEX.md（索引）、MEMORY.md（核心长期记忆）、SOUL.md（用户画像）、HEARTBEAT.md、memories/（facts、decisions、preferences、context）、journal/YYYY-MM-DD.md、archive/YYYY-MM.md 和 .sensitive/。
初始化命令： mkdir -p ~/.persistent-memory/{memories,journal,archive,.sensitive}
会话开始读取： cat ~/.persistent-memory/INDEX.md cat ~/.persistent-memory/MEMORY.md cat ~/.persistent-memory/SOUL.md cat ~/.persistent-memory/journal/$(date +%Y-%m-%d).md 2>/dev/null
条目写入流程四步：判断分类、生成条目 ID（如 F-20260228-001，前缀 F/D/P/C 分别对应 Facts/Decisions/Preferences/Context）与元数据、追加到对应文件、重写 INDEX.md。用户说“记住 xxx”即触发分类写入。
适用场景：多工具协作的编程项目、需要长期保存技术决策与配置事实的开发者、希望 AI 记住编码偏好与项目上下文的人。
限制：资料未提供收费、价格、效果数据；具体安装、检索策略、衰减与压缩算法细节、各工具适配方法均需查阅仓库内 references/ 文档（setup.md、workflow.md、intelligence.md、retrieval.md、commands.md、adapters/overview.md、migration.md、sync.md），本介绍不展开。