Hacker News Best

PaperPilot – Zero-Cloud, Pure-Rust PDF Engine with WASM and MCP

6.9内容质量

TL;DR · AI 摘要

GitHub - KrushnaVardhanReddy/PaperPilot: Your local AI copilot for documents · GitHub PaperPilot PDF tools for your AI a...

核心要点

  • 主题聚焦：PaperPilot – Zero-Cloud, Pure-Rust PDF Engine wi
  • 来源：Hacker News Best，建议结合原文判断细节。
  • AI 分析暂不可用，本条为保底评分与摘要。
#AI#编程#后端#云计算#安全
打开原文

GitHub - KrushnaVardhanReddy/PaperPilot: 你的本地文档AI协作者 · GitHub

PaperPilot

为你的AI代理和你自己打造的PDF工具。纯Rust编写。本地运行。文件始终保留在你的设备上。

在浏览器中试用 → · 下载 · 路线图

PaperPilot是一个用Rust编写的PDF和文档工具包。相同的引擎可以作为以下形式运行：

Surface

使用场景

MCP服务器

为Codex、Claude Code、Kimi Code、Pi、Claude Desktop、Cursor或任何MCP客户端提供合并、拆分、OCR和压缩PDF的功能

CLI

批量处理和脚本工作流

浏览器（WASM）

零安装工具；文件在浏览器内存中处理，不会上传任何内容

桌面应用

带查看器、标注和差异功能的Tauri + Svelte图形界面

本地REST API

通过Python、Node或n8n调用：

code
localhost:7823

无需Chromium、无需C++运行时、无需云端调用。

快速入门

1. 与你的编码代理（MCP）配合使用

Codex、Claude Code、Kimi Code和当前Pi版本都连接到相同的本地stdio服务器。查看每个客户端的编码代理设置指南，获取配置和验证步骤。从本项目源码构建的版本还可以输出可合并的配置：

code
paperpilot-mcp --client-config codex
#
同样支持：claude-code, kimi-code, pi, claude-desktop, cursor

从Releases下载paperpilot-mcp，然后添加到claude_desktop_config.json：

code
{
"mcpServers"
: {
"paperpilot"
: {
"command"
:
"
/path/to/paperpilot-mcp
"
}
  }
}

重启Claude并尝试："合并这两个PDF并压缩结果。"

2. 使用CLI

code
#
合并
paperpilot merge --inputs doc1.pdf doc2.pdf --output merged.pdf
#
压缩
paperpilot compress --input in.pdf --quality 75 --output compressed.pdf
#
旋转第1、3-5页90度
paperpilot rotate --input in.pdf --pages 1,3-5 --angle 90 --output out.pdf

3. 在浏览器中使用

访问usepaperpilot.com。在操作时打开浏览器的Network面板——你将看到没有任何文件上传。

4. 从源码构建

code
git clone https://github.com/KrushnaVardhanReddy/PaperPilot.git
cd
PaperPilot
cargo build --release -p paperpilot-cli -p paperpilot-mcp -p paperpilot-gateway

桌面应用：

code
cd
apps/desktop
&&
pnpm install
&&
pnpm tauri dev

需要Rust 1.75+、Node.js和pnpm。

当前功能（v0.6）

组织：合并、拆分、旋转、删除页面、重新排序页面、提取页面、书册排版、N-up网格 优化：压缩 提取：纯文本、OCR（通过rten的纯Rust PaddleOCR） 安全：水印、验证签名、移除签名、PII扫描、深度清理 办公数据：Excel → JSON、Excel → CSV

即将推出（详见ROADMAP.md）：

  • v0.7: PDF ↔ Markdown / HTML / JSON
  • v0.8: PDF → Word / Excel / PowerPoint
  • v0.9: 加密、解密、签名、红action、表单、注释
  • v1.0: 渲染、展平、修复、比较、PDF/A、 Bates编号

为什么需要另一个PDF工具？

  • 默认私密。所有操作均在本地或浏览器标签页中执行。
  • 代理友好。MCP支持是核心功能，而非附加功能。
  • 一个引擎，多种界面。CLI、MCP、REST、WASM和桌面应用共享相同的Rust内核，行为保持一致。
  • 体积小巧，依赖项精简。纯Rust编写，基于lopdf、pdf_oxide、rten等库。

性能基准

运行cargo bench --workspace可复现。方法论和结果详见：SYSTEM_BENCHMARK_REPORT.md。

架构

code
桌面端（Tauri）· 命令行工具 · REST（Axum）· MCP（stdio）· WASM（浏览器 / 边缘）
                              │
                       Rust 核心工作区
   paperpilot-core · paperpilot-pdf · paperpilot-nlp · paperpilot-gateway
   paperpilot-mcp · paperpilot-wasm · paperpilot-storage

嵌入到您自己的网站

code
<
script
src
="
https://cdn.usepaperpilot.com/embed.js
"
data-tools
="
merge,compress,ocr
"
>
</
script
>
<
div
id
="
paperpilot-widget
"
>
</
div
>

本地 REST API

code
paperpilot serve --port 7823
curl -X POST http://localhost:7823/api/v1/pdf/merge \
  -H
"
Content-Type: application/json
"
\
  -d
'
{"inputs": ["a.pdf", "b.pdf"], "output": "out.pdf"}
'

Swagger 文档地址：http://localhost:7823/docs .

贡献代码

欢迎提交问题和拉取请求。适合新手的贡献包括：附带示例 PDF 的错误报告、新工具需求以及文档修正。

许可证

社区版（本仓库）：Apache 2.0 许可证。包含命令行工具、MCP 服务器、REST 网关、WASM 引擎和桌面应用。

企业版（SSO、RBAC、审计日志、DLP）由独立团队开发。