396 lines
6.8 KiB
Markdown
396 lines
6.8 KiB
Markdown
# MetaCore M1 P0 任务卡清单
|
||
|
||
生成时间：2026-04-04
|
||
状态：草案
|
||
范围：M1 P0 执行卡片
|
||
读者：项目负责人、架构、引擎、编辑器、工具链、测试
|
||
|
||
## 目的
|
||
|
||
这份文档把 [metacore-m1-backlog.md](D:/MetaCore/docs/designs/metacore-m1-backlog.md) 中的 `M1 P0` 项，整理成可以直接复制到项目管理工具中的任务卡格式。
|
||
|
||
使用建议：
|
||
|
||
- 一张卡对应一个执行 owner
|
||
- 每张卡进入开发前先补 owner 和计划时间
|
||
- 每张卡进入 `Ready for QA` 前，先自检 `Definition of Done`
|
||
|
||
## 建议看板状态
|
||
|
||
- `Not Started`
|
||
- `In Design`
|
||
- `In Progress`
|
||
- `Blocked`
|
||
- `Ready for QA`
|
||
- `Accepted`
|
||
|
||
## 建议字段
|
||
|
||
- `Title`
|
||
- `Milestone`
|
||
- `Priority`
|
||
- `Workstream`
|
||
- `Owner`
|
||
- `Depends On`
|
||
- `Description`
|
||
- `Definition of Done`
|
||
- `Validation`
|
||
|
||
---
|
||
|
||
## 卡片 1
|
||
|
||
### Title
|
||
|
||
`M1-01 统一项目根目录解析`
|
||
|
||
### Milestone
|
||
|
||
`M1`
|
||
|
||
### Priority
|
||
|
||
`P0`
|
||
|
||
### Workstream
|
||
|
||
`引擎核心`
|
||
|
||
### Depends On
|
||
|
||
- 无
|
||
|
||
### Description
|
||
|
||
抽出统一的项目根目录解析入口，统一 Editor、Player、Tool 对项目路径的识别规则，消除当前分散 fallback 和相对路径偶然成功的问题。
|
||
|
||
### Definition of Done
|
||
|
||
- 存在统一的公共项目解析入口
|
||
- Editor / Player / Tool 使用同一套项目根解析规则
|
||
- 命令行传项目路径的优先级清晰
|
||
- 不再依赖临时相对路径 fallback 才能运行样板项目
|
||
|
||
### Validation
|
||
|
||
- 从不同当前工作目录启动 Editor 和 Player，解析到同一项目
|
||
- 传命令行项目路径和不传路径时，行为符合预期
|
||
- 样板项目不依赖“碰巧的路径”运行
|
||
|
||
---
|
||
|
||
## 卡片 2
|
||
|
||
### Title
|
||
|
||
`M1-02 统一项目描述文件模型`
|
||
|
||
### Milestone
|
||
|
||
`M1`
|
||
|
||
### Priority
|
||
|
||
`P0`
|
||
|
||
### Workstream
|
||
|
||
`引擎核心`
|
||
|
||
### Depends On
|
||
|
||
- `M1-01`
|
||
|
||
### Description
|
||
|
||
统一 `MetaCore.project.json` 的正式字段模型、读写入口和错误处理规则，避免项目描述语义继续分散。
|
||
|
||
### Definition of Done
|
||
|
||
- 项目描述文件有正式最小字段集合
|
||
- 有统一的读写实现
|
||
- 缺字段和损坏文件的行为明确
|
||
- 保存后重新读取结果一致
|
||
|
||
### Validation
|
||
|
||
- 正常项目文件可稳定读写
|
||
- 缺字段项目文件行为一致
|
||
- 损坏项目文件时有明确错误
|
||
|
||
---
|
||
|
||
## 卡片 3
|
||
|
||
### Title
|
||
|
||
`M1-05 startup scene 规则统一`
|
||
|
||
### Milestone
|
||
|
||
`M1`
|
||
|
||
### Priority
|
||
|
||
`P0`
|
||
|
||
### Workstream
|
||
|
||
`引擎核心`
|
||
|
||
### Depends On
|
||
|
||
- `M1-02`
|
||
|
||
### Description
|
||
|
||
统一 startup scene 在 Editor 和 Player 中的定位、设置、读取和异常处理规则。
|
||
|
||
### Definition of Done
|
||
|
||
- startup scene 读取规则统一
|
||
- startup scene 设置规则统一
|
||
- 缺失或损坏时有明确降级行为
|
||
- 修改 startup scene 后项目描述同步正确
|
||
|
||
### Validation
|
||
|
||
- 同一项目在 Editor / Player 中加载同一 startup scene
|
||
- startup scene 缺失时有明确日志
|
||
- 修改 startup scene 后重开项目结果一致
|
||
|
||
---
|
||
|
||
## 卡片 4
|
||
|
||
### Title
|
||
|
||
`M1-06 Asset Database 初始化主干`
|
||
|
||
### Milestone
|
||
|
||
`M1`
|
||
|
||
### Priority
|
||
|
||
`P0`
|
||
|
||
### Workstream
|
||
|
||
`引擎核心`
|
||
|
||
### Depends On
|
||
|
||
- `M1-01`
|
||
- `M1-02`
|
||
|
||
### Description
|
||
|
||
建立项目打开后的 Asset Database 初始化、扫描、记录加载与查询主流程。
|
||
|
||
### Definition of Done
|
||
|
||
- 打开项目后 Asset Database 稳定初始化
|
||
- 已存在资源能被识别
|
||
- 资源记录处于稳定可查询状态
|
||
- 多次打开同一项目结果一致
|
||
|
||
### Validation
|
||
|
||
- 打开样板项目后资源记录可查询
|
||
- 多次重复打开结果一致
|
||
- 初始化失败时有明确错误信息
|
||
|
||
---
|
||
|
||
## 卡片 5
|
||
|
||
### Title
|
||
|
||
`M1-07 meta / GUID / package 记录统一`
|
||
|
||
### Milestone
|
||
|
||
`M1`
|
||
|
||
### Priority
|
||
|
||
`P0`
|
||
|
||
### Workstream
|
||
|
||
`引擎核心 + 工具链与构建发布`
|
||
|
||
### Depends On
|
||
|
||
- `M1-06`
|
||
|
||
### Description
|
||
|
||
统一资源身份、GUID、`.mcmeta` 和 package 的基础规则，让资源进入项目后的元数据可追踪、可复现。
|
||
|
||
### Definition of Done
|
||
|
||
- GUID 生成和持久化规则明确
|
||
- `.mcmeta` 最小结构明确
|
||
- package 与资源记录关系一致
|
||
- 同一资源在重复打开项目后 GUID 保持稳定
|
||
|
||
### Validation
|
||
|
||
- 导入同一资源后再次打开项目，GUID 不变化
|
||
- meta 缺失或损坏时行为明确
|
||
- 资源记录能追溯到 package 和 meta
|
||
|
||
---
|
||
|
||
## 卡片 6
|
||
|
||
### Title
|
||
|
||
`M1-09 Project 面板第一版`
|
||
|
||
### Milestone
|
||
|
||
`M1`
|
||
|
||
### Priority
|
||
|
||
`P0`
|
||
|
||
### Workstream
|
||
|
||
`编辑器与工作流`
|
||
|
||
### Depends On
|
||
|
||
- `M1-06`
|
||
- `M1-07`
|
||
|
||
### Description
|
||
|
||
实现可用的 Project 面板第一版，让用户能够看到项目目录、资源列表和资源类型，并与 Inspector 联动。
|
||
|
||
### Definition of Done
|
||
|
||
- Project 面板能显示项目目录树
|
||
- 能显示资源列表和基础类型信息
|
||
- 资源选择与 Inspector 或详情区联动
|
||
- 新资源进入项目后能在面板中找到
|
||
|
||
### Validation
|
||
|
||
- 打开样板项目后可浏览资源结构
|
||
- 新资源进入项目后可立即定位
|
||
- 切换资源时联动信息正确
|
||
|
||
---
|
||
|
||
## 卡片 7
|
||
|
||
### Title
|
||
|
||
`M1-12 建立 M1 回归测试矩阵`
|
||
|
||
### Milestone
|
||
|
||
`M1`
|
||
|
||
### Priority
|
||
|
||
`P0-收尾`
|
||
|
||
### Workstream
|
||
|
||
`测试与验收`
|
||
|
||
### Depends On
|
||
|
||
- `M1-01`
|
||
- `M1-02`
|
||
- `M1-05`
|
||
- `M1-06`
|
||
- `M1-07`
|
||
- `M1-09`
|
||
|
||
### Description
|
||
|
||
建立覆盖 M1 主链的最小回归矩阵，保证后续 M2-M4 不会轻易破坏项目与资源主干。
|
||
|
||
### Definition of Done
|
||
|
||
- 项目创建/打开或打开现有项目测试存在
|
||
- 项目描述文件读写测试存在
|
||
- startup scene 测试存在
|
||
- Asset Database 初始化/刷新测试存在
|
||
- 样板项目回归步骤固定
|
||
|
||
### Validation
|
||
|
||
- M1 主链有自动化或半自动回归覆盖
|
||
- 后续修改后可以快速回归判断是否破坏 M1
|
||
|
||
---
|
||
|
||
## 建议第一批开工顺序
|
||
|
||
```text
|
||
卡片 1 -> 卡片 2 -> 卡片 3 -> 卡片 4 -> 卡片 5 -> 卡片 6 -> 卡片 7
|
||
```
|
||
|
||
## 建议并行策略
|
||
|
||
### 第一组
|
||
|
||
- 卡片 1
|
||
- 卡片 2
|
||
|
||
说明：
|
||
|
||
- 这两张卡决定项目语义主干，必须最先完成
|
||
|
||
### 第二组
|
||
|
||
- 卡片 3
|
||
- 卡片 4
|
||
|
||
说明：
|
||
|
||
- startup scene 和 Asset Database 可以在项目模型基本稳定后并行推进
|
||
|
||
### 第三组
|
||
|
||
- 卡片 5
|
||
- 卡片 6
|
||
|
||
说明：
|
||
|
||
- meta/GUID/package 与 Project 面板可以并行，但卡片 6 要依赖卡片 4 的稳定数据来源
|
||
|
||
### 第四组
|
||
|
||
- 卡片 7
|
||
|
||
说明：
|
||
|
||
- 当前面主链收敛后，立刻补测试矩阵，不要拖到 M2 中后期
|
||
|
||
## 建议首周目标
|
||
|
||
如果现在立刻进入执行，建议首周目标不是“完成整个 M1”，而是完成下面这一小段：
|
||
|
||
- 卡片 1：统一项目根目录解析
|
||
- 卡片 2：统一项目描述文件模型
|
||
- 卡片 3：startup scene 规则统一
|
||
|
||
原因：
|
||
|
||
- 这三张卡决定整个后续 M1-M4 的项目语义是否稳定
|
||
- 如果这层不稳，后面所有资源、导入、打包都容易建立在脆弱假设上
|
||
|
||
## 结论
|
||
|
||
M1 P0 的正确执行方式，不是同时开很多卡，而是先把项目语义、资源语义和编辑器可见性主链做稳。
|
||
|
||
因此建议现在就以本文件为基础，把卡片 1 到卡片 3 先进入正式开发，把卡片 4 到卡片 7 放入紧随其后的短周期执行队列。
|