工作原理
六个组件，一条记忆链路
钩子捕获 → worker 处理 → SQLite 落盘 → 向量索引 → 下一会话注入。全部在本地完成。
1. 工具调用2. 观察记录3. 语义摘要4. 索引5. 下一会话
01
生命周期钩子
SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SessionEnd。每个钩子都是一条无 shell 的命令 claude-mem hook claude-code <event>，由安装程序放到 PATH 上的一个小型启动器运行。
02
智能安装
带缓存的依赖检查器（claude --init / --maintenance 上的 Setup 钩子，外加 npx claude-mem install / repair）。
03
Worker 服务
由 Bun 管理的本地 HTTP API，带 Web 查看器 UI 与搜索端点。
04
SQLite 数据库
存储会话、观察与摘要。
05
mem-search 技能
带渐进式披露的自然语言查询。
06
Chroma 向量数据库
用于智能上下文检索的混合语义 + 关键词搜索。
生命周期钩子
六个时机，无 shell 执行
每个钩子都是一条无 shell 的命令 claude-mem hook claude-code <event>，由安装程序放到 PATH 上的一个小型启动器运行。
SessionStartUserPromptSubmitPreToolUsePostToolUseStopSessionEnd
钩子名称来自官方文档。逐条说明见 钩子参考。
数据流
从一次工具调用到下一次会话
下图按官方组件说明整理，用于理解链路顺序。
工具调用 — PreToolUse / PostToolUse 捕获
观察记录 — 写入 SQLite
语义摘要 — 生成可检索的观察
索引 — FTS5 + Chroma 向量
下一会话 — SessionStart 注入