SynaBun

SynaBun

为 AI 编码工具提供长期记忆，并存储在你自己的计算机上。

synabun.ai · 文档 · 博客 · 比较 · 更新日志

---

SynaBun 是一个开源、可自托管的 AI 工作空间和持久记忆 MCP 服务：SynaBun Assistant 可协调 Claude Code、Codex 和 OpenCode Agent。 你在某次会话中做出的决定、修复的问题和提供的解释，都会在下一次会话中保留，并可用于你连接的每个项目和工具，让你不必重复说明。一切都存储在你计算机上的一个 SQLite 文件中：无需账户、云服务或 API 密钥。

npm install -g synabun

synabun 可启动应用。synabun mcp 是通过 stdio 运行的 MCP 服务，可供任何 MCP 客户端使用：

{
  "mcpServers": {
    "SynaBun": {
      "command": "npx",
      "args": ["-y", "synabun", "mcp"]
    }
  }
}

全局安装后，"command": "synabun", "args": ["mcp"] 会运行同一个服务。请阅读文档，或查看 SynaBun 与其他记忆工具的比较。

只需一次开关即可连接 Claude Code、Codex CLI、Gemini CLI 和 OpenCode；对于 Cursor、Windsurf 或其他支持 MCP（Model Context Protocol）的工具，则只需复制一段配置。它还内置 Neural Interface，这是一个本地 Web 应用，你可以在其中查看工具记住的内容并运行编码 Agent。

你可以用它做什么

• 在不同会话间保留上下文。 助手会在工作过程中保存学到的内容，并在下一个任务开始前查找相关信息。搜索结果既匹配含义，也匹配关键词。
• 查看它掌握的信息。 在 Neural Interface 中浏览、搜索、编辑和删除记忆；相关记忆会在 3D 地图上聚集在一起。
• 并行运行 Claude Code、Codex 和 OpenCode。 每个工具在 Neural Interface 中都有一个侧边面板，旁边还有终端、文件浏览器和白板，所有工具共享同一份记忆。
• 委派任务。 SynaBun Assistant 会规划任务、为任务推荐模型，将任务交给 Claude Code、Codex 或 OpenCode 中的工作者执行，并汇报结果。你也可以通过 WhatsApp 向它发送消息。
• 自动化。 将任务保存为模板，然后循环运行或按计划运行。
• 为 Agent 提供浏览器。 浏览器工具可让 Agent 在你能实时查看的浏览器中打开网页、点击、输入和阅读。

快速开始

你需要 Node.js 22.19 或更高版本。

npm install -g synabun
npm --prefix "$(npm root -g)/synabun/mcp-server" run setup:embeddings
synabun

1. 安装。 第一个命令会安装 SynaBun。第二个命令会下载用于语义搜索的模型；不安装模型，SynaBun 仍可使用，但只能进行关键词搜索。在 Windows 命令提示符中，将 $(npm root -g) 替换为运行 npm root -g 后显示的路径。

2. 启动。 synabun 会在 http://localhost:3344 启动 Neural Interface，并在浏览器中打开设置向导。首次启动时，还会为浏览器工具安装 Chromium 版本。

3. 连接 AI 工具。 在向导中添加项目，并启用你要使用的工具。SynaBun 会向 Claude Code、Codex CLI、Gemini CLI 和 OpenCode 注册自身，并安装一组简短规则，告诉每个工具何时回忆、何时记住。对于 Cursor、Windsurf 或其他 MCP 工具，请复制同一步骤中显示的配置片段。之后可在 设置 → AI 连接 中更改连接。

4. 试用。 在 AI 工具中启动新会话，然后说：

   记住，我们从 release 分支部署，绝不从 main 部署。

   再启动另一个会话并询问：

   你记得我们是如何部署的吗？

   然后打开 http://localhost:3344，在地图上查看记忆。按 / 搜索，按 a 打开助手，点击标题栏中的 ? 按钮查看导览。

工作时请让 synabun 保持运行：Claude Code 通过它访问记忆。按 Ctrl+C 停止。如果遇到问题，synabun doctor 会报告数据和工具连接的状态。

若要从源代码运行：

git clone --depth=1 https://github.com/danilokhury/Synabun.git
cd Synabun
npm start

npm start 会安装依赖、构建 MCP 服务并启动应用。启动后，在另一个终端中运行 npm --prefix mcp-server run setup:embeddings，即可启用语义搜索。

工作原理

Your AI tool ── MCP ──▶ SynaBun MCP server ──▶ memory.db (SQLite) ◀── Neural Interface (localhost:3344)

• 本地数据库。 记忆存储在磁盘上的一个 SQLite 文件中。每条记忆都会建立关键词搜索和语义搜索索引，语义搜索使用的模型在你的机器上运行。
• MCP 服务。 它为 AI 工具提供记忆工具：remember、recall、reflect、forget、restore 等。任何 MCP 客户端都可以使用。
• Neural Interface。 这是一个运行在 3344 端口的本地 Web 应用，可读取同一数据库。它包含记忆地图、设置、侧边面板、助手和自动化功能。
• 规则和钩子。 已安装的规则会告诉每个工具在开始重要工作前进行回忆，并在完成后进行记忆。在 Claude Code 中，钩子还会将相关记忆引入会话，并提醒助手保存工作内容。

功能

记忆

• 关键词和语义搜索。 recall 会结合两种搜索方式，并可返回符合令牌预算的精简结果。
• 自定义类别。 每个类别的描述都会告诉助手哪些内容属于该类别。
• 每个项目各有一份记忆。 回忆时会优先考虑当前所在项目，同时也能找到你在其他地方学到的内容。
• 不易丢失。 编辑会保留修订历史，可撤销更改；删除的记忆会进入回收站，可从中恢复；sync 会标记源文件已更改的记忆。
• 备份。 可在 设置 → 记忆与备份 中设置定时备份，并验证校验和。synabun restore-backup --from <backup.zip> 会检查备份；添加 --apply 即可还原备份。

神经界面

• 记忆地图。 以 3D 地图展示存储的所有内容：顶级类别是大陆，类别是岛屿，相似的记忆并排排列。
• 工作区。 终端、文件浏览器和白板与记忆并列显示。
• 可搜索的设置，支持英语和巴西葡萄牙语。
• 工作区导览，点击 ? 按钮即可查看。
• 用于截图的展示模式。 使用 ?showcase=1 打开界面后，会加载你的布局，但不会保存任何更改，并会模糊处理你的个人内容：记忆、会话标题、对话记录、终端输出、账户名称，以及任何看起来像私人信息的内容（电子邮件、用户主目录路径、ID、密钥、电话号码、其他项目的名称）。?lang=en 或 ?lang=pt-BR 仅设置该页面的语言。画布上的地图标签无法逐个模糊处理；你拖动的白板和记忆位置仍会保存。

编码 Agent

• Claude Code、Codex 和 OpenCode 的侧边面板。 支持流式回复、工具调用、审批、计划和可恢复会话，并使用你自己的账户。Gemini CLI 和普通 Shell 会作为终端标签页打开。
• SynaBun Assistant。 一个能在每轮对话中回忆记忆、建议任务运行位置、将任务分派给工作者并读取结构化结果的助手。预算上限和 Token 计量表让支出一目了然。
• WhatsApp Link。 将你的手机作为关联设备，通过三种权限级别向 Assistant 发消息。请参阅 docs/whatsapp.md。
• macOS 上的电脑操控。 Assistant 可以查看和操作桌面应用，并受到防护机制和停止控制的约束。
• 风格指南。 为每个项目提供品牌与设计系统，保存为 DESIGN.md 和设计 Token。Agent 会读取指南，但只能提议更改。请参阅 docs/style-guide.md。

自动化和工具

• 自动化工作室和计划。 可循环运行或按计划运行的任务模板。
• 浏览器工具。 浏览、点击、输入、读取和截图，也可以将多个操作合并为一次调用。请参阅 docs/browser-v2.md。
• 集成。 提供 Discord、Google Search Console、YouTube Studio、Leonardo.ai 和 Bluesky 的工具组，以及用于读取 X、Facebook、Instagram、LinkedIn、TikTok 和 WhatsApp Web 的工具。工具配置可将会话限制为所需的工具组。
• 技能。 /synabun 可根据记忆进行头脑风暴、对照代码审查记忆、保存对话并创建计划。 /leonardo 可指导图像和视频提示词的编写。
• Claude Code hooks。 了解其安装、隔离和衡量方式：docs/hook-integrity.md。
• AI 决策（可选）。 使用你自己的 TypeSafe API 密钥时，SynaBun 会在固定规则可能无法准确判断时请求判定：这条记忆是否重复、是否包含机密、是否过时。每项判定都有本地回退机制，未提供密钥时不会发送任何内容。请参阅 docs/judgments.md。

要求

• Node.js 22.19 或更高版本。
• macOS、Windows 或 Linux。 电脑操控仅支持 macOS。
• 你想使用的编码工具，需已安装并使用你自己的账户登录。SynaBun 不包含模型访问权限。
• 可选：C/C++ 构建工具。 终端使用原生模块。如果你的系统没有预构建二进制文件，安装时会进行编译；如果编译失败，除终端外的所有功能仍可正常使用。
• 可选：集成服务的凭据，例如 Discord、YouTube 或 AI 决策所需的凭据。启用相应功能时，可在设置中输入凭据。

更新

npm install -g synabun@latest
npm --prefix "$(npm root -g)/synabun/mcp-server" run setup:embeddings

SynaBun 也会在应用内提供新版本。无论采用哪种方式，每次更新后都要运行第二条命令：搜索模型保存在已安装的软件包中，而更新会替换该软件包。如果 recall 提示 Local embeddings unavailable; keyword retrieval used.，按此操作即可解决。

从 2026.x 升级？ 手动运行一次 npm i -g synabun@latest。以前的版本使用日期格式（2026.9.5），现在改为标准语义化版本号（2.0.0），因此旧版本安装中的应用内更新检查不会提供 2.0.0。从 2.0.0 起，应用内更新程序会照常工作。

从源码运行？ 执行 git pull --ff-only，然后运行 npm run mcp:build 和 npm start。

新版本首次启动前，SynaBun 会对你的数据创建经过验证的快照，并将其保存在数据文件夹中的 backups/updates 目录下。如果无法创建快照，它会停止，而不会启动。

你的数据与隐私

SynaBun 存储的所有内容都位于应用之外的一个文件夹中：macOS 和 Linux 上是 ~/.synabun，Windows 上是 %APPDATA%\synabun。设置 SYNABUN_DATA_HOME 可使用其他位置。

~/.synabun/
├── .env                 # settings and credentials for integrations
├── data/                # interface state, schedules, logs
├── backups/             # backups and pre-update snapshots
└── mcp-data/memory.db   # your memories

• 你的记忆保留在自己的设备上。 数据库是本地文件，搜索模型也在本地运行。
• 哪些数据会离开设备。 你的 AI 工具会将提示词和检索到的记忆发送给各自的服务提供商。可选功能（AI 决策、WhatsApp、Discord、浏览器）在完成设置后会与相应服务通信。SynaBun 会检查 npm 和 GitHub 是否有新版本，界面还会从公共 CDN 加载网页字体和一个脚本。
• 仅在可信网络上使用。 Neural Interface 没有登录功能，并会监听所有网络接口。请勿将端口 3344 暴露到互联网。完整的安全模型请参阅 SECURITY.md。
• 通过应用备份。 SynaBun 运行时手动复制 memory.db 可能会遗漏近期写入的数据。

链接

• 更新日志：2.1.0 及更早版本中的新增内容
• 安全：安全模型及漏洞报告方式
• 参与贡献：欢迎通过 issues 提交错误报告和功能请求；不接受拉取请求
• 网站、文档 和 博客
• 社区：Discord 和 X

许可证

根据 Apache License, Version 2.0 授权。

你可以根据 Apache 2.0 使用、修改和分发 SynaBun。高级功能和企业扩展可能会根据单独的商业许可证提供。详情请参阅 LICENSE-COMMERCIAL.md。第三方声明见 NOTICE 和 THIRD-PARTY-LICENSES.md。

商标声明

“SynaBun”是其作者的商标。该许可证并未授予使用 SynaBun 名称、商标、服务标记或品牌标识的权限。如果你分叉此项目，必须为衍生作品使用不同的名称。

软件包验证：可下载的 VirusTotal 报告和 SHA-256 哈希值。请确保报告与确切的版本和文件哈希值匹配。报告记录了引擎覆盖范围和分析日期；这并不构成安全保证。网站上的结果描述的是 URL 信誉，而非漏洞审计。