AI Film Recommender DLE

AI Film Recommender для DataLife Engine

AI Film Recommender добавляет на сайт отдельную страницу подбора фильмов и сериалов по текстовому запросу пользователя. Запрос может описывать настроение, жанр, желаемую атмосферу, сюжет, страну производства, период выпуска или другую комбинацию условий.

Модуль не импортирует сторонние материалы и не выводит произведения, отсутствующие в базе сайта. AI используется для формирования списка рекомендаций, после чего модуль ищет соответствующие публикации DLE и отображает только найденные записи.

Принцип работы

1. Пользователь отправляет текстовый запрос через AJAX-интерфейс модуля.
2. Запрос дополняется настройками каталога сайта и инструкциями администратора.
3. Выбранный AI-провайдер возвращает структурированный список: оригинальное название, локализованные названия и год выпуска.
4. Модуль сопоставляет полученные данные с публикациями DLE по настроенным дополнительным полям и заголовку материала.
5. Найденные публикации выводятся через стандартный механизм show.short.php и выбранный TPL-шаблон.

Поддерживаемые AI-провайдеры

• OpenAI (GPT) — отдельный API-ключ, выбор модели, веб-поиск, принудительный веб-поиск и настройка глубины поискового контекста.
• Google Gemini — отдельный API-ключ, выбор модели и веб-поиск через Google Search grounding.
• DeepSeek — отдельный API-ключ и выбор модели; встроенный веб-поиск для этого провайдера не используется.

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

Настройка промпта и тематики каталога

Администратор задаёт контекст, в котором AI должен формировать рекомендации. Доступны готовые профили:

• фильмы и сериалы разных стран;
• корейские дорамы;
• аниме;
• турецкие сериалы;
• индийское кино;
• пользовательский профиль.

Для любого профиля можно указать собственное описание каталога и дополнительные инструкции. Это позволяет учитывать специализацию сайта, язык названий, состав базы и правила формирования рекомендаций.

Сопоставление рекомендаций с базой DLE

• Упорядоченные поля названий. Администратор выбирает несколько дополнительных полей и задаёт их приоритет. Первым указывается поле оригинального названия, далее можно добавить локализованные названия и заголовок публикации как резервный источник.
• Проверка года выпуска. Можно выбрать несколько полей года и настроить строгий, предпочтительный или отключённый режим сопоставления.
• Структурированный ответ AI. При поиске учитываются оригинальное название, альтернативные названия и год, а не только одна текстовая строка.
• Детерминированный выбор. При нескольких совпадениях учитываются приоритет источника названия, соответствие года и ID публикации.
• Совместимость XFields. Для старых версий DLE поддерживается формат xfields.txt, для новых — xfields.json и DLEXFields.

Отображение результатов

• Результаты формируются из реальных публикаций сайта.
• Для карточек можно указать отдельный TPL-шаблон без изменения основного shortstory.tpl.
• Поддерживаются стандартные теги DLE и дополнительные поля, обрабатываемые через show.short.php.
• Количество выводимых рекомендаций настраивается в административной панели.
• Страница модуля имеет отдельные SEO Title, Description и Keywords.

Кеширование и ограничения запросов

• Ответы AI сохраняются в структурированном JSON-кеше с учётом провайдера, модели, режима веб-поиска, профиля сайта и других параметров запроса.
• Разные профили и настройки не используют общий кеш, даже если пользователь отправил одинаковый текст.
• Старый кеш предыдущих версий читается только в совместимом контексте и переносится в новый формат.
• Для каждой группы пользователей задаётся отдельный почасовой лимит запросов.
• Счётчик увеличивается только после успешного получения и формирования результата.
• В административной панели доступен просмотр состояния и безопасная очистка кеша модуля.

Прокси и сетевые запросы

Для обращений к AI API можно включить общий прокси. Поддерживаются HTTP, SOCKS5 и SOCKS5H, а также авторизация по имени пользователя и паролю. SOCKS5H выполняет разрешение доменных имён через прокси.

URL и SEO-маршруты

• Модуль всегда доступен по внутреннему адресу index.php?do=ai-film-recommender.
• Можно включить отдельный ЧПУ-префикс страницы, например /ai-films/.
• На DLE 19.0 и новее правила модуля синхронизируются с rules.json.
• При синхронизации проверяются конфликты, создаётся резервная копия и изменяются только правила, принадлежащие модулю.
• Для старых версий DLE в панели выводятся правила для ручной настройки веб-сервера.

Административная панель

Панель управления оформлена стандартными компонентами DLE и разделена на три части:

• Настройки — провайдеры, модели, веб-поиск, прокси, профиль сайта, сопоставление полей, шаблон результатов, лимиты и SEO;
• Управление кешем — информация о файлах кеша, проверка и очистка;
• URL и SEO-маршруты — настройка и синхронизация ЧПУ.

API-ключи и пароль прокси не выводятся после сохранения. Административные действия проверяют права доступа и токен user_hash.

Совместимость и требования

• DataLife Engine: 14.x–20.0.
• PHP: 7.4–8.4.
• Расширения PHP: cURL, JSON, mbstring.
• AI API: требуется ключ хотя бы одного поддерживаемого провайдера.
• База материалов: для точного поиска необходимо настроить хотя бы одно реальное дополнительное поле оригинального названия; поле года рекомендуется, но не обязательно.

Особенности эксплуатации

• Качество результата зависит от состава базы сайта, заполненности названий и года выпуска, выбранной модели и текста запроса пользователя.
• Веб-поиск используется только провайдерами, которые поддерживают соответствующий режим.
• Модуль выводит только те рекомендации, для которых найдено соответствие среди публикаций сайта.
• Изменяемый файл конфигурации создаётся после сохранения настроек и не входит в установочный архив, поэтому обновление модуля не перезаписывает настройки сайта.

Видео-превью