First commit

IMAGES.md

@@ -0,0 +1,177 @@
+# Работа с изображениями в 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