postfx-router

后期处理路由器

根据后期处理需求，路由到 3 种专用技能。

路由协议

1. 分类 — 根据用户请求识别效果类型
2. 匹配 — 应用以下信号匹配规则
3. 组合 — 大多数生产场景需要组合使用 2-3 种技能
4. 加载 — 实现前读取匹配到的 SKILL.md 文件

快速路由

第 1 层：核心技能（从这里开始）

需求	技能	信号
管线设置、效果排序	postfx-composer	EffectComposer、设置、管线、渲染目标、自定义通道、多通道
光晕、亮度效果	postfx-bloom	泛光、光晕、霓虹、发光、亮度、UnrealBloom、选择性泛光
电影质感润色、色彩	postfx-effects	暗角、色差、DOF、颗粒、颜色分级、LUT、像差

信号匹配

主要信号

postfx-composer（新项目始终从这里开始）：

• “设置后期处理”
• “配置效果管线”
• “创建自定义效果/通道”
• “渲染目标”、“效果排序”

postfx-bloom：

• “泛光”、“光晕”、“亮度”、“霓虹”、“发光”
• “选择性泛光”、“物体光晕”、“UnrealBloomPass”

postfx-effects：

• “色差”、“暗角”、“景深”、“DOF”
• “胶片颗粒”、“噪点”、“颜色分级”、“LUT”、“色调映射”
• “扫描线”、“CRT”、“上帝光”

置信度评分

• 高（3 个以上信号） — 直接路由到匹配的技能
• 中（1-2 个信号） — 以 composer 为基础进行路由
• 低（0 个信号） — 从 postfx-composer 开始设置

常见组合

基础后期处理设置（2 种技能）

postfx-composer → Pipeline architecture, effect ordering
postfx-bloom    → Basic glow effects

电影场景（3 种技能）

postfx-composer → Pipeline setup, tone mapping
postfx-bloom    → Subtle glow on lights
postfx-effects  → Vignette, grain, color grading

霓虹/赛博朋克风格（2 种技能）

postfx-bloom    → High-intensity selective bloom
postfx-effects  → Chromatic aberration, vignette

自定义效果开发（1-2 种技能）

postfx-composer → Custom Effect class, shader writing
postfx-effects  → Reference existing effects

决策表

效果类型	复杂度	主要技能	辅助技能
仅光晕/泛光	简单	bloom	composer
电影质感	中等	effects	composer + bloom
自定义效果	复杂	composer	-
选择性泛光	中等	bloom	composer
颜色分级	简单	effects	composer
完整生产流程	复杂	全部三种	-

效果类别

光照效果 → postfx-bloom

• 泛光/光晕、选择性泛光、增强发光效果、HDR 亮度

摄像机效果 → postfx-effects

• 色差、暗角、景深、镜头畸变

色彩效果 → postfx-effects

• 色调映射、颜色分级、LUT、色相/饱和度

纹理效果 → postfx-effects

• 胶片颗粒、噪点、扫描线、CRT

架构 → postfx-composer

• EffectComposer 设置、效果排序、自定义效果、渲染目标

与其他领域集成

与 R3F（r3f-*）集成

r3f-fundamentals → Scene setup
postfx-composer  → Effect pipeline
postfx-bloom     → Object glow

与着色器（shaders-*）集成

shaders-glsl     → Custom effect shader code
postfx-composer  → Wrap in Effect class

与粒子（particles-*）集成

particles-systems → Particle emitters
postfx-bloom      → Particle glow
postfx-effects    → Atmosphere

与音频（audio-*）集成

audio-analysis    → Frequency data
postfx-bloom      → Audio-reactive bloom
postfx-effects    → Audio-reactive aberration

快速参考

效果	技能
泛光	postfx-bloom
选择性泛光	postfx-bloom
暗角	postfx-effects
色差	postfx-effects
景深	postfx-effects
胶片颗粒/噪点	postfx-effects
颜色分级	postfx-effects
LUT	postfx-effects
色调映射	postfx-effects
自定义效果	postfx-composer
渲染目标	postfx-composer

时间坍缩栈

postfx-composer → HDR pipeline, tone mapping, adaptive quality
postfx-bloom    → Cosmic glow on digits, particles, UI
postfx-effects  → Vignette (void edge), subtle chromatic, grain

回退行为

• 没有框架上下文 → 假定使用 @react-three/postprocessing
• 效果类型不明确 → 从 postfx-composer + postfx-bloom 开始
• 性能方面的顾虑 → 优先采用 postfx-composer 优化模式