OKF Agent Memory – 用于 AI 编码代理的 Git 原生持久内存

OKF 代理内存 基于开放知识格式 (OKF) v0.2 的 AI 代理的域中立、Git 本机持久项目内存。 🌟 概述 当上下文窗口关闭时，与 AI 代理的对话将重置。除非持久存储，否则有价值的架构决策、领域发现和操作事实都会丢失。 OKF Agent Memory 提供了一个标准化的、供应商中立的内存层，它作为带有 YAML frontmatter 的纯 Markdown 文件直接存在于您的存储库 (knowledge/) 中。它弥合了非结构化临时降价文件（ CLAUDE.md 、 AGENTS.md ）和复杂的黑盒矢量数据库之间的差距。流程图 TD L1["1. OKF v0.2 规范
(规范 Markdown 和 YAML 格式)"] L2["2. Agent 内存约定
(行为规则：搜索、审查、信任)"] L3["3. Agent 技能
(LLM 提示和操作工作流程)"] L4["4. 工具层：Go Library & CLI
(确定性解析、验证、搜索，MCP)"] L5["5.项目知识语料库
(知识/ OKF 捆绑包)"] L1 --> L2 L2 --> L3 L3 --> L4 L4 --> L5 加载 ⚡ 关键亮点 极快的性能（<300μs 搜索，~4ms 图形验证）：内存中 BM25 检索和捆绑包验证在微秒内执行，无需 VM 启动或网络往返。 100% Git 原生和零供应商锁定：一切都是版本控制的纯文本。使用标准 git diff 和 git log 检查、审核和审查代理的内存。无需外部数据库。内存检索的 API 成本为零：本地词法 BM25 索引消除了重复的向量嵌入 API 成本和网络往返。基于 Google OKF v0.2 构建：使用代理知识的开放标准格式，完全支持出处（来源）、信任层（生成与验证）和生命周期元数据（状态、stale_after）。解决上下文膨胀和内存腐烂：采用渐进式披露（分层索引.md 文件和链接图），因此代理仅加载他们需要的确切概念。写入前搜索原则：要求在创作之前查询现有内存，防止概念重复和幻觉分歧。零依赖 Go 工具链：具有零外部依赖的单个二进制文件、低于 5 毫秒的 CLI 启动时间和内置模型上下文协议 (MCP) 服务器 ( okf mcp )。真正的领域中立：专为软件工程、辅导、科学研究、文献评论和运营而设计。 📊 性能基准 okf 内置于 Go 中，外部依赖性为零，专为高频代理工具调用循环而设计： 基准指标 Python / Vector DB 运行时（Mem0、Letta） Deno / Node.js 工具 OKF 代理内存 (Go) 概念搜索延迟 150ms – 800ms（嵌入 API + Vector DB） 40ms – 120ms < 300 µs（微秒，内存中 BM25) 完整语料库解析和图形验证 200ms – 1.5s 80ms – 250ms ~4.0 ms（50+ 概念，双向图） 处理冷启动开销 250ms – 600ms（Python VM 启动） 80ms – 180ms（V8 / Deno 启动） < 4 ms（编译的单个二进制文件） 检索成本1,000 个查询 ~$0.10 – $0.50（嵌入令牌） $0.00 $0.00（零 API 成本，完全本地） 内存占用 (RSS) ~120 MB – 350 MB ~60 MB – 140 MB < 15 MB 提示使用您自己的 LLM 在本地重现：我们在纯 Go 中提供自动基准运行程序来验证首次令牌时间 (TTFT) 加速和本地硬件（LM Studio / Ollama 与 Gemma、Qwen、Llama）上的代币减少 -80%。运行 make benchmark 或探索 Progressive Disclosure Benchmark Suite。 🚀 快速入门 1. 构建工具克隆存储库并编译独立的 okf 可执行文件： make build 这会在 bin/okf 生成独立的二进制文件。 2. 基本 CLI 命令 # 验证包一致性、图形连接性和描述漂移 ./bin/okf validateknowledge --strict --drift # 通过内存 BM25 评分搜索概念 ./bin/okf search "architecturelayers"knowledge # 检查概念及其关系（使用 --json 支持） ./bin/okf showarchitecture/layersknowledge --json # 使用自动 log.md 和 index.md 簿记创建新概念 ./bin/okf create Decisions/auth-flowknowledge \ --type Decision\--title " OAuth2 Authorization Flow " \ --desc " Standardized on PKCE for clientauthentication. " # 更新现有概念 ./bin/okf update Decisions/auth-flowknowledge \ --desc " Updated OAuth2 PKCE token refresh Interval. " # 将完整代理内存堆栈引导到任何目标项目中 ./bin/okf bootstrap /path/to/project --name " My Project " # 仅初始化裸 OKF 包在任何目录中 ./bin/okf init my-project/knowledge 3. 在任何项目中引导代理内存 使用单个命令将完整的 OKF 代理内存架构搭建到任何新的或现有的存储库中： # 将完整内存堆栈引导到目标项目中 ./bin/okf bootstrap /path/to/my-project --name " My Service " 这会自动设置：knowledge/ — OKF v0.2 兼容的持久内存包（index.md、log.md） .agents/skills/okf-memory/ — 嵌入式代理技能定义和功能