架构
系统总览
MindMux 是一个 Electron 桌面应用，围绕本地优先（local-first）的项目大脑和可跨运行时迁移的执行层构建。
高层架构
从宏观上看，系统主要由五部分组成：
- React 渲染器
- Electron 主进程
- 运行时集成
- 基于 MCP 的工具层
- 基于本地文件的项目存储
核心流程
典型流程如下：
- 渲染器驱动用户交互。
- 主进程协调会话、项目、任务、监控器和配置。
- 被选中的运行时负责对话或任务执行。
- 运行时通过 MCP 工具界面读取和操作项目知识。
- 持久输出写入
brain/，运行状态写入项目本地存储。
责任划分
渲染器（Renderer）
负责用户界面：会话、页面、任务、设置和导航。
主进程（Main Process）
负责编排：窗口、会话生命周期、监控器、运行时协调、任务、通知和 IPC。
运行时层（Runtime Layer）
负责对话和任务的模型执行路径。
MCP 层（MCP Layer）
负责结构化项目操作和外部连接器访问。
设计意图
代码库里反复出现的架构选择有：
- 持久知识保持基于文件的存储
- 会话和任务作为明确的产品对象
- 运行时相关行为隔离在稳定抽象之后
- 通过 MCP 工具暴露结构化项目上下文
- 保留用户对项目知识的本地所有权
为什么这种形态有效
MindMux 需要同时处理：
- 桌面文件系统访问
- 长期本地状态
- 模型执行
- 显式知识结构
- 人工确认检查点
这套架构能同时满足这五点，而不必将它们合并成一个不透明的单体进程。
产品层面的结果
这种架构让应用可以沿两个维度独立演进：
- 知识模型可以持续加深，而不必重写运行时集成
- 运行时集成可以变化，而不破坏项目大脑