当前产品切片
今天这个库真正交付什么
- 1D / 2D 复数 FFT 与 IFFT，覆盖 WebGPU 主路径与 CPU 回退
- 1D / 2D 实值 FFT API，明确采用 half-spectrum 契约
- CPU-only 的频谱分析与频域图像滤波工具
- TypeScript 优先的导出表面和轻量包体
Skip to content
浏览器 FFT 技术白皮书
把 WebGPU FFT 核心项目，像架构 dossier 一样讲清楚。
这里不是 README 的放大版，而是 gpu-fft 的公开导读前台：它说明项目真正提供什么、边界停在哪里、WebGPU 与 CPU 各自负责什么，以及如何用架构页、证据页和参考页去核对这些说法。
GPU FFT 核心、CPU-only 分析工具、显式 real-input 契约、零运行时依赖，这些边界会在整站持续保持一致。
能力矩阵
把 GPU 主路径和 CPU-only utility 分开看
| 表面 | GPU | CPU | 说明 |
|---|---|---|---|
| 1D FFT / IFFT | 原生 | 回退 | 复数 interleaved 输入 |
| 1D RFFT / IRFFT | 包装实现 | 原生 | half-spectrum 契约 |
| 2D FFT / IFFT | 原生 | 回退 | row-column decomposition |
| Spectrum analyzer | — | CPU-only | 建立在窗口函数与 CPU FFT 上 |
| Image filter | — | CPU-only | 频域工具，不是 GPU shader pipeline |
按层阅读项目
指南
先看适配边界，再决定要不要继续。
这条路径最适合面试官、评估者和第一次接触仓库的读者。
打开指南导读
把页面当作课程大纲来读。
为评估、学习和贡献分别准备不同的阅读顺序。
打开阅读地图架构
看公开 API 如何落到 GPU pass。
重点理解 execution planner、WGSL pass 和 CPU-only utility 的边界。
打开架构页证据
把 benchmark 和 ADR 当证据而不是宣传。
所有性能与设计说法都应该能回到实测或决策记录。
打开证据页参考
把项目放回 FFT 研究和工程生态里看。
论文、相关实现和学习资源会告诉你这个项目刻意做窄在哪里。
打开参考中心系统读图
系统地图
从公开 API 到 GPU pass 的阅读顺序
这个项目的核心是一条很窄但很清楚的执行链：公开 API 暴露 FFT 契约，执行层负责 plan 与资源，GPU pass 负责核心蝶形变换，应用级工具仍停留在 CPU。
Layer 01
Public surface
createFFTEngine()、real-input FFT API、CPU shortcuts 和 utilities 构成公开入口。
Layer 02
Execution planner
FFTEngine 负责尺寸校验、execution plan cache、buffer 生命周期与 dispatch 顺序。
Layer 03
GPU compute passes
bit reversal、butterfly、scale 等 WGSL compute pass 组成 GPU FFT 主路径。
Layer 04
CPU-only utilities
频谱分析和图像滤波建立在 CPU FFT 与窗口函数之上，不冒充 GPU-native 功能。
BoundaryGPU core 与 CPU utility 必须在所有公开文案中明确区分。
Reading tip先读 capability boundary，再读 pipeline，会更容易理解 2D 与 real-input API 的位置。
为什么首页要这么“较真”
这页真正优化什么
理解速度、表述可信度、以及后续维护成本。
这个站点的目的不是把项目包装得更大，而是让技术读者在最短时间内理解真实切片，随后能把注意力花在“为什么这样设计”而不是“到底支持什么”上。
不要误读的地方
这不是一个“大而全”的 DSP 工具箱。
- 它不会把 CPU-only 的分析工具包装成 GPU-native 功能。
- 它不会对任意大小 FFT 给出未实现的承诺。
- 它不会在没有 benchmark 证据时发布夸张性能口径。
继续阅读的正确入口
| 如果你要解决的是 | 从这里开始 |
|---|---|
| 快速技术评估 | 起步导读 |
| 面试 / 代码审查阅读顺序 | 阅读地图 |
| 看执行模型和能力边界 | 架构总览 |
| 看实测和证据 | 性能基准 |
| 看论文和生态脉络 | 参考中心 |