> 开发分支文档 — commit c5a119d39ba4c149dc90ed5711c4e76759080b41
> 包版本: @zenfg/webgpu 0.2.0, @zenfg/snapshot 0.1.1, @zenfg/inspector 0.2.0, zenfg 0.2.0, zenfg-snapshot 0.1.1
> Source: https://github.com/uinosoft/zenfg/blob/c5a119d39ba4c149dc90ed5711c4e76759080b41/crates/zenfg/README.md
> Translation: https://github.com/uinosoft/zenfg/blob/c5a119d39ba4c149dc90ed5711c4e76759080b41/crates/zenfg/README.zh-CN.md

# zenfg

<!-- usage-source: docs/README.md -->

`zenfg` 是适用于 wgpu、与渲染器无关的 FrameGraph 编译器和瞬态资源执行器。它会记录逻辑资源及其访问、校验内容流、构建依赖、裁剪无用工作、推导使用标志、规划瞬态资源别名，并可选择在调用方拥有的设备和队列上实例化保留的工作。

<a id="installation"></a>

## 安装

<!-- generated:installation:start -->
```sh
cargo add zenfg@=0.2.0
```
<!-- generated:installation:end -->

<a id="quick-start"></a>

## 快速入门

导入方式、调用方提供的输入及执行生命周期见[完整快速入门](/zenfg/docs/zh-CN/guides/zenfg.md#quick-start)。

<a id="guides"></a>

## 指南

<!-- generated:usage:start -->
<a id="features"></a>

- [功能特性](/zenfg/docs/zh-CN/guides/zenfg.md#features)

<a id="lifecycle"></a>

- [生命周期](/zenfg/docs/zh-CN/guides/zenfg.md#lifecycle)

<a id="diagnostic-grouping"></a>

- [诊断分组](/zenfg/docs/zh-CN/guides/zenfg.md#diagnostic-grouping)

<a id="bloom-grouping-adapter"></a>

- [Bloom 分组适配器](/zenfg/docs/zh-CN/guides/zenfg.md#bloom-grouping-adapter)

<a id="validation-boundary"></a>

- [校验边界](/zenfg/docs/zh-CN/guides/zenfg.md#validation-boundary)

<a id="common-tasks"></a>

- [常见任务](/zenfg/docs/zh-CN/guides/zenfg.md#common-tasks)

<a id="key-pattern-bind-and-resolve-typed-access"></a>

- [关键模式：绑定并解析类型化访问](/zenfg/docs/zh-CN/guides/zenfg.md#key-pattern-bind-and-resolve-typed-access)

<a id="resource-and-integration-choices"></a>

- [资源与集成方式](/zenfg/docs/zh-CN/guides/zenfg.md#resource-and-integration-choices)

<a id="common-mistakes"></a>

- [常见错误](/zenfg/docs/zh-CN/guides/zenfg.md#common-mistakes)

<a id="complete-examples"></a>

- [完整示例](/zenfg/docs/zh-CN/guides/zenfg.md#complete-examples)

<a id="resource-pool-maintenance"></a>

- [资源池维护](/zenfg/docs/zh-CN/guides/zenfg.md#resource-pool-maintenance)

<a id="further-reading"></a>

- [延伸阅读](/zenfg/docs/zh-CN/guides/zenfg.md#further-reading)

<a id="execution-timing"></a>

- [执行计时](/zenfg/docs/zh-CN/guides/zenfg.md#execution-timing)

<a id="usage-references"></a>

- [使用参考](/zenfg/docs/zh-CN/guides/zenfg.md#usage-references)
<!-- generated:usage:end -->

- [完整使用指南](/zenfg/docs/zh-CN/guides/zenfg.md)
- [所有权、内容与集成](/zenfg/docs/zh-CN/concepts/zenfg.md)
- [完整示例](https://github.com/uinosoft/zenfg/blob/c5a119d39ba4c149dc90ed5711c4e76759080b41/crates/zenfg/examples)
- [升级说明](/zenfg/docs/zh-CN/migration/zenfg.md)

<a id="documentation-and-versions"></a>

## 文档与版本

<!-- generated:documentation:start -->
包清单声明 **zenfg 0.2.0**. 注册表徽章显示当前发布渠道，并非已安装版本。

- 已安装版本的准确 API：阅读包内的 `src/`, 或运行 `cargo doc --open` （在使用该包的项目中）。
- [在线指南（开发分支）](/zenfg/docs/zh-CN/packages/zenfg.md). 网站可能包含晚于此包版本的变更。
- [此版本的 Rust API（英文）](https://docs.rs/zenfg/0.2.0/).
- [此发布版本的源码与文档](https://github.com/uinosoft/zenfg/tree/cargo/zenfg/v0.2.0/crates/zenfg).
- 使用约定由本包维护，请阅读包内指南。历史源码链接对应指定发布版本，可能早于当前开发分支。
- [包升级说明](/zenfg/docs/zh-CN/migration/zenfg.md).
- [纯 Markdown 文档索引（开发分支）](/zenfg/docs/zh-CN/llms.txt).
- 完整 Cargo 示例位于 `examples/`.
<!-- generated:documentation:end -->