Как сообщить о проблеме

EyeAuras — очень сложная программа, которая постоянно развивается. К сожалению, развитие не обходится без проблем. Ошибки были, есть и, скорее всего, будут в будущем: какие-то незначительные, а какие-то критические.

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

Ошибки можно разделить на 3 основные категории:

1. Дефект

Что происходит?

Что-то работает не так, как ожидается: например, вы заметили странное поведение, не срабатывает триггер или действие выполняется неправильно. Приложение при этом продолжает работать, но не в полном объёме.

Что делать?

Нажмите кнопку “Report a problem” в заголовке окна. Откроется диалог “Error Report”, где можно описать проблему и отправить логи.

2. Сбой приложения

Что происходит?

Приложение внезапно прекращает работу. Обычно это связано с критической ошибкой в самом приложении или его конфигурации.

Что делать?

Диалог “Error Report” откроется автоматически и предложит отправить или сохранить логи. После закрытия окна Error Report приложение завершит работу, так как не может продолжать функционировать в нормальном режиме.

3. Сбой native-приложения — худший сценарий

Что происходит?

Приложение мгновенно закрывается без каких-либо предупреждений и без окна “Error Report” — просто исчезает.

Причины могут быть разными:

• Антивирусы: EyeAuras использует определённые техники, чтобы сохранять совместимость со многими играми и программами. Иногда это может вызывать срабатывания антивирусов. Часто это результат работы алгоритмов машинного обучения, которые помечают потенциальную угрозу — это не обязательно означает вирус, а лишь сигнализирует, что стоит проверить программу внимательнее. Самое быстрое решение — добавить папку EyeAuras в исключения антивируса. Возможно, в будущем я найду более удобное решение, но на 2023 год конкретного плана у меня нет.
• Античиты: из-за своей автоматизации EyeAuras может попадать под внимание некоторых античит-систем. Например, раньше EasyAntiCheat завершал EyeAuras при обнаружении. Однако на октябрь 2023 года такие системы, как EasyAntiCheat, ActiveAntiCheat и Vanguard, не обнаруживают программу и не мешают её работе.
• Критические ошибки приложения: я стараюсь не допускать подобных ситуаций, но полностью исключить их нельзя. Если такое произошло, свяжитесь со мной напрямую — будем разбираться.

Что делать?

Если после перезапуска проблема исчезает, нажмите “Report a problem” и отправьте диагностические данные — логи из предыдущего запуска всё ещё можно отправить или сохранить.

Если приложение стабильно падает при каждом запуске — такое случается редко — выполните следующие действия:

1. Откройте в Проводнике путь “%appdata%\EyeAuras\release” (просто скопируйте и вставьте его в адресную строку). Откроется основная папка хранения EyeAuras — в ней находятся конфигурация, логи и всё остальное.
2. Сохраните резервную копию файла “config.cfg” и папки “backups” в безопасное место. Это основной файл конфигурации (и его резервные копии), в котором хранятся все ваши настройки, ауры и т. д.
3. Удалите “config.cfg” и попробуйте запустить приложение. Это сбросит конфигурацию приложения к настройкам по умолчанию и удалит всё. Именно поэтому на предыдущем шаге вы сделали резервную копию.
4. Если приложение успешно запустилось — нажмите “Report a problem” и отправьте мне логи. Во многих случаях этого уже будет достаточно, чтобы понять причину проблемы.
5. Если приложение всё равно не запускается — упакуйте всю папку в архив и отправьте мне напрямую в Discord или Telegram. К счастью, такое бывает очень редко, и в большинстве случаев до этого не дойдёт.
6. После того как проблема будет решена (например, после обновления приложения), вы сможете восстановить свою конфигурацию из резервной копии и попробовать снова.

Error Report

Откройте окно кнопкой Report a problem в заголовке приложения или кнопкой отчёта в мини-приложении. Оно также может появиться автоматически после исключения.

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

• systemInfo.txt и, в текущих клиентах EyeAuras, applicationInfo.txt собираются автоматически. Информация о приложении включает отправителя, возможности лицензии, данные запуска, статистику дерева и подписки.
• stacktrace.txt содержит доступные сведения об исключении. Недавние логи приложения и скриншоты его окон выбраны по умолчанию.
• Скриншоты рабочего стола, конфигурацию аур и другие необязательные файлы можно выбрать в окне. Скриншоты рабочего стола и конфигурация аур по умолчанию не выбраны.

В разделе Отчёты о проблемах и приём архивов описаны формат, собираемые данные, пример и работа с отчётами для авторов шар. Старые архивы без applicationInfo.txt остаются пригодными для диагностики.