PDFCraft 是可在浏览器里处理文件的开源 PDF 工具箱,提供合并、拆分、旋转、压缩、OCR、格式转换和批注等功能。常规处理通过设备端的 WebAssembly 完成,无需先把文档上传到 PDFCraft 的处理服务器;个人可直接用网页,长期使用也能选择桌面版或自托管。

选择时先看手头任务:整理页序、把扫描件变成可搜索文件、重复处理一批资料,需要的功能和检查方式并不一样。项目采用 AGPL-3.0 许可,提供中文等多语言界面。
先整理页序,再做压缩和转换
例如,要把几份扫描资料整理成一份可分享的 PDF,可以按下面的顺序处理。这是基于工具能力的工作流程示例,并非每份文档都要走完全部步骤。
- 保留原文件,用副本确定哪些页要留、哪些要删除。合并与重排先解决资料顺序,旋转或纠偏处理方向不一致的扫描页。
- 如果需要搜索和复制扫描文字,再使用 OCR。完成 OCR 后应重点抽查姓名、证件号与角标小字是否出现形近误识别,确保检索准确。
- 根据交付需要添加页码、水印或批注,再考虑压缩。缩减文件体积后记得放大查验细节图纸和细小文字是否糊化。
- 另存结果并核对页数、页序和必要的书签;需要 DOCX、Excel 等可编辑格式时,再检查转换后的表格关系与版式。
只合并两份文件时,使用单个工具就够了。反复执行固定组合,才值得进入 /workflow 的可视化工作流编辑器:它可以连接节点、保存流程并批量处理,也提供合并压缩等预设模板。工作流目前仍处于 Beta,先用副本确认每个节点的输出,再扩大处理范围。
网页、桌面和内网入口怎么选
| 入口 | 适合的使用方式 | 选择时关注 |
|---|---|---|
| 官方网页 | 临时整理几份文件 | 应用资源需加载,处理性能受本机内存与浏览器影响 |
| 官方桌面构建 | 经常处理文档,使用固定安装版本 | 从 Releases 核对系统、安装包和版本;不要只凭“桌面”推断所有依赖都已离线 |
| Docker 自托管 | 团队内网统一入口或控制升级节奏 | 需要维护访问控制、HTTPS 与转换模块所需的响应头 |
本地处理减少了把原文档交给外部转换服务器的环节,但网页代码、浏览器扩展和设备环境仍需可信。高度敏感的资料可在经过核对的固定版本和受控环境中处理。工具提供签名、加密或 PDF/A 转换入口,另外工具里的手写签章与加密出口偏重快捷操作,涉密业务所需的法律效力认证及归档标准仍以行业合规口径为准。
为什么首页能打开,Office 转换却可能失败
PDFCraft 的 Word、Excel、PowerPoint 和 RTF 转 PDF 依赖 LibreOffice WASM,所用多线程能力需要跨源隔离。部署文档要求返回以下响应头,页面、脚本与 WASM 资源都应正确提供:
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Resource-Policy: cross-origin
GitHub Pages 不能直接配置这套必需响应头,部署文档因此指出相关 Office 转换不可用,其他 PDF 工具仍可使用。采用 Nginx 或 CDN 时,也要核对具体资源响应:页面主 HTML 带齐隔离响应头的同时,还需确保静态目录下的 .wasm 资源一并附带;代理移除响应头也会影响功能。
想在本机先看自托管入口,可在已安装 Docker 的环境运行官方镜像:
docker run -d -p 8080:80 --name pdfcraft ghcr.io/pdfcrafttool/pdfcraft:latest
然后访问 http://localhost:8080。这个命令提供本机起步入口,团队正式使用还需配置 HTTPS、访问范围与固定版本。部署到 /pdfcraft 这样的子目录时,BASE_PATH 必须在构建阶段提供,因为应用按静态页面导出,不能只在已有容器运行时换一个环境变量。
要改页面或转换逻辑,先看构建入口
项目使用 Next.js、React 与 TypeScript。开发入口是 npm run dev;npm run build 生成静态输出到 out/,部署不必常驻 Node.js 服务。package.json 中的安装、开发和构建脚本还负责 WASM 解压与资源处理,二次开发时不要只复制页面文件而漏掉这部分。
文档工具的成品质量仍取决于原文件:即使切换至中文界面,遇到冷门内嵌字体仍可能影响版面重排,而 OCR 识别准确度也直接受扫描原图清晰度左右。根据自己最常处理的扫描件、表格或 Office 文件选一小组样本,确认结果之后,再决定是否把它作为固定工具。
- 官方网页:
https://pdfcraft.devtoolcafe.com/ - GitHub 仓库:
https://github.com/PDFCraftTool/pdfcraft - 桌面构建与版本下载:
https://github.com/PDFCraftTool/pdfcraft/releases - 部署与响应头说明:
https://github.com/PDFCraftTool/pdfcraft/blob/main/DEPLOYMENT.md












暂无评论内容