claude-mem 中文文档

Appearance

开始使用 Claude-Mem ​

自动操作 ​

Claude-Mem 安装后会自动工作。无需人工干预！

完整循环 ​

  1. 开始 Claude Code - 最近 10 个会话的上下文会自动显示
  2. 正常工作 - 每次工具执行都会被记录
  3. Claude 完成回应 - 停止钩子会自动生成并保存摘要
  4. 下一次会议 - 之前的工作出现在上下文中

被捕获的内容 ​

每次Claude使用工具时，claude-mem 都会捕捉到它：

  • 读取 - 文件读取和内容访问
  • 写 - 新建文件
  • 编辑 - 文件修改
  • Bash - 命令执行
  • Glob - 文件模式搜索
  • Grep - 内容搜索
  • 以及所有其他 Claude Code工具

处理的内容 ​

Worker 服务处理工具观察并提取：

  • 标题 - 发生事情的简要描述
  • 字幕 - 额外的上下文
  • 叙述 - 详细解释
  • 事实 - 关键要点以项目符号形式列出
  • 概念 - 相关标签和分类
  • 类型 - 分类（决策、错误修复、功能等）
  • 文件 - 读取或修改了哪些文件

会议摘要 ​

当 Claude 完成回应（触发停止钩子）时，将自动生成一个摘要，包括：

  • 请求 - 你所要求的
  • 调查过的 - Claude探索的内容
  • 学到的 - 关键发现和见解
  • 已完成 - 完成了什么
  • 下一步 - 接下来要做什么

上下文注入 ​

当你开始一个新的 Claude Code 会话时，SessionStart 钩子：

  1. 查询数据库中您项目的最近观测（默认：50）
  2. 检索最近的会话摘要以供参考
  3. 以时间顺序显示带有会话标记的观察记录
  4. 仅当摘要是在上次观察之后生成时，显示完整的摘要详情（已调查、已了解、已完成、下一步）
  5. 将格式化的上下文注入到Claude的初始上下文中

摘要显示逻辑：

最近的摘要的完整详情仅在上下文显示的末尾出现，前提是该摘要是在最近一次观测之后生成的。这确保了当摘要代表项目的最新状态时，你可以看到摘要详情，但在自上次摘要以来已捕获新观测时，则不会显示。

例如：

  • ✅ 显示摘要：最后一次观察时间为下午2:00，摘要生成时间为下午2:05 → 摘要详情显示
  • ❌ 隐藏摘要：摘要生成于下午2:00，新观察于下午2:05 → 摘要详情已隐藏（已过时）

这可以防止在新的工作已被捕获但尚未总结时显示过时的摘要。

这意味着Claude“记得”之前会话中发生的事情！

手动命令（可选） ​

Worker 管理 ​

v4.0 会在第一次会话时自动启动 Worker 进程。下面的手动命令是可选的。

bash
# Start worker service (optional - auto-starts automatically)
npm run worker:start

# Stop worker service
npm run worker:stop

# Restart worker service
npm run worker:restart

# View worker logs
npm run worker:logs

# Check worker status
npm run worker:status

测试 ​

bash
# Run all tests
npm test

# Test context injection
npm run test:context

# Verbose context test
npm run test:context:verbose

发展 ​

bash
# Build hooks and worker
npm run build

# Build only hooks
npm run build:hooks

# Publish to NPM (maintainers only)
npm run publish:npm

查看已存储的上下文 ​

上下文存储在 ~/.claude-mem/claude-mem.db 的 SQLite 数据库中。

直接查询数据库：

bash
# Open database
sqlite3 ~/.claude-mem/claude-mem.db

# View recent sessions
SELECT session_id, project, created_at, status
FROM sdk_sessions
ORDER BY created_at DESC
LIMIT 10;

# View session summaries
SELECT session_id, request, completed, learned
FROM session_summaries
ORDER BY created_at DESC
LIMIT 5;

# View observations for a session
SELECT tool_name, created_at
FROM observations
WHERE session_id = 'YOUR_SESSION_ID';

理解渐进式披露 ​

上下文注入使用渐进式披露以提高 token 使用效率：

第1层：索引显示（会话开始） ​

  • 显示带有token成本估算的观测标题
  • 在时间顺序的时间线上显示会话标记
  • 按文件对观察进行分组以便于视觉清晰
  • 仅在最后一次观察之后生成时显示完整摘要详情
  • token 成本：索引视图约需 50-200 个 token

第2层：按需详情（MCP工具） ​

  • 自然地问：“我们修复了哪些错误？”或“我们是如何实现 X 的？”
  • Claude 自动调用 MCP 搜索工具以获取完整详情
  • 按概念、文件、类型或关键字搜索
  • 关于特定观察的时间轴背景
  • token 成本：每次获取的观察约需 100-500 个 token
  • 使用三层工作流程：搜索 → 时间线 → 获取观测

第3层：完美回忆（代码访问） ​

  • 在需要时直接读取源文件
  • 访问原始成绩单和原始数据
  • 可按需提供完整上下文

这确保了在保证所需时仍能访问完整历史记录的同时，实现高效的 token 使用。

多提示会话与 /clear 行为 ​

Claude-Mem 支持跨多个用户提示的会话：

  • prompt_counter：跟踪会话中的总提示数
  • prompt_number：标识会话中的特定提示
  • 会话连续性：观察和总结在提示之间相互关联

/clear 的重要说明 ​

当你使用 /clear 时，会话不会结束——它会用一个新的提示编号继续。这意味着：

  • ✅ 上下文已从最近的会话重新注入（SessionStart 钩子在 source: "clear" 时触发）
  • ✅ 观察仍在被记录 并被添加到当前会话中
  • ✅ 摘要将在 Claude 回复完成后生成（停止钩子触发）

/clear 命令会清除 Claude 可见的对话上下文，并重新注入来自最近会话的新上下文，同时底层会话仍会继续跟踪观察内容。

搜索你的历史 ​

Claude-Mem 提供用于查询您的项目历史的 MCP 工具。只需自然地提问即可：

"What bugs did we fix last session?"
"How did we implement authentication?"
"What changes were made to worker-service.ts?"
"Show me recent work on this project"

Claude 会自动识别您的意图并调用 MCP 搜索工具，这些工具使用三层工作流程（搜索 → 时间线 → 获取观察）以高效使用 token。

下一步 ​