OwnMem 是什么
OwnMem 是一个 Git 原生的 AI 编码代理项目记忆系统:代理在项目里踩过的坑、做过的决定、验证过的结论,写成仓库 .ownmem/ 目录下人类可读的 Markdown,随代码一起 clone、review、回滚,需要时由本地确定性召回投递给编码代理。它支持 Claude Code、Codex、Cursor、Gemini CLI、Grok CLI 五类 host,采用 Apache-2.0 协议,2026 年 8 月在 GitHub 开源,2026-09 查询约 400 star。典型场景是团队长期维护同一仓库、多个编码代理轮换干活,谁都不想再踩一遍上个会话刚查明的坑。
它先问”记忆归谁所有”,再谈”记住更多”
多数 agent memory 方案把力气花在”记住更多”:捕获更多对话、召回更多条目。OwnMem 的切入点在治理这一侧——官方 README 里它先问三个问题:项目知识归谁所有、谁可以改、坏记忆如何在改变代理行为之前被拦截。
这三问决定了产品形态:知识归仓库所有,记忆就得是仓库里可评审的文件;改动必须可归因,变更就得走 commit;坏记忆要拦在投递前,就得有独立于内容的证据检查。把记忆存在厂商账号下、由模型自动写入的系统,这三问都没有现成答案——下文的对比以此为基准。
五大优势:所有权、确定性、证据、弃权、净零增长
官方 README 列了五条主张,逐条看工程含义。
一,仓库拥有记忆。 记忆是 .ownmem/ 里可读的 Markdown,随代码一起 clone、review、回滚;Claude Code 和 Codex 读同一份来源。
二,确定性本地召回。 默认召回不做模型调用、不做网络调用:同一查询、同一配置、同一快照,产生同一排序——可复现、可离线、零检索 API 账单,排序出问题能重现。
三,证据先于权威。 一条记忆不能因为”写在记忆里”就可信,要有独立凭据(receipts),投递前还有实时证据检查——类比 code review:不看 commit message 多自信,看 diff。
四,会告诉你”它不知道”。 投递分三档:引用原文、最多三条”明确不是答案”的指针、或者弃权并点名是哪道门拒绝。主动说”没有相关记忆”,比硬塞似是而非的条目有用得多。
五,净零增长。 条目数有硬上限,且只往下棘轮:加新条目,必须在同一次变更里退役旧条目。这条堵住了记忆系统最经典的腐化路径:只进不出,最后召回一堆互相矛盾的旧账。
核心机制:先编译再召回,五通道融合,四门三档
架构上仓库是唯一事实源:L1 路由、L2 区域索引、L3 主题,三层都是可审阅的 Markdown。写路径先编译再召回——schema、图、生命周期、证据门把记忆编译成内容寻址的不可变快照,召回读的是快照。工程含义:同一快照召回结果可复现;没过编译的记忆进不了库,格式损坏在写入侧就被拦。
读路径是五条确定性召回通道本地融合:exact、BM25F、n-gram、fuzzy、graph。embeddings 是可选第六通道,权重为 0,除非本地 A/B 证据通过——向量检索在这里是待验证项。日常召回是一条命令:
npx ownmem recall -- "staging deploy timed out again, should I add more workers?"
输出里有条目名、score=0.875、lanes=exact,bm25f,ngram(命中通道)和信任级别,外加风险提示:“当作线索去代码里复核,不要当作既定事实”。完整流程见本站安装教程。
投递侧是四门三档:相关性、认知有效性、任务适用性、行动风险四道门各自独立拒绝,阈值从消融曲线读出。日常语言版:要么拿到带出处的原文,要么拿到”去看看这几个地方”的指针,要么被告知这次没有可用记忆、卡在哪道门。
三方对比:指令文件、厂商内置记忆、OwnMem
编码代理的记忆目前有三类载体,官方 README 对比整理成表:
| 维度 | 指令文件(CLAUDE.md/AGENTS.md) | 厂商内置记忆 | OwnMem |
|---|---|---|---|
| 谁来写 | 你手写 | 代理从对话里写 | 代理起草,你像审代码一样审 |
| 存在哪 | 你的仓库 | 厂商账号下,条目你可能永远看不到 | 你的仓库(Markdown) |
| 什么进模型 | 每轮全文进模型 | 厂商侧决定 | 三档投递,带 token 预算 |
| 证据漂移 | 无处理机制 | 官方对比未给出 | 会降级并指出什么变了 |
| 错了怎么办 | 你来改文件 | 条目不可见,难以拦截 | 变更走 commit,可归因可回滚 |
| 每轮成本 | 全文 token,随文件增长 | 官方对比未给出 | 零模型调用、零网络调用 |
差异最实质的是两行。“什么进模型”决定 token 账单与信噪比:指令文件每轮全文加载,文件越长税越重;OwnMem 只投当轮任务相关条目,且允许答”这次没有”。“错了怎么办”决定风险下限:厂商内置记忆的条目你可能永远看不到,谈不上审、谈不上拦;OwnMem 把变更做成 commit,评审归因回滚走现成 Git 工作流。
指令文件并没有被取代:稳定约定(命令、风格、禁区)依然写 CLAUDE.md,见本站专文;逐行拆解与选型决策表见对比专文。
适用与不适用:官方判断口径
官方 README 的判断表,原样整理:
| 场景 | 判断 |
|---|---|
| 团队想让项目知识随代码被评审、迁移 | 适合 |
| 多个编码代理轮换同一仓库 | 适合 |
| 要本地可复现召回,不付检索 API 账单 | 适合 |
| 坏记忆必须可归因、可拒绝、可回滚 | 适合 |
| 需要跨仓库个人画像或全局用户记忆 | 不适合 |
| 要自动捕获每段对话、无证据边界 | 不适合 |
| 需要大规模云端向量搜索或实时全局知识图谱 | 不适合 |
| 召回量优先于治理 | 不适合 |
最后一行展开:目标是”代理记住的越多越好”的话,净零增长会和你打架——它为治理优先的团队仓库设计;团队知识库是另一条路线,见本站 teamai CLI 知识召回。
研究谱系:CaMeL 与记忆投毒防御
官方 README 引用的研究谱系里,安全线最值得点名:AgentPoison 与 PoisonedRAG 演示了对 agent memory 与 RAG 知识库的投毒攻击,CaMeL 给出不可信数据与权威分离的防御架构,OwnMem 的 receipts 凭据机制就是这条线的工程化。它的安全立场:内容不能自称可信,代理自我归因不算用户确认。
常见问题
claude code 记忆系统有哪些?
常见三类:CLAUDE.md 这类手写指令文件、厂商侧内置记忆、OwnMem 这类 Git 原生记忆系统;前两类各有短板,均可与第三类组合使用。
三类职责不同:稳定约定归指令文件,踩坑经验归 OwnMem;厂商内置记忆适合自动沉淀对话,代价是条目可能永远看不到。三者并非互斥,分层组合更现实。
claude code 记忆文件在哪?
分三处:CLAUDE.md 在仓库根目录;OwnMem 的经验记忆在仓库 .ownmem/ 目录里;厂商内置记忆的条目存在厂商账号下,仓库里找不到对应文件。
OwnMem 把记忆放进仓库,为的是让记忆和代码同生命周期:clone 即继承,review 即评审,回滚即回滚;接入步骤见本站安装教程。
OwnMem 的记忆会被投毒吗?
投毒是真实风险,学术上已有 AgentPoison、PoisonedRAG 等记忆与知识库投毒研究;OwnMem 的对策是证据先于权威:条目要独立凭据,投递前实时证据检查。
具体机制:证据漂移会让条目降级并指出什么变了;每次记忆变更都是某个人的 commit;被召回的文本永远不能覆盖 host 指令或授权工具。投毒者要同时过评审与证据两道关。