# MetaCore 设计文档索引

这份索引用于帮助快速找到第一阶段执行所需的核心文档。

## 当前主线

当前 MetaCore 的技术路线已经收敛为：

- 底层架构：`EnTT` ECS，外层提供 `GameObject + Component` 编辑器语义。
- 编辑器界面：`Dear ImGui`。
- 渲染核心：`Google Filament`，Panda3D 仅作为历史兼容或待清理上下文。
- 运行时 UI：`RmlUi`，定位类似 Unity UGUI。
- 模型导入：当前优先 `glTF / GLB / gltfio`。
- 资产策略：编辑期 JSON / 可读元数据，发布期 Cook / 二进制资产。
- 交付目标：编辑器面向 Windows、Linux、统信、麒麟；运行时面向 C/S，并为 B/S / WebGPU 预留。

建议先阅读：

- [metacore-current-architecture.md](D:/MetaCore/docs/designs/metacore-current-architecture.md)
- [metacore-product-plan.md](D:/MetaCore/docs/designs/metacore-product-plan.md)

## 推荐阅读顺序

1. 产品与范围
   - [metacore-current-architecture.md](D:/MetaCore/docs/designs/metacore-current-architecture.md)
   - [metacore-product-plan.md](D:/MetaCore/docs/designs/metacore-product-plan.md)
   - [metacore-phase1-scope.md](D:/MetaCore/docs/designs/metacore-phase1-scope.md)

2. 引擎能力与里程碑
   - [metacore-engine-feature-baseline.md](D:/MetaCore/docs/designs/metacore-engine-feature-baseline.md)
   - [metacore-phase1-roadmap.md](D:/MetaCore/docs/designs/metacore-phase1-roadmap.md)
   - [metacore-phase1-m1-m4-tasklist-and-acceptance.md](D:/MetaCore/docs/designs/metacore-phase1-m1-m4-tasklist-and-acceptance.md)
   - [metacore-phase1-m1-m4-workstreams.md](D:/MetaCore/docs/designs/metacore-phase1-m1-m4-workstreams.md)

3. 直接执行用文档
   - [metacore-m1-backlog.md](D:/MetaCore/docs/designs/metacore-m1-backlog.md)
   - [metacore-m1-p0-task-cards.md](D:/MetaCore/docs/designs/metacore-m1-p0-task-cards.md)
   - [metacore-m2-backlog.md](D:/MetaCore/docs/designs/metacore-m2-backlog.md)
   - [metacore-m3-backlog.md](D:/MetaCore/docs/designs/metacore-m3-backlog.md)
   - [metacore-m4-backlog.md](D:/MetaCore/docs/designs/metacore-m4-backlog.md)

## 当前执行建议

如果现在开始第一阶段开发，建议直接从下面两份文档开始：

- [metacore-phase1-roadmap.md](D:/MetaCore/docs/designs/metacore-phase1-roadmap.md)
- [metacore-m1-p0-task-cards.md](D:/MetaCore/docs/designs/metacore-m1-p0-task-cards.md)

对应执行顺序：

1. 先按 roadmap 对齐阶段目标
2. 再按 `M1 P0` 开任务卡
3. 先做项目路径、项目文件和 startup scene 主链

## 专项设计文档

- 资源与导入
  - [metacore-project-panel-asset-browser-design.md](D:/MetaCore/docs/designs/metacore-project-panel-asset-browser-design.md)
  - [metacore-gltf-glb-importer-design.md](D:/MetaCore/docs/designs/metacore-gltf-glb-importer-design.md)

- 材质与渲染
  - [metacore-material-render-pipeline-selection.md](D:/MetaCore/docs/designs/metacore-material-render-pipeline-selection.md)
  - [metacore-material-import-integration-design.md](D:/MetaCore/docs/designs/metacore-material-import-integration-design.md)
  - [metacore-material-meshrenderer-data-structure-design.md](D:/MetaCore/docs/designs/metacore-material-meshrenderer-data-structure-design.md)

- 场景与 UI
  - [metacore-scene-hierarchy-workflow-design.md](D:/MetaCore/docs/designs/metacore-scene-hierarchy-workflow-design.md)
  - [metacore-ui-workflow-design.md](D:/MetaCore/docs/designs/metacore-ui-workflow-design.md)

- 打包与运行时
  - [metacore-packaging-runtime-delivery-design.md](D:/MetaCore/docs/designs/metacore-packaging-runtime-delivery-design.md)

- RuntimeData
  - [metacore-runtime-data-access-design.md](D:/MetaCore/docs/designs/metacore-runtime-data-access-design.md)
  - [metacore-runtime-data-usage.md](D:/MetaCore/docs/designs/metacore-runtime-data-usage.md)