AI 3D Sorter — это скрипт для автоматической сортировки 3D-моделей по папкам библиотеки с помощью ИИ. Он анализирует имя файла и preview-изображение модели, определяет категорию объекта и переносит модель в соответствующую папку. Запуск скрипта осуществляется с помощью файла ai_3d_sorter_current.bat. Вся информация по работе скрипта содержится в папке docs, файл AI_3DSorter_QuickStart_Guide.pdf

Требования для работы скрипта:
Для работы AI 3D Sorter требуется установленный LM Studio и локально загруженная AI-модель Qwen3-VL.
Скрипт не содержит встроенную AI-модель и не работает сам по себе без запущенного локального сервера LM Studio. Пользователь должен самостоятельно установить LM Studio, скачать модель qwen/qwen3-vl-8b, загрузить её в LM Studio и включить сервер во вкладке Developer.
Рекомендуемая модель: qwen/qwen3-vl-8b
LM Studio должен быть запущен, модель должна быть загружена, а локальный сервер должен иметь статус Running. По умолчанию скрипт ожидает подключение к LM Studio по адресу: http://127.0.0.1:1234 
Перед сортировкой рекомендуется нажать кнопку «Проверить LM Studio» в интерфейсе AI 3D Sorter. Если модель и сервер настроены правильно, скрипт подтвердит готовность подключения.

Как скрипт обрабатывает файлы модели:
AI 3D Sorter работает по связкам файлов с одинаковым основным названием. Обычно такая связка состоит из архива модели и preview-изображения
Скрипт считает такую пару одной моделью: архив используется как основной файл модели, а preview-изображение — для визуального анализа и определения категории.
Если рядом с архивом находятся дополнительные файлы с тем же названием, которые не входят в рабочую связку модели, они могут быть удалены в процессе обработки. Это сделано для очистки лишних файлов и сохранения аккуратной структуры библиотеки.
Если для одной модели найдено несколько preview-изображений, скрипт выбирает одно изображение для анализа и сортировки. Остальные preview-файлы этой модели удаляются как дубликаты. Все удаленные файлы помещаются в папку _Trash в дереве библиотеки.

Перед первым реальным запуском рекомендуется использовать тестовый режим и убедиться, что скрипт правильно определяет пары «архив + preview». Если в папке есть важные дополнительные файлы, лучше заранее сделать резервную копию исходной папки.

Основные возможности:
1. Автоматическая сортировка 3D-моделей по категориям.
2. Анализ имени файла и preview-изображения модели.
3. Распознавание моделей даже при буквенно-численных или неинформативных именах файлов, если рядом есть preview-изображение.
4. Поддержка стандартной и пользовательской структуры библиотеки.
5. Создание структуры папок библиотеки по умолчанию.
6. Сопоставление папок пользователя с категориями библиотеки по умолчанию.
7. Возможность сопоставить несколько стандартных категорий с одной пользовательской папкой.
8. Редактор библиотеки для настройки категорий, путей и AI-подсказок.
9. Тестовый режим для проверки сортировки перед реальным переносом файлов.
10. Ручная проверка и корректировка результатов сортировки по двойному клику в поле пути каждой модели.
11. Подробные логи сортировки с описанием объекта, выбранной категорией и итоговым путём.
12. Поддержка русского и английского языков интерфейса.
13. Поддержка тёмной и светлой темы оформления.
14. Пакетная обработка большого количества моделей.
15. Реальное перемещение файлов по папкам библиотеки.
16. Увеличение preview-изображения по двойному клику с закрытием окна по Esc.