架構
系統總覽
MindMux 是一個 Electron 桌面應用，圍繞本地優先（local-first）的專案大腦和可跨執行時遷移的執行層構建。
高層架構
從宏觀上看，系統主要由五部分組成：
- React 渲染器
- Electron 主程序
- 執行時整合
- 基於 MCP 的工具層
- 基於本地檔案的專案儲存
核心流程
典型流程如下：
- 渲染器驅動使用者互動。
- 主程序協調會話、專案、任務、監控器和配置。
- 被選中的執行時負責對話或任務執行。
- 執行時透過 MCP 工具介面讀取和操作專案知識。
- 持久輸出寫入
brain/，執行狀態寫入專案本地儲存。
責任劃分
渲染器（Renderer）
負責使用者介面：會話、頁面、任務、設定和導航。
主程序（Main Process）
負責編排：視窗、會話生命週期、監控器、執行時協調、任務、通知和 IPC。
執行時層（Runtime Layer）
負責對話和任務的模型執行路徑。
MCP 層（MCP Layer）
負責結構化專案操作和外部聯結器訪問。
設計意圖
程式碼庫裡反覆出現的架構選擇有：
- 持久知識保持基於檔案的儲存
- 會話和任務作為明確的產品物件
- 執行時相關行為隔離在穩定抽象之後
- 透過 MCP 工具暴露結構化專案上下文
- 保留使用者對專案知識的本地所有權
為什麼這種形態有效
MindMux 需要同時處理：
- 桌面檔案系統訪問
- 長期本地狀態
- 模型執行
- 顯式知識結構
- 人工確認檢查點
這套架構能同時滿足這五點，而不必將它們合併成一個不透明的單體程序。
產品層面的結果
這種架構讓應用可以沿兩個維度獨立演進：
- 知識模型可以持續加深，而不必重寫執行時整合
- 執行時整合可以變化，而不破壞專案大腦