rahilp/second-brain-cloudflare
One memory layer, every AI tool. Store anything once — recall it in Claude, ChatGPT, Cursor, or any MCP client. Self-hosted on Cloudflare's free tier.
Second Brain – AI 工具的个人与团队记忆
简介 – 一个云托管的“知识库”,存储您的笔记、决策、偏好和其他项目事实,并能按语义搜索。它作为 Cloudflare Worker 运行,后端使用 Cloudflare D1、Vectorize、Workers AI 和 KV,并通过简单的 REST/MCP API 与任何 兼容 MCP 的 AI 助手(Claude、ChatGPT、Cursor、Codex 等)通信。
重要性
| 问题 | Second Brain 的解决方案 |
|---|---|
| AI 助手没有共享上下文,您在每个应用中重复相同信息。 | 提供单一、私有且团队范围的记忆层,所有客户端都能查询,因此同一事实在所有地方都可用。 |
| 您必须记住确切的措辞才能检索笔记。 | 语义嵌入让您 按意义回忆;即使查询措辞不同,也能找到相同事实。 |
| 在多处(Obsidian、Notion、电子邮件、日历)保存笔记会导致信息分散。 | 集成功能直接从这些来源捕获到同一个大脑,并保留原始来源元数据。 |
| 团队需要共享知识库,但也需要个人隐私。 | 团队版 为每个用户提供私有工作区和共享的“公司”层;共享会移动单个标准记忆,而不是复制。 |
| 扩展语义搜索可能成本高昂。 | 使用 Cloudflare Vectorize 实现廉价、快速的向量搜索;如果不可用则回退到关键词搜索,索引通过夜间作业自动增长。 |
核心功能(概述)
- 语义捕获与回忆 –
remember、recall、append、update等支持自然语言查询。 - 自动组织 – 分类、重复检测、关系图、时间感知排序、每周洞察。
- 多层访问 – 个人(私有)、公司(共享团队)以及未来的 团队 层。
- 提示胶囊 – 确定性、只读的“核心”或项目特定上下文块,可前置到 LLM 网关的提示词中。
- 丰富集成 – 桌面应用(无需终端)、CLI、浏览器扩展、Obsidian 同步、Notion 同步、日历/电子邮件钩子、iOS 快捷指令,以及 Claude Code、Codex、Cursor、VS Code Copilot、Gemini CLI 的钩子。
- 控制与审计 – 仪表盘可浏览、编辑、删除、导出和查看历史记录;管理工具管理成员和共享权限。
- 在您自己的 Cloudflare 账户上自托管 – 所有数据(向量、凭据、记忆)都保留在您自己的账户中,而非第三方 SaaS。
工作原理(简化流程)
- 部署 – 一键 Cloudflare Workers 部署(或使用提供的桌面应用,它会为您完成)。创建的资源:D1 数据库(SQL 存储)、Vectorize 索引、KV 缓存、Workers AI 模型。
- 捕获 – 任何客户端调用
/capture端点(或 MCPremember),带有{content, source, tags, …}。Worker 存储文本,运行嵌入模型,分类条目,检查重复,并添加到向量索引。 - 组织 – 后台夜间作业创建全文相关性索引,链接相关记忆,并生成每周洞察。
- 回忆 – 客户端发送自然语言查询(
recall)。Worker 执行向量相似度搜索,使用全文索引重新排序,跟踪关系,并返回最相关的记忆(带有来源链接)。 - 提示胶囊 – 特别标记的记忆(
capsule:*)被编译成确定性、大小受限的文本块,可以缓存并用作 LLM 提示词的稳定前缀。
快速入门(步骤)
- 桌面应用 – 从 Releases 页面下载,运行,设置密码,并登录 Cloudflare。应用会自动配置 Worker 并连接您的 AI 工具。
- 或手动部署 –
npm install && npm run vectors:create && npm run deploy(需要 Wrangler、Cloudflare 账户和 D1/Vectorize 计划)。 - 连接客户端 – 使用提供的 MCP URL(
https://<your-worker>.workers.dev/mcp)并附带您的AUTH_TOKEN(Bearer 头)。README 列出了适用于 Claude、ChatGPT、Cursor、VS Code、Obsidian、Notion 等的现成集成。 - 尝试 –
curl -X POST https://<worker>/capture -H "Authorization: Bearer <token>" -d '{"content":"second brain is working","source":"test"}'应返回{"ok":true,"id":"..."}。
适用人群
- 个人 AI 重度用户,希望在 Claude、ChatGPT、Copilot 等之间拥有持久、可搜索的记忆。
- 中小型团队,需要共享“第二大脑”,同时保持个人笔记私密。
- 开发者,构建需要确定性上下文块(提示胶囊)的自定义 AI 代理或网关。
- 任何希望数据保留在自己 Cloudflare 账户内而不是 SaaS 提供商的人。
限制与注意事项
- 依赖 Cloudflare Vectorize;如果服务被禁用,系统会回退到关键词搜索,失去语义质量。
- 当前团队版每个大脑支持一个共享团队(多团队计划在将来发布)。
- 提示胶囊有 12k 字符的硬预算;超出大小的条目将被跳过或导致
409错误。 - 所有客户端认证基于令牌;出于安全考虑,查询字符串令牌已在 v3 中移除。
TL;DR
Second Brain 是一个由 Cloudflare 托管的语义记忆存储,让您和您的团队为每个 AI 助手提供一致、可搜索的上下文。一键部署,从数十种日常工具捕获,并按意义而非确切措辞检索信息,同时数据始终保留在您自己的 Cloudflare 账户下。
相关
- 项目
- 项目
- 项目
- 项目
- 项目