URP 下替换 Unity Terrain 内置草 / 树的绘制。包名 com.infinity.render-foliage（文件夹仍是 com.infinity.foliage）。
Agent 工作台见 AGENTS.md。交付与宿主验收见 Docs/DELIVERY.md。
- 在 Terrain 上挂
GrassComponent和 / 或TreeComponent，在 URP Renderer 中启用FoliageRenderer。 - 退出 Play，选中 Terrain 所在对象，从
GameObject / EntityAction / Landscape执行BuildTerrainGrass和BuildTerrainTree；Build 会继续执行对应 Update。更改 Terrain 密度或树实例后可执行UpdateTerrainGrass/UpdateTerrainTree，然后保存场景。 - 草的
numSection控制空间格（Build 菜单默认按 32 世界单位切）；树有自己的numSection（默认 16），不跟草走。 - 当前 Bake 将草写成每种草一份基础密度资产和
4×4细节页，将树候选流写成独立资产。旧 Scene、MeshAsset 和旧密度布局没有兼容路径，必须重新 Build/Update；Play 前确认流式资产已生成。 - Play 时默认最多驻留 2 个 Terrain；同一草 prefab 跨 Terrain 默认最多驻留 8 个细节页。基础层随 Terrain 驻留，细节页按可见性和距离加载。
GrassComponent.SetDensityScale或 Terrain 的detailObjectDensity可调整运行密度。组件会关掉 Terrain 内置草 / 树距离，停用后恢复。
URP Renderer 的 FoliageRenderer / Settings 给全场景提供默认值：草 / 树绘制隔离、treePreZ（默认开）、树 backend（Auto / CPU / GPU）、Terrain Occlusion 与 GPU HZB、LOD dither fade、淡化模式、过渡带宽度与迟滞、树主光投影、草 / 树绘制距离倍率，以及驻留 Terrain 数 / 每草种细节页数 / 页可见保留帧。每个视点先 Cull、再 Pack、再 Draw。treePreZ 开启时，Cull 与 Pack 在深度预通道完成，PreZ 只画带 clip 的子网格和正在淡化的桶，颜色通道复用同一份结果；关闭时这三步都在不透明通道完成。HZB 使用上一帧按相机保存的深度，视点不连续的那一帧不用。backend 默认 Auto：核心 Compute 可用时选 GPU，不可用时选 CPU。两种树遮挡默认开启，淡化模式为时间窗，过渡带宽度 0.2，迟滞 0.08，距离倍率 1，预算 2 / 8 / 12。预算可在 Play 调整；细节页预算设为 0 时草保留基础层。4×4 页格局与基础层 1/8 属于 Bake 格式，不能在运行时修改。时间窗在档位变化后共享一段 fadeDuration。距离互补按当前屏占比在过渡带里逐棵混合，相机停下混合就停下。
TreeComponent / Rendering Overrides 可为该 Terrain 单独覆盖 backend、遮挡、距离、LOD fade / 淡化模式 / 过渡带宽度 / 迟滞和主光投影。fadeDuration 只作用于时间窗，仍由组件决定。GrassComponent 可单独覆盖绘制距离，草密度仍读取 Terrain。距离未覆盖时使用进入 Play 前的 Terrain 距离乘 Renderer 倍率；退出 Play 会恢复 Terrain 原值。实时阴影的距离及级联继续在 URP Asset 设置，本包主光开关只控制树的投影。
选中组件并启用 showBounds 可看有真实深度遮挡的线框。草格红 / 绿只代表 CPU 视锥与距离；草页黄 / 绿表示仅基础层 / 有细节页驻留。CPU 树的实时线框只代表 CPU 阶段；GPU 实时线框不表示最终可见性。要判断 HZB 是否剔除了树，在 TreeComponent 指定 debugCamera（空值使用 Main Camera），点击 Capture Visibility Snapshot；冻结结果显示 backend、相机、帧号与最终 index 数，并按阶段给格和实例上色。可填写 debugTreeIndex 与 debugCandidateIndex 查看单个候选，随后点击 Clear Visibility Snapshot 恢复实时线框。该读回只在 Editor 按需执行。
距离模式的快照还列出最终 fade index／权重配对数与无效权重数；指定候选位于过渡带时显示该候选在两档中的权重。没有配对时，该机位可能没有树进入过渡带，需移动相机后重新捕获。
在 Renderer Settings 选择 Tree Backend；组件启用 Override Backend 可只改变该 Terrain。Inspector 显示请求值、实际 backend 和回退原因。CPU 使用 Burst 完成格 / 实例可见性、LOD 分桶与最终 compact；GPU 使用 Compute 完成同一工作，经 64 位 mask、计数、分层前缀扫描和 compact 输出最终 index / args。两者都使用现有 Indirect Draw，因此不能通过 Draw API 名称判断剔除发生在 CPU 还是 GPU。草继续 CPU 格剔除与页内连续 run。
Terrain Occlusion 在两条 backend 都可开启；GPU HZB 只对 GPU 生效。选择 CPU 时 HZB 控件禁用，但保存选择不会被清除。没有有效相机深度或当前投影不适合 HZB 时，GPU 继续基础可见性并显示原因，保守保留候选。强制 GPU 初始化失败时回退 CPU，仅状态变化时警告。视锥与距离剔除始终保留。
backend、淡化模式或 fade 开关改变后，下次视图更新重置该相机的目标状态，首帧硬切，避免播完旧状态或消费旧 args。Temporal 仍使用双视点、共享 alpha 与 fadeDuration；GPU 在自己的状态缓冲中闭合过渡。Distance 仍使用单视点过渡带，fade index 旁存同序权重。主光 CSM 跟随所选 backend，每相机 / 每级联独立生成结果，硬切并使用自己的迟滞；不读取颜色 HZB、颜色索引或距离权重。实时阴影距离及级联仍由 URP 设置。
该改动不改变 Bake 资产或矩阵布局，无需为切换 backend rebake。GPU 正常帧不读回结果；冻结诊断才读回。跨平台及实际验收状态以 交付记录 为准。