Карточка лежит рядом с фильмом, а не в репозитории: код общий для всех каналов, состояние — своё у каждого проекта.

Карточка ищется по цепочке: сначала прямое указание пути, затем корень проекта, затем поиск вверх от текущей папки. Любой ключ можно перебить переменной окружения — имя строится из префикса YTAI_ и ключа заглавными: YTAI_CUT_VERSION, YTAI_LANG. Это для разовых прогонов, а не для постоянной настройки.

Откуда карточка берётся. Первый раз её заводит review.py init --project <путь или КОД> --channel <КАНАЛ> [--mode cut_review] [--cut <адрес ката>] — из шаблона стадии; если у проекта остался старый prep_config.json, его переносит --from-prep-config. Дальше карточка правится руками.

Без ключей ниже ругается review.py card check. ⚠️ Но это не гейт: проверка ничего не блокирует, цепочку можно запустить и с неполной карточкой — она упадёт позже и в менее понятном месте. Поэтому card check гоняют руками перед первым запуском и после каждой ручной правки карточки.

Это самая длинная часть карточки и единственное место, где структура выпуска описана целиком. Из неё растут заставки глав, название фильма, плашки спикеров, панель подглав, прогресс перечислений, титры подтем, крупные фразы, собственные страницы фильма, вкладка «Главы», карта выпуска в XMind и маркеры секвенции.

sub — плоский список троек «секунда, номер главы, подпись». Не словарь по главам: подглавы идут сквозным потоком по фильму, и так их проще и расставлять, и сдвигать. Словарь по главам код не примет вовсе — рендер падает на распаковке. На втором круге список заполняет сама стадия sub (stages/sub_from_prev.py): переносит подглавы прошлого ТЗ на ось нового ката — проекцией, досадкой по словам подписи и снапом на паузу.

// review_card.json — YTUVI01, кат v2: 62 подглавы сквозным списком
"sub": [
  [ 16, 1, "Цветные камни держат цену" ],
  [ 44, 1, "Не такой уж обычный рубин" ],
  [ 71, 1, "Один состав — три цены" ]
],
"sub_img":       { "01": "sub_card_01.jpg", "02": "sub_card_02.jpg" },
"sub_no_screen": [ 4, 9, 17 ],   // порядковые номера в sub (с 1), НЕ секунды; числа для примера
"ch_no_final":   { "01": "—", "02": "01", "10": "—" }

sub_img — кадр подглавы, ключ равен её порядковому номеру в списке. sub_no_screen — порядковые номера подглав в sub (счёт с 1), титра которых в кате нет. ⚠️ Это не секунды: код сравнивает их с номером подглавы, а не со временем, и записанные секундами они молча не совпадут ни с одной строкой. Подглава без титра — не ошибка кадрирования, а пропущенный монтажёром экран: во вкладке «Главы» она помечается «⚠️ титра подтемы в кате нет», в карте XMind — «➕ СОЗДАТЬ». На втором круге список берётся из сверки с прошлым ТЗ автоматически, той же стадией sub.

Два вида экрана, которые ставятся не по главам, а по месту: название фильма встаёт один раз сразу после хука, плашка спикера — там, где человек впервые появляется. Рисует их stages/bdd_plates.py titles — пока это рендер YTCH на языке брендбука фонда, — показывает вкладка «Главы» в режиме заставок (6.3).

// review_card.json — YTCH12, кат v5
"film_title":         "ОДНА С РЕБЁНКОМ",
"film_title_variant": "a",
"film_title_chapter": "01",
"film_title_caption": "фильм",
"name_plates": [ { "sec": 676, "name": "ЖИМАГУЛ ПАНФИЛОВА",
  "role": "куратор по семьям · фонд «Бюро Добрых Дел»", "kind": "q_lower_e",
  "now": "Подпись в кате стоит на 11:16…", "do": "▶ Перерисовать плашкой спикера фонда…" } ]

Когда в главе идёт список («три способа», «шесть видов обработки»), на экране живёт накопительный прогресс «N из M». Его задают: prog — заголовок и пункты; prog_t — секунды, в которые перечисление продвигается на следующий пункт; prog_final — что показать, когда отмечены все; prog_note — пометка к отдельному пункту; prog_variant — тема панели одной буквой: z тёмная (принята) · h светлая (осталась для сравнения); неизвестная буква останавливает рендер; prog_demo_sec — кадр под демонстрацию.

Два ключа, из которых растут ещё два вида экрана — и их легко не заметить, потому что нужны они не всегда.

Отдельно — ключи, которые пишет не человек, а код, и руками их дописывать не нужно:

• v2 — вставки слоя футажей. Перезаписывается целиком при каждом применении подбора визуала: ручная дописка исчезнет.
• drop_segments и disabled_ranges — что Роман снял и что выключил прямо на ревью-секвенции; читается из автосохранения проекта Premiere и означает «вырезать».
• footage_routing — каталог своих съёмок, из которого берутся собственные клипы вместо стока.

Часть ключей существует только ради того, чтобы машина могла проверить саму себя.

• ocr_anchors, llm_anchors — две-три фразы, которые в этом кате точно есть на экране. Если чтение экранов их не находит — что-то сломалось на нарезке или распознавании. Пустые якоря означают, что проверка просто пропущена, а не что она прошла.
• verify_tz — проверки по содержанию ТЗ: «такой-то пункт должен быть про такое-то».
• notes — грабли конкретного проекта. Печатаются в тикете для следующей сессии, чтобы их не приходилось вспоминать.
• sources — авторитеты факт-чека именно этого фильма, сверх канальных.
• film_subject — тема одним словом, для промптов.

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

Профиль отвечает на вопрос «как принято на этом канале» и меняется куда реже карточки.

Расширения — не у всех каналов:

• lang, currency, ocr_langs — для англоязычного канала. lang: en меняет не только подписи: номера правок печатаются FIX-NN вместо ТЗ-NN, метки блоков идут по-английски (▶ DO, ❌ NOW), доводка строк локальной моделью пропускается. Рядом — канон записи сумм и языки распознавания экранов.
• sensitivity — чувствительные темы: помечать предупреждением и отправлять на подтверждение, но не вырезать самостоятельно.
• structure_rules, verdict — проверки структуры фильма и редакторский вердикт одним агентом.
• probe — собственный логотип канала, чтобы зонд не считал его чужим следом.
• kb — база знаний канала для подбора визуала: корни архивов, что исключать, сколько картинок на эпизод.

• Пустой внешний id не роняет круг — он его обесценивает. Стадия отметится пройденной, а вкладки не будет. Фолбэка на прошлый фильм нет и не будет — это как раз сделано намеренно, — но и остановки нет: следить за пометками в status.
• Частоту кадров писать числом. Точную дробь для NTSC считает код; записанное вручную округление уводит таймкоды к концу фильма.
• Подглавы — плоский список троек. Словарь по главам рендер не примет: падает на распаковке тройки.
• sub_no_screen и sub_img — порядковые номера, а не секунды. Вставишь подглаву в середину sub — съедут оба списка разом. Поэтому предложения новых экранов в sub не вливаются: они живут в work/{кат}/screens_proposal.json и доезжают до вкладки «Главы» и карты XMind оттуда.
• Исключение без границ — это заметка. Запись с пустыми началом и концом в фильтр не попадает; проверка карточки об этом предупреждает.
• v2 руками не дописывать — ключ перезаписывается целиком при следующем применении подбора визуала.
• Нумерация выпуска не равна номеру главы. У хука и финала номера нет, и это не пропуск в данных.
• Подглава без титра — не ошибка кадрирования. Она отмечена отдельно именно потому, что экран на неё не поставили, и это повод для ТЗ, а не для правки карточки.
• Ключи сверки с прошлым кругом заводятся только тогда, когда прошлый круг был. Прошлое ТЗ, версия прошлого ката и режим показа кадров — не заготовка на будущее, а признак того, что фильм идёт вторым кругом.