Name: 项目记忆管理插件
Author: evgenygurin

使用说明

Claude Mem0项目内存插件

🧠 基于Mem0的Claude Code智能长期内存管理

特性

✅ 自动捕获：在编码会话期间自动捕获决策、模式和学习
🔍 语义搜索：使用自然语言从过去的工作中寻找相关背景
🔄 智能同步：用重要模式更新您的CLAUDE.md
🎯 项目范围：使用语义标记按项目组织内存
🧠 代理技能：克劳德在需要时会自动回忆起相关的记忆
🛠️ 显式控制：手动内存管理的Slash命令
🪝 基于钩子：通过SessionStart、SessionEnd和PostToolUse挂钩实现自动化工作流

安装

先决条件

Mem0帐户：注册地址：成员.ai 获取API密钥
Node.js：必需 @mem0/mcp-server
jq：用于钩子中的JSON处理(brew install jq / apt install jq)

设置

1.克隆此存储库

git clone https://github.com/evgenygurin/claude-mem0-project-memory.git
cd claude-mem0-project-memory

2.使脚本可执行

chmod +x scripts/*.sh

3.在您的项目中安装

cd /path/to/your/project
mkdir -p .claude/plugins
cp -r /path/to/claude-mem0-project-memory .claude/plugins/

4.配置环境

添加到您的shell配置文件或 .env:

export MEM0_API_KEY="your-mem0-api-key"
export MEM0_USER_ID="your-user-id"  # optional, defaults to project name

5.在克劳德代码中启用

/settings plugins
# Enable claude-mem0-project-memory

用法

🤖 自动模式

启用后，插件会自动：

初始化 会话开始时
跟踪更改 编辑代码时（写入/编辑工具用法）
回忆往事 当相关上下文存在时（通过代理技能）
自动保存到Mem0 在会话结束时（SessionEnd钩子）
- 捕获带有更改计数的会话摘要
- 通过API直接存储到Mem0（无需手动干预）
- 包括元数据：项目、时间戳、类型、更改计数
通知达到同步阈值时（5+次更改）

📝 手动命令

捕获内存

/mem0-capture We standardized error handling to always use Result<T, AppError> pattern

搜索内存

/mem0-search error handling patterns
/mem0-search database migration decisions

同步到CLAUDE.md

/mem0-sync              # Sync all memories
/mem0-sync decisions    # Sync only decisions

反思会议

/mem0-reflect           # Analyze last 5 sessions
/mem0-reflect 10        # Analyze last 10 sessions

配置

编辑 .claude/plugins/claude-mem0-project-memory/config/memory-config.json:

{
  "auto_capture": true,                  // Enable hooks (tracking, notifications)
  "auto_add_to_mem0": true,              // Auto-save session summaries to Mem0
  "sync_to_claude_md": true,             // Auto-sync to CLAUDE.md
  "auto_load_context": false,            // Load memories at session start
  "reflection_threshold": 5,             // Changes before suggesting sync

  "skill_settings": {
    "auto_recall_enabled": true,         // Enable automatic memory recall
    "recall_threshold": 0.75,            // Minimum relevance for auto-recall
    "max_context_memories": 5            // Max memories to load per recall
  },

  "hook_settings": {
    "session_start_init": true,          // Initialize at session start
    "track_tool_usage": true,            // Track Write/Edit events
    "log_mem0_calls": false,             // Debug logging (verbose)
    "min_changes_for_capture": 3,        // Minimum edits before capture
    "capture_session_summary": true,     // Capture session summaries
    "capture_significant_changes": false // Capture individual changes (verbose)
  }
}

关键设置

auto_add_to_mem0：何时 true，SessionEnd hook通过API自动将会话摘要添加到Mem0
capture_session_summary：控制是否捕获会话摘要
capture_significant_changes：（未来）捕获单个重大代码更改

建筑

┌───────────────────────────┐
│     Claude Code Agent      │
│   (with Sonnet 4.5)       │
└───────────┬────────────────┘
            │
            ├─── Skills (automatic)
            │    └── recall-project-memory
            │
            ├─── Commands (user-invoked)
            │    ├── /mem0-capture
            │    ├── /mem0-search
            │    ├── /mem0-sync
            │    └── /mem0-reflect
            │
            ├─── Hooks (event-driven)
            │    ├── SessionStart
            │    ├── SessionEnd
            │    ├── PostToolUse (Write|Edit)
            │    └── Stop
            │
            ↓
┌───────────────────────────┐
│      MCP Server              │
│    (@mem0/mcp-server)       │
└───────────┬────────────────┘
            │
            ↓
┌───────────────────────────┐
│   Mem0 API (Cloud/Self)    │
│  Long-term Semantic Memory │
└───────────────────────────┘

运作原理

1.🎯 捕捉

自动:

SessionEnd钩子分析成绩单
提取决策、模式、错误、解决方案
将重要见解存储到Mem0

手册:

使用 /mem0-capture 显式保存重要上下文

2.💾 商店

存储在以下位置的记忆：

语义嵌入 用于相似性搜索
项目范围 （user_id=项目名称）
元数据：类型、标签、时间戳、来源
内存类型：决策、模式、约束、学习

3.🔍 检索

自动（代理技能）:

克劳德检测到任务何时可能从记忆中受益
自动搜索Mem0
应用相关模式/约束
与过去的决策保持一致

手册:

/mem0-search <query> 用于显式搜索
返回分组、相关性评分的结果

4.🔄 同步

已同步到CLAUDE.md的重要模式：

自动生成的部分会定期更新
保留手册指南
基于阈值的通知
可通过内存ID进行跟踪

项目内存结构

在你的 CLAUDE.md:

## Project Memory

### Manual Guidelines
<!-- manual -->
[Your hand-written rules - never auto-modified]
<!-- /manual -->

### Auto-Discovered Patterns
<!-- BEGIN AUTO-GENERATED FROM MEM0 - Last synced: 2025-12-14 -->

#### Architecture Decisions
- **[2025-12-14]** Using Result<T, E> for error handling [[mem0:abc123]]
- **[2025-12-10]** PostgreSQL chosen for JSONB support [[mem0:def456]]

#### Code Patterns  
- **[2025-12-13]** API routes follow /api/v1/{resource} structure [[mem0:ghi789]]
- **[2025-12-11]** Builder pattern for complex configs [[mem0:jkl012]]

#### Constraints
- **[2025-12-12]** JWT tokens: 15min expiry (security requirement) [[mem0:mno345]]

#### Key Learnings
- **[2025-12-09]** Database indexes critical for query performance [[mem0:pqr678]]

<!-- END AUTO-GENERATED FROM MEM0 -->

路线图

[ ] v0.3：LLM驱动的成绩单摘要（与简单启发式）
[ ] v0.4：跨项目共享团队记忆
[ ] v0.5：内存分析仪表板
[ ] v0.6：与Linear/GitHub集成问题
[ ] v0.7：智能内存修剪和归档
[ ] v0.8：CLAUDE.md更新的冲突解决
[ ] v0.9：内存版本控制和差异可视化
[ ] v1.0：生产准备就绪，经过全面测试

贡献

欢迎投稿！拜托：

分叉回购
创建特征分支(git checkout -b feature/amazing-feature)
遵循官方的Claude Code插件规范
如果适用，添加测试
更新文档
提交带有清晰描述的PR

许可证

MIT许可证-请参阅许可证文件

支持

问题: GitHub问题
文档: 设置.md, 更改日志.md
克劳德代码: docs.code.claude.com
Mem0: 医学博士

学分

内置：

克劳德代码通过Anthropic
Mem0 长期语义记忆
模型上下文协议（MCP）

制作❤️ 通过 @evgenygurin