文件
架構

執行時與 MCP 架構

MindMux 透過執行時層和 MCP 工具層,把模型執行與專案知識分開。

執行時抽象

執行時抽象讓不同執行後端可以驅動同一個產品介面。對話會話和任務都依賴這層抽象。

它的主要目標是:

  • 執行時可移植性
  • 不同後端上的共享產品行為
  • 更清晰的產品邏輯與供應商特定執行之間的邊界

當前支援的執行時

當前產品方向是讓多個執行時共同作用於同一個知識模型。當前文件覆蓋的可用執行時包括:

  • Claude Code
  • Codex

真正重要的架構點不是品牌列表,而是專案大腦不屬於其中任何一個執行時。

MCP 作為知識邊界

MindMux 透過 MCP 工具暴露結構化專案能力,而不是只依賴原始 prompt 上下文。

重要的工具家族包括:

  • 專案大腦讀寫工具
  • 根文件工具
  • 技能工具
  • 任務工具
  • 配置工具

典型請求路徑

對話作用域和任務作用域

工具介面是被刻意限域的。有些工具對主對話 agent 開放,但不會直接開放給代理任務執行,尤其是那些涉及路徑解析、編排許可權或專案級寫入的能力。

例如更偏向對話作用域的行為有:

  • 專案級編排
  • 使用者互動卡片
  • 大範圍知識寫入

而更適合任務作用域的行為包括:

  • 聚焦的讀訪問
  • 受約束的審查或執行流程

獨立 MCP server 程序

程式碼庫使用的是一個獨立 MCP server 邊界,而不是把所有能力都封裝進同一個單體執行時迴圈。這樣能更嚴格地控制工具暴露範圍,也讓知識介面保持清晰。

外部聯結器和橋接

MindMux 本身也是一個 MCP client。這意味著產品既能:

  • 把自己的能力暴露給執行時
  • 把外部 MCP servers 當作聯結器來消費

當某個執行時不能直接消費某種傳輸形態時,架構裡還會透過一層橋接來把聯結器規範化成可用形式。

為什麼這很重要

這套架構讓 MindMux 擁有一份穩定的知識契約。執行時可以變化,但專案大腦及其操作方式仍然保持可讀和結構化。