| name | finish-es_latam-audiobook |
| description | Финализация аудиокниги ru→es_latam. Проверяет что ВСЕ переводы готовы, генерирует TTS, комбинирует аудио, ищет фоновую картинку, создаёт видео. Использовать ТОЛЬКО после завершения claude-translation-pipeline-es_latam. |
Finish es_latam Audiobook
⚠️ КРИТИЧЕСКИЕ ТРЕБОВАНИЯ
1. ПЕРЕВОДИТЬ НЕЛЬЗЯ!
❌ ЗАПРЕЩЕНО: Переводить предложения или слова
❌ ЗАПРЕЩЕНО: Изменять таблицы sentences/rare_words
✅ РАЗРЕШЕНО: Только чтение из БД + генерация audio/video
2. Предварительная проверка (ОБЯЗАТЕЛЬНО!)
Перед ЛЮБЫМИ действиями выполни:
import sqlite3
db = sqlite3.connect('projects/PROJECT_ru_es_latam/project.db')
# Проверить ВСЕ предложения переведены
missing = db.execute('''
SELECT COUNT(*) FROM sentences WHERE lang="ru"
AND sentence_idx NOT IN (SELECT sentence_idx FROM sentences WHERE lang="es_latam")
''').fetchone()[0]
# Проверить ВСЕ слова переведены
missing_words = db.execute('''
SELECT COUNT(*) FROM rare_words WHERE translation IS NULL
''').fetchone()[0]
if missing > 0 or missing_words > 0:
print(f"❌ СТОП! Переводы не завершены!")
print(f" Missing sentences: {missing}")
print(f" Missing words: {missing_words}")
print(" → Сначала завершить claude-translation-pipeline-es_latam")
# ОСТАНОВИТЬСЯ! НЕ ПРОДОЛЖАТЬ!
else:
print("✅ Все переводы готовы, можно продолжать")
Если есть missing → ОСТАНОВИТЬСЯ и сообщить пользователю!
Параметры
| Параметр | Значение |
|---|---|
| Source lang | ru |
| Target lang | es_latam |
| TTS locale | es-latam (Latin American Spanish) |
| Source speed | 1.5 |
| Target speed | 0.8 |
| Parallel workers | 16 (все процессы) |
Pipeline
Step 1: Проверка переводов
См. выше. Если не пройдена → СТОП.
Step 2: Поиск фоновой картинки
# Получить название книги из проекта
book_name = "asimov_profession" # из имени проекта или meta
# Поиск в интернете
search_query = f"{book_name} book cover art wallpaper"
# Использовать WebSearch для поиска
# Выбрать подходящую картинку (1920x1080 или больше)
# Скачать в projects/PROJECT/video/background.jpg
Критерии выбора картинки:
- Разрешение минимум 1920x1080
- Тематически связана с книгой
- Без текста или с минимальным текстом
- Подходит как фон (не слишком яркая/пёстрая)
Step 3: Генерация Audio + Video
python3 main.py resume PROJECT_NAME \
--tts google_cloud \
--tts-target-locale es-latam \
--source-speed 1.5 \
--target-speed 0.8 \
--tts-parallel 16 \
--combine-workers 16 \
--video-workers 16 \
--background projects/PROJECT/video/background.jpg
Если background не поддерживается CLI:
# Сначала audio
python3 main.py resume PROJECT_NAME \
--tts google_cloud \
--tts-target-locale es-latam \
--source-speed 1.5 \
--target-speed 0.8 \
--tts-parallel 16 \
--combine-workers 16
# Потом video с background (проверить CLI опции)
python3 main.py resume PROJECT_NAME \
--video-workers 16 \
--background projects/PROJECT/video/background.jpg
Workflow Summary
1. ✅ Проверить переводы (sentences + rare_words)
↓ Если missing → СТОП
2. 🔍 Найти фоновую картинку (WebSearch)
↓ Скачать в video/background.jpg
3. 🎙️ TTS генерация (16 параллелей)
- Source: ru, speed 1.5
- Target: es-latam, speed 0.8
4. 🔊 Combine audio (16 параллелей)
5. 🎬 Generate video с background (16 параллелей)
6. ✅ Готово!
Проверка результата
После завершения:
ls -la projects/PROJECT/
# Должно быть:
# - audio/combined.mp3
# - video/output.mp4
# - video/subtitles.ass
# - video/background.jpg
# Проверить размер видео
ffprobe projects/PROJECT/video/output.mp4
Troubleshooting
TTS квота исчерпана
python3 main.py quota
# Если Google Cloud квота закончилась - подождать или использовать другой провайдер
Video генерация падает
# Уменьшить параллелизм
--video-workers 8
# Или даже
--video-workers 4
Background не подхватывается
Проверить что картинка:
- Существует по пути
- Формат JPG/PNG
- Не битая
Self-Reminder
📌 CURRENT STATE:
- Project: {name}
- Translations: ✅ verified
- Background: {found/missing}
- Audio: {pending/in_progress/complete}
- Video: {pending/in_progress/complete}
- Next: {action}
Anti-Patterns
❌ НЕ ДЕЛАТЬ:
- Запускать без проверки переводов
- Переводить что-либо
- Редактировать sentences/rare_words
- Использовать es вместо es-latam для TTS
- Забывать про background картинку
✅ ДЕЛАТЬ:
- Проверка переводов ПЕРВЫМ шагом
- Искать качественный background
- 16 параллелей везде
- Скорости: source 1.5, target 0.8
- TTS locale: es-latam