用途：在 gitframes 项目中执行 WebGPU 后处理着色器，实现调色、电影质感、程序化 VFX 与设备端视觉。使用前需先完成 gitframes 安装、脚手架与首次渲染。
主要能力：效果为强类型 Effect 子类，参数支持静态值、关键帧、Signal 或音频提取。附着方式有四种：图层级 .withEffect()；整合成 comp.apply()；局部区域 comp.section/Layer.section；媒体链 Media 上 .apply() 后 renderFrame。效果分类包括：调色（Curves、ColorBalance、Levels、SelectiveColor、GradientMap、ShadowsHighlights、ApplyLUT、Modulate）；光学与胶片（FilmGrain、Vignette、Blur、UnsharpMask、HighPass、HalftoneScreen、TileOffset、MotionBlur、TemporalDeflicker）；3D 空间光照（Relight3D、SSAO、PBRGlass、DepthOfField）；遮罩抠像（ColorKey、Crop）。属性级目录见 references/effects-catalog.md。
设备端视觉：comp.withVision() 或 Layer.withVision()，模型首次使用时懒下载并缓存于 $GITFRAMES_MODELS_DIR，支持检测、分割、姿态、自拍抠像；variant 默认 "s"，confidence 默认 0.3，可用 classes 过滤。检测与分割共用一次推理。注意单帧延迟、按顺序渲染视觉帧、主体选择与实例合并规则。离线或 CI 可用 runner.preload 预下载。
用法示例片段：Layer.video("assets/footage.mp4").withEffect(new Curves(...))；const vision = comp.withVision({ enableDetection: true })；comp.addSubjectSandwich、addSmartFraming、addSubjectOutline、blurRegion、analyzeVisionSequence。
限制与建议：合成调色先于镜头光学、颗粒最外层；静态导出设 animated: false；自拍抠像仅适合近景；抽象画面宜提高 confidence。