howdeploy/kisa-stack/stream-timecodes

Stream Timecodes

Автоматическое создание таймкодов для стримов, подкастов и видео из VTT-файлов транскрипции.

Входные данные

• VTT файл с транскрипцией (любая длительность)
• Путь к файлу через вложение в Telegram или прямой путь

Выходные данные

18 таймкодов в формате:

ЧЧ:ММ:СС - Краткое описание темы

Правила форматирования

КРИТИЧНО: Букву "ё" НЕ использовать!

• Всегда заменять "ё" на "е"
• ❌ "всё" → ✅ "все"
• ❌ "ещё" → ✅ "еще"
• ❌ "трёхчасовой" → ✅ "трехчасовой"

Формат таймкодов

• Временная метка: ЧЧ:ММ:СС (всегда с ведущими нулями)
• Разделитель: - (пробел-тире-пробел)
• Описание: краткое, емкое, без "ё"
• Длина описания: 30-70 символов

Стиль описаний

• Без точки в конце
• Начинать с заглавной буквы
• Избегать общих фраз типа "Обсуждение темы"
• Конкретика: упоминать ключевые моменты, имена, технологии
• Без излишних подробностей

Процесс работы

1. Получить VTT файл от пользователя
2. Запустить обработку через скрипт scripts/process_vtt.py
3. Проанализировать сегменты и выделить 18 ключевых моментов
4. Создать описания для каждого таймкода (краткие, без "ё")
5. Отправить в чат текстовым сообщением (НЕ файлом!)

Использование скрипта

python3 scripts/process_vtt.py /path/to/file.vtt

Скрипт выводит базовую разметку по 5-минутным интервалам. На основе этого вывода:

• Выбери 18 самых важных моментов
• Равномерно распредели по длительности
• Создай краткие описания тем

Пример вывода

00:00:00 - Стартуем, приветствия
00:05:00 - История создания продукта на AI
00:10:00 - Колоссальный скачок в развитии AI
00:15:00 - Путь в вайбкод: от Linux до первых лендингов
00:20:00 - Deep research и база знаний через нейронки
00:25:00 - Разочарование в крипте
00:30:00 - AI растет, крипта стоит
00:35:00 - Промпт-инженеры и автоматизация
00:40:00 - AI vs человеческие навыки
00:45:00 - Регуляция AI неизбежна
00:50:00 - Китайские модели без цензуры
00:55:00 - Инструменты и RAG: много хайпа
01:00:00 - AI-агенты в реальности
01:05:00 - Оркестрация суб-агентов
01:10:00 - Почему Claude Code — лучший инструмент
01:15:00 - Безопасность AI-решений
01:20:00 - E-commerce проект и GigaChat
01:25:00 - Русские нейронки: катастрофа

Важно

• Отправлять В ЧАТ, не файлом
• 18 таймкодов — ровно столько, не больше, не меньше
• Без буквы "ё" — проверить весь текст перед отправкой
• Равномерное распределение по длительности стрима
• Конкретные темы в описаниях, без воды