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

基于开放知识格式 (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 中，外部依赖性为零，专为高频代理工具调用循环而设计： Benchmark Metric 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) 加速和 -80% 令牌减少（LM Studio / Ollama）与杰玛、Qwen、Llama）。运行 make benchmark 或探索 Progressive Disclosure Benchmark Suite。克隆存储库并编译独立的 okf 可执行文件：这会在 bin/okf 生成独立的二进制文件。 # 验证包一致性、图形连接性和描述漂移 ./bin/okf 验证知识 --strict --drift # 通过内存 BM25 评分搜索概念 ./bin/okf 搜索“架构层”知识 # 检查概念及其关系（使用 --json 支持） ./bin/okf 显示架构/层知识 --json # 使用自动 log.md 和 index.md 簿记创建新概念 ./bin/okf 创建决策/验证流知识 \ --type Decision \ --title " OAuth2 授权流程 " \ --desc " 针对客户端身份验证的 PKCE 标准化。" # 更新现有概念 ./bin/okf 更新决策/验证流程知识 \ --desc " 更新 OAuth2 PKCE 令牌刷新间隔。" # 将完整代理内存堆栈引导到任何目标项目中 ./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/ — 嵌入式代理技能定义和功能指南 AGENTS.md — 针对 AI 编码代理的项目定制操作说明 Makefile — 用于验证的便捷任务 ( make vali