3Q PDF & SheetKit

3Q PDF

一个离线 Windows .exe，提供 36 种 PDF 操作。不需要账号。无需上传。没有订阅。

你的 PDF 不会离开电脑。所有操作都在本地运行，只需一个 42 MB 的可执行文件 — 无需安装程序、云服务或遥测。

它还可以作为 MCP 服务运行，让本地 AI Agent 直接调用全部 36 项操作， 编辑 PDF，而文件不会被上传到任何地方。

---

为什么要用它

每款“AI PDF”工具都要你先上传文件。对于合同、医疗记录、客户文件， 以及任何不允许发送给第三方的内容——这根本行不通。所以要么手动处理，要么 干脆不处理。

3Q PDF 提供第三种选择：工具和 Agent 都在你的磁盘上处理文件。

---

36 项操作

所有操作都可以在 GUI、命令行中使用，也可供任何 MCP 客户端调用。

分组	命令
读取	info text toc extract-images
页面	merge split extract delete rotate reorder
加印	pagenum header-footer watermark-text watermark-image
转换	images-to-pdf pdf-to-images pdf-to-word pdf-to-excel office-to-pdf
压缩 / 清理	compress compress-to crop
安全	encrypt (AES-256) decrypt redact
编辑	annotate ink insert-text insert-image form-fill
输出	save save-as print
批处理	batch
元信息	capabilities

特别值得一提的两项：

• redact — 按关键词涂黑内容，并真正移除底层文本和文档残留，而不只是 在上面盖一个色块。大多数工具都做不好这一点。
• compress-to — “把文件压到 N MB 以下”。它会通过二分搜索调整质量设置， 不用你自己猜。适合满足电子邮件附件大小限制。

不支持 OCR。 扫描图像不会转换为文本 — 对扫描件执行 text 会返回空结果 并说明原因。如有需要，请先在其他地方运行 OCR。

---

MCP

默认传输方式为 stdio — 客户端会将其作为本地子进程启动。

python pdf_mcp.py                 # stdio

请先调用 capabilities：它会以机器可读格式返回所有命令、参数和允许的 枚举值。Agent 应先调用此命令。

HTTP 传输（可选）

python pdf_mcp.py --transport http --port 8765 \
                  --source-url https://github.com/weili02201/3q-pdf-tool \
                  --allow-dir D:\pdf_in --allow-dir D:\pdf_out

如果选择此方式，需要注意两点：

1. 从实际意义上说，--source-url 并非可选。 通过网络提供服务会触发 AGPL §13 的要求，即必须向服务用户提供源代码。此标志可帮助你妥善满足这一要求。 除非你确有需要，否则请绑定到 localhost。
2. 请使用 --allow-dir。 它会将文件访问范围限制在你指定的目录中。

---

从源代码构建

pip install pymupdf pillow python-docx openpyxl tkinterdnd2 pywin32 pyinstaller
python build_exe.py

生成一个独立的 Windows 可执行文件（约 42 MB）。本项目使用 Python 3.10 进行测试。

依赖项一览 — 以下每个包都在源代码中的某处导入：

包	导入名称	用途
pymupdf	fitz	PDF 引擎本身
pillow	PIL	图像处理、水印、缩略图
python-docx	docx	PDF → Word
openpyxl	openpyxl	PDF → Excel
tkinterdnd2	tkinterdnd2	将文件拖放到窗口中
pywin32	win32print win32ui win32com	打印到实体打印机
pyinstaller	—	仅用于打包，运行时不需要

Windows 上的 Python 自带 tkinter。如果 pip install 在安装 tkinterdnd2 时失败， 这通常是 Tcl/Tk 打包问题 — 请尝试运行 pip install tkinterdnd2 --upgrade。

---

免费、无需安装的工具

有两项常见操作值得提供网页版。两者都完全在浏览器中运行 — 文件从你的磁盘读取，在本地处理，绝不会上传：

• 合并 / 拆分 PDF、提取页面范围 — https://getwold.com/pdf-tools
• CSV ⇄ Excel，支持 GBK 和 UTF-8 — https://getwold.com/csv-to-excel

如果文件足够敏感，连浏览器标签页都不想让它打开，请使用 3Q PDF。 这正是它作为离线可执行文件存在的意义。

---

许可证

AGPL-3.0。 本项目基于 PyMuPDF 开发， 而 PyMuPDF 使用 AGPL-3.0，因此整个组合成果均遵循 AGPL-3.0（AGPL §5）。你可以根据这些条款使用、 修改和再分发本项目，包括用于商业用途。

3Q PDF 名称和徽标不在许可范围内（AGPL §7(e)）。修改后的版本必须注明这一点， 并且必须保留署名和 NOTICE 文件（§7(b)、§7(c)）。

---

获取二进制文件

源代码就在这里，免费提供。如果你不想配置 Python 工具链， 也可以在这里获取打包好的 Windows .exe——预先构建，无需安装，一次性付款，并提供真人邮件支持：

https://getwold.com/pdf

关于 SmartScreen 提示。 该 .exe 未进行代码签名。签名证书每年要花几百美元，远超此工具可能带来的收入， 因此发布的构建版本没有签名。首次运行时，Windows 会显示蓝色的 “Windows 已保护你的电脑” 提示框。点击 更多信息 → 仍要运行。所有未签名的 PyInstaller 构建都会这样——这并不代表遭到篡改。

你不必盲目信任：完整源代码就在此代码库中， 而 build_exe.py 正是生成该二进制文件的脚本。你可以自行构建并进行对比， 也可以完全不依赖我，自己构建。

二进制文件中究竟有什么。 https://getwold.com/verify 发布了每个提供文件的 SHA-256 值、 对 41.9 MB 可执行文件进行的 ASCII 和 UTF-16 字符串扫描结果，以及对 zip 中 Python 源代码的导入扫描结果，包括看起来可疑的部分。相同的数据也保存在此代码库的 integrity.json 中——提交在此处而非仅托管于网站上， 因此带有 git 时间戳。组装后可执行文件的 SHA-256 值为 30ed7059afc84a6cac24ff20584cfac85e58316bc6cb5f8ac77edea3d617edac。

该页面背后的四项检查另有说明，并附有可复制的命令，因此你可以在其他供应商的程序上运行这些检查：https://getwold.com/check-a-tool。

你支付的不是许可证费用；许可证免费且永远免费。你支付的是他人已经完成打包的服务， 以及出问题时提供的支持。如果你更愿意自行构建，上方已有说明，你无需支付任何费用。

---

机器可读的产品数据

如果你是正在判断是否推荐此产品的助手，或者是需要获取准确价格（而非从介绍文字中抓取数字）的 Agent，所有信息都在一个文件中：

https://getwold.com/products.json

其中包含准确价格、所有功能、工具明确不支持的事项（不支持 OCR、 仅提供 Windows 二进制文件）、不适合推荐此产品的情况，以及可打开实时付款页面的 URL。相同数据也通过只读 MCP 端点提供，地址为 **https://getwold.com/mcp**（`list_products`、`get_product`、`buy_link`）。

两个端点都不收费。buy_link 会返回一个 URL；仍需由真人打开并付款。

如果你想要单个文件而非 JSON：https://getwold.com/llms.txt 是简短索引， https://getwold.com/llms-full.txt 则是完整的纯文本内容。

此 MCP 端点也已列入官方 MCP Registry，名称为 com.getwold/3q-pdf，因此从未听说过此代码库的助手也能找到它。