更新提醒：如果你当前使用的程序是2025年3月18日之前下载的，强烈建议根据获取更新来更新程序，该版本集中处理了大量问题。
autoContents 是一款专为扫描版 PDF 设计的书签全自动生成工具，能够基于目录页内容创建可跳转书签。如果想先看看该工具的实际表现情况，请点击这里。
该工具支持单栏、双栏及混合排版的目录结构，适用于扫描质量合格（页面倾斜度 ≤2°，文字清晰度满足 OCR 识别要求）的 PDF 文档。适用的文档长度无理论上限，实测 500+ 页可稳定生成，更高的还未测试。
- 如果你会用
git clone命令，请将仓库克隆到本地：
git clone https://github.com/NatsUIJM/autoContents.git
- 如果你不会
git clone命令，请点击页面顶部的绿色按钮Code，然后点击Download ZIP以下载程序源码。
在 95% 以上的测试样本中，阿里云能够提供稳定且优质的服务，足以满足大多数需求。因此建议优先完成阿里云相关服务的申请。仅在生成结果质量严重低于预期时，再考虑使用 Azure 作为补充方案。点此查看全部教程。
- 右键点击
setup_documents文件夹中的windows_install.bat，选择“以管理员身份运行”，等待脚本运行完成。 - 双击打开
setup_documents文件夹中的windows_setup_api_keys.bat，并按要求配置。
- 打开“终端”APP，输入
chmod +x（注意最后面有空格；注意是+x不是-x），然后将setup_documents文件夹中的macos_install.sh和macos_setup_api_keys.sh文件拖入终端窗口，按return。 - 将
macos_install.sh文件拖入终端窗口，按return，然后根据提示进行安装。- 如果未安装
Xcode CLI Tools，会先安装该程序，安装完成后请重新运行该脚本，进行后续步骤。 - 输入密码时，输入的内容并不会显示在屏幕上，输入完成后按
return即可。
- 如果未安装
- 重新打开“终端”APP，输入
sudo（注意最后面有空格），然后再将macos_install.sh文件拖入终端窗口，按return，等待脚本执行完成。 - 输入
sudo zsh，将macos_setup_api_keys.sh文件拖入终端窗口，按return，并按要求配置。
- 双击根目录下的
windows_start.bat或macos_start.command来启动程序，浏览器界面会自动打开。 - 如果浏览器未打开，请在弹出的命令行窗口中找到
http://127.0.0.1:5xxx，并复制到浏览器以打开。
- 点击“选择PDF文件”，然后选择需要处理的 PDF 文件。
- 填写 PDF 数据：目录起始页指的是目录的第一页是 PDF 文件的第几页；目录结束页指的是目录的最后一页是 PDF 文件的第几页；正文偏移量是指 PDF 页码与实际页码的差值，比如书籍的第 10 页是 PDF 文件的第 20 页，那么该值为 20 - 10 = 10。
- 点击“开始执行”，等待进度条走完，浏览器会自动下载带有书签的 PDF 文件。
该项目提供简易的书签编辑工具，可使用contents_editor中的脚本对 PDF 文件的书签进行编辑，使用方法如下：
- 将需要编辑的 PDF 文件放入
contents_editor文件夹中； - 运行
windows_extract.bat或macos_extract.command脚本，进行目录提取； - 使用
Microsoft Excel，Numbers，VSCode或其他任何可编辑csv文件的软件编辑生成的csv文件：如果需要添加条目，那么插入一行；如果需要删除条目，那么删除对应行；如果只需要修改条目，那么修改对应行； - 保存并关闭
csv文件，然后再运行windows_merge.bat或macos_merge.command脚本，将修改后的目录与 PDF 文件合并； - 该目录下的
*_edited.pdf文件即为处理后的 PDF 文件。
请阅读常见问题解答进行问题排查。
- 点击页面顶部的绿色按钮
Code，然后点击Download ZIP以下载程序源码； - 将下载的
autoContents-main文件夹中的全部内容覆盖到本地autoContents-main文件夹中； - 重新运行
2.2.1的第1步或2.2.2的1-3步。