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 指令或授权工具。投毒者要同时过评审与证据两道关。