First commit
This commit is contained in:
343
EXAMPLES.md
Normal file
343
EXAMPLES.md
Normal file
@@ -0,0 +1,343 @@
|
||||
# Примеры использования 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` для справки по командам
|
||||
Reference in New Issue
Block a user