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