Пакетный органайзер библиотеки романов

# Руководство по использованию пакетного органайзера библиотеки романов

## Обзор

Novel Library Batch Organizer предназначен для упорядочивания неорганизованных локальных коллекций китайских романов в формате TXT. Он позволяет преобразовывать текстовые файлы в UTF-8, классифицировать документы по качеству, стандартизировать структуру глав, очищать форматирование и проверять результаты после обработки.

Он подходит для коллекций текстовых файлов романов с различными кодировками, несогласованными форматами заголовков глав, неупорядоченным форматированием абзацев или необходимостью пакетной проверки качества.

## Возможности по упорядочиванию

- **Стандартизация кодировки**: преобразование текстовых файлов в UTF-8 для сокращения различий в кодировках файлов TXT из разных источников.
- **Классификация по качеству**: сканирование и классификация документов по качеству для выявления файлов, требующих дальнейшей обработки.
- **Стандартизация глав**: распознавание, сопоставление, замена и перенумерация глав для унификации их структуры.
- **Базовая очистка**: устранение распространённых нарушений форматирования и улучшение компоновки текста.
- **Проверка результатов**: проверка обработанных результатов после завершения упорядочивания.

## Рекомендуемый рабочий процесс

### 1. Подготовьте библиотеку романов в формате TXT

Убедитесь, что обрабатываемые материалы представляют собой локальные файлы китайских романов в формате TXT, и определите, для каких файлов требуется стандартизация кодировки, упорядочивание глав или очистка форматирования.

### 2. Выполните предварительную обработку кодировок, затем сканирование и классификацию

Сначала выполните предварительную обработку кодировок, а затем сканирование и классификацию документов по качеству. Инструментарий содержит `preprocess_encoding.py` и `scan_and_classify.py` для предварительной обработки кодировок и классификации на основе сканирования соответственно.

### 3. Стандартизируйте главы

Для текстовых файлов с несогласованными заголовками глав или последовательностями глав, требующими корректировки, используйте процессы сопоставления, замены и перенумерации глав. Инструментарий содержит `auto_chapter_map.py`, `chapter_replace.py` и `renumber.py`; правила для глав приведены в `references/chapter_patterns.md`.

### 4. Очистите форматирование основного текста

Используйте процесс базовой очистки для устранения распространённых проблем форматирования текста. Инструментарий содержит `clean_basic.py` и справочный файл с шаблонами загрязнений `references/pollution_patterns.md`.

### 5. Проверьте упорядоченные результаты

После обработки кодировки, глав и форматирования воспользуйтесь процессом проверки результатов. Инструментарий содержит `validate.py` для проверки упорядоченных выходных данных.

## Связанные ресурсы

Инструментарий включает следующие вспомогательные ресурсы:

- Справочник по обработке кодировок: `references/encoding_guide.md`
- Справочник по шаблонам глав: `references/chapter_patterns.md`
- Справочник по шаблонам загрязнений: `references/pollution_patterns.md`
- Шаблоны запросов для очистки, обработки глав и проверки: каталог `templates/`
- Скрипты для отслеживания прогресса и разбиения на фрагменты: `progress_manager.py`, `merge_progress.py`, `split_chunks.py`

Репозиторий навыка:
https://github.com/jy02534655/ux-skill/tree/8dae19f37c0c9925871fb752b7df3612d27bdfac/skills/novel-formatter

## Информация, которую необходимо уточнить перед использованием

Доступные материалы не содержат конкретных команд, параметров, правил для входных и выходных каталогов или стратегий обработки для каждого скрипта. Перед началом пакетной обработки запросите у сопровождающего инструкции по работе из `SKILL.md` или уточните область целевых файлов, стандарты оформления глав и требования к проверке.