# Анализатор медиа

Раздел **Медиа → Анализатор** проверяет содержимое `/uploads` и сопоставляет
файлы с явными ссылками в документах, полях, рубриках, шаблонах, блоках,
навигации, запросах, настройках, теме и установленных модулях.

Проверка работает только на чтение. Она не удаляет, не переименовывает и не
пережимает файлы.

После проверки AVE.cms обновляет компактную карту использования для карточек,
а также индекс имён и путей для глобального поиска. При удалении система не
доверяет возрасту этой карты и отдельно проверяет выбранный путь по живым данным.
Запускайте анализатор после массовой загрузки по FTP или восстановления копии
`/uploads`. Обычная загрузка и переименование через панель обновляют поисковый
индекс сразу.

## Что показывает отчёт

| Группа | Что означает |
| --- | --- |
| Не используются | Явная ссылка на файл не найдена. Это кандидат на ручную проверку, а не команда на удаление. |
| Одинаковые | Несколько файлов имеют одинаковый размер и SHA-256 содержимого. |
| Нет оригиналов | В данных есть ссылка на отсутствующий файл либо служебное превью осталось без исходника. |
| Нет превью | Для изображения пока не найдено ни одной созданной миниатюры. При ленивой генерации это может быть нормой. |
| Большие | Файл не меньше 5 МБ либо сторона изображения не меньше 4000 px. |
| Неверные пути | Ссылка содержит недопустимый путь или ведёт за пределы `/uploads`. |
| Все файлы | Полная карта файлов, размеров, разрешений и найденных мест использования. |

Для каждого используемого файла выводится карта связей: тип сущности, её ID,
поле или колонка и ссылка на подходящий раздел панели. Анализатор распознаёт
литеральные пути. Если модуль собирает URL динамически из нескольких частей,
файл может попасть в список «Не используются», поэтому удаление всегда
выполняется только после ручной проверки.

## Как пользоваться

1. Откройте **Медиа → Анализатор**.
2. Нажмите **Запустить проверку**.
3. Начните с групп **Нет оригиналов** и **Неверные пути**.
4. Проверьте дубли и крупные изображения.
5. Перед удалением файла из группы **Не используются** откройте карту связей и
   проверьте публичный сайт.

Отчёт сохраняется в `storage/reports/media-audit.json`. Повторная проверка
полностью заменяет предыдущий отчёт актуальным состоянием.