快速开始

这份指南介绍在本地运行 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：了解日常知识沉淀工作流。