pdf-toc-editor

KO | EN

gitlite — search

#hacktoberfest #react #llm #golang #machine-learning #deep-learning #macos #windows #awesome #kubernetes #pytorch #mcp #ios #openai

(★ 11)

pdf目录生成

pdf-toc-editor Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PDF Marker | 智能 PDF 目录编辑器

一个现代、纯净且高效的 PDF 目录（书签）工作台。支持智能自动扫描和灵活的手动编辑，助您快速为 PDF 文档构建完美的索引体系。

![Dashboard Preview](https://raw.githubusercontent.com/jiangnan1224/pdf-toc-editor/main/imgs/Snipaste_2026-01-18_21-01-52.png)

## ✨ 核心特性

- 🤖 **智能目录提取**：内置高精度算法，一键扫描文档前页并自动识别潜在层级结构。
- 🧠 **AI 视觉解析 (NEW)**：集成 OpenAI 兼容多模态模型，支持**扫描版 PDF** 的图片级目录还原。
- 🖱️ **自由拖拽排序**：支持通过手柄直接拖拽调整目录顺序，所见即所得。
- 📐 **多层级支持**：支持三级目录结构（章、节、点），轻松应对复杂文档。
- 🔢 **页码偏置修正**：内置**页码计算器**，自适应纸质页码与电子页码的偏差，确保跳转精准无误。
- 📁 **本地化存储**：尊重隐私，文件处理完成后自动清理服务器残留。

![AI OCR Preview](https://raw.githubusercontent.com/jiangnan1224/pdf-toc-editor/main/imgs/Snipaste_2026-01-19_18-07-57.png)

![Editor Preview](https://raw.githubusercontent.com/jiangnan1224/pdf-toc-editor/main/imgs/Snipaste_2026-01-18_21-02-23.png)

### 配置 AI 环境变量 (可选)
  
项目支持配置默认的 LLM 模型设置（适配 OpenAI 兼容格式）。配置后，用户在前端可直接使用“内置配置”。

#### 本地开发
在项目根目录创建 `.env` 文件：
```env
LLM_API_KEY=your_key_here
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-4o
```

#### Docker 部署
通过 `-e` 参数注入环境变量：
```bash
docker run -d \
  -p 5000:5000 \
  -e LLM_API_KEY=sk-xxxx \
  -e LLM_BASE_URL=https://api.openai.com/v1 \
  -e LLM_MODEL=gpt-4o \
  --name pdf-toc-editor \
  ghcr.io/jiangnan1224/pdf-toc-editor:latest
```

## 🚀 快速开始

### 本地运行

1. **克隆仓库**
   ```bash
   git clone https://github.com/jiangnan1224/pdf-toc-editor.git
   cd pdf-editor
   ```

2. **安装依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. **启动服务**
   ```bash
   python app.py
   ```
   访问 `http://127.0.0.1:5000` 即可开始使用。

### Docker 部署

1. **拉取镜像** (推荐)
   ```bash
   docker pull ghcr.io/jiangnan1224/pdf-toc-editor:latest
   ```

2. **运行容器**
   ```bash
   docker run -d -p 5000:5000 --name pdf-toc-editor ghcr.io/jiangnan1224/pdf-toc-editor:latest
   ```
   访问 `http://localhost:5000`。

## 🛠️ 技术栈
 
- **后端**: Python (Flask), pypdf, PyMuPDF, OpenAI SDK
- **前端**: HTML5, Vanilla JavaScript, Tailwind CSS (Style Engine), SortableJS
- **容器化**: Docker, GitHub Actions (CI/CD)

## ⚖️ 许可

[MIT License](LICENSE)

pdf-toc-editor

pdf-toc-editor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

pdf-toc-editor

pdf-toc-editor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README