renamed inage_split to image_prepare, fixed some code and parameters

.ai/ARCHITECTURE.md

@@ -14,7 +14,7 @@ ocr/
 html/
     генерация HTML
 
-cli.py → image_split.py
+cli.py → image_prepare.py
 
 Этапы:
 1. Input

README.md

@@ -22,7 +22,7 @@
 JPEG/TIFF/PNG (многостраничный скан)
     │
     ▼
-src/image_split.py          ← Stage 1: разрезание
+src/image_prepare.py        ← Stage 1: подготовка (разрезание, обрезка)
     │ --slice / --slice-auto
     │ --pre-rotate, --border
     │ --post-crop
@@ -31,7 +31,7 @@ src/image_split.py          ← Stage 1: разрезание
 JPEG страницы
     │
     ▼
-src/image_ocr.py           ← Stage 2: OCR + Markdown (бывший image_to_latex.py)
+src/image_ocr.py           ← Stage 2: OCR + Markdown
     │ --ocr-engine paddle|surya
     │ --input file.jpg         (одна страница)
     │ --input pages/           (пакетный режим: все изображения в каталоге)
@@ -52,7 +52,7 @@ src/image_ocr.py           ← Stage 2: OCR + Markdown (бывший image_to_la
 
 ## Параметры
 
-### Stage 1: `src/image_split.py`
+### Stage 1: `src/image_prepare.py`
 
 | Параметр | Описание | По умолчанию |
 |----------|----------|:---:|
@@ -66,10 +66,58 @@ src/image_ocr.py           ← Stage 2: OCR + Markdown (бывший image_to_la
 
 Пример:
 ```bash
-python -m src.image_split -i scan.jpg -s 3:3 -b 10 -o pages/
-python -m src.image_split -i scan.jpg --slice-auto
+python -m src.image_prepare -i scan.jpg -s 3:3 -b 10 -o pages/
+python -m src.image_prepare -i scan.jpg --slice-auto
 ```
 
+<details>
+<summary><code>--help</code></summary>
+
+```
+ Usage: python -m src.image_prepare [OPTIONS]
+
+ Подготовить отсканированное изображение: разрезать по сетке, обрезать,
+ добавить рамку.
+
+╭─ Options ────────────────────────────────────────────────────────────────────╮
+│ --input       -i                    <file>              Путь к входному      │
+│                                                         изображению (JPEG,   │
+│                                                         PNG, TIFF)           │
+│ --slice       -s                    <str>               Размер сетки в       │
+│                                                         формате              │
+│                                                         <колонки>:<строки>,  │
+│                                                         например 3:2         │
+│ --slice-auto  -a                                        Автоматически        │
+│                                                         определить размер    │
+│                                                         сетки по содержимому │
+│                                                         изображения          │
+│ --output-dir  -o                    <directory>         Каталог для          │
+│                                                         сохранения           │
+│                                                         результатов (по      │
+│                                                         умолчанию — текущий) │
+│                                                         [default: .]         │
+│ --pre-rotate  -r                    <int>               Поворот изображения  │
+│                                                         перед разрезанием:   │
+│                                                         90, 180 или 270      │
+│ --border      -b                    <int range> [x>=0]  Отступ в пикселях    │
+│                                                         (белая рамка /       │
+│                                                         отступ при обрезке   │
+│                                                         содержимого, по      │
+│                                                         умолчанию 50)        │
+│                                                         [default: 50]        │
+│ --post-crop   -c  --no-post-crop                        Обрезать каждую      │
+│                                                         страницу по границам │
+│                                                         полезного            │
+│                                                         содержимого          │
+│                                                         (включено по         │
+│                                                         умолчанию)           │
+│                                                         [default: post-crop] │
+│ --help                                                  Show this message    │
+│                                                         and exit.            │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+</details>
+
 ### Stage 2: `src/image_ocr.py`
 
 | Параметр | Описание | По умолчанию |
@@ -104,6 +152,58 @@ python -m src.image_ocr -i ./pages/ --ocr-engine surya --no-result-one-document
 python -m src.image_ocr -i page.jpg --ocr-engine paddle --fix-by-llm
 ```
 
+<details>
+<summary><code>--help</code></summary>
+
+```
+ Usage: python -m src.image_ocr [OPTIONS]
+
+ OCR → PostProcess → Markdown. Принимает файл или каталог изображений.
+
+╭─ Options ────────────────────────────────────────────────────────────────────╮
+│ *  --input               -i      <path>                Путь к входному       │
+│                                                        изображению или       │
+│                                                        каталогу (JPEG, PNG,  │
+│                                                        TIFF)                 │
+│                                                        [required]            │
+│ *  --ocr-engine                  <str>                 OCR-движок: paddle    │
+│                                                        (PP-StructureV3),     │
+│                                                        surya (Surya 2 VLM)   │
+│                                                        или external-qwen3    │
+│                                                        (Qwen3.8 Max API)     │
+│                                                        [required]            │
+│    --output-dir          -o      <directory>           Каталог для           │
+│                                                        сохранения            │
+│                                                        результатов (по       │
+│                                                        умолчанию — рядом с   │
+│                                                        входным файлом)       │
+│    --fix-by-llm                                        Исправить OCR-ошибки  │
+│                                                        локальным LLM         │
+│                                                        (Qwen2.5-7B). Не      │
+│                                                        работает с            │
+│                                                        --ocr-engine          │
+│                                                        external-qwen3        │
+│    --fix-by-external-q…                                Исправить OCR-ошибки  │
+│                                                        внешней VLM (Qwen3.8  │
+│                                                        Max, API). Не         │
+│                                                        работает с            │
+│                                                        --ocr-engine          │
+│                                                        external-qwen3        │
+│    --no-result-one-doc…                                Не объединять .md     │
+│                                                        результаты в один     │
+│                                                        документ              │
+│                                                        [default: True]       │
+│    --pause                       <int range>           Пауза между           │
+│                                  [0<=x<=600]           изображениями в       │
+│                                                        секундах (по          │
+│                                                        умолчанию 5)          │
+│                                                        [default: 5]          │
+│    --help                                              Show this message and │
+│                                                        exit.                 │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+</details>
+
 ### Debug-лог
 
 Для отладки зависаний и падений — файл с полным логом всех этапов обработки.
@@ -255,8 +355,8 @@ llama-server не указывает количество потоков — п
 
 ```
 src/
-  image_split.py         — CLI Stage 1
-  image_ocr.py          — CLI Stage 2 (бывший image_to_latex.py)
+  image_prepare.py      — CLI Stage 1
+  image_ocr.py          — CLI Stage 2
   split/slicer.py        — разрезание, post-crop
   ocr/
     paddle_engine.py     — PP-StructureV3

installation.md

@@ -73,16 +73,16 @@ cp .env.dist .env
 
 ```bash
 # Stage 1
-python -m src.image_split --help
+python -m src.image_prepare --help
 
 # Stage 2 — PaddleOCR
-python -m src.image_ocr -i test.jpg
+python -m src.image_ocr -i test.jpg --ocr-engine paddle
 
 # Stage 2 — Surya
 python -m src.image_ocr -i test.jpg --ocr-engine surya
 
 # Stage 2 — с LLM-корректором
-python -m src.image_ocr -i test.jpg --llm
+python -m src.image_ocr -i test.jpg --ocr-engine paddle --fix-by-llm
 ```
 
 ---

src/image_split.py → src/image_prepare.py

@@ -144,7 +144,7 @@ def slice_pages(
         ),
     ] = True,
 ) -> None:
-    """Разрезать отсканированное изображение на отдельные страницы по геометрической сетке."""
+    """Подготовить отсканированное изображение: разрезать по сетке, обрезать, добавить рамку."""
     input_path = _validate_input(input)
     _validate_rotation(pre_rotate)
     cols, rows = _resolve_grid(slice, slice_auto, input_path, pre_rotate)

stage2_results.md

@@ -88,7 +88,7 @@
 Входное изображение (JPEG/PNG/TIFF)
     │
     ▼
-src/image_split.py          ← Stage 1: разрезание
+src/image_prepare.py          ← Stage 1: разрезание
     │ --slice / --slice-auto
     │ --border, --post-crop
     │
@@ -121,7 +121,7 @@ src/image_ocr.py            ← Stage 2: OCR + Markdown
 
 ```
 src/
-  image_split.py         — CLI Stage 1
+  image_prepare.py         — CLI Stage 1
   image_ocr.py           — CLI Stage 2
   cli_utils.py           — run_main()
   env.py                 — загрузка .env