Nano PDF Editor 是什么？

Nano PDF Editor（Nano-PDF）是一款为开发者和高频制作幻灯片的人设计的命令行 PDF 编辑工具。它基于 Google 的 Gemini 3 Pro Image（内部代号 “Nano Banana”）模型，通过自然语言指令直接对 PDF 幻灯片进行修改，不需要打开复杂的界面，也不用手动对齐图表与文字。一句命令，就能让整套 Deck 在几分钟内焕然一新，非常适合 Pitch Deck、季度汇报、产品演示、投融资路演等场景。


关键功能亮点


🗣 自然语言编辑 PDF

你可以用接近对话的方式修改幻灯片内容，例如：

  • “Update the graph to include data from 2025”
  • “Change the chart to a bar graph”
  • “Change the tagline in the logo to ‘Cringe posts from work colleagues’ and update the date”

Nano PDF 会将指定页面渲染为图片，结合你的文字指令，通过 Gemini 3 Pro Image 生成新的页面内容，再自动写回原 PDF 中。


🧩 保留文字层，编辑后仍可搜索

很多 AI 图像生成方案会把幻灯片变成一张“死图”。

Nano PDF 使用 OCR 复写（OCR re-hydration）机制，在生成新页面后，用 Tesseract 恢复 PDF 的文字层：

  • 文本依然可选中、可复制
  • 文档结构得以保留
  • 搜索和索引功能正常可用

这让 AI 编辑过的 Deck 更适合实际工作流和协同项目。


🧬 新增幻灯片，风格自动跟随

如果需要补充新的页面，例如：

  • 在开头增加标题页：

    \"Title slide with \'Q3 2025 Review\'\"
  • 在某一页后增加总结页：

    \"Summary slide with key takeaways as bullet points\"

通过

nano-pdf add

命令即可插入全新页面。

工具会根据已有页面的视觉风格（字体、颜色、布局）自动匹配，让新增页面看起来就像本来就属于这套 Deck。


⚡ 多页并行处理，高效批量编辑

Nano PDF 支持一次性编辑多页，并行处理以提升速度，例如： 

nano-pdf edit my_deck.pdf \\
  1 \"Update date to Oct 2025\" \\
  5 \"Add company logo\" \\
  10 \"Fix typo in footer\"

在单次命令中，你可以指定不同页面的不同修改指令。

工具支持 4K / 2K / 1K 三档分辨率，可在质量与成本之间自由平衡。


工作原理概览


🔧 底层流程一图读懂


  1. 页面渲染

    ：使用 Poppler 将目标 PDF 页面转换为图片。

  2. 风格参考

    ：可通过

    --style-refs \"1,5\"

    指定页面，用作视觉风格参考。

  3. AI 生成

    ：将页面图片与自然语言指令一起发送给 Gemini 3 Pro Image。

  4. OCR 复写

    ：使用 Tesseract 将可搜索文字层重新写回新生成页面。

  5. PDF 组合

    ：用 AI 编辑后的页面替换原页面，保持文档结构不变。

整个过程在多页并行完成，兼顾速度与质量。


安装与环境要求


📦 快速安装

支持通过 Python 生态或现代工具链安装：

  • 使用 pip：

    pip install nano-pdf
  • 使用 uvx：

    uvx nano-pdf edit my_deck.pdf 2 \"Your edit here\"


🔑 必需配置：Google Gemini API

Nano PDF 依赖 Gemini 3 Pro Image，因此需要：

  • 一个已开通计费的 Google Gemini API 密钥（免费层不支持图像生成功能）
  • 在 Google AI Studio 获取 API Key
  • 在自己的 Google Cloud 项目中启用计费
  • 将 API Key 配置为环境变量：

    export GEMINI_API_KEY=\"your_api_key_here\"

工具还提供

--disable-google-search

选项，用于禁止模型在生成前使用 Google 搜索能力。


核心命令示例


🎯 单页编辑

编辑单页标题或文案，例如修改第 2 页标题： 

nano-pdf edit my_deck.pdf 2 \"Change the title to \'Q3 Results\'\"


📚 多页批量修改

一条命令中修改多个页面的不同元素： 

nano-pdf edit my_deck.pdf \\
  1 \"Update date to Oct 2025\" \\
  5 \"Add company logo\"


📈 插入新幻灯片

在开头添加标题页，或在中间插入总结页： 

# 在开头插入标题页
nano-pdf add my_deck.pdf 0 \"Title slide with \'Q3 2025 Review\'\"

# 在第 5 页后插入总结页
nano-pdf add my_deck.pdf 5 \"Summary slide with key takeaways as bullet points\"

支持通过

--output \"new.pdf\"

指定输出文件名，以及通过

--use-context / --no-use-context

控制是否将整份 PDF 文本作为上下文，提高生成精准度。


适合人群与使用场景


👨‍💻 谁适合使用 Nano PDF？

  • 经常改版 Pitch Deck 的创始人、投融资团队
  • 持续更新汇报文档的产品经理、运营、市场负责人
  • 需要快速修订图表和文字的分析师、顾问
  • 偏爱命令行、希望自动化报告生成流程的开发者


📌 典型使用场景

  • 给老的融资 BP 全面“焕新”一版
  • 批量修正日期、Logo、页脚、免责声明等信息
  • 为季度汇报快速补充“总结页”“关键指标页”
  • 在 CI/CD 流程中自动生成或更新 PDF 报告


Nano PDF 项目地址

GitHub地址：

https://github.com/gavrielc/Nano-PDF