[开源] Precedent Loop：让 Agnet 换个会话也记得项目里踩过的坑

用 Codex 和 Claude Code 写代码久了，最头疼的是它不记事。上周跟它一起查了一下午，根因找到了，方案也定了。这周开个新会话，它又从头猜一遍，有时还会把当初否掉的方案再提出来。

我试过两种办法，都不太顺手。

一种是写进 AGENTS.md / CLAUDE.md。放"必须遵守的规则"没问题。但"这个接口为什么要做幂等""那个报错其实是连接池配置引起的"这类经验，一条条加进去，文件很快就几百行。每次会话都全量塞给模型，真正相关的那几句反而被淹没了。

另一种是用客户端自带的记忆。记什么由模型自己决定，我看不全，也不知道哪条在哪次起了作用，记错了也很难发现。

所以我做了 Precedent Loop ，思路很简单：经验让 Agent 来提，入不入库我说了算，用的时候按需去取。

实际用起来是这样一个循环：

和前面两种办法比，好处主要有这几点：

库里每一条都是我看过的。 Agent 只能提候选，不能直接往库里写，所以不会越记越乱。
上下文不会膨胀。 库里有几百条也没关系，每次只取和当前任务相关的几条，而且有上限。
知识会跟着项目更新。 旧结论不对了，是在用的时候顺手发现、顺手提修订，不需要我定期去翻。
能看出哪些经验真有用。 每条被查到几次、被用上几次都有记录，长期没人用的可以清掉。
Codex 和 Claude Code 共用一个库。 多个项目之间也能互相查，比如在后端项目里查前端那边的约定。
全在本地。 数据就是一个 SQLite 文件，App 不调用任何模型 API ，也不保存 Key 。已有的 Markdown 笔记可以借本机的 Codex / Claude Code CLI 转成候选导进来。

它不是用来替代 AGENTS.md 的。每次都要遵守的规则继续写在那里，只在特定场景下用得上的经验放到这里。

先说清楚现在的不足，免得大家装了失望：

只支持 Apple Silicon 的 Mac 。App 没签名，第一次打开要去系统设置里手动放行。界面目前只有中文。
检索用的是 SQLite 全文检索（ FTS5 trigram ）加字面匹配，没上向量。好处是简单、能解释，不依赖外部服务；缺点是换个说法可能就搜不到。现在的补救办法是每条知识入库时必须带 3–16 个检索词，把常见说法提前写进去。这是我最想改进的地方。
没做过严格的对照实验。我自己从 7 月 8 日用到 10 月 4 日，库里攒了 79 条，被查到 307 次，模型标记用上 113 次。"用上"是模型自己报的，只能当个参考。

README 开头有一段 83 秒的演示视频。装好后 App 有引导，跟着点几步就能把 Codex 和 Claude Code 都接上。

欢迎试用、提 issue 。特别想听听大家的意见：同义说法怎么检索比较好，召回效果又该怎么评测。