# AI Pro Video Skill 4.0 — пословно синхронный режиссёрский монтаж

Инструменты и правила для профессионального монтажа вертикальных роликов и длинных
видео до часа. Всё привязывается к реальной речи, а количество склеек диктует смысл,
а не желание постоянно менять картинку.

## Две аксиомы

1. **Монтаж не имеет собственного таймера.** Шкала возникает из произнесённых слов и
   точек склейки. Субтитры, б-роллы, музыка, переходы и звуки читают одну шкалу.
2. **Всё, что можно измерить, измеряется.** Каждый шаг сообщает числа: покрытие слов,
   ширину блока против лимита, расхождение длительности, достигнутую громкость, какой
   шрифт libass взяла на самом деле. Шаг, который «вроде сработал», считается не
   сработавшим.

## Что нового в 4.0

- 61 кириллическое семейство, 159 начертаний, измерение текста по метрикам шрифта.
- 25 пресетов субтитров, 5 режимов подсветки слова, контактный лист для выбора глазами.
- Умная нарезка речи: вздохи и причмокивания убираются, речь не трогается.
- Скоростные рампы с сохранением липсинка и формант.
- 30 переходов и 22 синтезированных звука с бюджетом энергии.
- Дуальный монтаж камера плюс экран с синхронизацией по звуку.
- Стоки: один запрос во все провайдеры, полный провенанс.
- 12 грейдов, 9 обработок голоса, 6 акцентов.
- Чанковый рендер с возобновлением, главы длинного видео.
- Пробинг кодеров настоящим кодированием с разбором причины отказа.

Полный список исправленных ошибок предыдущей версии — в `CHANGELOG.md`. Шесть из них
означали, что версия 3.2 молча выдавала не тот результат: например, шрифтовой пак
вообще не подключался к прожигу субтитров.

## Производственный цикл

1. `skill_config.py --status` и `render_core.py` — проверка машины.
2. `discover_sources.py` + `media_probe.py` — все исходники и их настоящие свойства.
3. `transcribe_words.py` — пословная транскрибация каждого исходника.
4. `plan_source_stitch.py` / `sync_dual_sources.py` — стыки или два источника дубля.
5. `compose_word_timeline.py` или `plan_speech_recut.py` — единая шкала.
6. `render_speech_recut.py` — база с нарезкой и ретаймингом.
7. `apply_grade.py` — цвет.
8. `build_word_synced_ass.py` + `burn_ass_captions.py` — субтитры.
9. `plan_transitions.py` + `render_transitions.py` + `mix_sfx_track.py` — переходы и звук.
10. `audio_fx.py` — обработка речи и финальная громкость.
11. `run_quality_gates.py` — ворота качества.

Начинать с `SKILL.md`. Быстрый старт для агента — `INSTALL_FOR_AGENTS.md`.

Для сокращения пауз без потери слов:

```bash
python scripts/remap_recut_timeline.py words.json director_recut.json timeline_recut.json
```

Для музыки Pixabay:

```bash
python scripts/register_music_asset.py track.mp3 music_provenance.json \
  --provider pixabay --title "Track" --creator "Artist" \
  --source-page "https://pixabay.com/music/..." \
  --license "Pixabay Content License" \
  --license-url "https://pixabay.com/service/license-summary/"
```

## Быстрый запуск

```bash
python scripts/discover_sources.py INPUT_ARCHIVE --project PROJECT --accept-all
python scripts/transcribe_words.py PROJECT/source/source_001.mov --out PROJECT/transcripts/source_001
python scripts/transcribe_words.py PROJECT/source/source_002.mov --out PROJECT/transcripts/source_002
python scripts/plan_source_stitch.py PROJECT/transcripts/source_001.words.json PROJECT/transcripts/source_002.words.json --out PROJECT/stitch_plan.json
python scripts/compose_word_timeline.py PROJECT/stitch_plan.json --out PROJECT/timeline.json
python scripts/build_word_synced_ass.py PROJECT/timeline.json PROJECT/captions.ass
python scripts/validate_sync.py PROJECT/timeline.json PROJECT/caption_map.json
```

Затем собирается HyperFrames-композиция и запускаются:

```bash
npx hyperframes doctor
npx hyperframes lint comp.html --json
npx hyperframes inspect comp.html --json
npx hyperframes preview comp.html
npx hyperframes render comp.html --out output.partial.mp4 --json
python scripts/validate_full_end.py output.partial.mp4 PROJECT/timeline.json
python scripts/validate_render.py output.partial.mp4 --timeline PROJECT/timeline.json
```

## Официальные навыки HyperFrames

Устанавливаются отдельно, чтобы получать свежую версию:

```bash
npx skills add heygen-com/hyperframes
```

Набор включает навыки композиции, командной строки, подготовки медиа, каталога компонентов, GSAP, Anime.js, CSS-анимаций, Lottie, Three.js и Web Animations API. Смотри `references/HYPERFRAMES_2026.md`.

## Секреты

В архиве нет настоящих ключей. Ключи хранятся только в `.env`, который исключён из Git. Старый файл с ключом Pixabay удалён намеренно. Люди почему-то любят класть секреты в архивы с названием «финал», а потом удивляются.