开源 | 我是怎么用 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 --target agents-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 frozen

AI 读到这些，就不会再犯"帮你把 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 完全本地跑：

export AI_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。