加速器引擎：Spectrum / Prisma¶

NextPDF 加速器引擎是以 Rust 撰寫的原生效能加速層，透過 FFI 橋接或 Sidecar 程序與 PHP 端協同運作。它能大幅提升字型子集化、影像壓縮、文件解析等運算密集型操作的吞吐量。

三層架構總覽¶

加速器引擎依授權分為三個層級，滿足從開源到大型企業的不同需求：

Spectrum（Core 內建，LGPL-3.0）¶

Spectrum 是 NextPDF Core 套件內建的開源加速引擎，無需額外授權即可使用。

核心功能¶

• 字型子集化加速：將 OpenType / TrueType 字型子集化速度提升數倍
• 影像壓縮管線：JPEG、WebP、PNG 影像壓縮與重採樣的 Rust 原生實作
• PDF 流程解析：低記憶體佔用的串流式 PDF 解析器
• 電路斷路器：內建 threshold=3 的斷路保護，FFI 失敗時自動降回 PHP 實作

二進位檔發布格式¶

# 快速啟用 Spectrum（從 Core 套件根目錄）
SPECTRUM_ENABLED=true SPECTRUM_BIN=/usr/local/bin/nextpdf-spectrum php artisan nextpdf:warmup

Prisma Pro（商業授權）¶

Prisma Pro 在 Spectrum 的基礎上新增批次處理與進階 PDF 操作能力。

核心功能¶

• 批次渲染引擎：多核心並行文件生成，支援優先權佇列
• 進階 PDF 解析：完整的 PDF 2.0 內容串流解析、表格提取、表單欄位讀取
• 文件比對：語意層級的 PDF 差異分析
• 文字提取管線：結構化文字提取，保留字型、位置、閱讀順序元資料

Prisma Enterprise（商業授權）¶

Prisma Enterprise 提供大規模企業部署所需的叢集模式與硬體安全模組整合。

核心功能¶

• 叢集模式：水平擴展的多節點 Prisma 叢集，支援 Kubernetes Operator
• HSM 硬體加速：PKCS#11 介面，對接 Thales、Entrust、AWS CloudHSM
• RAG 向量嵌入：PDF 文件分塊、向量化，直接輸出至 Pinecone / Qdrant / pgvector
• HighControl 模式：租戶隔離、資料主權管控、審計日誌完整鏈

架構快速導覽¶

加速器引擎支援兩種部署模式，詳見 架構說明：

• Mode A — Sidecar：Prisma 以獨立程序在同一主機運行，PHP 透過 Unix Socket / TCP 通訊
• Mode B — Remote：Prisma 以獨立服務部署（容器、Kubernetes），PHP 透過 REST API 呼叫

部署指南¶

授權與取得¶

• Spectrum：隨 nextpdf/core 免費提供，LGPL-3.0
• Prisma Pro / Enterprise：需商業授權金鑰