unity-postprocess

**调用此模块中的任何技能之前：**如果你正准备根据技能名称或描述猜测参数并调用技能，请停止——先阅读此文件（或通过 GET /skills/recommend?includeSchema=true 获取其架构）。如果你已从 recommend/schema 获得参数定义，则可直接执行 dryRun。

触发条件

• 设置后处理
• 向 VolumeProfile 添加效果
• 调整 URP/HDRP 场景观感
• 搭建后处理、向 VolumeProfile 添加效果、调整 URP/HDRP 场景观感

后处理技能

基于 SRP Volume 框架构建的现代 URP / HDRP 后处理技能。对于 Volume 容器 / 配置文件的 CRUD（volume_profile_create、volume_create 等），请使用 volume 模块。

运行模式

• 查询技能（postprocess_list_effects、postprocess_get_effect）属于 SkillMode.SemiAuto —— 在所有三种模式下都可运行，无需授权。
• 修改技能（postprocess_add_effect、postprocess_set_parameter、postprocess_set_bloom、postprocess_set_depth_of_field、postprocess_set_tonemapping、postprocess_set_vignette、postprocess_set_color_adjustments）属于 SkillMode.FullAuto —— 在 Approval 模式下需要用户授权（授权后会触发一次服务器端执行并返回结果）；在 Auto / Bypass 模式下则直接执行。
• postprocess_remove_effect 带有 SkillOperation.Delete 标记，在 Approval / Auto 模式下会被自动禁止（NeverInSemi）。只有 Bypass 模式或用户管理的 Allowlist 才能运行。

SRP 软件包占位实现

此模块针对 com.unity.render-pipelines.core（SRP_CORE）编译。如果未安装 URP 或 HDRP（即没有 SRP Core），所有技能都会返回占位结果 { error: "Scriptable Render Pipeline Core package … is not installed." }（RenderPipelineSkillsCommon.NoSRP()）。该占位结果是诊断信息，而非权限拒绝——不需要授权，也不会被视为 NeverInSemi。

防护规则

不要：

• 将此模块用于 PPv2 / com.unity.postprocessing
• 将此模块用于常规 Volume 容器 / 配置文件管理；请使用 volume

运行时优先规则：

• 在假定活动管线中存在某种效果之前，务必先调用 postprocess_list_effects
• 设置通用参数前，使用 postprocess_get_effect 或 volume_get_component 检查实际参数名称
• 优先使用专用的高频技能（postprocess_set_bloom、postprocess_set_depth_of_field 等），不要猜测通用参数名称
• 将 URP 和 HDRP 的参数范围视为相似但并不完全相同；不要不加判断地跨管线复用名称

技能

postprocess_list_effects

列出活动管线支持的现代 SRP 后处理效果。

postprocess_add_effect

向 VolumeProfile 添加后处理效果覆盖项。

postprocess_remove_effect

从 VolumeProfile 中移除后处理效果覆盖项。

postprocess_get_effect

检查后处理效果覆盖项。

postprocess_set_parameter

设置后处理效果覆盖项的一个参数。

postprocess_set_bloom

配置 Bloom。

postprocess_set_depth_of_field

配置景深。

postprocess_set_tonemapping

配置色调映射。

postprocess_set_vignette

配置暗角。

postprocess_set_color_adjustments

配置颜色调整。

---

精确签名

精确的名称、参数、默认值和返回值由 GET /skills/schema 或 unity_skills.get_skill_schema() 定义，而非此文件。