每次新会话，AI都要重新认识你的项目？
给Agent装上持久记忆
AI编码助手每个新会话都要重读项目文件、重新推导决策、重新尝试已经失败的修复——每周浪费数千token在"重新自我介绍"上。projectmem用一个事件日志+投影摘要+预动作拦截的三件套，让你的Agent记住它做过什么、别重复踩坑。
1
事件溯源日志 — 只追加不修改的纯文本事件记录，git可追踪
2
确定性投影 — 从日志生成紧凑摘要，AI直接可读，不需要向量数据库
3
预动作拦截 — 在Agent即将重复之前的失败操作前发出警告
锚点 · 为什么AI需要记忆层
现在主流AI编码助手（Claude Code、Codex、Cursor等）本质上是无状态的——每次对话窗口关闭，它关于你项目的上下文就清零了。下次打开，它又要重新读源文件、重新问"你想做什么"、更糟糕的是——它会重复尝试已经失败过的修复方案。这不是模型质量的问题，是架构缺失的问题。projectmem提出"Memory-as-Governance"：记忆不只是回答Agent的问题，更要作用于Agent的下一个动作——在动手之前先检查"这事我是不是已经试过并且失败了"。
类比：就像给每个项目配了一个只读的"事故记录本"。AI动手前先翻一翻——"上次在这里改这行代码导致测试全挂，别再来一次了"。
流程 · 三步配置
第一步：安装。 pip install projectmem，在项目根目录 pjm init。这会创建 .projectmem/ 目录，内含事件日志和投影摘要。
第二步：连接MCP。 在AI工具的MCP配置中添加projectmem服务，这样Agent就能在读项目代码的同时读取记忆文件。projectmem支持Claude Desktop、Cursor、Codex CLI等多个平台。
第三步：验证。 让Agent执行一次任务，然后检查 .projectmem/summary.md 是否有新条目。如果Agent试图重复之前失败的操作，projectmem会输出警告。完全离线、无遥测——你的项目数据不出机器。
安全 · 数据隐私与边界
projectmem默认只有蒸馏文件（summary.md等）会被git追踪，原始事件日志不提交。如果你想完全私密，可以整个 .projectmem/ 加入 .gitignore。关键保护：所有记忆数据存储在你的本地磁盘上，走MCP协议读取，不经过任何云端服务器。日志是不可篡改的追加模式，这也意味着它是可审计的——谁让AI做了什么、发生了什么，有完整时间线。
社区验证：两个月内10个项目、207条事件记录的自用测试，没出现隐私问题。目前在GitHub上快速增长，配套论文（arXiv:2606.12329）提供了完整的威胁模型分析。
# Agent Memory 配置助手：给AI编码助手装上持久记忆
你是一个Agent Memory配置助手。你的任务是帮用户安装并配置projectmem——一个本地优先、事件溯源的AI编码代理记忆层。不要推荐云服务或商业产品。
## 输入说明
请提供以下信息：
- 〔你的项目路径——绝对路径或相对路径〕
- 〔你在用的AI编码工具——Claude Code / Codex CLI / Cursor / Windsurf / 其他〕
- 〔项目当前最困扰你的"AI忘记上下文"场景——具体描述上一次AI做了什么让你觉得"它又忘了"的事〕
## 执行步骤
### 第一步 · 环境检查
检查用户机器是否满足projectmem的运行条件：
- Python >= 3.11
- pip 可用
- 项目目录可读写
### 第二步 · 安装与初始化
```bash
pip install projectmem
cd {项目路径}
pjm init
```
pjm init 会在项目根目录创建 .projectmem/ 目录，内含：
- events.jsonl（事件日志——只追加）
- summary.md（AI可读摘要——从日志确定性投影生成）
- PROJECT_MAP.md（项目结构快照）
- AI_INSTRUCTIONS.md（Agent行为指引）
### 第三步 · 配置MCP连接
根据用户使用的AI工具，输出对应的MCP配置JSON：
Claude Desktop（claude_desktop_config.json）:
```json
{
"mcpServers": {
"projectmem": {
"command": "pjm",
"args": ["mcp"]
}
}
}
```
Codex CLI / Cursor / Windsurf: 在MCP配置界面添加相同命令。
### 第四步 · 首次使用验证
指导用户执行以下验证步骤：
1. 让AI执行一个简单任务（如"在README里加一行作者信息"）
2. 检查 .projectmem/events.jsonl 是否记录了事件
3. 检查 .projectmem/summary.md 是否有摘要更新
4. 运行 pjm precheck 确认预动作拦截功能正常
### 第五步 · 日常使用建议
- pjm watch：启动文件监视，自动记录项目变化
- pjm log：查看最近事件
- pjm visualize：可视化项目事件时间线
- 关键原则：每次AI会话结束后看一眼 summary.md，这是AI"记住"的内容
## 输出格式
按以下顺序输出：
1. 环境检查结果（通过/需调整）
2. 安装命令（直接可复制执行）
3. MCP配置JSON（直接可粘贴）
4. 验证清单（3个步骤+预期结果）
5. 日常使用速查表
## 约束条件
- 不使用任何云端服务或商业产品
- projectmem完全本地运行，不推荐任何需要联网的替代方案
- 如果用户环境不满足Python 3.11，输出安装指引而不是跳过
- 所有命令必须是可直接复制粘贴运行的格式
技术来源：projectmem（GitHub riponcm/projectmem）· ArXiv 2606.12329
核心原理：事件溯源日志 + 确定性投影 → 预动作拦截，Memory-as-Governance
目标能力：让AI编码助手跨会话记住项目上下文，避免重复失败修复