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。

工作原理(简化流程)

  1. 部署 – 一键 Cloudflare Workers 部署(或使用提供的桌面应用,它会为您完成)。创建的资源:D1 数据库(SQL 存储)、Vectorize 索引、KV 缓存、Workers AI 模型。
  2. 捕获 – 任何客户端调用 /capture 端点(或 MCP remember),带有 {content, source, tags, …}。Worker 存储文本,运行嵌入模型,分类条目,检查重复,并添加到向量索引。
  3. 组织 – 后台夜间作业创建全文相关性索引,链接相关记忆,并生成每周洞察。
  4. 回忆 – 客户端发送自然语言查询(recall)。Worker 执行向量相似度搜索,使用全文索引重新排序,跟踪关系,并返回最相关的记忆(带有来源链接)。
  5. 提示胶囊 – 特别标记的记忆(capsule:*)被编译成确定性、大小受限的文本块,可以缓存并用作 LLM 提示词的稳定前缀。

快速入门(步骤)

  1. 桌面应用 – 从 Releases 页面下载,运行,设置密码,并登录 Cloudflare。应用会自动配置 Worker 并连接您的 AI 工具。
  2. 或手动部署 – npm install && npm run vectors:create && npm run deploy(需要 Wrangler、Cloudflare 账户和 D1/Vectorize 计划)。
  3. 连接客户端 – 使用提供的 MCP URL(https://<your-worker>.workers.dev/mcp)并附带您的 AUTH_TOKEN(Bearer 头)。README 列出了适用于 Claude、ChatGPT、Cursor、VS Code、Obsidian、Notion 等的现成集成。
  4. 尝试 – 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 账户下。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目