agentmem 是一个面向长期存在编程智能体的受治理记忆系统。它的出发点是：AI 编程助手在会话之间会遗忘一切，重复过去的错误，也无法分辨当前规则和过时规则；上下文压缩后恢复过程也很痛苦。多数记忆工具解决的是“存储”，agentmem 解决的是“信任”。
【用途与定位】 agentmem 用于给 Claude Code、Cursor 和 Codex 等编程智能体提供共享记忆，让它们知道哪些内容仍然成立。它强调本地优先（local-first），不依赖云服务、API 密钥或向量数据库，只使用一个 .db 文件。
【主要能力】
- 真相治理（Truth Governance）：每条记忆都有一个状态，用来衡量它应被信任的程度。资料给出的状态包括假设（hypothesis）、活跃（active）、已验证（validated）、已弃用（deprecated），并提到被取代（superseded）。缺少治理时，智能体记忆会积累过时规则、矛盾内容和已废弃决策，例如一月的 voice 设置已在三月被覆盖，但两条都会检索出来，LLM 随机选择。
- 冲突检测：发现互相矛盾的记忆。它会检测主题重叠（Jaccard 相似度）、区分重复与矛盾、进行句子级否定匹配（不只是关键词扫描），并按严重程度区分 critical（两者均为活跃）与 warning（其一带已弃用）。资料提到治理引擎把冲突从 1848 个误报降到 11 个真实发现。
- 过期检测：按年龄（N 天未更新）、来源文件缺失（被引用文件已删除）、哈希漂移（源文件内容变化但记忆未更新）找出过时记忆。
- 健康评分：从冲突、过期百分比、孤立引用、已弃用权重以及是否存在已验证记忆等维度，给记忆系统打 0-100 分。
- 来源感知同步（Provenance-Aware Sync）：把规范 markdown 文件同步进数据库并跟踪来源。相同哈希=跳过（幂等）；不同哈希=更新；章节被移除=弃用（带原因）；章节恢复=复活（重新激活已弃用记忆）。
- 信任排序召回（Trust-Ranked Recall）：recall() 不只找相关记忆，而是找最可信的相关记忆。FTS5 检索返回候选后，每条按相关性 25% + 信任状态 20% + 来源 20% + 新近度 15% + 频率 10% + 置信度 10% 打分。已验证的规范记忆排在无来源的假设记忆之上；已弃用和被取代的记忆完全排除；并按 token 预算贪心打包。
- 项目范围限定（Project Scoping）。
- 七种记忆类型，覆盖真实智能体工作流（资料未逐一列出类型名称）。
【使用方式】
- 快速开始：按 Claude Code / Cursor / Codex 的说明安装，重启编辑器后智能体即拥有 13 个记忆工具，可运行 memory_health 确认。
- 仅 Python 用户：可执行 pip install quilmem，且无需 MCP 额外依赖；也提供 Python API。
- MCP 服务器：内置于 Claude Code、Cursor 及任何 MCP 客户端。Claude Code 配置示例为 .claude/settings.json。
- MCP 工具：add_memory、search_memory、recall_memory、update_memory、delete_memory、list_memories、save_session、load_session、promote_memory、deprecate_memory、supersede_memory、memory_health、memory_conflicts。
- 教智能体使用记忆：把 agent instructions 复制到 CLAUDE.md、.cursorrules 或 AGENTS.md 中，以教会智能体会话协议、信任层级以及何时搜索、何时新增。
【适用场景】 面向长期存在的编程智能体，尤其是希望跨会话保留正确规则、避免重复 bug、需要区分当前规则与过时规则的开发流程。资料称 agentmem 在 2 个多月的每日生产使用压力下构建：产出 65+ 条 YouTube Shorts 且零重复生产 bug；330+ 条记忆治理语音生成、FFmpeg 组装、图像提示词、上传工作流；每个 bug 只被捕获一次、修复一次，不再重复。
【技术实现】 存储使用 SQLite 的 WAL 模式（并发读、线程安全）；搜索使用 FTS5，配合 porter 词干与 unicode61 分词器；排序使用综合评分：文本相关性 + 信任状态 + 来源 + 新近度 + 频率 + 置信度；治理包含状态生命周期、冲突检测、过期检测、健康评分；同步具备来源感知，支持源哈希与复活。零基础设施：无 API 密钥、无云、无向量数据库，只有一个 .db 文件。
【限制】 当前资料未提供价格、收费模式、平台支持矩阵、许可协议或具体性能数据；七种记忆类型的完整名称亦未列出。
