Баг-репорты в GitHub Issues с записью экрана, логами консоли и сети
Обновлено
GitHub Issues — это место, где многие продуктовые команды и open-source проекты отслеживают баги, прямо рядом с кодом. Midge позволяет любому участнику команды записать баг вместе с логами консоли, сетевыми запросами и данными об устройстве, а затем нажать Send to GitHub и создать issue с ИИ-сводкой, шагами воспроизведения, вероятной причиной и ссылкой на запись.
Как это работает
- Установите приложение один раз. Администратор рабочего пространства открывает в Midge Settings › Workspace › Integrations и нажимает Connect у GitHub. GitHub предлагает установить приложение Midge Bug Reports и выбрать репозитории, в которых оно сможет создавать issues. Прежде чем сохранить установку, Midge проверяет через вход в GitHub, что она действительно принадлежит этому администратору, а затем тот выбирает репозиторий, куда будут попадать баги.
- Запишите баг. Расширением для Chrome, Midge для Mac или Midge для iPhone запишите экран или сделайте скриншот. В репорт попадут консоль, сетевые запросы, ваши клики и данные об устройстве.
- Отправьте в GitHub. В репорте нажмите Send to GitHub. Issue создаётся от имени приложения, а в репорте будет видно, какой issue он создал.
Что содержит issue в GitHub
GitHub отображает Markdown, поэтому issue можно спокойно прочитать, ничего больше не открывая. Вот что в нём будет:
- ссылка на репорт Midge с видео и панелями консоли и сети,
- ИИ-сводка,
- пронумерованные шаги воспроизведения, составленные по тому, что вы делали в записи,
- вероятная причина,
- URL страницы и количество ошибок консоли и упавших запросов.
Примечание в самом конце сообщает, что сводку написал ИИ на основе очищенных логов, поэтому тот, кто возьмёт issue в работу, знает, что её стоит сверить с записью.
Сначала ваши слова
Всё, что автор репорта написал при отправке, например ожидаемый результат или аккаунт, под которым он работал, попадает в issue сразу под ссылкой, перед ИИ-сводкой. Первое слово остаётся за тем, кто своими глазами видел баг, а сводка лишь дополняет то, что он не успел или не стал записывать.
Минимум доступа
Приложение Midge Bug Reports запрашивает issues: write и metadata: read в выбранных вами репозиториях — и больше ничего. Оно не может читать ваш код, pull requests или Actions, а убрать репозиторий из списка или удалить приложение можно в любой момент в настройках GitHub.
Секреты не попадают в репозиторий
В публичных репозиториях текст issue виден всем, в том числе совершенно посторонним людям. Midge удаляет пароли, токены, cookies, заголовки авторизации и номера карт из логов, прежде чем они покинут браузер или телефон, и маскирует email и номера телефонов. Issue пишется уже по этим очищенным логам. Сама запись остаётся в Midge со своей настройкой доступа: «Workspace members» или «Only me» сохраняют её приватной, даже если issue публичный. Подробнее — на странице скрытия данных.
От issue до исправления
Разработчик открывает issue, переходит к записи и видит упавший запрос и стек-трейс ровно в тот момент, когда случился баг. Если он работает с ИИ-агентом для программирования, та же ссылка отправляется в Claude Code или Cursor, и агент читает консоль, сетевые запросы и шаги через MCP-сервер Midge.
Кто этим пользуется
- Небольшие продуктовые команды, которые ведут всё в GitHub и не хотят заводить ещё один инструмент для багов.
- QA и поддержка, которые заводят баги прямо в репозитории, за которым уже следят инженеры.
- Мейнтейнеры, которым нужны репорты с приложенными логами, а не issues в духе «оно не работает».
Без интеграции
У каждого репорта есть ссылка, которая копируется сразу при создании. Вставьте её в любой issue, pull request или обсуждение, и она откроет тот же самый репорт — с видео, консолью и сетевыми запросами.
Что ещё почитать
- Все интеграции: Jira, Linear, Slack и вебхуки.
- Как написать баг-репорт.
- Примеры баг-репортов.
Midge бесплатен, включая интеграцию с GitHub: записи без ограничений, видео до 15 минут и без водяного знака.
Частые вопросы
- Какой доступ есть у GitHub App от Midge?
- Issues: write и metadata: read — в тех репозиториях, которые вы выберете при установке. Читать или менять ваш код оно не может.
- Кто указан автором issue?
- Приложение Midge Bug Reports. Issue ссылается на репорт Midge, а там видно, кто сделал запись.
- Работает ли это с приватными репозиториями?
- Да, с любым репозиторием, где установлено приложение. Помните, что issue ссылается на репорт: настройте доступ к репорту так, чтобы его могли открыть нужные люди.
- Поддерживается ли GitHub Enterprise Server или GitLab?
- Нет, только GitHub.com. Подписанный вебхук может создавать задачи в других системах через ваш собственный небольшой сервис.