开源 | 我是怎么用 ai-memory 让 Cursor 每次开新对话都自动知道项目背景的
开源地址：https://github.com/hyxnj666-creator/ai-memory
npm：npx ai-memory-cli@latest（内置免费模型，无需配置 API Key）
协议：MIT
先说痛点
用 Cursor 做过多项目的人应该都有这个体验：
每次开新会话，要花 5-15 分钟重新铺背景。“这个项目用的是 PostgreSQL，当时选它是因为……”、“上次那个 Redis 方案我们讨论过不用，原因是……”、“这个模块正在重构，不要动里面的逻辑……”
AI 永远是新的。记忆永远是你自己扛。
我在 Cursor 里积累了 37 个对话窗口，涉及将近 20 个项目。直到有一天跑了一次 ai-memory，把这些对话提取成了519 条结构化记忆，才发现里面藏着多少"沉没的知识"。
从那之后，我把 ai-memory 变成了日常开发工作流的一部分。这篇文章分享一下我现在的具体做法。
我现在的工作流
第一步：周期性提取（增量模式）
我在本机注册了一个每天自动跑的定时任务：
npx ai-memory-cli init--schedule这样每天早上 9 点，工具自动扫描新增的 Cursor 对话，增量提取，不用手动触发。
如果要手动跑一次：
# 增量模式，只处理新增对话，已提取的跳过npx ai-memory-cli extract--incremental第二步：提取后同步 AGENTS.md
提取完之后，我会更新一下 AGENTS.md：
npx ai-memory-cli rules--targetagents-md这个文件会被 Cursor、Claude Code、Windsurf、Copilot、Codex CLI 在每次新会话时自动读取。AI 打开对话就已经知道这个项目的架构、决策、禁区——不需要你再解释一遍。
生成的 AGENTS.md 大概长这样：
## Architecture Decisions - Use PostgreSQL (not MongoDB) — chosen for ACID compliance in billing module - Event Sourcing for audit log — append-only, immutable history required ## Conventions - All API routes use snake_case - No direct DB access from route handlers — always go through repos ## Off-limits - Do not refactor /src/legacy/ — scheduled for Q3, currently frozenAI 读到这些，就不会再犯"帮你把 MongoDB 换成 PostgreSQL"或者"顺手重构了一下你说不要动的模块"这类问题。
第三步：开新会话时加载上下文
如果某个功能需要某个特定对话的背景，我会用 context 命令把那段记忆复制进去：
# 把最近的记忆复制到剪贴板npx ai-memory-cli context--copy# 只加载某一个对话的记忆npx ai-memory-cli context --source-id e0ef3946--copy粘贴到新会话的开头，AI 立刻有了完整上下文。
第四步：搜索历史决策
三个月前做过一个技术选型，现在突然想起来当时的结论是什么：
npx ai-memory-cli recall"OAuth"不仅能找到相关决策，还能看到这条记忆在 git 历史中每次被修改的轨迹——什么时候做的决定，后来有没有改过，谁改的。
Dashboard 可视化
npx ai-memory-cli dashboard浏览器打开http://localhost:3141，可以看到所有记忆的分布、时间线、每个对话的产出量。
提取的 5 种记忆类型
ai-memory 会把对话内容分成 5 类：
| 类型 | 说明 | 示例 |
|---|---|---|
| Decision | 技术选型、架构决策 | “决定用 PostgreSQL 而不是 MongoDB” |
| Architecture | 系统架构设计 | “用 Event Sourcing 实现账单审计日志” |
| Convention | 编码规范、命名约定 | “所有 API 使用 snake_case 命名” |
| TODO | 待完成任务 | “需要补充 OAuth 错误处理” |
| Issue | 发现的 bug 或问题 | “AGENTS.md 输出字段重复” |
每条是一个独立的 Markdown 文件，放在.ai-memory/{author}/{type}/下，完全可以用git diff追踪变化。
支持的编辑器
| 编辑器 | 状态 |
|---|---|
| Cursor | ✅ |
| Claude Code | ✅ |
| Windsurf | ✅ |
| VS Code Copilot Chat | ✅ |
| OpenAI Codex CLI | ✅ |
零配置直接跑
不用配 API Key，内置免费模型（DeepSeek-V4-Flash），限 2 个对话/次，体验完整流程够用：
npx ai-memory-cli try# 试用，不修改任何文件npx ai-memory-cli extract# 直接提取大批量提取推荐硅基流动（500 条记忆约 ¥0.1），或者 Ollama 完全本地跑：
exportAI_REVIEW_API_KEY=sk-...# OPENAI_BASE_URL=https://api.siliconflow.cn/v1开源信息
- GitHub：https://github.com/hyxnj666-creator/ai-memory
- npm：https://www.npmjs.com/package/ai-memory-cli
- 版本：v2.6（持续迭代中）
- 协议：MIT License
如果你也在用 Cursor / Claude Code 开发，欢迎试试，有问题直接提 Issue。
