Генератор баг-репортов

Превратите запись в понятный и полезный отчет об ошибке

Загрузите запись экрана с ошибкой. Запустите воспроизведение и отмечайте каждый важный момент. Инструмент зафиксирует временную метку, сделает стоп-кадр из видео в этот момент и добавит шаг в нумерованный список.

Опишите краткую суть, ожидаемое и фактическое поведение, а затем скопируйте результат целиком в виде Markdown для GitHub, разметки Jira или обычного текста. Данные о браузере и параметрах экрана уже подставлены.

Запись никогда не покидает ваше устройство. Она воспроизводится из локального файла, а кадры извлекаются прямо в браузере, что особенно важно при работе с нерелизными сборками или аккаунтами клиентов.

Почему Этот Инструмент Не Использует ИИ для Написания Отчета

Модель, наблюдающая за записью экрана, может описать, что она видит. Она не может знать, что вы ожидали увидеть, а это та часть отчета об ошибке, которая определяет, сможет ли кто-либо действовать по ней.

«Нажал «Подтвердить», панель счета была пуста» - это наблюдение. Является ли это ошибкой, полностью зависит от того, что должно было там появиться, и единственный человек, который это знает, - это вы. Инструмент, генерирующий ожидаемое поведение из видео, угадывает и представляет эту догадку как обнаружение, что хуже, чем оставлять поле пустым, потому что правдоподобное неверное ожидание направляет разработчика по неверному пути.

Поэтому разделение здесь преднамеренное. Инструмент выполняет механическую работу, которую он может сделать точно: отметки времени, кадры, окружение, форматирование, нумерация. Вы предоставляете суждение. Это занимает около минуты, и в результате получается отчет, по которому вам никто не будет задавать вопросов.

Три Вещи, Которые Отчеты Обычно Упускают

Прочитав множество неполных отчетов об ошибках, я заметил, что одни и те же пробелы повторяются, и все три являются скорее механическими, чем сложными.

Отметки времени. Отчет, который гласит «смотрите прикрепленное видео», заставляет читателя просматривать четыре минуты, чтобы найти нужный момент. Шаг, который указывает, что это произошло в 1:12, этого не требует.

Окружение. Браузер, операционная система, размер экрана. Все знают, что это нужно включать, но почти никто этого не делает, потому что это означает открытие панели настроек, пока вы погружены в мысли. Здесь это считывается из вашего браузера и уже заполнено в отчете, и вы можете это исправить.

Кадры. Кадр в момент сбоя - это то, что сканируется в списке из двадцати проблем. Извлекать кадры из видео вручную достаточно утомительно, чтобы люди пропускали это, поэтому это происходит автоматически на каждом шаге, который вы отмечаете.

Что Именно Захватывается

Каждый отмеченный шаг записывает точное время воспроизведения и кадр JPEG из видео в этот момент, масштабированный для сохранения легковесности отчета. Вы можете скачать кадры, чтобы прикрепить их к проблеме.

Окружение поступает из браузера: его название и версия, операционная система, размер экрана с его пиксельным соотношением и размер области просмотра. Браузеры теперь сообщают о себе меньше, чем раньше, поэтому некоторые данные могут быть неизвестны, и каждое поле является редактируемым, а не заблокированным.

Ничего не выводится из пикселей. Инструмент не пытается считывать текст ошибки с экрана или угадывать, на какой элемент вы нажали, потому что делать это ненадежно хуже, чем не делать этого вообще.

Структура, Которую Он Заполняет

Вывод следует форме, которая установилась для отчетов об ошибках, потому что системы отслеживания и люди, читающие их, этого ожидают. Если вы искали шаблон отчета об ошибке, то это тот, который приходит уже заполненным, а не тот, который вы вставляете и рассматриваете.

Сначала краткое изложение, в одной строке, потому что эта строка - то, что кто-то сканирует в списке из тридцати проблем, и она решает, будет ли ваша открыта сегодня.

Затем нумерованные шаги с тайм-кодом на каждом, ожидаемое поведение, фактическое поведение и окружение. Этот порядок - не украшение. Читатель проверяет шаги, чтобы увидеть, воспроизводима ли ошибка, пару «ожидаемое/фактическое» - чтобы понять, действительно ли это ошибка, и окружение - чтобы определить, относится ли она к его системе. Скрытие любой из этих деталей приводит к дополнительным уточнениям.

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

Перед началом записи

Качество отчета напрямую зависит от качества записи. Достаточно выработать две полезные привычки.

Начинайте с известного исходного состояния. Запись, сделанная с середины сценария, оставляет неясным контекст, и воспроизвести шаги становится невозможно. Начинайте со страницы входа, чистой страницы или четко обозначенной стартовой точки.

Уберите с экрана всё лишнее. Токены в адресной строке, имя клиента, открытое в соседней вкладке постороннее письмо, API-ключ в панели инструментов разработчика. Баг-репорты пересылаются, отправляются в чаты и просматриваются людьми вне команды, а запись экрана фиксирует всё, что на нем отображалось. Этот инструмент не загружает видео в сеть, но отчет и стоп-кадры попадут туда, куда вы их отправите.

Чего инструмент не делает

Он не создает задачу в трекере. Здесь нет интеграции с GitHub, Jira или другими сервисами: вы копируете отчет и вставляете его туда, куда нужно, а значит, можете проверить его перед отправкой.

Он не собирает логи, сетевые запросы или вывод консоли. Все это находится в инструментах разработчика и крайне важно для некоторых ошибок. Прикрепляйте эти данные привычным для вашей команды безопасным способом, а не снимайте консоль на видео.

Он не проводит диагностику. Инструмент не подскажет причину сбоя, проблемный компонент и не найдет дубликаты среди существующих задач. Его задача - привести доказательства в удобный для работы вид, и только.

Как записать саму ошибку

Если вам только предстоит зафиксировать проблему, программа записи экрана позволяет захватить вкладку, окно или весь экран прямо в браузере. Если при воспроизведении ошибки нужны голосовые комментарии, включите запись звука - так объяснение останется вместе с видеоматериалом.

Два полезных сопутствующих инструмента: если вам нужны отдельные изображения вместо отчета, генератор скриншотов из видео извлекает кадры с заданным интервалом. А если запись длинная и вы хотите получить голосовые пояснения в виде текста, генератор транскрипций преобразует речь в текст с возможностью поиска.

Задайте вопрос по записи с ошибкой

Инструмент на этой странице работает локально на вашем устройстве и не требует учетной записи. Чтобы узнать, что именно было сказано или показано на видео, загрузите его в ScreenApp. Нажмите на вопрос, чтобы открыть ScreenApp с готовым запросом.

В ScreenApp нажатие на момент в стенограмме переводит плеер к этой точке записи, так что вы всегда можете сопоставить любой ответ с записью.

Возможности каждого тарифа

Инструмент на этой странице бесплатен и останется бесплатным. Аккаунт нужен для шага до или шага после него.