postfx-router

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Post-Processing Router

后期处理路由工具

Routes to 3 specialized skills based on post-processing requirements.

根据后期处理需求路由至3个专属技能模块。

Routing Protocol

路由规则

Classify — Identify effect type from user request
Match — Apply signal matching rules below
Combine — Most production scenes need 2-3 skills together
Load — Read matched SKILL.md files before implementation

分类 — 从用户需求中识别特效类型
匹配 — 应用以下信号匹配规则
组合 — 大多数生产场景需要同时使用2-3个技能模块
加载 — 在实现前读取匹配的SKILL.md文件

Quick Route

快速路由

Tier 1: Core (Start Here)

第一层：核心模块（从此开始）

Need	Skill	Signals
Pipeline setup, effect ordering	`postfx-composer`	EffectComposer, setup, pipeline, render target, custom pass, multi-pass
Glow, luminance effects	`postfx-bloom`	bloom, glow, neon, emissive, luminance, UnrealBloom, selective bloom
Cinematic polish, color	`postfx-effects`	vignette, chromatic, DOF, grain, color grade, LUT, aberration

需求	技能模块	关键词信号
管线配置、特效排序	`postfx-composer`	EffectComposer、setup、pipeline、render target、custom pass、multi-pass
发光、亮度特效	`postfx-bloom`	bloom、glow、neon、emissive、luminance、UnrealBloom、selective bloom
电影级润色、色彩调整	`postfx-effects`	vignette、chromatic、DOF、grain、color grade、LUT、aberration

Signal Matching

信号匹配

Primary Signals

核心信号

postfx-composer (always start here for new projects):

"set up post-processing"
"configure effect pipeline"
"create custom effect/pass"
"render targets", "effect ordering"

postfx-bloom:

"bloom", "glow", "luminance", "neon", "emissive"
"selective bloom", "object glow", "UnrealBloomPass"

postfx-effects:

"chromatic aberration", "vignette", "depth of field", "DOF"
"film grain", "noise", "color grading", "LUT", "tone mapping"
"scanlines", "CRT", "god rays"

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

"搭建后期处理"
"配置特效管线"
"创建自定义特效/通道"
"render targets"、"特效排序"

postfx-bloom：

"bloom"、"glow"、"luminance"、"neon"、"emissive"
"selective bloom"、"物体发光"、"UnrealBloomPass"

postfx-effects：

"chromatic aberration"、"vignette"、"depth of field"、"DOF"
"film grain"、"noise"、"color grading"、"LUT"、"tone mapping"
"scanlines"、"CRT"、"god rays"

Confidence Scoring

置信度评分

High (3+ signals) — Route directly to matched skill
Medium (1-2 signals) — Route with composer as foundation
Low (0 signals) — Start with
```
postfx-composer
```
for setup

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

Common Combinations

常见组合

Basic Post-Processing Setup (2 skills)

基础后期处理配置（2个技能）

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

postfx-composer → 管线架构、特效排序
postfx-bloom    → 基础发光特效

Cinematic Scene (3 skills)

电影级场景（3个技能）

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

postfx-composer → 管线配置、色调映射
postfx-bloom    → 灯光的柔和发光
postfx-effects  → 暗角、颗粒感、色彩分级

Neon/Cyberpunk Aesthetic (2 skills)

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

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

postfx-bloom    → 高强度选择性bloom
postfx-effects  → 色差、暗角

Custom Effect Development (1-2 skills)

自定义特效开发（1-2个技能）

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

postfx-composer → 自定义Effect类、着色器编写
postfx-effects  → 参考现有特效

Decision Table

决策表

Effect Type	Complexity	Primary Skill	Supporting Skill
Glow/bloom only	Simple	bloom	composer
Cinematic look	Medium	effects	composer + bloom
Custom effect	Complex	composer	-
Selective bloom	Medium	bloom	composer
Color grading	Simple	effects	composer
Full production	Complex	All three	-

特效类型	复杂度	核心技能	辅助技能
仅发光/bloom	简单	bloom	composer
电影级视觉	中等	effects	composer + bloom
自定义特效	复杂	composer	-
选择性bloom	中等	bloom	composer
色彩分级	简单	effects	composer
完整生产环境	复杂	全部三个	-

Effect Categories

特效分类

Lighting Effects → postfx-bloom

灯光特效 → postfx-bloom

Bloom/glow, selective bloom, emissive enhancement, HDR luminance

Bloom/发光、选择性bloom、自发光增强、HDR亮度

Camera Effects → postfx-effects

相机特效 → postfx-effects

Chromatic aberration, vignette, depth of field, lens distortion

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

Color Effects → postfx-effects

色彩特效 → postfx-effects

Tone mapping, color grading, LUT, hue/saturation

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

Texture Effects → postfx-effects

纹理特效 → postfx-effects

Film grain, noise, scanlines, CRT

胶片颗粒、噪点、扫描线、CRT效果

Architecture → postfx-composer

架构模块 → postfx-composer

EffectComposer setup, effect ordering, custom effects, render targets

EffectComposer配置、特效排序、自定义特效、render targets

Integration with Other Domains

与其他领域的集成

With R3F (r3f-*)

与R3F（r3f-*）集成

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

r3f-fundamentals → 场景搭建
postfx-composer  → 特效管线
postfx-bloom     → 物体发光

With Shaders (shaders-*)

与着色器（shaders-*）集成

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

shaders-glsl     → 自定义特效着色器代码
postfx-composer  → 封装为Effect类

With Particles (particles-*)

与粒子系统（particles-*）集成

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

particles-systems → 粒子发射器
postfx-bloom      → 粒子发光
postfx-effects    → 氛围效果

With Audio (audio-*)

与音频（audio-*）集成

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

audio-analysis    → 频率数据
postfx-bloom      → 音频响应式bloom
postfx-effects    → 音频响应式色差

Quick Reference

快速参考

Effect	Skill
Bloom	`postfx-bloom`
Selective Bloom	`postfx-bloom`
Vignette	`postfx-effects`
Chromatic Aberration	`postfx-effects`
Depth of Field	`postfx-effects`
Film Grain/Noise	`postfx-effects`
Color Grading	`postfx-effects`
LUT	`postfx-effects`
Tone Mapping	`postfx-effects`
Custom Effects	`postfx-composer`
Render Targets	`postfx-composer`

特效	技能模块
Bloom	`postfx-bloom`
选择性Bloom	`postfx-bloom`
暗角	`postfx-effects`
色差	`postfx-effects`
景深	`postfx-effects`
胶片颗粒/噪点	`postfx-effects`
色彩分级	`postfx-effects`
LUT	`postfx-effects`
色调映射	`postfx-effects`
自定义特效	`postfx-composer`
Render Targets	`postfx-composer`

Temporal Collapse Stack

时序折叠栈

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

postfx-composer → HDR管线、色调映射、自适应画质
postfx-bloom    → 数字元素、粒子、UI的宇宙风格发光
postfx-effects  → 暗角（边缘虚化）、轻微色差、颗粒感

Fallback Behavior

降级处理逻辑

No framework context → Assume @react-three/postprocessing
Unclear effect type → Start with
```
postfx-composer
```
+
```
postfx-bloom
```
Performance concerns → Prioritize
```
postfx-composer
```
optimization patterns

无框架上下文 → 默认为@react-three/postprocessing
特效类型不明确 → 从
```
postfx-composer
```
+
```
postfx-bloom
```
开始
性能顾虑 → 优先采用
```
postfx-composer
```
的优化方案