文档
核心概念

本地与 Cloud Brain

MindMux 在两种存储环境中使用同一套知识模型。本地 Brain 随项目保存在你的机器上;Cloud Brain 位于 Cloud Project 中,可通过 Cloud app 或兼容的 MCP 客户端访问。

保持一致的部分

两者都使用项目级根页面和结构化 Page 来组织知识。Page 都包含元数据、当前的 compiled_truth 与追加式 timeline。因此,即使工作的地点变了,知识模型也不会改变。

本地 Brain

当你更重视文件系统所有权、离线访问和常规 Git 工作流时,请选择本地 Brain。它的 Markdown 文件位于项目根目录下,即使不打开 MindMux 也可检查,并天然适合桌面端应用。

会话日志和任务运行数据等本地运行状态与 Brain 分开保存。

Cloud Brain

当你更重视可共享、可在浏览器访问的知识来源时,请选择 Cloud Brain。它属于 Workspace 内的 Cloud Project,支持成员与 Project 级访问控制、服务端版本历史,也可以让 MCP 客户端通过 OAuth 明确选择。

Cloud 不会把 Brain 变成无结构的文件桶;当前理解与历史证据的区分依然成立。

两者的关系是明确的

Cloud 不会自动发现本地文件夹,也不会替 agent 决定使用哪个 Brain。连接 MCP 客户端时,请选择或创建目标 Cloud Brain;使用桌面端时,请通过 Cloud 设置连接或迁移,以便审阅目标和结果。

不要把本地与 Cloud Brain 当成同一项目的两份、可任意独立编辑的副本。请先决定某个工作流的知识来源,再使用受支持的连接或迁移路径有意识地改变这个决定。

实用选择

需求优先选择
文件随仓库保存、本地所有权或离线工作本地 Brain
浏览器访问、协作、共享历史或远程 MCP 直连Cloud Brain
已有本地项目且希望变为共享项目迁移到 Cloud Project

这是运营方式的选择,而不是理念之争:两者都用于保存结构化、可长期维护的项目知识。