ayako/EXAMPLES.md

# Примеры использования VNDB Telegram Bot

## Быстрый старт

### 1. Начало работы

Напишите боту:
```
/start
```

Бот вернёт приветственное сообщение с основной информацией.

### 2. Справка

Для просмотра всех доступных команд:
```
/help
```

## Примеры основных команд

### Поиск визуальных новелл

#### Простой поиск
```
/search Steins Gate
```

**Результат:**
- Список из 10 найденных ВН с основной информацией
- Рейтинг и количество голосов
- Дата выпуска
- Автоматическая отправка обложек первых 3 результатов 📸

#### Различные запросы
```
/search Clannad
/search Fate
/search Genshin
/search Tsukihime
```

### Поиск персонажей

#### Простой поиск
```
/char Okabe Rintaro
```

**Результат:**
- Список найденных персонажей
- Информация о поле персонажа
- В каких ВН появляется персонаж
- Аватары первых 3 персонажей 🖼️

#### Другие примеры
```
/char Nagisa
/char Sakura
/char Saber
/char Rem
```

### Поиск релизов

#### Поиск по платформе
```
/release Windows
/release Switch
/release PlayStation
```

#### Поиск по названию
```
/release Steins Gate Windows
/release Clannad PS2
```

## Детальный просмотр с картинками

### Просмотр ВН

Сначала найдите ВН:
```
/search Steins Gate
```

Видите в результатах: `v17` - это ID Steins;Gate

Затем просмотрите детали:
```
/vn_detail v17
```

**Получите:**
- Высокое качество обложки
- Полная информация:
  - Название: Steins;Gate
  - Оригинальное название: シュタインズ・ゲート
  - Дата выпуска: 2009-09-15
  - Рейтинг и голоса
  - Длительность
  - Разработчик
  - Подробное описание
  - Прямая ссылка на VNDB

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

Найдите персонажа:
```
/char Okabe
```

Видите: `c4 - Okabe Rintaro`

Посмотрите детали:
```
/char_detail c4
```

**Получите:**
- Аватар персонажа высокого качества
- Информация:
  - Имя и оригинальное имя
  - Пол
  - Группа крови
  - Связанные ВН
  - Биография

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

Найдите релиз:
```
/release Steins Gate Windows
```

Видите ID релиза в результатах

Посмотрите детали:
```
/release_detail r12345
```

## Информационные команды

### Статистика базы данных
```
/stats
```

**Результат:**
- Количество ВН
- Количество персонажей
- Количество релизов
- Количество продюсеров
- Количество сотрудников
- Количество тегов
- Количество черт характера

### Популярные теги
```
/tag
```

**Результат:**
- Список 15 самых популярных тегов
- Категории и описания

### Черты характера персонажей
```
/trait
```

**Результат:**
- Список 15 самых распространённых черт
- Количество персонажей с каждой чертой

### Случайные цитаты
```
/quote
```

Получить одну случайную цитату

```
/quote 3
```

Получить 3 случайные цитаты (максимум 5)

## Расширенные примеры

### Изучение конкретной ВН

```bash
# 1. Поиск ВН
/search Clannad

# 2. Просмотр полной информации (видите обложку и описание)
/vn_detail v4

# 3. Если интересует персонаж из Clannad
/char Nagisa

# 4. Просмотр информации о персонаже
/char_detail c82

# 5. Поиск выпусков для разных платформ
/release Clannad Windows

# 6. Просмотр конкретного релиза
/release_detail r500
```

### Исследование визуальных новелл от одного разработчика

```bash
# 1. Поиск ВН от Key (фамилия разработчика)
/search Key

# 2. Посмотрите детали найденных ВН
/vn_detail v17    # Steins;Gate
/vn_detail v4     # Clannad
/vn_detail v1     # Air

# 3. Изучите персонажей из каждой ВН
/char Nagisa      # из Clannad
/char Okabe       # из Steins;Gate
```

### Поиск информации о персонаже

```bash
# 1. Найти персонажа по имени
/char Saber

# 2. Посмотреть его подробную информацию
/char_detail c1234

# 3. Найти его родственные ВН в списке
# (информация включена в /char_detail)
```

## Советы и трюки

### Совет 1: Комбинирование команд

Эффективный способ использования:
```bash
/search [название]  # Найдите элемент
/[type]_detail [id] # Посмотрите детали
```

### Совет 2: Использование ID

После поиска вы видите ID в скобках:
```
1. **Steins;Gate** (v17)
```

Скопируйте ID и используйте:
```
/vn_detail v17
```

### Совет 3: Максимум информации за раз

Команды подробного просмотра дают максимум информации:
- Картинку (если есть)
- Все основные данные
- Описание
- Связанные элементы
- Ссылку на оригинальный сайт

### Совет 4: Работа с изображениями

- **Быстрый поиск**: используйте `/search`, получите автоматические картинки
- **Качество**: используйте `/vn_detail` и т.д. для лучшего качества картинок
- **Нет картинки**: если элемента нет в VNDB, текстовая информация всё равно будет доступна

## Обработка ошибок

### Если ничего не найдено
```
/search очень_редкое_название
# Результат: 😞 Ничего не найдено
```

Попробуйте:
- Изменить орфографию
- Использовать часть названия
- Попробовать русское или английское название

### Если элемент не существует
```
/vn_detail v999999
# Результат: 😞 ВН с ID v999999 не найдена
```

Убедитесь, что:
- ID правильный
- ID на самом сайте VNDB имеет этот вид

### Если картинка не загружается
Текстовая информация по-прежнему будет отправлена. Вы можете:
- Попробовать ещё раз
- Посетить https://vndb.org напрямую для просмотра картинок
- Сообщить об ошибке, если проблема повторяется

## Полезные команды для разных целей

### Исследование ВН
```bash
/stats           # Сколько всего ВН
/search [имя]    # Найти конкретную ВН
/vn_detail [id]  # Полная информация о ВН
```

### Изучение персонажей
```bash
/char [имя]           # Найти персонажа
/char_detail [id]     # Полная информация о персонаже
/trait                # Посмотреть черты характера
```

### Поиск релизов
```bash
/release [название]   # Найти релиз
/release_detail [id]  # Информация о релизе
/search [ВН]          # Найти ВН и её релизы
```

### Просмотр категорий
```bash
/tag                  # Теги и категории
/trait                # Черты характера
/schema               # Полная информация о полях API
```

---

**Нужна помощь?** Напишите `/help` для справки по командам