@zenfg/webgpu

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

安装

npm install @zenfg/webgpu@0.2.0

Agent Skills

此开发版本随附英文 zenfg-webgpu Skill，用于指导 WebGPU 集成、资源访问、诊断分组和帧捕获。 Skills 支持尚未发布：已发布的 0.2.0 包不包含此能力。 请使用明确随包提供 Skills 的发布版本，或从此分支构建的 tarball。

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

pnpm approve
pnpm install

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

快速入门

导入方式、调用方提供的输入及执行生命周期见完整快速入门。

指南

• 生命周期

• 诊断分组

• Bloom 分组适配器

• 常见任务

• 关键模式：声明、列出并解析访问令牌

• 原生渲染通道描述符扩展

• 资源与集成方式

• 错误处理

• 诊断与 Snapshot

• 下载 Snapshot 并在 Inspector 中查看

• 常见错误

• 完整示例

• 资源池维护

• 延伸阅读

• 使用参考

• 完整使用指南
• 所有权、内容与集成
• 完整示例
• 升级说明

文档与版本

包清单声明 @zenfg/webgpu 0.2.0. 注册表徽章显示当前发布渠道，并非已安装版本。

• 已安装版本的准确 API：查看 package.json → exports → dist/*.d.ts; 声明映射指向包内的 src/. 只有声明的导出路径属于公共 API。
• 在线指南（开发分支）. 网站可能包含晚于此包版本的变更。
• TypeScript API（开发分支，英文）.
• 此发布版本的源码与文档.
• 使用约定由本包维护，请阅读包内指南。历史源码链接对应指定发布版本，可能早于当前开发分支。
• 包升级说明.
• 纯 Markdown 文档索引（开发分支）.
• 包内完整示例： examples.