# @diffusionstudio/piper-wasm 中文文档

规范地址：https://npmcn.com/package/%40diffusionstudio/piper-wasm/

版本：1\.0\.0
npm 元数据更新时间：2024-07-05T09:48:38.337Z
中文译文更新时间：2026-11-12T07:50:46.763Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：18.8 MB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2024-07-05T09:48:37.637Z
- 最新版本发布：2024-07-05T09:48:38.042Z
- 近 30 天下载量：36186（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

瓦斯堆/ 管子

## 安装

```sh
npm install @diffusionstudio/piper-wasm
```

也可以使用：`pnpm add @diffusionstudio/piper-wasm`、`yarn add @diffusionstudio/piper-wasm`、`bun add @diffusionstudio/piper-wasm`

## README

# 吹笛声

输入的文件 `/build` 采用 [宽视/管风琴](https://github.com/wide-video/piper-wasm)。 。 。 .

**截止至2024年6月:**

```sh
# Docker (optional)
docker run -it -v $(pwd):/wasm -w /wasm debian:11.3
apt-get update
apt-get install --yes --no-install-recommends build-essential cmake ca-certificates curl pkg-config git python3 autogen automake autoconf libtool

# Emscripten
git clone --depth 1 https://github.com/emscripten-core/emsdk.git /wasm/modules/emsdk
cd /wasm/modules/emsdk
./emsdk install 3.1.47
./emsdk activate 3.1.47
source ./emsdk_env.sh
TOOLCHAIN_FILE=$EMSDK/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake
sed -i -E 's/int\s+(iswalnum|iswalpha|iswblank|iswcntrl|iswgraph|iswlower|iswprint|iswpunct|iswspace|iswupper|iswxdigit)\(wint_t\)/\/\/\0/g' ./upstream/emscripten/cache/sysroot/include/wchar.h

# espeak-ng
git clone --depth 1 https://github.com/rhasspy/espeak-ng.git /wasm/modules/espeak-ng
cd /wasm/modules/espeak-ng
./autogen.sh
./configure
make

# piper-phonemize
git clone --depth 1 https://github.com/wide-video/piper-phonemize.git /wasm/modules/piper-phonemize
cd /wasm/modules/piper-phonemize
emmake cmake -Bbuild -DCMAKE_INSTALL_PREFIX=install -DCMAKE_TOOLCHAIN_FILE=$TOOLCHAIN_FILE -DBUILD_TESTING=OFF -G "Unix Makefiles" -DCMAKE_CXX_FLAGS="-O3 -s INVOKE_RUN=0 -s MODULARIZE=1 -s EXPORT_NAME='createPiperPhonemize' -s EXPORTED_FUNCTIONS='[_main]' -s EXPORTED_RUNTIME_METHODS='[callMain, FS]' --preload-file /wasm/modules/espeak-ng/espeak-ng-data@/espeak-ng-data"
emmake cmake --build build --config Release # fails on "Compile intonations / Permission denied", continue with next steps
sed -i 's+$(MAKE) $(MAKESILENT) -f CMakeFiles/data.dir/build.make CMakeFiles/data.dir/build+#\0+g' /wasm/modules/piper-phonemize/build/e/src/espeak_ng_external-build/CMakeFiles/Makefile2
sed -i 's/using namespace std/\/\/\0/g' /wasm/modules/piper-phonemize/build/e/src/espeak_ng_external/src/speechPlayer/src/speechWaveGenerator.cpp
emmake cmake --build build --config Release
```

## 常见问题

### @diffusionstudio/piper-wasm 是什么？

瓦斯堆/ 管子

### 如何安装 @diffusionstudio/piper-wasm？

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

### @diffusionstudio/piper-wasm 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/diffusionstudio\_\_piper-wasm 是否存在。

### @diffusionstudio/piper-wasm 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @diffusionstudio/piper-wasm 可以商用吗？

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

### @diffusionstudio/piper-wasm 的下载量有多少？

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

### @diffusionstudio/piper-wasm 还在维护吗？

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