MetaCore/docs/designs/metacore-m3-backlog.md

MetaCore M3 Backlog

生成时间：2026-04-04
状态：草案
范围：M3 Prefab 与 UI 基础
读者：架构、引擎、编辑器、渲染、工具链、测试

目的

这份文档把 M3 从“里程碑目标”进一步下钻为“可以直接开卡的 backlog”。

M3 的核心不是单独做 Prefab 或单独做 UI，而是建立两条新的应用制作链：

• 可复用对象模板链
• 基础应用界面链

也就是：

场景中的内容不再只能手工复制维护，应用界面不再只能靠硬编码或占位逻辑。

M3 成功定义

M3 完成时，MetaCore 至少应满足：

• 用户可以从对象树创建 Prefab，并实例化到 Scene
• Prefab 的基础 Apply / Revert 成立
• UI 文档成为正式资源
• 用户可以创建和编辑基础 UI
• Player 可以显示基础 UI
• Scene / 项目可以稳定引用 Prefab 和 UI 资源

---

M3-01 Prefab 资源模型正式化

背景

Prefab 相关结构已出现，但需要从“接口和测试存在”推进到“正式资源模型成立”。

目标

定义 Prefab 资源的正式数据模型和持久化边界。

交付结果

• Prefab 资源数据结构
• Prefab 与 Scene 实例关系定义
• Prefab 根对象和子树承载规则
• Prefab 元数据正式化

依赖

• M2 完成

建议 owner

• 引擎核心

验收标准

• Prefab 成为正式资源，而非临时编辑器结构
• Prefab 与 Scene 实例关系可序列化、可恢复

---

M3-02 从对象树创建 Prefab

背景

如果不能从现有 Scene 内容提取 Prefab，复用工作流无法开始。

目标

建立从对象树创建 Prefab 的工作流。

交付结果

• 从选中对象树创建 Prefab 的入口
• Prefab 资源生成
• Scene 对象与 Prefab 关系建立

依赖

• M3-01

建议 owner

• 编辑器与工作流
• 引擎核心配合

验收标准

• 用户可以从一棵对象树创建 Prefab
• 生成后的 Prefab 可在 Project 面板中看到
• Scene 中原对象关系明确

---

M3-03 Prefab 实例化工作流

背景

Prefab 只有资源，没有实例化，就没有复用价值。

目标

支持从 Prefab 资源创建 Scene 实例。

交付结果

• 从 Project 面板实例化 Prefab
• Prefab 实例对象树生成
• 实例与 Prefab 来源关系建立

依赖

• M3-01
• M3-02

建议 owner

• 编辑器与工作流
• 引擎核心配合

验收标准

• 用户可以把 Prefab 放入场景
• 多次实例化结果稳定
• 保存重开后实例仍可识别其 Prefab 来源

---

M3-04 Prefab Apply / Revert 第一版

背景

如果实例改动无法回收或回写，Prefab 只是复制模板，不是真复用系统。

目标

建立 Prefab 的基础 Apply / Revert 语义。

交付结果

• 实例修改记录的最小模型
• Apply 第一版
• Revert 第一版
• 基础冲突和不可回写情况的处理规则

依赖

• M3-03

建议 owner

• 引擎核心
• 编辑器与工作流配合

验收标准

• 用户可以对实例做基础修改并应用回 Prefab
• 用户可以将实例恢复到 Prefab 基线
• 保存重开后 Prefab 关系和基础修改状态不丢失

---

M3-05 Prefab 编辑器表达

背景

Prefab 需要在编辑器里被明确识别和管理。

目标

补齐 Project / Inspector / Scene 中的 Prefab 表达。

交付结果

• Project 面板识别 Prefab
• Inspector 显示 Prefab 来源和状态
• Scene 中实例操作规则清晰

依赖

• M3-03
• M3-04

建议 owner

• 编辑器与工作流

验收标准

• 用户能一眼识别哪些对象是 Prefab 实例
• 用户能看到 Prefab 来源和基本操作入口

---

M3-06 UiDocument 正式资源化

背景

当前 UI 更偏资源结构和测试原型，需推进到正式项目资源。

目标

把 UiDocument 做成正式一等资源。

交付结果

• UiDocument 资源结构收敛
• UI 资源保存/加载规则
• Project 面板识别 UI 资源

依赖

• M2 完成

建议 owner

• 引擎核心
• 编辑器与工作流配合

验收标准

• UI 文档成为正式资源，可在项目中创建和打开
• 保存和重开行为稳定

---

M3-07 UI 节点模型与基础控件

背景

没有正式节点模型和最小控件集，就谈不上 UI 工作流。

目标

收敛基础 UI 节点模型与控件集合。

交付结果

• Panel
• Text
• Image
• Button
• UI 节点层级关系
• 基础属性集

依赖

• M3-06

建议 owner

• 引擎核心
• 编辑器与工作流

验收标准

• 用户可以创建上述基础 UI 节点
• 节点层级与属性可被稳定保存和恢复

---

M3-08 UI 编辑器第一版

背景

只有数据结构，没有编辑器，就还不能算可用 UI 系统。

目标

做出 UI 编辑器第一版。

交付结果

• UI 层级树
• UI Inspector
• 创建节点
• 删除节点
• 调整基础布局与属性

依赖

• M3-06
• M3-07

建议 owner

• 编辑器与工作流

验收标准

• 用户可以不用手改文件创建和组织 UI
• UI 编辑器保存并重开后状态一致

---

M3-09 UI 运行时渲染第一版

背景

UI 如果只能在编辑器中编辑，不能在 Player 中显示，应用链路仍然不完整。

目标

实现 Player 中的基础 UI 显示能力。

交付结果

• UI 资源加载到 Player
• 基础控件显示
• 基础分辨率适配

依赖

• M3-07
• M3-08

建议 owner

• 渲染与资源表现
• 引擎核心配合

验收标准

• Player 能显示基础 UI
• 不同窗口尺寸下 UI 至少保持可用

---

M3-10 UI 与项目/Scene 引用关系

背景

UI 需要成为项目与场景的一部分，而不是孤立文档。

目标

定义 UI 资源与项目、Scene、运行时之间的引用关系。

交付结果

• 项目默认 UI 或启动 UI 规则
• Scene 或项目引用 UI 资源的规则
• 保存和重开时 UI 引用稳定

依赖

• M3-06
• M3-09

建议 owner

• 引擎核心

验收标准

• 项目或 Scene 可以稳定引用 UI 资源
• Player 启动时可加载默认 UI

---

M3-11 Prefab / UI 资源进入构建链

背景

Prefab 和 UI 如果不进入正式构建链，M4 之前就会积累隐患。

目标

让 Prefab 和 UI 资源成为正式构建输入。

交付结果

• Prefab 资源加载/落盘稳定
• UI 资源加载/落盘稳定
• 相关资源能进入后续打包链

依赖

• M3-03
• M3-06
• M3-09

建议 owner

• 工具链与构建发布
• 引擎核心配合

验收标准

• Prefab 和 UI 资源在编辑器和运行时之间语义一致
• 后续打包链可以把它们当作正式输入

---

M3-12 M3 回归测试矩阵

背景

Prefab 和 UI 都横跨资源、编辑器、运行时，没有测试会很快回归。

目标

建立 M3 的最小稳定验收矩阵。

交付结果

• Prefab 创建测试
• Prefab 实例化测试
• Prefab Apply / Revert 测试
• UI 文档保存/重开测试
• Player UI 显示测试
• 样板项目回归

依赖

• M3-01 到 M3-11

建议 owner

• 测试与验收
• 各模块 owner 联合

验收标准

• M3 主链均有回归覆盖
• 样板项目可以稳定验证 Prefab 和 UI 链路

---

建议优先级

P0

• M3-01 Prefab 资源模型正式化
• M3-02 从对象树创建 Prefab
• M3-03 Prefab 实例化工作流
• M3-04 Prefab Apply / Revert 第一版
• M3-06 UiDocument 正式资源化
• M3-07 UI 节点模型与基础控件
• M3-09 UI 运行时渲染第一版
• M3-10 UI 与项目/Scene 引用关系

P1

• M3-05 Prefab 编辑器表达
• M3-08 UI 编辑器第一版
• M3-11 Prefab / UI 资源进入构建链

P2

• M3-12 M3 回归测试矩阵

说明：

• M3-12 依赖前面链路收敛，不代表不重要
• 一旦 P0/P1 基本成立，应立刻补齐回归矩阵

推荐执行顺序

M3-01
  -> M3-02
    -> M3-03
      -> M3-04
        -> M3-05
          -> M3-06
            -> M3-07
              -> M3-08
                -> M3-09
                  -> M3-10
                    -> M3-11
                      -> M3-12

Prefab 与 UI 两条线可以部分并行：

• Prefab 主线：M3-01 -> M3-05
• UI 主线：M3-06 -> M3-10

但在 M3 结束前，应通过 M3-11 汇合到统一构建链中。

建议任务卡字段

后续如果转到看板，建议每个任务卡都带上：

• Milestone: M3
• Workstream: 引擎核心 / 编辑器与工作流 / 渲染与资源表现 / 工具链与构建发布 / 测试与验收
• Priority: P0/P1/P2
• Owner
• Depends On
• Definition of Done
• Validation

结论

M3 的本质不是单点增加 Prefab 或 UI，而是建立两条对应用制作非常关键的能力链：

• 内容复用链
• 界面制作链

只有这两条链成立，MetaCore 才开始从“能搭场景”进一步变成“能做应用”的引擎工具。