项目大脑

项目大脑是 MindMux 的核心。它既不是笔记本，也不是对话记录的归档，更不是向量数据库。它是项目持久化、结构化的记忆层。

一个更具体的心智模型

最简单的理解方式是：

• 根文档描述整个项目
• 页面记录具体且稳定的知识单元

在实践中，一个项目大脑经常长这样：

brain/
├── background.md
├── architecture.md
├── flow.md
├── mindmap.md
├── stack.md
├── roadmap.md
├── index.md
├── schema.md
├── mindmux.json
├── pages/
│   ├── runtime-profile-model.md
│   └── task-execution-model.md

项目大脑里有什么

项目大脑主要由两层组成：

• 根文档
• 页面

根文档

根文档是项目级别的固定输出，包括：

• background
• architecture
• flow
• mindmap
• stack
• roadmap

这些是项目的长期总览文档。它们会在原地更新，而不是衍生出多个版本。

每一份文档承担的角色不同：

• background：项目是什么、面向谁、为什么存在
• architecture：系统的主要结构
• flow：关键的端到端用户或系统流程
• mindmap：功能或能力地图
• stack：重要的技术选择和尚未敲定的决策
• roadmap：短中期方向

页面

页面是无上限扩展的结构化知识层。每一页通常代表一个独立实体，比如：

• 一个决策
• 一个概念
• 一条项目线索
• 一个人
• 一份参考资料

每个页面有两个关键部分：

• compiled_truth：整合后的事实，即当前最好的理解
• timeline：时间线，记录形成这个理解的证据和变更历史

这是 MindMux 最重要的设计之一：同时保留当前结论，以及通向该结论的路径。

所以一个页面同时回答两个问题：

• “我们当前相信什么？”
• “我们是怎么走到这里的？”

页面生命周期状态

每个页面还携带一个生命周期状态：

• draft（草稿）—— 仍在成形
• active（活跃）—— 当前项目知识
• archived（已归档）—— 不再活跃，但保留供历史追溯

普通读取和搜索默认只包含 active 页面，以保持工作上下文的聚焦。draft 和 archived 页面仍然保存在 brain/pages/ 中，可以在需要时显式调出。

沉淀路径

理想的知识流动通常是这样：

Chat discussion
  -> 页面
  -> 根文档更新

不是每条信息都必须经过每一层，但这个结构表达了从原始材料到项目事实的典型演进路径。新页面可以先以 draft（草稿）状态存在，成形后再转为 active（活跃）。

为什么使用 Markdown

MindMux 选择 Markdown 和简单元数据，是因为项目大脑需要保持：

• 可移植
• 可检查
• 可版本化
• 可脱离应用编辑

这是产品层面的选择，不只是存储实现细节。

项目大脑不是什么

项目大脑不应该变成：

• 什么都往里塞的临时堆放区
• 文件上传桶
• 源码控制的替代品
• 只有应用自己能读懂的黑盒 AI 记忆库

团队应该怎样理解它

最合适的心智模型是：

• 对话是思考发生的地方
• 项目大脑是稳定理解落地的地方

如果一段讨论以后要重建起来成本很高，那它很可能应该以某种形式进入项目大脑。