大腦結構

本頁總結 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 中存放的使用者可見專案名稱。這樣專案身份會隨專案大腦一起移動，而不是只存在於本地應用偏好設定中。