Alluvia 实战教程：从 Claude Code、Cursor、ChatGPT 的对话历史中淘金

你每天和 AI 编码 Agent 聊几个小时。Claude Code 里推敲系统设计，Cursor 里调试数据库查询，ChatGPT 里探索新技术方向。三个月下来，每个工具攒了几十甚至上百次对话。

问题是：这些对话彼此不认识。

你在 Cursor 里踩过的坑，两周后又在 Claude Code 里踩了一次。你在 ChatGPT 里冒出的好主意——”下次一定要试试用 X 架构重构这个模块”——随着会话关闭就沉到了历史深处。每个 AI 工具只记得自己那一段，而你还要靠自己的记忆力把它们串起来。

Alluvia 就是来解决这个问题的。它是一个本地优先的跨工具 AI 对话挖掘工具，把你的 Claude Code、Cursor、ChatGPT 历史统一归到一个本地知识地图里，然后找出你早已遗忘的”桥梁”——在工具 A 里讨论过的漏洞，可能在工具 B 的调试记录中找到同一个根因。

安装

Alluvia 使用 Python 编写，MIT 开源，支持 pip 和 uv 两种安装方式：

uv tool install alluvia

pip install alluvia

安装后执行 alluvia init 即可初始化。它会自动检测你机器上已有的 Claude Code、Cursor、ChatGPT 数据源，并引导你配置 LLM provider（支持 Groq、OpenAI、Anthropic）。

alluvia init

💡 免费试用：Alluvia 支持 Groq 免费套餐——你可以在不绑定信用卡的情况下完整运行，你的对话数据始终留在本地机器上。

四个核心「透镜」

Alluvia 将你的 AI 对话历史蒸馏为原子化笔记、聚类为主题、再构建跨工具关联。最终通过四个 CLI 命令——它称之为”透镜”——来呈现：

1. alluvia themes — 你的思维主题全景

运行 alluvia refresh 完成数据摄入和聚类后，themes 命令展示你的思维地图上有哪些话题簇：

alluvia themes

输出示例：

• Docker Issues  [84 sessions/2 sources]  (2025-03→2026-06)
• Refresh Token Storage  [9 sessions/2 sources]
    Insecure localStorage tokens vulnerable to XSS; approaches discussed...
• 测试框架迁移  [31 sessions/3 sources]

每个主题后面标注了涉及的会话次数和来源工具数量，一眼看出哪些话题花时间最多。

2. alluvia connections — 跨工具的桥梁（最强功能）

这是 Alluvia 最亮眼的功能——它会找出你在不同工具、不同时间里讨论过的同一个问题：

alluvia connections

输出示例：

🔗 "no cross-check between ids enables forgery"   [Claude Code · 2026-06]
   ↔ "service isn't storing the id on upload"      [Cursor · 2025-04]
   why: same missing validation, found twice, 14 months apart.

这意味着你在六个月前用 Cursor 调试时已经遇到过同一个验证漏洞——但你完全不记得了。Alluvia 把它捞了出来。

3. alluvia unfinished — 你从未收尾的线程

我们在 AI 对话中经常讨论到一半就忙别的事了，很多想法永远没落地：

alluvia unfinished

输出示例：

🧵 测试基础设施重构   open · 4 sessions over 388 days
🧵 API 版本迁移方案   open · 2 sessions over 45 days

那些打开了一年还没收尾的线程，Alluvia 帮你记着。

4. alluvia propose — 基于你的笔记生成下一步计划

基于你的历史笔记和跨工具连接，Alluvia 可以自动生成可操作的建议：

alluvia propose

输出示例：

[prop:50bda956] Add server-side consistency check  (feasibility 4/5)
    ...cites: note:104966a3, note:93de85cc

每条建议都引用了原始笔记。你可以用 alluvia rate prop:50bda956 --keep 评分——Alluvia 会从你的评分中学习，逐步优化建议质量。

可视化仪表盘

除了命令行，Alluvia 还内置了一个仪表盘：

alluvia serve --open

在 http://localhost:8177 打开后，你可以看到：

• 知识地图总览（主题气泡图）
• 跨工具桥梁图（谁连接了谁）
• 一周活动时间线
• 最长的未完成线程
• 完整的评分历史

整个仪表盘是一个自包含的 HTML 页面，零外部请求，只监听 127.0.0.1。

从 ChatGPT 导入数据

ChatGPT 的对话需要从官方数据导出导入：

1. ChatGPT → Settings → Data controls → Export data
2. 等邮件收到 ZIP 文件后：

alluvia ingest --source chatgpt-export --path ~/Downloads/chatgpt-export.zip
alluvia refresh

导入后，你的 ChatGPT 会话会和 Claude Code、Cursor 的会话进入同一个知识地图。跨工具桥梁就是这么来的。

MCP 集成：在编码 Agent 中实时查询

Alluvia 提供了 MCP 服务器，你可以把它接入 Claude Code 或 Cursor：

claude mcp add alluvia -- uv run --directory  alluvia mcp

添加后，八个 MCP 工具让 Agent 能在对话中实时查询你的知识地图——”你四月份讨论过这个问题，当时得出的结论在这里。”

隐私设计

Alluvia 的隐私模型很清晰：

所有的 embedding 计算都在本地完成（fastembed + ONNX），不需要上传到任何第三方服务。LLM 调用只发送已脱敏的摘要文本。

实用技巧

使用 Groq 免费套餐完整体验：配置 Groq 作为 provider（不需要绑定支付方式），Alluvia 可以在免费额度下完成全部功能。如果某个模型的日额度用完，Alluvia 会自动降级到下一个可用模型，下次刷新时自动重试。

周报模式：Alluvia 可以每周自动推送最多 5 条值得关注的内容：

alluvia digest run --if-due

这条命令平时沉默不语，只有真正值得打断你的事情才会推送。

监控运行状态：

alluvia status    # 查看所有路径和大小
alluvia top       # 实时 CPU/内存/磁盘
alluvia doctor    # 诊断安装问题并自动修复

总结

Alluvia 解决的是一个真实且普遍的痛点——你的 AI 编码知识散落在各个工具的历史中，而每个工具都像是独立的孤岛。它的价值不在于”又一个 AI 记忆工具”，而在于跨工具的知识关联：那些你在 Cursor 里遇到的 bug，在 Claude Code 里讨论的架构决策，在 ChatGPT 里收藏的思路——Alluvia 把它们串起来，让你看到自己思维的完整图景。

如果你每天都在用多个 AI 编码工具工作，哪怕是 Groq 免费套餐试用十分钟，可能都会发现一些早已遗忘但有价值的内容。

相关链接

• Alluvia GitHub
• PyPI: alluvia
• 60 秒演示视频