unity-urp

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

触发条件

• 配置 URP 资产
• 添加或编辑渲染器特性
• 调整 URP 渲染设置
• 配置 URP 资产、添加或编辑渲染器特性、调整 URP 渲染设置

URP 技能

适用于 Unity 2022.3+（URP 14 和 Unity 6 / URP 17）的 URP 专用资产和渲染器特性管理。

运行模式

• 查询技能（urp_get_info、urp_list_renderers、urp_list_renderer_features）属于 SkillMode.SemiAuto——在所有三种模式下均可运行，无需授权。
• 修改技能（urp_set_asset_settings、urp_add_renderer_feature、urp_set_renderer_feature_active）属于 SkillMode.FullAuto——在 Approval 模式下需要用户授权（授权会触发一次服务器端执行并返回结果）；在 Auto / Bypass 模式下会直接执行。
• urp_remove_renderer_feature 带有 SkillOperation.Delete，在 Approval / Auto 模式下会被自动禁止（NeverInSemi）。只有 Bypass 或由用户管理的 Allowlist 才能运行。

URP 包存根

此模块针对 com.unity.render-pipelines.universal（URP）编译。如果未安装 URP，所有技能都会返回存根 { error: "Universal Render Pipeline package … is not installed." }（RenderPipelineSkillsCommon.NoURP()）。该存根是诊断负载，而非权限拒绝——它不需要授权，也不会被视为 NeverInSemi。看到此错误时，请先调用 project_get_render_pipeline。

防护规则

不要：

• 使用此模块处理 ShaderGraph
• 假设任意自定义渲染器特性都可以安全实例化
• 假设 Unity 2022 和 Unity 6 提供相同的内置渲染器特性

运行时优先规则：

• 调用 urp_add_renderer_feature 前，始终先调用 urp_get_info
• 仅使用 urp_get_info.creatableRendererFeatures 返回的名称
• 不要将 RenderObjects、FullScreenPassRendererFeature、ScreenSpaceReflectionRendererFeature 等硬编码为普遍可用
• 调用 urp_set_renderer_feature_active 或 urp_remove_renderer_feature 前，使用 urp_list_renderer_features 确认现有特性的名称/索引

已验证的行为：

• Unity 2022.3 + URP 14 的实际环境可能提供较少的可创建特性，例如 DecalRendererFeature 和 ScreenSpaceAmbientOcclusion
• Unity 6 + URP 17 的实际环境可能提供更多特性

技能

urp_get_info

检查活动 URP 资产和渲染器布局。

urp_set_asset_settings

修改 HDR、MSAA、渲染比例、阴影和摄像机纹理等关键 URP 资产设置。

urp_list_renderers

列出活动 URP 资产上的渲染器数据资产。

urp_list_renderer_features

列出指定渲染器上的渲染器特性。

urp_add_renderer_feature

向渲染器添加安全的内置渲染器特性。

urp_remove_renderer_feature

从渲染器中移除渲染器特性。

urp_set_renderer_feature_active

启用或禁用渲染器特性。

---

精确签名

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