# @fugood/node-whisper-wasm 中文文档

规范地址：https://npmcn.com/package/%40fugood/node-whisper-wasm/

版本：1\.2\.0-rc\.2
npm 元数据更新时间：2026-11-09T05:18:40.777Z
中文译文更新时间：2026-11-15T16:21:00.942Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fugood/node-whisper-wasm
原文对照：https://npmcn.com/package/%40fugood/node-whisper-wasm/?lang=original
项目主页：https://github.com/mybigday/whisper.node#readme
源码仓库：https://github.com/mybigday/whisper.node

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：9.7 MB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-06-02T04:22:37.246Z
- 最新版本发布：2026-11-09T05:18:40.577Z
- 近 30 天下载量：24227（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

浏览器 WASM 模块用于低语. node

## 安装

```sh
npm install @fugood/node-whisper-wasm
```

也可以使用：`pnpm add @fugood/node-whisper-wasm`、`yarn add @fugood/node-whisper-wasm`、`bun add @fugood/node-whisper-wasm`

## README

# @fugood/node-whiper-wasm (英语)

浏览器 WASM 执行软件包 `@fugood/whisper.node`应用 代码应导入 `@fugood/whisper.node`;这个包由主拖入 用于浏览器构建的软件包.

该软件包暴露了与原生软件包相同的高层次上下文 API (单位:千美元)`initWhisper`, (中文(简体) ), `initWhisperVad`,以及 `initParakeet`),但模型和音频文件 路径作为 URL 获取并复制到 Emscripten 文件系统之前 推论.

```js
import { initWhisper } from '@fugood/whisper.node'

const whisper = await initWhisper({
  filePath: 'https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin',
  useGpu: false,
})

const { promise } = whisper.transcribeFile('https://raw.githubusercontent.com/ggml-org/whisper.cpp/master/samples/jfk.wav', {
  language: 'en',
})

console.log(await promise)
await whisper.release()
```

包裹同时装有单行道和接线道WASM等文物. 打开 横跨原生页面 `SharedArrayBuffer`,装载器使用 线粒体文物; 否则它会掉回单线粒体文物 自动。 基于 Whisper 转录默认最多 8 个线程 可用线程时浏览器硬件货币; 通过 `maxThreads` 改为 超过它。 浏览器 WASM 夹 `maxThreads` 至汇编的集合限额为8, 或单行道倒置中取一. 浏览器页面运行模型加载, 默认情况下,在专门的模块工人中进行转录、基准和 VAD uI线程可以继续渲染. 使用主线 `whisper.node` 软件包条目 在浏览器代码中 :

```js
import { configureWasm, initWhisper } from '@fugood/whisper.node'
```

使用 `configureWasm({ worker: false })` 只有在你明确需要时 线上运行时间, `configureWasm({ threads: false })` 迫使 单行道文物,或通过 `workerPath`, (中文(简体) ), `jsPath`,以及 `wasmPath` 何时 服务自定义 URL 的软件包文件。 年长者 `workerUrl` 财务报告和审定财务报表 `runtimeScriptUrl` 选项名称仍然有效。 模式下载被缓存于 默认浏览器缓存存储 。 过 `cacheModel: false` 禁用持久性 缓冲, `modelCacheName` 以隔离缓存命名空间,或 `modelCacheKey` 当获取 URL 是一个代理或已签名的 URL , 但应该重新使用相同的缓存 型号。 设定 `useGpu: true` 仅使用软件包构建 `GGML_WEBGPU=ON` (单位:千美元) 显示的浏览器 `navigator.gpu`目前 VAD 返回到 CPU 浏览器软件包,因为Silero VAD图点击了不支持的WebGPU ops.

默认构建释放 `wasm/whisper-node.js`, (中文(简体) ), `wasm/whisper-node.wasm`, (中文(简体) ), `wasm/whisper-node.threads.js`,以及 `wasm/whisper-node.threads.wasm`启用 `bash scripts/build-wasm.sh --single-file` 只有在您想要WASM 二进制时 嵌入每个生成的JS文件. 现代标记嵌入了线程 在JS主文件中的工人拖带, 所以一个单独的 `whisper-node.worker.js` 实值 非预期。 使 UI 工作脱离主线的软件包模块工作 实值 `worker.js`启用 `npm run build-wasm-docker` 通过多克建造; 它 在苹果硅主机上选择本地的 arm64 标记图像 .

## 常见问题

### @fugood/node-whisper-wasm 是什么？

浏览器 WASM 模块用于低语\. node

### 如何安装 @fugood/node-whisper-wasm？

在项目目录运行 npm install @fugood/node-whisper-wasm，或使用 pnpm add / yarn add / bun add。

### @fugood/node-whisper-wasm 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fugood/node-whisper-wasm 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fugood/node-whisper-wasm 可以商用吗？

@fugood/node-whisper-wasm 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fugood/node-whisper-wasm 的下载量有多少？

根据 npm 官方下载统计，@fugood/node-whisper-wasm 在 2026/10/16 – 2026/11/14 这 30 天内被下载 24,227 次，日均约 808 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fugood/node-whisper-wasm 还在维护吗？

最新版本 1\.2\.0-rc\.2 发布于 2026/11/09（6 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/06/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。