Полезное сообщение о плохом вырезе
Полезный отчет о неисправностях объясняет что не удалось, где произошел сбой и как это воспроизвести. Начните с симптома, исходного формата и размеров, версии браузера и расширения, метода ввода и завершения настройки модели при первом запуске.
Не отправляйте личный оригинал автоматически. Сначала попытайтесь воспроизвести проблему с помощью безобидной замены или сильно обрезанного и отредактированного примера. В отчете службы поддержки редко требуются сведения о личности человека, тексте документа, местонахождении или полном объеме клиентского актива.
Сначала решите, является ли это проблемой качества или отказом
«Плохой вырез» может означать несколько разных вещей:
- изображение не открывалось;
- обработка не началась;
- обработка завершилась сбоем или остановкой;
- из маски субъекта удалена важная часть;
- вокруг объекта остался фон;
- распались волосы, мех, стекло или тонкие предметы;
- ореол появился только после экспорта;
- Не удалось скопировать, хотя загрузка работала;
- результат выглядел правильно в редакторе, но неправильно в другом приложении.
Назовите категорию в первом предложении. «Дескриптор исчез после обработки» дает поддержку отправной точкой. «Это не работает» — нет.
Если обработка завершена и требуется небольшая коррекция только края, это может быть обычным случаем уточнения, а не программным сбоем. Укажите, что делал автоматический результат до использования кистей «Добавить» или «Стереть».
Запишите кратчайший путь воспроизведения
Напишите шаги так, как будто их должен выполнить другой человек при чистой установке:
- Откройте расширение с панели инструментов.
- Скиньте локальный JPG размером 2400×1600.
- Дождитесь завершения обработки.
- Осмотрите зазор внутри ручки объекта.
- Загрузите PNG.
- Обратите внимание, что пробел заполняется как при предварительном просмотре, так и при экспорте.
Используйте только те шаги, которые необходимы для достижения симптома. Упомяните альтернативы, которые меняют результат, например «тот же файл работает, если сохранить его в формате PNG» или «Загрузка работает, а копирование — нет».
В случае проблемы с изображением страницы укажите, происходит ли сбой только по маршруту щелчка правой кнопкой мыши и работает ли локальное сохранение того же изображения. Некоторые веб-сайты доставляют изображения способами, которые не позволяют рабочему процессу страницы их прочитать; эти доказательства отделяют ограничения доставки от качества модели.
Включите детали среды, которые могут изменить поведение
Достаточно компактного блока окружения:
- версия расширения;
- версия браузера;
- Операционная система;
- примерный объем памяти устройства при сбое обработки больших файлов;
- завершилась ли загрузка модели;
- исходный формат, размеры в пикселях и приблизительный размер файла;
- маршрут ввода: выберите, перетащите, вставьте или изображение страницы;
- маршрут вывода: скачать PNG или скопировать;
- повторяется ли проблема после повторного открытия редактора.
Избегайте отправки полной инвентаризации системы. Серийные номера оборудования, имена учетных записей, сетевые адреса, списки установленных приложений и несвязанная история браузера обычно добавляют риск, не помогая воспроизвести пограничный дефект.
Описываем изображение геометрически
Если вы не можете поделиться источником, опишите визуальные условия:
- темные вьющиеся волосы на фоне темной стены;
- прозрачная стеклянная оправа на светлом фоне;
- узкие велосипедные спицы, пересекающие фактурную улицу;
- бледный край продукта на не совсем белом фоне;
- мягкая тень от пола, касающаяся объекта;
- скриншот низкого разрешения с блоками сжатия;
- объект частично обрезан по краю кадра.
Укажите, где появляется ошибка: верхний левый край, замкнутый зазор, тень от контакта, полупрозрачная область или полоса в один пиксель вокруг экспортируемого объекта. Этот словарь более действенный, чем фраза «модель не поняла фотографию».
По возможности используйте безопасную замену
Попробуйте воссоздать ту же визуальную проблему с помощью объекта, которым вы можете поделиться. Если у клиентского товара отсутствует ручка, сфотографируйте обычную кружку на аналогичном фоне. Если отдельные детали волос не удаются, используйте парик, щетку, пряжу или растение с аналогичной структурой краев.
Заменитель полезен только в том случае, если он воспроизводит симптом. Четко укажите, что это репродукция, а не оригинал. Включите как условия успеха, так и условия неудачи:
- не работает на низкой контрастности, работает на высокой контрастности;
- не работает при превышении определенного размера изображения, работает после изменения размера;
- не проходит действие с изображением страницы, работает из сохраненного файла;
- предварительный просмотр правильный, экспортированный PNG показывает бахрому в указанном локальном средстве просмотра.
Такое сравнение часто раскрывает больше, чем только оригинал.
Если вам необходимо поделиться изображением, сверните его.
Получите разрешение владельца и сначала следуйте любой политике клиента или рабочего места. Затем удалите все, что не нужно расследованию:
- Дублируйте файл, чтобы оригинал остался нетронутым.
- Плотно обрежьте дефектный край.
- Удалите метаданные, если этого требует утвержденный рабочий процесс.
- Редактировать имена, экраны, адреса, лица и опознавательные знаки за пределами соответствующей области.
- Подтвердите редактирование в фактической экспортированной копии.
- Делитесь информацией только по назначенному каналу обратной связи.
Закрашивание текста черным цветом может оказаться недостаточным, если формат документа сохраняет слои или скрытое содержимое. Обычно легче рассуждать о сплющенной, сильно обрезанной растровой копии, но следуйте правилам вашей организации.
Никогда не отправляйте документы, удостоверяющие личность, интимные изображения, фотографии детей, медицинские записи, учетные данные или конфиденциальные доказательства только для того, чтобы улучшить отчет об ошибке.
Снимайте до и после, не публикуя лишнего
Для отчета высокого качества может помочь подборка трех состояний:
- исходный край;
- автоматический результат маски;
- желаемый результат после ручной доработки.
Сохраняйте кадрирование достаточно большим, чтобы показать локальный контраст и текстуру, но достаточно маленьким, чтобы удалить идентичность и контекст. Подпишите каждое состояние. Если снимки экрана содержат вкладки браузера, закладки, уведомления, имена файлов или аватары учетных записей, обрежьте их перед отправкой.
Если проблема касается экспорта, проверьте PNG как на светлом, так и на темном локальном фоне. Бледный ореол может исчезнуть на белом фоне, оставаясь при этом заметным на темно-сером. Скажите, существует ли дефект в предварительном просмотре редактора, экспортированном файле или только в целевом приложении.
Честно сообщайте о времени и частоте
Полезное время приблизительное: «обработка зависает более чем на две минуты после запуска индикатора прогресса» или «сбой происходит сразу после выбора файла». Не сообщайте о точном эталоне, полученном за один отвлеченный прогон.
Государственная частота:
- каждая попытка использования этого безопасного образца;
- две попытки из пяти;
- один раз, после перезапуска не воспроизводится;
- только при первом запуске;
- началось после обновления расширения.
Одноразовое событие по-прежнему имеет значение, но его точная маркировка позволяет сосредоточить расследование.
Что не включать
Опустить:
- пароли, токены или учетные данные;
- полные журналы браузера, которые вы не просматривали;
- несвязанные личные файлы;
- исходное приватное изображение, когда безопасный кадр воспроизводит проблему;
- предположения о загрузке сервера, основанные только на наблюдениях за сетевой активностью;
- агрессивные заявления о причине без доказательств.
Сначала опишите наблюдения. «На этом 30-мегапиксельном файле рабочая ошибка появляется через 40 секунд», — тому подтверждение. «Сервер отклонил мою фотографию» — это предположение, особенно когда путь вырезания предназначен для локального запуска.
Шаблон отчета
Используйте эту компактную структуру:
Краткое содержание: Одно предложение с названием неудавшегося объекта или этапа.
Ожидается: то, что должно оставаться прозрачным, непрозрачным, копироваться или загружаться.
Наблюдено: Что на самом деле произошло и где это проявляется.
Шаги: Репродукция с кратчайшим номером.
Среда: Версии, система, состояние настройки модели, исходный формат и размеры.
Частота: Каждый раз, периодически или один раз.
Безопасный образец: прикрепленная репродукция, обрезанный пример или «невозможно поделиться».
Решение: Измените размер, повторно экспортируйте, используйте локальный файл, уточните вручную или ничего не делайте.
Используйте поток обратной связи о расширении, если ваша установленная сборка его предоставляет. В противном случае сохраните текст отчета, чтобы можно было вставить его в текущий маршрут поддержки, не восстанавливая доказательства по памяти.
Сделайте отчет полезным и заботящимся о конфиденциальности
Самый сильный отчет – это не тот, который содержит больше всего данных. Это пример с наименьшим воспроизводимым примером и самой четкой границей между наблюдением и предположением.
Чтобы немедленно исправить ситуацию, проверьте Устранение неполадок. Прежде чем прикреплять какой-либо образец, используйте правила из Привычки безопасного тестового изображения. Хорошие отчеты улучшают качество вырезок, не превращая частный контент в ненужный вспомогательный материал.