nano-pdf

nano-pdf 是什么

nano-pdf 是围绕 nano-pdf 命令行工具编写的轻量 Skill，让代理用自然语言描述对 PDF 某一页的修改，例如替换文字、调整排版或修正页面元素。它把复杂 PDF 编辑压缩成“输入文件、页码、指令”三项，但并不保证所有版式都能无损重建。

适用场景与不适用场景

适合小范围、可目视验证的单页修订和快速原型。不适合批量合规脱敏、数字签名保全、表单字段工程或要求像素级不变的印刷文件。扫描 PDF、复杂字体、透明图层和矢量图可能需要专业工具。

核心能力与工作机制

核心调用形式是对 PDF、页码和自然语言指令执行 edit。上游特别提醒不同版本或配置可能采用从 0 或从 1 开始的页码；若目标错页，应停止并用另一种索引重试。每次输出都必须打开检查，不能只依据命令成功状态。

实际工作流与产物

先复制原文件并记录页数，选择单页做小改动；执行后渲染或打开目标页，对照文字、字体、图像、裁切和其他页面。确认无误再处理下一页。若页码偏移，先纠正索引；若版式破坏，回到备份并缩小指令。

安装、依赖与权限

需要安装 nano-pdf 二进制，上游建议通过 uv 安装对应包。它需要读取输入 PDF 并写出修改结果，不要求在线账号。实际模型或后端依赖应以当前 nano-pdf 版本说明为准，导航条目不假设离线能力。

限制、风险与使用建议

PDF 编辑可能覆盖内容、改变字体或导致不可见元素丢失；页码基准不一致会改错页。应始终保留原件、使用新输出路径并逐页复核。含隐私、合同或签名的文件不要上传到未知服务，先确认工具的数据处理方式。

上手建议

先用一句只包含一个目标的指令测试，例如修改标题而不改变其他元素。结果应检查目标页和相邻页，并用文本提取或视觉比较验证。高价值文件在人工批准前不要替换原件。

来源、版本与许可

依据 ClawHub 页面和 1.0.0 完整 Skill 整理，页面声明 MIT-0，并显示自动审核 Pass；审核标记只代表平台扫描结果。

常见问题

1. 需要安装什么？

需要可执行的 nano-pdf 命令，上游建议通过 uv 安装 nano-pdf 包。安装后先查看帮助和版本，确认 edit 子命令与参数，再对副本进行测试。

2. 页码从 0 还是 1 开始？

上游明确说可能因版本或配置而不同。第一次应使用无风险副本核对目标页；发现偏一页就停止，不要连续试写原文件，再改用另一种索引。

3. 命令成功就代表编辑正确吗？

不代表。成功状态只能说明流程完成，文字位置、字体、裁切或目标页仍可能错误。必须打开或渲染输出，对照原件逐页检查。

4. 会覆盖原 PDF 吗？

具体输出行为取决于当前工具版本，不能凭 Skill 摘要假设。安全做法是先复制原件、指定新输出并确认文件差异，重要文档还要保留只读备份。

5. 适合扫描件吗？

扫描 PDF 本质上是图像，文字修改可能先需要 OCR，且版面恢复难度更高。先在一页测试识别准确度，无法稳定时改用专业 OCR/PDF 工作流。

6. 可以批量修改很多页吗？

可以逐页调用，但该 Skill 的安全模式更适合小步处理。批量前先验证一页和页码规则，限制并发，并为每批保留输出和检查记录。

7. 敏感文件如何处理？

先核查 nano-pdf 当前后端是否联网、数据发往何处及保留政策。合同、身份证明和财务文件不应在未知数据路径中使用，必要时选择本地受控工具。

8. 什么情况下应换专业工具？

需要签名完整性、表单字段、批量脱敏、印刷色彩或像素级版面时，应使用专门 PDF 软件并建立复核流程；自然语言编辑不适合作为唯一保障。