API VEGA

Сводка

CLI-инструментарий для заготовки проектов, валидации, предпросмотра и рендеринга видеокомпозиций HyperFrames.

  • Создает проекты-шаблоны с помощью init (доступно 9 шаблонов), выполняет линтинг композиций на структурные ошибки и визуально контролирует макеты на переполнение текста и проблемы обрезки по всей временной шкале

  • Режим предпросмотра автоматически обновляется при изменении файлов; рендер поддерживает уровни качества (черновой/стандартный/высокий), несколько форматов (MP4/WebM), частоты кадров и параметризованные переопределения переменных

  • Включает команды по устранению неполадок окружения (doctor, browser, info) и требует Node.js >= 22 и FFmpeg

  • Для аудиообработки (TTS, транскрипция, удаление фона), используйте навык hyperframes-media.

HyperFrames CLI

Запускайте команды как npx hyperframes ..., если инструкции проекта не предусматривают обертку. Следуйте обертке, когда она есть. CLI требует Node.js 22 или новее и FFmpeg.

Цикл разработки

  • Скелетирование: npx hyperframes init <project> или захватить сайт. В режиме non-TTY передайте --non-interactive --example=<name>.

  • Автор: напишите композицию, используя /hyperframes-core.

  • Быстрая обратная связь во время редактирования: запустите npx hyperframes lint после первого прохода HTML и после структурных изменений.

  • Финальный контроль: запустите npx hyperframes check; он повторно выполнит lint перед открытием браузера. Не добавляйте лишний одиночный вызов lint. Добавьте --snapshots для аннотированных обзорных кадров и для поиска обрезков.

  • Инспектируйте суб-композиции: когда index.html монтирует data-composition-src, захватывайте снимки середины и осматривайте каждую смонтированную сцену.

  • Откройте финальный Studio-просмотр: запустите npx hyperframes preview, передайте пользователю URL проекта на таймлайне и спросите, следует ли внести изменения или выполнить рендер.

  • Рендерить только после утверждения: используйте черновое качество для итераций и высокое качество для доставки.

  • Проверка вывода: подтвердите, что файл существует, не пуст и имеет правдоподобную продолжительность.

# Fast iteration check; repeat while authoring as needed.
npx hyperframes lint