大脑结构

本页总结 MindMux 项目大脑的主要文件模型。

示例布局

brain/
├── background.md
├── architecture.md
├── flow.md
├── mindmap.md
├── stack.md
├── roadmap.md
├── index.md
├── schema.md
├── mindmux.json
└── pages/

根文档

每个项目大脑都有六份固定的根文档：

• background.md
• architecture.md
• flow.md
• mindmap.md
• stack.md
• roadmap.md

这些都是项目级文档，会被原地更新。

页面

页面存放在 brain/pages/ 下，数量不设上限。

每个页面通常包括：

• frontmatter 元数据
• compiled_truth 段落
• timeline 段落

一个典型页面大致会长这样：

---
id: runtime-profile-model
category: decision
status: active
tags: [runtime, profile]
title: Runtime and Profile Model
created: "2026-05-01"
updated: "2026-06-01T10:00:00Z"
---

## compiled_truth

Current best understanding.

## timeline

- time: 2026-06-01T10:00:00Z
  kind: decision
  summary: Adopted the current runtime/profile boundary.

页面元数据

比较重要的页面元数据字段如下：

• id
• title
• category
• status
• tags
• created
• updated

分类

主要的页面分类包括：

• project
• concept
• decision
• person
• reference

时间线语义

时间线原则上是只追加的。它记录理解如何随着以下内容演化：

• 决策
• 观察
• 来源材料
• 推翻

设计意图是：

• compiled_truth 可以被重写
• timeline 应该保留历史推理路径

页面生命周期状态

每个页面都有一个生命周期状态：draft（草稿）、active（活跃）或 archived（已归档）。

• draft — 仍在成形，尚未被视为项目事实。
• active — 当前的、可读取的项目知识。
• archived — 已被取代或不再相关，但保留供历史追溯。

如果页面文件省略了 status，为保持兼容会按 active 处理。普通读取默认只返回 active 页面；只有当用户明确要求时，工具才会扩大范围包含 draft 或 archived 页面。

交叉引用风格

知识模型使用 wiki 风格的页面引用来完成页面之间的交叉链接。

元数据文件

项目大脑也可以包含项目级元数据，例如 mindmux.json 中存放的用户可见项目名称。这样项目身份会随项目大脑一起移动，而不是只存在于本地应用偏好设置中。