【亲测免费】 PDF Craft 项目使用与配置教程

1. 项目的目录结构及介绍

PDF Craft 项目主要包含以下目录和文件：

• docs/：存放项目文档。
• pdf_craft/：包含项目的核心代码，包括处理 PDF 文件的模块和类。
• scripts/：存放项目运行所需的脚本文件。
• tests/：存放项目测试代码。
• .gitignore：定义 Git 忽略的文件和目录。
• FIXME.md：记录项目中需要修复或改进的问题。
• LICENSE：项目许可证文件，本项目采用 AGPL-3.0 许可。
• MANIFEST.in：用于打包项目时包含特定文件。
• README.md：项目说明文件。
• README_zh-CN.md：项目说明文件的中文版本。
• requirements.txt：项目依赖的 Python 包列表。
• setup.py：项目安装脚本。
• test.py：项目测试脚本。

2. 项目的启动文件介绍

项目的启动主要通过 main.py 文件进行，该文件通常位于 pdf_craft/ 目录下。以下是启动文件的基本结构：

# main.py

# 导入必要的模块和类
from pdf_craft import PDFPageExtractor, MarkdownWriter

# 初始化 PDFPageExtractor
extractor = PDFPageExtractor(
    device='cpu',
    model_dir_path='/path/to/model/dir/path'
)

# 初始化 MarkdownWriter
with MarkdownWriter(markdown_path, 'images', 'utf-8') as md:
    for block in extractor.extract(pdf='/path/to/pdf/file'):
        md.write(block)

# 运行结果将在指定的 markdown_path 路径生成 .md 文件

在上述代码中，首先导入了项目所需的模块和类，然后初始化了 PDFPageExtractor 和 MarkdownWriter 对象，用于处理 PDF 文件并生成 Markdown 文件。

3. 项目的配置文件介绍

项目的配置主要通过 config.py 文件进行，该文件通常位于项目根目录。以下是配置文件的基本结构：

# config.py

# 定义项目全局配置
class Config:
    # 设定模型目录路径
    MODEL_DIR_PATH = '/path/to/model/dir/path'
    # 设定输出目录路径
    OUTPUT_DIR_PATH = '/path/to/output/files'
    # 设定分析目录路径
    ANALYSING_DIR_PATH = '/path/to/analysing/dir'
    # 设定 LLM 配置（如果有）
    LLM_KEY = 'sk-XXXXX'
    LLM_URL = 'https://api.deepseek.com'
    LLM_MODEL = 'deepseek-chat'
    LLM_TOKEN_ENCODING = 'o200k_base'

在上述配置文件中，定义了项目运行所需的目录路径和 LLM 配置。这些配置可以根据实际情况进行调整，以适应不同的运行环境。在项目运行时，这些配置将被加载并使用。