autoContents

项目概述

autoContents 是一款专为扫描版 PDF 设计的书签全自动生成工具，能够基于目录页内容创建可跳转书签。上传 PDF 文档后无需进行任何其他操作，等待 1 分钟左右即可获取处理结果。 如果想先看看该工具的实际表现情况，请点击这里。

适用文档

适用于全部自带目录页面的中英文文档。

Step 1 下载程序

请点击页面顶部的绿色按钮Code，然后点击Download ZIP以下载程序源码。

Step 2 配置环境

2.1 申请通义千问 API-KEY

1. 注册账号：如果没有阿里云账号，请先注册一个。
2. 实名认证：参考实名认证文档对阿里云账号进行实名认证。
3. 获取 API Key：前往百炼控制台（API-KEY管理）然后创建一个 API-KEY。
4. 如果你有高校学生或教师身份，可前往阿里云高校计划申请一些优惠。具体政策以该网页为准。

2.2 配置运行环境

Windows

1. 点击这里下载Python安装程序。下载完成后双击打开，然后按照下图依次操作：勾选Add python.exe to PATH -> 点击Install Now -> 安装完成后，点击Close。

1. 双击根目录下的windows_install.bat，直到运行完成（Setup complete.）。

macOS

1. 点击这里下载Python安装程序。下载完成后直接安装即可。
2. 打开“终端”APP，输入chmod +x（注意最后面有空格），然后将macos_install.command文件拖入终端窗口，按return。

Step 3 使用方法

3.1 运行程序

1. 双击根目录下的windows_start.bat或macos_start.command来启动程序，浏览器界面会自动打开。
2. 如果浏览器未打开，请在弹出的命令行窗口中找到http://127.0.0.1:5xxx，并复制到浏览器以打开。
3. 将百炼控制台（API-KEY管理）获取的API-KEY填入LLM配置管理的API 密钥栏中，然后点击保存 LLM 配置。

3.2 上传 PDF 并处理

1. 点击“选择PDF文件”，然后选择需要处理的 PDF 文件。
2. 点击“开始执行”，等待进度条走完，浏览器会自动下载带有书签的 PDF 文件。
3. 关于结果：
   1. 如果效果不错，请前往页面右上方，为这个项目增加一个Star，谢谢！
   2. 如果目录层级有误，请参见下方的编辑书签条目，或者使用自己的PDF编辑器进行相关操作。
   3. 如果运行出现问题，请参见下方的疑难解答以进行问题排查。

编辑书签

该项目提供简易的书签编辑工具，可使用contents_editor中的脚本对 PDF 文件的书签进行编辑，使用方法如下：

1. 将需要编辑的 PDF 文件放入contents_editor文件夹中；
2. 运行windows_extract.bat或macos_extract.command脚本，进行目录提取；
3. 使用Microsoft Excel，VSCode或其他任何可编辑csv文件的软件编辑生成的csv文件：如果需要添加条目，那么插入一行；如果需要删除条目，那么删除对应行；如果只需要修改条目，那么修改对应行；
4. 保存并关闭csv文件，然后再运行windows_merge.bat或macos_merge.command脚本，将修改后的目录与 PDF 文件合并；
5. 该目录下的*_edited.pdf文件即为处理后的 PDF 文件。

MCP 服务器（可选，供 AI Agent 调用）

autoContents 也可作为 MCP（Model Context Protocol）服务器运行，让 AI 编程助手（如 Cherry Studio、Claude Desktop）直接调用书签生成能力。

安装 uv

uv 是 Python 的快速包管理器，也是 MCP 服务器的运行环境。

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

配置 MCP 客户端

将以下 JSON 添加到你的 MCP 客户端配置文件中（路径按实际情况修改）：

{
  "mcpServers": {
    "autoContents": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/autoContents",
        "python",
        "/path/to/autoContents/mcp_server.py"
      ],
      "env": {
        "AUTOCONTENTS_API_KEY": "sk-xxx",
        "AUTOCONTENTS_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "AUTOCONTENTS_MODEL": "qwen3.7-plus"
      }
    }
  }
}

字段	说明
command	固定为 uv，需先完成上一步的安装
args 中的路径	将 /path/to/autoContents 替换为项目实际路径
AUTOCONTENTS_API_KEY	必填，替换为你的百炼 API Key
AUTOCONTENTS_BASE_URL	可选，默认为百炼兼容接口
AUTOCONTENTS_MODEL	可选，默认为 qwen3.5-397b-a17b

配置完成后重启客户端，即可使用 generate_pdf_bookmarks 和 check_llm_config 两个工具。

更新日志

更新提醒：最新版本是2026年7月26日发布的，你可以根据获取更新来更新程序。

10月13日的版本对识别逻辑进行了完全重构，可实现任意版面结构的目录数据提取，同时处理速度提升50%，且进一步简化了配置流程；12月2日的版本支持直接在前端进行提示词修改；3月25日发布的版本支持自定义LLM服务；3月29日发布的版本增加了使用LLM对下载文件进行重命名的功能，特别鸣谢@Little-White3110提出的建议；4月4日发布的版本实现的全自动目录提取。4月6日的版本对项目结构再次进行大量重构，解决了很多细节问题。7月26日的版本增加了uv和MCP支持。

获取更新

1. 点击页面顶部的绿色按钮Code，然后点击Download ZIP以下载程序源码；
2. 将下载的autoContents-main文件夹中的全部内容覆盖到本地autoContents-main文件夹中；
3. 重新运行2.2.1的第1步或2.2.2的1-3步。

Star History