快速開始

這份指南介紹在本地執行 MindMux 桌面應用的最快路徑。

前置條件

• macOS（arm64 或 x64）
• 可選：本地已安裝 Claude Code 或 Codex CLI，以便使用內建執行時。

獲取應用

MindMux 目前處於內部測試階段。最省時的方式是下載預編譯版本：

1. 訪問 mindmuxai/mindmux GitHub Releases 頁面。
2. 下載最新版本的 .dmg 檔案。
3. 將 MindMux 拖到“應用程式”資料夾並開啟。

開啟第一個專案

MindMux 以本地專案目錄為單位組織工作。啟動後：

1. 選擇一個專案根目錄，或新建一個資料夾。
2. MindMux 會在該目錄下建立 brain/，並初始化專案所需的本地執行狀態。

啟動第一次會話

進入主介面後：

1. 在左側會話列表點選 新建會話。
2. 選擇一個執行時（Runtime）和專家（Expert）。
3. 輸入第一條訊息，例如：
   • “總結這個專案的當前架構和開放問題。”
   • “把今天的討論整理成 brain 頁面。”

MindMux 會自動把討論中已經想清楚的內容寫入 brain/pages/。

從討論建立任務

當討論收斂為可執行動作時：

1. 讓 agent 呼叫 create_task，或直接在聊天中要求建立任務。
2. 在彈出的 任務確認卡片 中選擇執行渠道和隔離方式。
3. 點選確認後，任務會進入右側任務面板，狀態從 dispatched 變為 running，最終到達 closed-success、closed-failed 或 closed-cancelled。

下一步

• 專案與工作區模型：理解專案知識與本地執行狀態的分工。
• 第一次會話：學習如何讓首次討論產生高價值產出。
• 從探索到 Brain：瞭解日常知識沉澱工作流。