Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(rearch): mark B2b PostProcess landed

esengine8c1bebb92be3
diff --git a/docs/REARCH_FOUNDATION_CONSOLIDATION.md b/docs/REARCH_FOUNDATION_CONSOLIDATION.md
index c4292579a..2c8c485c4 100644
--- a/docs/REARCH_FOUNDATION_CONSOLIDATION.md
+++ b/docs/REARCH_FOUNDATION_CONSOLIDATION.md
@@ -90,9 +90,9 @@ RC1–RC5 坍缩了五个正确性根因,但留下四处"半成品 / 未统一
**批次顺序(每批独立验证、保持常绿)**:
1. **B1 Camera** — ✅ 已落地(`95f74041`):`CameraView` 资源 + per-App scratch 池。
2. **B2a Timeline** — ✅ 已落地(`06e0268e`):`Timeline` 资源,消除全局 handles 串味。
-3. **B2b PostProcess** — 🟡 设计已定(见下)。
-4. **B3 SpriteAnimator**(含 LoadContext 改造:clip 注册按 app 路由)。
-5. **B4 模块绑定单例**——仅当"多 App 独立模块"成立(见子岔路);否则降级为 teardown 重置。
+3. **B2b PostProcess** — ✅ 已落地(`1e27c712`/`a1f421b0`/`90b8cfdc`/`60937741`):拆 god-object(Stack 数据 / Api 类 / effects 工厂)→ per-App `defineResource` + **管线依赖注入**(后处理成为可插拔渲染阶段,pipeline 不再硬依赖全局)+ 删 `sync.ts` 重复路径。两个 App 后处理状态完全隔离。
+4. **B3 SpriteAnimator** — ⏳(含 LoadContext 改造:clip 注册按 app 路由)。
+5. **B4 模块绑定单例** — ⏳ 仅当"多 App 独立模块"成立(见子岔路);否则降级为 teardown 重置。
### B2b PostProcess —— 拆 god-object,后处理成为可插拔渲染阶段
**病灶**:`PostProcess`(`postprocess/PostProcessAPI.ts`)是四合一全局单例——混 ① wasm 调用 ② 状态(`stacks`/`cameraBindings`/`screenStack`)③ 着色器工厂 ④ 管线编排(`_applyForCamera`/`_applyScreenStack` 等)。叠加三处结构病:`renderPipeline.ts:9` 反向 `import` 全局并在热路径调 `PostProcess._*`(管线硬依赖全局);状态散落 4+ 份全局(`activeRegistry`、`screenStack`、`sync.ts` 与 `volumeSystem.ts` 各一套 `volumeStacks/volumeShaders`);`PostProcessStack` 构造即自注册全局 `activeRegistry`(`:56`)。`sync.ts` 与 `volumeSystem.ts` 是两套重复的 volume→stack。