文档

MindMux 概览

MindMux 是一个本地优先(local-first)的 AI 工作台,核心围绕“项目大脑”展开。产品和工程团队可以在这里讨论想法、提炼稳定的知识、把执行任务派发出去,同时保留推导出这些结论的推理过程。

和通用聊天客户端不同,MindMux 把对话当作入口,而不是终点。真正值得长期保留的资产是 brain/:结构化的 Markdown 文档、知识页面和执行上下文,它们可以跨会话、运行时和 agent 复用。

产品命题

MindMux 适合那些已经意识到“只靠聊天还不够”的团队。讨论当然重要,但想让项目真正持久,还需要:

  • 稳定的项目记忆
  • 明确的决策和理由
  • 可以跨会话复用的上下文
  • 从思考到执行的清晰交接

MindMux 围绕一个简单的循环设计:

  1. 讨论(Discuss)
  2. 提炼(Distill)
  3. 派发(Dispatch)

它有什么不同

它是项目大脑,不是聊天记录归档

MindMux 把持久上下文保存在本地 brain/ 目录里,而不是锁在某个供应商的聊天记录中。项目大脑包含:

  • 六份项目级根文档
  • 带有生命周期状态的结构化知识页面

会话可以恢复、分叉,也可以打开新主题

会话在 MindMux 里是一等公民。它可以被恢复、从某个节点分叉;当讨论出现独立新主题时,也可以由 agent 建议单独开一个新会话,同时仍然和同一个项目大脑保持关联。

知识可以跨运行时迁移

MindMux 把知识层和执行层拆开。Claude Code、Codex 等不同运行时都可以围绕同一个项目大脑工作,切换运行时时不必从头重建上下文。

执行交接足够轻量

MindMux 可以把已经收敛的讨论转成任务,并带上相关项目大脑上下文一起派发出去。任务系统是执行桥梁,不是项目管理套件。

核心构件

Project(项目)

用户工作的顶层单元。面向用户时优先使用 “project”(项目),虽然部分实现细节仍使用 workspace(工作区)。

Brain(项目大脑)

保存在文件中的持久知识层,是项目的长期记忆。

Session(会话)

一条带有运行时、专家角色、来源关系和消息历史的讨论线程。

Expert(专家角色)

应用内的讨论角色,用来塑造会话的思考方式和回应风格。

Runtime(运行时)和 Profile(模型配置)

决定会话或任务由哪套模型系统来执行的配置组合。

Task(任务)

当讨论收敛为可执行工作时,用来向外派发执行工作的单元。

这份文档会覆盖什么

  • 开始使用:安装、项目初始化和第一次高价值工作流。
  • 核心概念:数据模型和工作模型。
  • 工作流:团队如何日常使用 MindMux。
  • 架构:桌面应用、运行时边界、MCP 集成和存储模型。
  • 参考:具体文件结构和生命周期规则。