Отладчик
Отладчик — это встроенная часть веб-редактора, которая позволяет тестировать историю, не покидая редактор. Он интерпретирует Yarn-скрипт в реальном времени и отображает результат в панели, стилизованной под чат.
Запуск отладчика
Есть два способа запустить отладчик из панели ин струментов редактора:
| Кнопка | Действие | Описание |
|---|---|---|
| ▶ | Запуск текущей ноды | Запускает отладчик с узла, который вы сейчас редактируете |
| ▶▶ | Запуск с точки входа | Запускает отладчик с точки входа истории (is_entry_point: true) |
Перед запуском отладчик парсит скрипт и проверяет ошибки. Если ошибки найдены, отладчик не запустится — сначала исправьте ошибки.
Используйте ▶ (Запуск текущей ноды), чтобы быстро протестировать узел, над которым вы работаете, без проигрывания всей истории с начала.
Панель отладчика
Когда отладчик работает, между панелью инструментов и редактором кода появляется панель. Она состоит из:
Сообщения
Левая область отображает диалог так, как он выглядел бы в Telegram:
- Сообщения бота с текстом и форматированием
- Имена спикеров (выделены цветом)
- Медиа-сообщения (фото, видео, голосовые, кружки) с превью при наведении
- Выбор пользователя (показывается после выбора)
Переменные
Правая панель отображает все переменные, объявленные и используемые в скрипте:
- Имена переменных и их текущие значения
- Нажмите кнопку редактирования рядом с любой переменной, чтобы изменить её значение на лету
- Изменения вступают в силу мгновенно и влияют на ход истории
Пример: Если ваша история исполь зует $score, вы можете вручную установить любое значение, чтобы протестировать разные ветки без повторного проигрывания всей истории.
Опции
В нижней части панели отладчика отображаются текущие варианты выбора. Нажмите на опцию, чтобы сделать выбор и продолжить историю.
Опции с условиями (<<if>>), которые вычисляются как false, отображаются как неактивные.
Настройки отладчика
Заголовок отладчика содержит настройки, управляющие скоростью воспроизведения:
Турбо-режим
Включите чекбокс Turbo, чтобы пропустить все задержки (команды <<wait>> и <<typing>>). История будет проигрываться мгновенно, что удобно для быстрого тестирования логики ветвлений.
Время ожидания (Wait)
Управляет задержкой (в секундах) для команд <<wait>>. По умолчанию: 1. Регулируется от 0 до 10 с шагом 0.5.
Время набора (Typing)
Управляет длительностью (в секундах) анимации статусов (<<typing>>, <<upload_photo>>, <<record_voice>>, <<record_video_note>>). По умолчанию: 1. Регулируется от 0 до 10 с шагом 0.5.
Включите Турбо-режим, чтобы мгновенно пропускать историю и сосредоточиться на тестировании логики ветвлений и условий переменных.
Подсветка строк
Пока отладчик работает, текущая исполняемая строка подсвечивается в редакторе кода. Редактор автоматически:
- Прокручивает к текущей строке
- Переключается на нужную главу, если история переходит к другому узлу
- Показывает зелёный индикатор у активной главы в боковой панели
Это позволяет легко следить за ходом выполнения и точно понимать, на каком месте находится история в любой момент.
Остановка отладчика
Нажмите кнопку Stop в заголовке отладчика, чтобы остановить отладку и вернуться к редактированию. Подсветка строк очищается, панель отладчика закрывается.
Превью медиа
Если в вашем проекте загружены медиа-файлы, отладчик показывает медиа-сообщения с иконками типа. Наведите курсор на имя файла, чтобы увидеть превью:
- Фото — отображается как изображение
- Видео / Кружки — отображаются как зацикленное видео
- Голосовые сообщения — отображаются с аудиоплеером
Пример рабочего процесса
- Напишите или отредактируйте узел в редакторе
- Нажмите ▶, чтобы запустить отладчик с текущего узла
- Наблюдайте за появлением сообщений в панели отладчика
- Когда появятся опции, нажмите на одну из них, чтобы сделать выбор
- Если что-то не так, нажмите Stop, отредактируйте скрипт и нажмите ▶ снова
- Изменяйте переменные на лету, чтобы тестировать разные ветки
- Включите Turbo для быстрого пропуска длинных последовательностей