📖 Документация Telegram-бота «Перлика»
Перлика — это Telegram-бот, который помогает разбираться в лоре игры Arknights, а также предоставляет инструменты для администрирования чатов.
Бот всё еще находится на стадии разработки. Вы можете подписаться на официальный телеграм канал, где будут публиковаться дальнейшие обновления.
👋 Команда /start
Описание
Запускает бота в личных сообщениях и выводит приветственное сообщение.
Где работает
✅ Личные сообщения
❌ В группах не используется
Пример
/start
Ответ бота
Привет, Доктор! 👋 Я Перлика — помощник по лору Arknights. Помогаю разбираться в сюжете, персонажах, фракциях и событиях игры. Иногда могу отвечать с ошибками — я всё ещё учусь 💙 Задавай любой вопрос по лору!
⚙️ Система триггеров
Триггеры позволяют боту автоматически отвечать на определённые слова или фразы в чате.
что такое оригиниум
Бот может автоматически отправить заранее заданный ответ.
⚠ Управлять триггерами могут только администраторы чата.
➕ /settriger
Описание
Добавляет новый триггер в чат.
Когда сообщение содержит указанный триггер — бот отправит заданный текст.
Где работает
✅ Только в группах
❌ Не работает в личных сообщениях
Кто может использовать
Формат команды
/settriger "триггер" текст
Пример
/settriger "оригиниум" Оригиниум — источник энергии в мире Arknights.
Ответ бота
✅ Триггер "оригиниум" добавлен.
❌ /delltriger
Описание
Удаляет существующий триггер из чата.
Где работает
Формат
/delltriger "триггер"
Пример
/delltriger "оригиниум"
Ответ бота
🗑 Триггер "оригиниум" удалён.
📋 /triggerlist
Описание
Показывает список всех триггеров в текущем чате.
Пример
/triggerlist
Ответ
📋 Список триггеров: • оригиниум • родос • инфекция
👋 Система приветствия (Welcome)
Бот может автоматически отправлять приветственное сообщение, когда новый участник входит в чат.
⚙️ Переменные welcome
Можно использовать переменные:
Пример
Добро пожаловать {user}!
Добро пожаловать @username!
➕ /setwelcome
Описание
Устанавливает приветственное сообщение для новых участников.
Кто может использовать
Где работает
Способ 1 — текст
/setwelcome Добро пожаловать {user} в наш чат!
Способ 2 — ответ на сообщение
Можно ответить на сообщение с:
/setwelcome
Способ 3 — медиа + текст
Ответьте на медиа и добавьте текст:
/setwelcome Добро пожаловать {user}!
Ответ бота
✅ Welcome успешно сохранён.
❌ /delwelcome
Удаляет приветственное сообщение.
Формат
/delwelcome
Ответ
🗑 Welcome успешно удалён.
⚠ Welcome не установлен.
🤖 Управление AI Перлики
Перлика может работать как ИИ-ассистент по лору Arknights.
Администраторы могут управлять её состоянием.
🧠 /clearai
Описание
После команды бот забывает контекст разговора.
Формат
/clearai
Ответ
🧠 Перлика всё забыла...
Альтернативные фразы
забыть всё
перезагрузиться
перлика забудь
▶️ /onai
Описание
Кто может использовать
Формат
/onai
Ответ
🤖 Перлика включена.
⛔ /offai
Описание
Формат
/offai
Ответ
🚫 Перлика выключена.
💬 Общение с Перликой
В личных сообщениях можно просто написать вопрос.
кто такая кал'цит
👥 В группах
перлика кто такая кал'цит
2️⃣ ответили на сообщение бота
🧠 Память диалога
20 сообщений
10 последних сообщений
🔗 Привязка AI к теме форума
Команда позволяет закрепить работу ИИ Перлики только внутри одной темы форума в группе Telegram.
Это удобно, если в группе несколько тем и нужно, чтобы бот не отвечал везде.
📌 /bindtopic
Описание
Привязывает ИИ Перлики к текущей теме форума.
После этого бот будет реагировать только на сообщения внутри этой темы.
Все остальные темы будут игнорироваться.
Кто может использовать
Где работает
✅ Только в группах
✅ Только в темах форума
Формат команды
/bindtopic
Привязать тему
Важное условие
Команда должна быть отправлена внутри темы форума.
Если написать её вне темы, бот ответит:
Команду нужно написать внутри темы.
Успешный ответ
✅ Перлика теперь живёт только в этой теме.
Как использовать
1️⃣ Создайте тему форума в группе
2️⃣ Зайдите в неё
3️⃣ Напишите:
/bindtopic
После этого Перлика будет отвечать только там.
⏱ Ограничение частоты ответов
Чтобы бот не спамил в чатах, действует ограничение.
Перлика отвечает не чаще одного раза в 10 секунд на чат.
Если пользователь ответил на сообщение бота, ограничение снимается.
📚 Использование базы лора
Если вопрос связан с лором игры Arknights, Перлика использует базу знаний.
💬 Обычный режим общения
Если вопрос не связан с лором, Перлика отвечает как обычный чат-ассистент.
👤 Определение адресата
Перлика может понимать, кому адресовано сообщение.
перлика скажи васе что он прав
Бот попытается определить пользователя Васю среди активных участников чата.
👥 Учёт участников чата
Бот хранит список последних активных пользователей, чтобы:
💬 Индикатор печати
Перед отправкой ответа бот показывает:
typing...
Это создаёт ощущение реального набора сообщения.
⚠️ Ошибки AI
Если возникает ошибка при работе ИИ, бот отвечает:
Перлика заебалась... 💭