纯 Rust 重构的 PDF 工具：桌面网页共用一套引擎，还能让 AI 直接改文档

你说一句「第三页删了，摘要挪到最前面」，它自己就干了。

PDF 这玩意儿，属于那种天天用、从来不觉得有问题的东西。

直到你要动它。

删两页、把扫描件里的表格抠出来、给合同盖个章、二十张发票并成一份，每一样都得这么折腾一圈：先找个在线网站，传上去（合同内容传给别人的服务器），等它转，下载，发现格式乱了，再换一个网站。

或者装个 Adobe，一年两千多，装完发现那台老笔记本跑不动。

最难受的不是花钱，是你的文件不长在你自己的机器上。

今年九月，有人开了个仓库叫 pdfcraft，纯 Rust 写的桌面 PDF 工作台。现在 18,105 星。

01 它没套壳

它不是 Chrome 内核套个界面再打印成 PDF，也不是把现成的 C 库包一层 Rust 皮。没调 Poppler，没调 MuPDF，没调 PDFium。

整个解析引擎是照着 ISO 32000 这个 PDF 官方标准，一行一行自己写的。

听着像技术洁癖，但它带来几件套壳做不到的事：

• 增量保存：只写改动的那部分，不是重新生成整个文件，大文件改一个字不用等十秒
• 原子写入：先写临时文件再替换，原文件始终完整，写一半断电也不会烂
• 完全离线：一个字节都不出本机，合同、病历、身份证扫描件，随便放
• 同一套代码：网页版是 WASM 编译出来的，功能不是阉割版

最后一条值得多说两句。大部分工具的网页版和桌面版是两个团队、两套代码、两套 bug。它这里，桌面端（egui 画的界面）和网页版（WASM）跑的是同一个引擎。

网页版能干什么，装上桌面版就是那个，不多也不少。

02 一屏工具全摊开

打开界面，左边一列工具，名字都很直白：

• Export a PDF      导出
• Fill & Sign       填表签名
• Edit a PDF        编辑
• Create a PDF      新建
• Combine files     合并
• Organize pages    页面整理
• Add comments      批注
• Scan & OCR        扫描与文字识别
• Protect a PDF     加密
• Redact a PDF      涂黑
• Compress a PDF    压缩
• Prepare a form    做表单
• Add a stamp       盖章
• Use a certificate 数字证书

十四项，没有一项叫「AI 智能助手」，也没有一项藏在二级菜单里。这风格我不太喜欢，信息密度太高，第一次打开有点晕。但用两次就顺了，因为路径从来不变，肌肉记忆攒得住。

页面整理那屏最能说明思路。缩略图铺满一屏，选中几页，工具栏立刻变成「3 pages selected」，后面一排是旋转、删除、复制、插入、提取、合并。选中哪几页、要干什么，一屏之内全解决。

03 让 AI 自己动手

这块是我最想聊的，也是它跟别的 PDF 工具拉开距离的地方。

它内置了三套接口：

• MCP server   # 给 AI agent 调的
• CLI          # 给脚本调的
• GUI control  # 给自动化流程调的

三套底下是同一个引擎。你在界面里点的那一下，和 AI 通过 MCP 调的那一下，走的是同一条路。

说白了，你可以直接跟 agent 说需求，不用自己点。

「这份合同第三页那个签名区放大一圈，右下角盖个章，然后导出两份，一份加密一份不加密。」

它自己拆成：定位页面、调整表单域、插入图章、导出、设密码。中间调了什么你不用管。

为什么这事儿以前干不了？

大部分 PDF 工具的自动化能力，是「给你的 GUI 套一层命令行」。你让 agent 调，它调的其实是「模拟点按钮」，页面一变就崩。pdfcraft 的 CLI 和 MCP 是直接下到引擎的，不经过界面。

04 敢说自己没做完

这是我决定写这篇文章的真正原因。

它的 README 里明明白白写着：alpha 阶段，核心大约 94% 就绪。

一个 18k 星的项目，第一屏就告诉你没做完。这种事儿不常见。

更少见的是它怎么证明自己没崩：拿 983 到 986 个真实世界的 PDF 文件跑了压测，零崩溃。保存出来的文件用 qpdf 这个业界公认的校验工具验过，能过。

敢把「我还没做完」和「但我没崩过」同时写出来的项目，通常是真的在干活。

坑也说几句。

它的界面是 egui 画的，不是原生控件，也不是 Electron 那种网页壳。好处是启动快、体积小，坏处是字体渲染和高分屏缩放跟系统原生应用有差距。你要是习惯 Adobe 那种精细排版，会不适应。

中文 PDF 的字体嵌入，这种自己写引擎的项目历来在这上头栽跟头。标准里字体嵌入的路径有好几条，不是每条都实现全了。它现在敢说自己 94%，但那 6% 里有多少跟中文字体有关，README 没说。建议你先拿自己最恶心的一份 PDF 去试。

alpha 还意味着接口会变。你现在写脚本接它的 CLI，下个版本可能就得改。

写在最后

我用 PDF 工具十几年，一直觉得这个领域没什么可创新的。格式二十年没大变，工具也就那几个，大家比的是谁广告少。

pdfcraft 让我改了看法。

它证明了一件事：老格式不等于没机会，只要你肯从底层重做一遍。

在线工具把文件传出去这事儿，说了十年也没人真解决。有个人干脆写了个完全离线的，还顺手把 agent 接口做进去了。

搜 storytold/pdfcraft，Apache-2.0。桌面版和网页版都有，网页版不用装东西，先试试手感。