MobileGL/docs/Disaggregated/README.md

MGPipe：MobileGL 前后端拆分

做什么：在 MobileGL 的前端（处理应用的 GL 调用）和后端（调用 GLES / Vulkan 驱动）之间立一份显式接口——前端把状态变化推给后端，后端不再直接读前端的内存。有了这份接口，前后端可以放在两个线程、两个进程，甚至两台机器上运行。

做到哪了：见 CURRENT_STAGE_PROGRESS.md。当前阶段与下一步只在那一页维护，这里不再复述。

一张图

应用的 GL 调用
  → 前端 MG_Impl：处理 GL 语义；在每条"做事的命令"（draw、clear…）之前，把状态变化整理成记录
  → MGPipe 接口（两张函数指针表，由调用目录 PipeCalls.def 生成）
  → 三选一：直接调用（单线程）│ 队列 → 另一个线程 │ 队列 → 另一个进程 / 另一台机器
  → 后端 MG_Backend：Espryt（GLES）/ Magma（Vulkan），按记录更新自己的状态并调用驱动
  ← 反向消息（错误、GPU 写回、窗口尺寸）按顺序回到前端

文档导航

想知道	看
现在做到哪、下一步	CURRENT_STAGE_PROGRESS.md
设计要点与各部分设计	ARCHITECTURE.md → design/
分几个阶段、每个阶段做了什么	ROADMAP.md
性能与验证的关键数字	MEASUREMENTS.md
怎么构建、运行、测试	guide/build-and-run.md
代码在哪 / 术语 / 工程纪律	guide/code-map.md、guide/glossary.md、guide/discipline.md

整理记录：2026-09-24 两次整理——顶层只留索引，设计正文拆到 design/，上手与参考放 guide/，阶段细节放 notes/<阶段>/（这些笔记已从树中删除，见 git 历史）；整理前的版本见提交 1fb18d9。更早的设计竞赛与评审稿在 git 历史（8b31de2f、1794ac94、8349babe、87ee17c6）。