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)

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

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

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

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

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

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

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

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

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

# 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

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

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

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

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

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

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

Эффективный способ использования:

/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 напрямую для просмотра картинок
• Сообщить об ошибке, если проблема повторяется

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

📚 Исследование ВН

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

👥 Изучение персонажей

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

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

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

🏷️ Просмотр категорий

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

---

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