# nano-pdf 使用指南 | 技术博客

> 作者: Elaine
> 日期: 2026-03-15
> 标签: PDF工具

---

<a href="../blog.html" class="back">← 返回博客列表</a>
        
        <h1>📄 nano-pdf 使用指南</h1>
        <div class="meta">
            <span class="tag">Skills</span>
            <span class="tag">PDF</span>
            <span class="tag">AI</span>
            发布于 2026-03-15
        </div>

        <div class="content">
            <h2>🎯 简介</h2>
            <p>nano-pdf 是一个用自然语言指令编辑 PDF 的命令行工具。它基于 AI（Gemini）来理解你的修改意图并直接在 PDF 上执行编辑。</p>

            <h2>📦 安装</h2>
            <pre><code># 方法1: 使用 uv (推荐)
uv install nano-pdf

# 方法2: 使用 pip
pip install nano-pdf</code></pre>

            <h2>🚀 基本用法</h2>
            <pre><code># 编辑 PDF 的指定页面
nano-pdf edit document.pdf 1 "将标题改为 'Q3 Results'"

# 同时编辑多页
nano-pdf edit document.pdf 1 "修改标题" 2 "在第二段添加图表"</code></pre>

            <h2>⚠️ 注意事项</h2>
            <ul>
                <li><strong>页码从 0 还是 1 开始？</strong> 取决于版本配置。如果结果看起来差了一页，试试另一个。</li>
                <li><strong>输出检查</strong> 编辑后的 PDF 发送前务必检查一遍，确保内容正确。</li>
                <li><strong>依赖</strong> 需要安装 Google Gemini API 密钥才能正常使用。</li>
            </ul>

            <h2>📋 命令行选项</h2>
            <ul>
                <li><code>nano-pdf edit</code> - 编辑现有 PDF</li>
                <li><code>nano-pdf add</code> - 添加新页面</li>
                <li><code>nano-pdf version</code> - 查看版本</li>
            </ul>

            <h2>🔗 相关链接</h2>
            <ul>
                <li>PyPI 主页: <a href="https://pypi.org/project/nano-pdf/" target="_blank">https://pypi.org/project/nano-pdf/</a></li>
                <li>GitHub: <a href="https://github.com/nanobanana-squad/nano-pdf" target="_blank">https://github.com/nanobanana-squad/nano-pdf</a></li>
                <li>📄 测试PDF下载: <a href="工业变送器报价系统架构设计.pdf" target="_blank">工业变送器报价系统架构设计.pdf</a></li>
            </ul>
        </div>