OKF Agent Memory教程:Git原生的Agent记忆系统

📌 项目日期:2026年9月 | 数据来源:GitHub官方仓库 | 星数:500+

📋 项目简介

okf-agent-memory 是一个 0.5k 星的 Go 项目,实现了 Google OKF v0 规范:给 AI 编程 Agent 装上"Git 原生的持久记忆"。传统 Agent 每次会话都是"金鱼记忆",项目背景、踩过的坑、你的偏好每次都要重讲。OKF 把记忆结构化地存进 Git 仓库——可版本化、可 diff、可协作共享,Agent 每次开工自动加载上下文。

同类方案对比见 claude-mem 记忆插件教程Codebase Memory MCP 教程

🔧 核心设计

特性说明优势
Git原生记忆存为仓库内结构化文件版本控制/回滚/协作免费获得
OKF v0规范Google定义的记忆格式标准跨工具互操作
分层记忆项目背景/决策记录/偏好/待办分层结构清晰易检索
自动加载Agent启动自动注入相关记忆无感续接上下文

📦 安装使用

git clone https://github.com/okf-memory/okf-agent-memory.git
cd okf-agent-memory
go build -o okf ./cmd/okf

# 在你的项目中初始化记忆库
cd your-project
okf init

# Agent会话中自动记录与加载
# 手动记录一条决策:
okf remember --type decision "选择PostgreSQL而非MongoDB,因为需要事务"

# 查看记忆
okf list --type decision

# 记忆以 .okf/ 目录存于仓库,随git提交共享给团队

💡 与其他记忆方案对比

方案存储协作
OKFGit仓库内随代码共享,天然团队化
claude-mem本地SQLite个人单机
Memory MCPMCP服务端取决于部署方式