regulation-extractor（调节提取器）

Regulation Extractor v3.0

从建筑工程规范PDF中提取条文，支持文字层提取和纯图片PDF的OCR识别，经过多轮清洗后输出高质量结构化数据。

工作流（完整Pipeline）

Step 1: 提取条文（文字层）

python scripts/extract_regulation.py <pdf_path> -o <output.json>

支持 --chapters <chapters.json> 自定义章节映射。 支持编号格式：3.1.2、3. 1. 2、4级编号 6.1.2.4，自动去除空格。

Step 2: OCR处理（纯图片PDF）

# 批量：自动检测0条文的JSON，仅OCR这些PDF
python scripts/ocr_batch.py <pdf_dir> <output_dir>

# 单文件
python scripts/ocr_batch.py <pdf_path> -o <output.json>

Step 3: 深度清洗（必做）

python scripts/deep_clean.py <output_dir>

一次性完成：

• ❌ 过滤符号表（2.2.x 类编号）
• ❌ 删除过短（<5字）和无中文条文
• ✅ 修复中英文粘连（自动插入空格）
• ✅ 切除末尾混入的章节标题
• ✅ 切分过长条文（>300字，按句号/分号智能切分，子条目编号如 3.1.2.a, 3.1.2.b）

Step 4: 清洗文本（向量化前必做）

python scripts/clean_json.py <output_dir>

去除 \ 换行符、页眉页脚垃圾（如 www.bzfxw.com、规范名称重复）。每条条文变成一段连续纯文本。

Step 5: 修复残留尾部垃圾

python scripts/fix_tails.py <output_dir>

更彻底地修复：

• 页码残留（—83— 等各种变体）
• 图表标题残留（图N xxx示意图）
• 规范名称重复
• 章节标题拼接

Step 6: 质量检查

python scripts/quality_check.py <output_dir>

输出每个PDF的质量报告：中英文粘连、符号表、末尾章节标题、过长、过短、OCR错误、无中文。

Step 7: 同步到飞书

python scripts/sync_to_bitable.py <output.json> \
  --app_token <APP_TOKEN> --table_id <TABLE_ID> \
  --app_id <APP_ID> --app_secret <APP_SECRET> \
  --delete_dupes

Step 8: 人工校验

重点检查：

• quality: ocr_error 的条文（OCR识别不准）
• 过长条文的切分点是否合理
• 术语定义中的中英文分隔

输出JSON结构

{
  "articles": {
    "3.0.1": {"id": "3.0.1", "chapter": "基本规定", "page": 11, "text": "...", "quality": "clean"},
    "5.3.2.a": {"id": "5.3.2.a", "chapter": "施工", "page": 45, "text": "（切分后的第一段）", "quality": "clean"},
    "5.3.2.b": {"id": "5.3.2.b", "chapter": "施工", "page": 45, "text": "（切分后的第二段）", "quality": "clean"}
  },
  "report": {"total": N, "clean": N, "ocr_error": N, "by_chapter": {...}, "missing": [...], "warnings": [...]}
}

脚本清单

技术要点

• 双图层处理：PDF有原文层和OCR层，优先保留原文层，过滤OCR乱码层
• OCR引擎：RapidOCR (ONNX)，离线运行，无需GPU，支持中英文
• 编号格式：支持 3.1.2、3. 1. 2、4级编号，自动去除空格
• 过长切分：按句号→分号逐级切分，子条目加后缀 .a .b .c
• 清洗Pipeline：5步递进式清洗，每步解决一类问题
• 数据质量：实测21个PDF，5865条条文，96.8%干净率

依赖

pip install PyMuPDF rapidocr-onnxruntime

• Python 3.10+

已知限制

• 部分PDF只有封面（如JGJ 162-2008仅3页），无法提取条文
• 条文编号非X.X.X格式的文件（如纯文本式实施细则）可能匹配不到
• OCR准确率依赖PDF图片质量，建议对 quality: ocr_error 的条文人审
• 约2%条文残留页码/章节标题噪声，对向量化检索影响极小

实测数据

历史版本