AI 生成的长 PDF 翻页很费劲，怎样补一份能直接跳章节的书签目录

先列出人工确认的章节名称、层级和物理页号，再把它们写入PDF书签，另存新文件后逐条回读目标。书签能改善导航，但不会自动判断AI报告中的章节内容是否正确，也不能用印刷页码直接替代PDF页索引。

封面会改变页号对应关系

附件生成五页PDF，第一页是封面，第一部分从物理第2页开始。某份真实报告正文可能标“第1页”，却因为封面和前言位于PDF的第5页。chapter-map.csv明确使用从1开始的物理页号，转换时按照PyMuPDF接口约定传入，不混用从零开始的内部下标。输入章节表应先由人打开原PDF确认，不让模型凭目录文字猜页数。

两级书签保持合理层次

本例第一部分指向第2页、细节指向第3页，第二部分与其细节分别指向第4、5页。层级只能从一级逐步进入二级，不能没有父项就直接跳四级。脚本写入新文件report-with-bookmarks.pdf，原report.pdf保持不变。使用前可先编辑章节CSV，把标题改成实际文稿名，再重新生成；标题与页目标需要分别核对。

重新打开检查导航目标

生成后脚本用本地PDF工具重开文件，保存bookmark-readback.json，四条书签应与输入一致。读者还应在常用阅读器里展开书签面板，依次点击四项，确认跳到预期章节，而不是只查看JSON。不同阅读器的侧栏可能默认关闭，文件里有书签不保证打开时立刻展示侧栏；这属于阅读器界面选择。

越界与错章分开处理

失败命令将二级改为四级，程序应在写文件前停止；目标页超出五页范围也不能接受。即使目标没有越界，也可能指向内容错误的那一页，所以技术检查之后仍要人工阅读章节开头。若报告后续插页，旧书签目标可能整体偏移，应依据新版本重建。这个包使用原创合成PDF，未调用模型或修改旧站文章，也不是在线PDF工具的新增功能；它提供可在自己的文件副本上复用的本地流程。

多人修订报告时，应确认章节表指向的PDF版本与最终交付文件相同。内容页插入一张空白页就会改变后续物理目标，旧书签可能全部偏移；保留输入文件摘要与章节表，可以在重建前发现版本不匹配，而不是等读者逐项点击才发现。

下载与复现

下载完整样例包，解压到一个新文件夹；也可查看全部文件清单和主脚本。使用Python 3.10或更新版本，在解压目录运行。依赖写在安装清单，建议在自己创建的虚拟环境安装。

python -m pip install -r requirements.txt
python -B run.py
python -B run.py --negative

先查看主要结果，再修改输入重跑；已有输入会保留，结果写回同目录。边界命令可能故意非零退出，也可能输出明确的不适用状态，按正文说明判断，不把所有非零退出都当成安装故障。

依据与延伸阅读

资料核对日期为2026年10月24日。一手资料1：PyMuPDF的set_toc写入分层书签，get_toc可回读章节与物理页目标。

继续阅读：WorkBuddy 怎么从 PDF 里提取内容：抽正文、抽表格、批量抽字段的指令与验收；PDF 正文喂给 AI 总夹着页眉页脚，怎样生成可复核的干净阅读稿；AI 写好的长文怎样做成 EPUB：章节目录、图片和阅读顺序一起交付。