pgames-manager/docs/F95.md

Импорт данных и обложек F95zone

Кнопка «Подтянуть» в формах создания и редактирования игры загружает название, описание, теги и превью. Изображение сохраняется на сервере в WebP; обложка игры меняется только после сохранения формы. Перед сохранением превью можно убрать.

Cookie привязаны к текущему пользователю приложения. Если они отсутствуют, истекли или F95zone запросил вход, открывается окно авторизации с возможностью отказаться. Уже полученные название, описание и теги остаются в форме. При отказе автоматических повторов нет; можно заполнить данные вручную.

Чтобы добавить сессию:

1. Войдите в свой аккаунт F95zone в браузере и откройте тему игры.
2. Нажмите F12 → «Приложение» (Application) → «Хранилище» → «Файлы cookie» → https://f95zone.to.
3. Выберите строку xf_user и скопируйте только содержимое колонки «Значение» в одноимённое поле окна авторизации. Если копируете из нижней панели Cookie Value, отключите «Показать декодированные параметры URL». При необходимости добавьте xf_session таким же способом. Имена cookie, домен, путь и срок действия копировать не нужно.
4. Нажмите «Сохранить и повторить». Импорт повторится с вашими cookie.

xf_user — токен «запомнить меня», xf_session — идентификатор текущей сессии. В XenForo вход может подтверждаться одним из них; начните с xf_user, либо используйте xf_session, если xf_user отсутствует. Это не гарантирует доступ через защиту F95zone. См. пояснение разработчика XenForo. xf_csrf и TSVB_UID для этого импорта не запрашиваются.

Если сайт блокирует запрос, откройте «Если F95zone блокирует запрос» и добавьте cf_clearance из той же таблицы. Необязательный User-Agent находится в Network → запрос страницы темы → Request Headers → User-Agent. cf_clearance привязан к посетителю и устройству; перенос cookie из браузера на сервер может не сработать (документация Cloudflare).

Cookie используется для запроса темы и скачивания картинки. Сессия хранится зашифрованной в записи вашего пользователя; другие пользователи её не используют. Значения не возвращаются через API и не сохраняются в localStorage. Кнопка «Забыть cookie F95zone» удаляет вашу сессию. При повторном отказе в доступе сохранённая сессия сбрасывается и окно предлагает ввести новые cookie либо отказаться. Успешный доступ к F95zone зависит также от защиты сайта; ответ 403 может означать блокировку автоматических запросов, а не только истёкшую сессию.

После обновления приложения примените миграции до 0005 обычным способом (Docker-образ применяет их при запуске backend). Установите обновлённые зависимости backend. Шифрование использует SECRET_KEY; при смене ключа пользователям потребуется заново добавить cookie. Общие F95_COOKIE и F95_USER_AGENT из .env больше не используются; перезапуск сервера для изменения личной сессии не требуется.

Импорт выбирает og:image, а при его отсутствии — первую доступную bbImage из первого сообщения вне скрытых блоков. Поддерживаются изображения на f95zone.to и его поддоменах; внешние хостинги пропускаются. Скачивание ограничено 20 МиБ, переходы за пределы F95zone блокируются до отправки cookie. Если изображение скачать не удалось, текстовые данные импортируются с сообщением об ошибке превью; текущая обложка игры сохраняется.