告别PDF阅读障碍：pdfdir让电子书导航不再繁琐

当你在数百页的PDF电子书中艰难翻找特定章节时，是否曾因缺少导航书签而倍感沮丧？无论是扫描版书籍还是文字版文档，没有目录导航都会严重影响阅读效率。pdfdir作为一款开源的PDF导航书签自动生成工具，正是为解决这一痛点而生，它能根据目录文本智能生成完整导航书签，让PDF阅读体验焕然一新。

📌 核心价值：让每本PDF都拥有专业导航

pdfdir通过自动化处理流程，将原本需要手动数小时的书签添加工作缩短至分钟级。无论是学术论文、技术文档还是电子书籍，只需简单三步，即可为任何PDF文件构建结构化导航系统，让文档查阅效率提升50%以上。

🔍 场景化解决方案：覆盖三大核心使用需求

学术研究场景：论文文献快速定位

功能对应：通过src/convert.py实现的多层级目录解析
操作流程：

1. 从论文目录页复制文本内容
2. 粘贴至工具文本框并设置页码偏移值
3. 点击生成按钮完成书签创建
   注意事项：学术论文通常有"引言""文献综述"等标准章节，建议保留原始层级结构

电子书阅读场景：扫描版书籍功能增强

功能对应：src/pdf/bookmark.py模块的书签层级构建
操作流程：

1. 从图书详情页获取目录文本
2. 调整识别到的标题层级（支持最多6级）
3. 生成带完整导航的新PDF文件
   注意事项：扫描版PDF需确认实际页码与目录页码是否一致

技术文档场景：API手册结构化导航

功能对应：src/gui/main_ui.py实现的可视化编辑界面
操作流程：

1. 导入技术文档PDF文件
2. 在树形视图中调整章节顺序
3. 预览确认后执行书签写入
   注意事项：技术文档建议保留"术语表""索引"等特殊章节

⚡ 核心技术亮点解析

智能识别引擎：自动区分标题层级与页码，通过文本模式匹配技术，即使复杂格式的目录也能精准解析。

高效PDF处理：基于src/pdf/pdf.py实现的轻量级PDF操作内核，在保持原始排版的同时，实现书签的快速插入与更新。

跨平台兼容性：使用PyQt5构建的GUI界面确保在Windows、macOS和Linux系统上均有一致表现，满足不同用户的操作习惯。

🛠️ 进阶使用技巧

命令行批量处理

通过run_cli.py实现无界面操作，适合批量处理多个PDF文件：
python run_cli.py -i input.pdf -t contents.txt -o 3
（参数说明：-i指定PDF文件，-t指定目录文本，-o设置页码偏移值）

自定义界面语言

修改src/language/目录下的语言文件，可添加新的界面语言或调整现有翻译，满足国际化使用需求。

目录文本预处理

对于格式混乱的目录文本，可先使用工具内置的"文本清洗"功能去除多余空行和特殊字符，提高识别准确率。

📚 开始使用指南

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/pd/pdfdir
2. 安装依赖：pip install -r requirements.txt
3. 启动应用：python run_gui.py

现在就用pdfdir为你的PDF文档添加专业导航吧！让每一次阅读都能直达目标章节，告别无意义的翻页操作。无论是学术研究、专业学习还是休闲阅读，pdfdir都能让PDF文档的使用体验提升到新高度。