Claude-Mem 是什么：编程 Agent 如何跨会话记忆
Claude-Mem 架构：从宿主事件到可检索记录
依次看 Hook、队列、生成记录与搜索，不把它们混成一步
Claude-Mem 架构：从宿主事件到可检索记录知识学习CN编辑简报更新 2026-10-08
你将学会
- 捕获事件
- 处理并保存
- 有选择地返回上下文
开始前需要
- 合成的双会话项目
- 一种受支持宿主
- 明确选择的记忆供应商
用合成的两次会话，再做排除和删除检查
先看结论
- Hook 文件比示意图更细。
- 存储与向量检索职责不同。
- README 的工具数量存在内部不一致。
捕获事件
固定版本 `plugin/hooks/hooks.json` 包含 Setup、SessionStart、UserPromptSubmit、PostToolUse、PostToolUseFailure、PreToolUse、Stop 和 SessionEnd。部分处理器通过 Bun runner 启动脚本。
架构概览把这些事件简化成生命周期示意。统计具体配置时应以 Hook 文件为准，因为文档图可能省略新增或较窄的处理器。
处理并保存
本地架构文档描述 worker 接收会话与观察事件，使用待处理消息队列及 SDK Agent 生成结构化观察。SQLite 保存会话、观察与摘要，Chroma 用于向量检索。
入队消息、生成的观察记录和搜索命中是不同对象。概览讨论了生成器错误后的恢复，我们没有实际测试崩溃与重放。
有选择地返回上下文
README 建议先搜简短索引，再看时间线，最后按 ID 打开观察详情。其他原生宿主可能通过自己的集成方式捕获事件并访问 worker。
同一 README 在该段先说有四个 MCP 工具，后面却只列出三个名称。实际使用应检查客户端暴露的工具，不能直接照搬这个不一致的数量。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
识别宿主事件与处理器。
- 2
把 worker 队列与持久记录分开追踪。
- 3
只打开回答问题需要的观察详情。
可复制示例
text
host -> hook or adapter -> worker queue
worker -> SQLite observation + Chroma index
search index -> timeline -> selected observation常见问题
所有宿主都使用相同 Hook 吗？
不是，原生适配器和转录文件监听有不同的捕获路径。
搜索结果能证明摘要准确吗？
重要问题仍应回到原始文件或会话记录核对。
资料来源
- Claude-Mem / README.md来源核查 2026-10-08
- Claude-Mem / docs/architecture-overview.md来源核查 2026-10-08
- Claude-Mem / plugin/hooks/hooks.json来源核查 2026-10-08
- Claude-Mem / docs/native-harness-integrations.md来源核查 2026-10-08