> 开发分支文档 — 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/packages/webgpu/README.md
> Translation: https://github.com/uinosoft/zenfg/blob/c5a119d39ba4c149dc90ed5711c4e76759080b41/packages/webgpu/README.zh-CN.md

# @zenfg/webgpu

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

`@zenfg/webgpu` 是一个轻量级 WebGPU FrameGraph，用于声明并执行逐帧 GPU 工作。它负责排列图节点、校验资源访问、裁剪未使用的工作、推导 WebGPU 使用标志、跟踪资源生命周期，并复用瞬态纹理和缓冲区。

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

## 安装

<!-- generated:installation:start -->
```sh
npm install @zenfg/webgpu@0.2.0
```
<!-- generated:installation:end -->

## Agent Skills

此开发版本随附英文 [zenfg-webgpu Skill](https://github.com/uinosoft/zenfg/blob/c5a119d39ba4c149dc90ed5711c4e76759080b41/packages/webgpu/skills/zenfg-webgpu/SKILL.md)，用于指导
WebGPU 集成、资源访问、诊断分组和帧捕获。
Skills 支持尚未发布：已发布的 0.2.0 包不包含此能力。
请使用明确随包提供 Skills 的发布版本，或从此分支构建的 tarball。

使用 pnpm 12.11.0 或更高版本（已验证 12.11.2），先将上述包安装为应用的直接依赖，然后运行：

```sh
pnpm approve
pnpm install
```

在交互提示中批准此包的 Skills；构建脚本权限单独控制。pnpm 会将已批准的 Skills
链接到受支持的项目代理目录。如果没有合适的目录，请在安装前配置 `skills.dirs`。
目录选择和批准细节见 [pnpm Agent Skills](https://pnpm.io/agent-skills)。
编程助手会读取链接的 Skill 及其引用的包内资料。

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

## 快速入门

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

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

## 指南

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

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

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

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

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

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

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

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

<a id="key-pattern-declare-list-and-unwrap-access"></a>

- [关键模式：声明、列出并解析访问令牌](/zenfg/docs/zh-CN/guides/webgpu.md#key-pattern-declare-list-and-unwrap-access)

<a id="native-render-pass-descriptor-extras"></a>

- [原生渲染通道描述符扩展](/zenfg/docs/zh-CN/guides/webgpu.md#native-render-pass-descriptor-extras)

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

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

<a id="error-handling"></a>

- [错误处理](/zenfg/docs/zh-CN/guides/webgpu.md#error-handling)

<a id="diagnostics-and-snapshot"></a>

- [诊断与 Snapshot](/zenfg/docs/zh-CN/guides/webgpu.md#diagnostics-and-snapshot)

<a id="download-a-snapshot-for-inspector"></a>

- [下载 Snapshot 并在 Inspector 中查看](/zenfg/docs/zh-CN/guides/webgpu.md#download-a-snapshot-for-inspector)

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

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

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

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

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

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

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

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

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

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

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

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

## 文档与版本

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

- 已安装版本的准确 API：查看 `package.json` → `exports` → `dist/*.d.ts`; 声明映射指向包内的 `src/`. 只有声明的导出路径属于公共 API。
- [在线指南（开发分支）](/zenfg/docs/zh-CN/packages/webgpu.md). 网站可能包含晚于此包版本的变更。
- [TypeScript API（开发分支，英文）](/zenfg/docs/api/webgpu/index.md).
- [此发布版本的源码与文档](https://github.com/uinosoft/zenfg/tree/npm/webgpu/v0.2.0/packages/webgpu).
- 使用约定由本包维护，请阅读包内指南。历史源码链接对应指定发布版本，可能早于当前开发分支。
- [包升级说明](/zenfg/docs/zh-CN/migration/webgpu.md).
- [纯 Markdown 文档索引（开发分支）](/zenfg/docs/zh-CN/llms.txt).
- 包内完整示例： [examples](/zenfg/docs/zh-CN/guides/examples.md).
<!-- generated:documentation:end -->