@build-qube/papyra-native

中文文档

0.8.0发布于 2026/10/27MITTypeScriptCommonJS零依赖构建来源已验证近 30 天下载 4676

Node-API bindings for papyra — prefer the @build-qube/papyra wrapper

@build-qube/papyra-native

The compiled core of papyra: Node-API bindings over a Rust PDF renderer, built as a native addon per platform and as a wasm module for the browser.

You almost certainly want @build-qube/papyra instead. It depends on this package, and it is where the API lives — the scheduler, the render cache, fitWidth, outlines, text and search, canvas painting. This package is a deliberately thin surface beneath it, and its shape is not a stable public API.

npm install @build-qube/papyra

The platform binaries (@build-qube/papyra-native-darwin-arm64, -linux-x64-gnu, -wasm32-wasi, …) are optional dependencies of this package; your package manager installs the one that matches. The browser build needs cross-origin isolation — see the papyra README.

Source and documentation: https://github.com/BuildQube/papyra

版本与发布记录

@build-qube/papyra-native 共发布 11 个版本，首次发布于 2026/08/27；过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`0.8.0`latest	2026/10/27	13 天前
`0.7.1`	2026/10/24	15 天前
`0.7.0`	2026/10/24	16 天前
`0.6.0`	2026/10/23	16 天前
`0.5.0`	2026/10/23	17 天前
`0.4.0`	2026/10/08	1 个月前

关于 @build-qube/papyra-native 的常见问题

@build-qube/papyra-native 是什么？

Node-API bindings for papyra — prefer the @build-qube/papyra wrapper

如何安装 @build-qube/papyra-native？

在项目目录运行 npm install @build-qube/papyra-native，或使用 pnpm add / yarn add / bun add。

@build-qube/papyra-native 支持 TypeScript 吗？

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

@build-qube/papyra-native 支持 ESM 还是 CommonJS？

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

@build-qube/papyra-native 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >= 18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@build-qube/papyra-native 可以商用吗？

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

@build-qube/papyra-native 的下载量有多少？

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

@build-qube/papyra-native 还在维护吗？

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