node-pdf2img 0.1.7 → 0.1.9

package/README.md

@@ -1,16 +1,19 @@
 # node-pdf2img
 
-高性能 PDF 转图片工具，基于 PDFium 原生渲染器 + Sharp 图像编码。
+高性能 PDF 转图片工具，支持 PDFium 原生渲染器和 PDF.js 渲染器。
 
 [![npm version](https://badge.fury.io/js/node-pdf2img.svg)](https://badge.fury.io/js/node-pdf2img)
 
 ## 特性
 
-- **高性能**：使用 PDFium 原生渲染，多线程并行处理
+- **双渲染引擎**：PDFium 原生渲染（高性能）+ PDF.js（纯 JavaScript，无需原生依赖）
+- **高性能**：PDFium 多线程并行处理，整体快 1.7x
+- **流式渲染**：URL 输入支持 HTTP Range 请求，大文件无需完整下载
 - **多种格式**：支持 WebP、PNG、JPG 输出
 - **多种输入**：支持本地文件、URL、Buffer
 - **多种输出**：支持本地文件、Buffer、腾讯云 COS
 - **CLI + API**：命令行工具和 Node.js 模块双模式
+- **广泛兼容**：支持 GLIBC 2.17+ (CentOS 7/RHEL 7+)
 
 ## 安装
 
@@ -25,14 +28,20 @@ npm install -g node-pdf2img
 ## 系统要求
 
 - Node.js >= 18.0.0
-- 支持平台：Linux x64/arm64、macOS x64/arm64、Windows x64
+- 支持平台：
+  - Linux x64/arm64 (GLIBC 2.17+，兼容 CentOS 7/RHEL 7+)
+  - macOS x64/arm64
+  - Windows x64
 
 ## CLI 使用
 
 ```bash
-# 基本用法 - 转换所有页面
+# 基本用法 - 转换所有页面（默认使用 PDFium）
 pdf2img document.pdf -o ./output
 
+# 使用 PDF.js 渲染器
+pdf2img document.pdf -o ./output -r pdfjs
+
 # 转换指定页面
 pdf2img document.pdf -p 1,2,3 -o ./output
 
@@ -51,6 +60,9 @@ pdf2img document.pdf -f jpg -q 85 -o ./output
 # 显示 PDF 信息
 pdf2img document.pdf --info
 
+# 显示渲染器版本信息
+pdf2img --version-info
+
 # 上传到腾讯云 COS
 pdf2img document.pdf --cos --cos-prefix images/doc-123
 ```
@@ -64,8 +76,10 @@ pdf2img document.pdf --cos --cos-prefix images/doc-123
 | `-w, --width <width>` | 渲染宽度（像素） | `1920` |
 | `-q, --quality <quality>` | 图片质量（0-100） | `100` |
 | `-f, --format <format>` | 输出格式：webp, png, jpg | `webp` |
+| `-r, --renderer <renderer>` | 渲染器：pdfium, pdfjs | `pdfium` |
 | `--prefix <prefix>` | 文件名前缀 | `page` |
 | `--info` | 仅显示 PDF 信息 | |
+| `--version-info` | 显示渲染器版本信息 | |
 | `-v, --verbose` | 详细输出 | |
 | `--cos` | 上传到腾讯云 COS | |
 | `--cos-prefix <prefix>` | COS key 前缀 | |
@@ -88,7 +102,7 @@ pdf2img document.pdf --cos --cos-prefix images/doc-123
 ### 基本用法
 
 ```javascript
-import { convert, getPageCount, isAvailable } from 'node-pdf2img';
+import { convert, getPageCount, isAvailable, RendererType } from 'node-pdf2img';
 
 // 检查渲染器是否可用
 if (!isAvailable()) {
@@ -96,7 +110,7 @@ if (!isAvailable()) {
     process.exit(1);
 }
 
-// 转换 PDF 为图片（返回 Buffer）
+// 转换 PDF 为图片（返回 Buffer，默认使用 PDFium）
 const result = await convert('./document.pdf');
 console.log(`转换了 ${result.renderedPages} 页`);
 
@@ -106,6 +120,24 @@ for (const page of result.pages) {
 }
 ```
 
+### 使用 PDF.js 渲染器
+
+```javascript
+import { convert, RendererType, isPdfjsAvailable } from 'node-pdf2img';
+
+// 检查 PDF.js 渲染器是否可用
+if (isPdfjsAvailable()) {
+    const result = await convert('./document.pdf', {
+        renderer: RendererType.PDFJS,  // 或直接使用 'pdfjs'
+    });
+    console.log(`使用 PDF.js 转换了 ${result.renderedPages} 页`);
+}
+```
+
+> **渲染器选择建议**：
+> - **PDFium**（默认）：高性能，适合大多数场景，整体快 1.7x
+> - **PDF.js**：纯 JavaScript，无需原生依赖，适合超大文件（>50MB）或无法使用原生模块的环境
+
 ### 保存到文件
 
 ```javascript
@@ -200,8 +232,15 @@ const result = await convert('https://example.com/document.pdf', {
     outputType: 'file',
     outputDir: './output',
 });
+
+// 查看流式渲染统计（仅 URL 输入时存在）
+if (result.streamStats) {
+    console.log(`流式渲染: 缓存命中 ${result.streamStats.cacheHits} 次`);
+}
 ```
 
+> **流式渲染**：对于大于 2MB 的远程 PDF，会自动使用 HTTP Range 请求按需获取数据，避免完整下载。小于 2MB 的文件会直接下载后渲染，减少 Range 请求开销。
+
 ### 上传到腾讯云 COS
 
 ```javascript
@@ -256,6 +295,7 @@ PDF 转图片。
   - `prefix` (string)：文件名前缀，默认 'page'
   - `format` ('webp' | 'png' | 'jpg')：输出格式，默认 'webp'
   - `targetWidth` (number)：渲染宽度，默认 1280
+  - `renderer` ('pdfium' | 'pdfjs')：渲染器，默认 'pdfium'
   - `webp` (object)：WebP 编码选项
     - `quality` (number)：质量 0-100，默认 80
   - `jpeg` (object)：JPEG 编码选项
@@ -276,15 +316,30 @@ PDF 转图片。
 
 **返回：** Promise\<number\>
 
-### `isAvailable()`
+### `isAvailable(renderer?)`
+
+检查渲染器是否可用。
+
+**参数：**
+- `renderer` ('pdfium' | 'pdfjs')：可选，指定检查的渲染器，默认检查 PDFium
+
+**返回：** boolean
+
+### `isPdfjsAvailable()`
 
-检查原生渲染器是否可用。
+检查 PDF.js 渲染器是否可用。
 
 **返回：** boolean
 
 ### `getVersion()`
 
-获取原生渲染器版本信息。
+获取 PDFium 渲染器版本信息。
+
+**返回：** string
+
+### `getPdfjsVersion()`
+
+获取 PDF.js 渲染器版本信息。
 
 **返回：** string
 
@@ -299,8 +354,39 @@ PDF 转图片。
 | 变量 | 说明 | 默认值 |
 |------|------|--------|
 | `PDF2IMG_THREAD_COUNT` | 工作线程数 | CPU 核心数 |
+| `PDF2IMG_RENDERER` | 默认渲染器 (pdfium/pdfjs) | `pdfium` |
 | `PDF2IMG_DEBUG` | 启用调试日志 | `false` |
 
+## 渲染器对比
+
+| 特性 | PDFium | PDF.js |
+|------|--------|--------|
+| 性能 | ⚡ 快 1.7x | 普通 |
+| 依赖 | 原生模块 | 纯 JavaScript |
+| 大文件 (>50MB) | 普通 | ⚡ 更快 |
+| 兼容性 | Linux/macOS/Windows | 所有平台 |
+| 流式渲染 | ✓ | ✓ |
+
+## 架构
+
+模块化设计，职责分离：
+
+```
+src/
+├── core/
+│   ├── converter.js      # 主 API 入口
+│   ├── renderer.js       # PDF 渲染逻辑（流式/下载/本地）
+│   ├── thread-pool.js    # 线程池管理
+│   ├── downloader.js     # 远程文件下载
+│   ├── output-handler.js # 文件保存和 COS 上传
+│   └── config.js         # 配置常量
+├── renderers/
+│   ├── native.js         # PDFium 原生渲染器
+│   └── pdfjs.js          # PDF.js 渲染器（分片加载）
+└── utils/
+    └── logger.js         # 日志工具
+```
+
 ## 许可证
 
 MIT

package/bin/cli.js

@@ -12,8 +12,13 @@
  *   pdf2img document.pdf -p 1,2,3 -o ./output
  *   pdf2img document.pdf --quality 90 --width 1920 -o ./output
  *   pdf2img document.pdf --format png -o ./output  # 输出 PNG 格式
+ *   pdf2img document.pdf --renderer pdfjs -o ./output  # 使用 PDF.js 渲染器
  *   pdf2img document.pdf --cos --cos-prefix images/doc  # 上传到 COS
  *
+ * 渲染器：
+ *   pdfium  - PDFium 原生渲染器（默认，高性能）
+ *   pdfjs   - PDF.js 渲染器（纯 JavaScript，无需原生依赖）
+ *
  * COS 环境变量：
  *   COS_SECRET_ID     - 腾讯云 SecretId
  *   COS_SECRET_KEY    - 腾讯云 SecretKey
@@ -42,10 +47,10 @@ try {
 
 // 处理 --version-info 选项（在解析前检查）
 if (process.argv.includes('--version-info')) {
-    const { isAvailable, getVersion } = await import('../src/index.js');
+    const { isAvailable, getVersion, RendererType } = await import('../src/index.js');
     console.log(`pdf2img v${pkg.version}`);
-    console.log(`原生渲染器: ${getVersion()}`);
-    console.log(`可用: ${isAvailable() ? '是' : '否'}`);
+    console.log(`PDFium 渲染器: ${isAvailable(RendererType.PDFIUM) ? getVersion(RendererType.PDFIUM) : '不可用'}`);
+    console.log(`PDF.js 渲染器: ${isAvailable(RendererType.PDFJS) ? '可用' : '不可用'}`);
     process.exit(0);
 }
 
@@ -59,6 +64,7 @@ program
     .option('-w, --width <width>', '目标渲染宽度（像素）', '1920')
     .option('-q, --quality <quality>', '图片质量（0-100，用于 webp/jpg）', '100')
     .option('-f, --format <format>', '输出格式：webp, png, jpg', 'webp')
+    .option('-r, --renderer <renderer>', '渲染器：pdfium（默认）或 pdfjs', 'pdfium')
     .option('--prefix <prefix>', '输出文件名前缀', 'page')
     .option('--info', '仅显示 PDF 信息（页数）')
     .option('--version-info', '显示原生渲染器版本')
@@ -77,20 +83,31 @@ program
         }
 
         // 动态导入主模块
-        const { convert, getPageCount, isAvailable, getVersion } = await import('../src/index.js');
+        const { convert, getPageCount, isAvailable, getVersion, RendererType } = await import('../src/index.js');
 
         // 显示版本信息
         if (options.versionInfo) {
             console.log(`pdf2img v${pkg.version}`);
-            console.log(`原生渲染器: ${getVersion()}`);
-            console.log(`可用: ${isAvailable() ? '是' : '否'}`);
+            console.log(`PDFium 渲染器: ${isAvailable(RendererType.PDFIUM) ? getVersion(RendererType.PDFIUM) : '不可用'}`);
+            console.log(`PDF.js 渲染器: ${isAvailable(RendererType.PDFJS) ? '可用' : '不可用'}`);
             return;
         }
 
-        // 检查 native renderer
-        if (!isAvailable()) {
-            console.error('错误：原生渲染器不可用。');
-            console.error('请确保 PDFium 库已正确安装。');
+        // 验证渲染器
+        const renderer = options.renderer.toLowerCase();
+        if (renderer !== 'pdfium' && renderer !== 'pdfjs') {
+            console.error(`错误：不支持的渲染器 "${options.renderer}"。支持的渲染器：pdfium, pdfjs`);
+            process.exit(1);
+        }
+
+        // 检查渲染器可用性
+        if (!isAvailable(renderer)) {
+            if (renderer === 'pdfium') {
+                console.error('错误：PDFium 原生渲染器不可用。');
+                console.error('请确保 PDFium 库已正确安装，或使用 --renderer pdfjs 切换到 PDF.js 渲染器。');
+            } else {
+                console.error('错误：PDF.js 渲染器不可用。');
+            }
             process.exit(1);
         }
 
@@ -111,17 +128,15 @@ program
 
         // 仅显示 PDF 信息
         if (options.info) {
-            if (isUrl) {
-                console.error('错误：--info 选项仅支持本地文件');
-                process.exit(1);
-            }
-
             try {
-                const pageCount = getPageCount(input);
-                const stat = fs.statSync(input);
-                console.log(`文件: ${path.basename(input)}`);
-                console.log(`大小: ${(stat.size / 1024 / 1024).toFixed(2)} MB`);
+                const pageCount = await getPageCount(input, { renderer });
+                if (!isUrl) {
+                    const stat = fs.statSync(input);
+                    console.log(`文件: ${path.basename(input)}`);
+                    console.log(`大小: ${(stat.size / 1024 / 1024).toFixed(2)} MB`);
+                }
                 console.log(`页数: ${pageCount}`);
+                console.log(`渲染器: ${renderer}`);
             } catch (err) {
                 console.error(`错误: ${err.message}`);
                 process.exit(1);
@@ -143,6 +158,7 @@ program
             targetWidth: parseInt(options.width, 10),
             quality: parseInt(options.quality, 10),
             format: format,
+            renderer: renderer,
         };
 
         // COS 模式
@@ -195,7 +211,7 @@ program
 
             const duration = Date.now() - startTime;
 
-            spinner.succeed(`${modeText}完成 ${result.renderedPages}/${result.numPages} 页，格式: ${result.format.toUpperCase()}，耗时 ${duration}ms`);
+            spinner.succeed(`${modeText}完成 ${result.renderedPages}/${result.numPages} 页，格式: ${result.format.toUpperCase()}，渲染器: ${result.renderer}，耗时 ${duration}ms`);
 
             // 显示结果
             if (options.cos) {

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "node-pdf2img",
-    "version": "0.1.7",
-    "description": "High-performance PDF to image converter using PDFium native renderer",
+    "version": "0.1.9",
+    "description": "High-performance PDF to image converter using PDFium native renderer or PDF.js",
     "type": "module",
     "main": "./src/index.js",
     "types": "./src/index.d.ts",
@@ -29,6 +29,7 @@
         "image",
         "converter",
         "pdfium",
+        "pdfjs",
         "webp",
         "native",
         "cli"
@@ -53,9 +54,13 @@
         "dotenv": "^16.0.3",
         "ora": "^8.0.0",
         "p-limit": "^7.2.0",
+        "pdfjs-dist": "^4.0.0",
         "piscina": "^5.1.4",
         "sharp": "^0.33.0",
-        "node-pdf2img-native": "^1.1.8"
+        "node-pdf2img-native": "^1.1.10"
+    },
+    "optionalDependencies": {
+        "canvas": "^2.11.0"
     },
     "devDependencies": {
         "@types/node": "^20.0.0"

package/src/core/config.js

@@ -2,6 +2,15 @@
  * PDF2IMG 配置
  */
 
+// ==================== 渲染器类型 ====================
+export const RendererType = {
+    PDFIUM: 'pdfium',  // PDFium 原生渲染器（默认，高性能）
+    PDFJS: 'pdfjs',    // PDF.js 渲染器（纯 JavaScript，无需原生依赖）
+};
+
+// 默认渲染器
+export const DEFAULT_RENDERER = process.env.PDF2IMG_RENDERER || RendererType.PDFIUM;
+
 // ==================== 渲染配置 ====================
 export const RENDER_CONFIG = {
     // 目标渲染宽度（像素）