ayako/IMAGES.md

Работа с изображениями в VNDB Telegram Bot

📸 Поддерживаемые изображения

Бот может отправлять изображения для:

• 🎮 Визуальные новеллы - обложки и постеры
• 👤 Персонажи - аватары и официальные картинки
• 📦 Релизы - коробки и обложки физических изданий

🚀 Использование изображений

1. Автоматическая отправка при поиске

При поиске бот автоматически отправляет изображения для первых 3 результатов:

/search Steins Gate

Бот вернёт:

• 📝 Текстовую информацию со списком найденных ВН
• 🖼️ Обложки первых 3 ВН

2. Детальный просмотр с полной информацией

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

Просмотр визуальной новеллы

/vn_detail v17

Отправит:

• 🎮 Обложку ВН (высокое качество)
• 📋 Полная информация:
  • Название и оригинальное название
  • Дата выпуска
  • Рейтинг и количество голосов
  • Длительность
  • Разработчик
  • Описание
  • Ссылка на VNDB

Просмотр персонажа

/char_detail c1

Отправит:

• 👤 Аватар персонажа
• 📋 Информация:
  • Имя и оригинальное имя
  • Пол
  • Группа крови
  • Список ВН, в которых появляется персонаж
  • Описание

Просмотр релиза

/release_detail r1

Отправит:

• 📦 Картинку релиза
• 📋 Информация:
  • Название
  • Дата выпуска
  • Платформа
  • Тип (оригинальный, фан-перевод и т.д.)
  • Языки
  • Издание
  • ВН, к которой относится
  • Описание

🎨 Примеры

Поиск и просмотр ВН

# Найти ВН по названию
/search Clannad

# Просмотреть детали найденной ВН
/vn_detail v4

Поиск и просмотр персонажа

# Найти персонажа
/char Nagisa

# Просмотреть детали персонажа
/char_detail c82

Поиск и просмотр релиза

# Найти релиз
/release Clannad Windows

# Просмотреть детали релиза
/release_detail r500

🔗 Как найти ID элемента

ID визуальной новеллы

• На сайте VNDB URL выглядит как: https://vndb.org/v17
• ID: v17

ID персонажа

• На сайте VNDB URL: https://vndb.org/c1
• ID: c1

ID релиза

• На сайте VNDB URL: https://vndb.org/r123
• ID: r123

ID посредством поиска

При поиске бот показывает ID в формате:

1. **Steins;Gate**
   ID: v17

Скопируйте ID и используйте в команде подробного просмотра:

/vn_detail v17

⚠️ Обработка ошибок при изображениях

Если изображение недоступно или бот не может его отправить:

• Бот вернёт текстовую информацию без изображения
• Информация будет полной и точной
• Вы по-прежнему можете посетить VNDB напрямую для просмотра изображения

🌐 Источник изображений

Все изображения загружаются с официального CDN VNDB:

• URL база: https://t.vndb.org
• Качество: Оптимальное для отображения в Telegram

💡 Советы

1. Для быстрого поиска: используйте /search, /char, /release

   • Автоматически получите первые изображения
   • Быстрый просмотр информации

2. Для подробной информации: используйте /vn_detail, /char_detail, /release_detail

   • Полная информация о элементе
   • Высокое качество изображения
   • Ссылка на официальный VNDB

3. Сочетание команд: сначала найдите элемент, потом просмотрите детали

   /search Steins Gate
   # Видите v17 в результатах
   /vn_detail v17
   # Получаете полную информацию с обложкой
   

📝 Примечания

• Не все элементы имеют изображения в VNDB
• Если изображение отсутствует, бот отправит только текстовую информацию
• Качество изображений зависит от наличия и разрешения в базе данных VNDB
• Бот поддерживает максимум до 3 изображений при поиске (для экономии трафика и скорости)

---

Для других вопросов см. /help или README.md