added and updaded help

README.md

@@ -6,9 +6,9 @@
 ## Список дел
 
 - [X] Команда /start
-- [ ] Команда /help
+- [X] Команда /help
 - [X] Команда /mute
-- [ ] Команда /unmute
+- [X] Команда /unmute
 - [X] Команда /ban
 - [X] Команда /unban
 - [ ] Фильтрация сообщений

src/config.py

@@ -9,31 +9,71 @@ LOG_FILE_NAME = 'bot.log'
 
 # Сообщения команд
 COMMAND_MESSAGES = {
-    'start': 'Бот-модератор для чата @linux_gaming_ru',
-    'help': 'пусто',
+    'start': 'Бот-администратор для чата @linux_gaming_ru',
+    'help': (
+        "<b>📚 Справочник команд администратора</b>\n\n"
+        "<u>Основные команды:</u>\n"
+        "• <code>/start</code> - Начало работы\n"
+        "• <code>/help</code> - Этот справочник\n\n"
+        "<u>🛠 Команды модерации:</u>\n"
+        "• <code>/mute help</code> - Инструкция по муту\n"
+        "• <code>/unmute help</code> - Снятие мута\n"
+        "• <code>/ban help</code> - Инструкция по бану\n"
+        "• <code>/unban help</code> - Снятие бана\n\n"
+        "<i>ℹ️ Для подробностей по конкретной команде используйте: /команда help</i>"
+    ),
     'manual_mute': (
-        'ℹ️ Использование мута:\n'
-        '1️⃣ Ответьте на сообщение: <code>/mute время</code>\n'
-        '2️⃣ Укажите тэг: <code>/mute @username время</code>\n'
-        '3️⃣ Укажите ID: <code>/mute 123456789 время</code>\n\n'
+        "<b>🔇 Команда /mute</b>\n\n"
+        "<i>Ограничивает права пользователя на указанное время</i>\n\n"
+        "<u>🕒 Форматы времени:</u>\n"
+        "• Минуты: <code>10м</code>, <code>30м</code>\n"
+        "• Часы: <code>1ч</code>, <code>3ч</code>\n"
+        "• Дни: <code>1д</code>, <code>7д</code>\n\n"
+        "<u>🎯 Способы использования:</u>\n"
+        "1. Ответ на сообщение:\n"
+        "   <code>/mute 30м причина</code>\n"
+        "2. По тегу пользователя:\n"
+        "   <code>/mute @username 1ч спам</code>\n"
+        "3. По ID пользователя:\n"
+        "   <code>/mute 123456789 1д нарушение правил</code>\n\n"
+        "<b>⚠️ Максимальный срок: 30 дней</b>\n"
+        "<i>ℹ️ Причину стараться указывать</i>"
     ),
     'manual_unmute': (
-        'ℹ️ Использование размута:\n'
-        '1️⃣ Ответьте на сообщение: <code>/unmute время</code>\n'
-        '2️⃣ Укажите тэг: <code>/unmute @username время</code>\n'
-        '3️⃣ Укажите ID: <code>/unmute 123456789 время</code>\n\n'
+        "<b>🔊 Команда /unmute</b>\n\n"
+        "<i>Снимает ограничения с пользователя</i>\n\n"
+        "<u>🎯 Способы использования:</u>\n"
+        "1. Ответ на сообщение:\n"
+        "   <code>/unmute</code>\n"
+        "2. По тегу пользователя:\n"
+        "   <code>/unmute @username</code>\n"
+        "3. По ID пользователя:\n"
+        "   <code>/unmute 123456789</code>\n\n"
+        "<i>ℹ️ Работает только для временно замученных пользователей</i>"
     ),
     'manual_ban': (
-        'ℹ️ Использование бана:\n'
-        '1️⃣ Ответьте на сообщение: <code>/ban</code>\n'
-        '2️⃣ Укажите тэг: <code>/ban @username</code>\n'
-        '3️⃣ Укажите ID: <code>/ban 123456789</code>'
+        "<b>🚫 Команда /ban</b>\n\n"
+        "<i>Навсегда исключает пользователя из чата</i>\n\n"
+        "<u>🎯 Способы использования:</u>\n"
+        "1. Ответ на сообщение:\n"
+        "   <code>/ban причина</code>\n"
+        "2. По тегу пользователя:\n"
+        "   <code>/ban @username спам</code>\n"
+        "3. По ID пользователя:\n"
+        "   <code>/ban 123456789 нарушение правил</code>\n\n"
+        "<b>⚠️ Добавляет в ЧС</b>\n"
+        "<i>ℹ️ Для разбана используйте /unban</i>"
     ),
     'manual_unban': (
-        'ℹ️ Использование разбана:\n'
-        '1️⃣ Ответьте на сообщение: <code>/unban</code>\n'
-        '2️⃣ Укажите тэг: <code>/unban @username</code>\n'
-        '3️⃣ Укажите ID: <code>/unban 123456789</code>'
+        "<b>✅ Команда /unban</b>\n\n"
+        "<i>Снимает бан с пользователя</i>\n\n"
+        "<u>🎯 Способы использования:</u>\n"
+        "1. По тегу пользователя:\n"
+        "   <code>/unban @username</code>\n"
+        "2. По ID пользователя:\n"
+        "   <code>/unban 123456789</code>\n\n"
+        "<b>⚠️ Работает только для забаненных через /ban</b>\n"
+        "<i>ℹ️ Пользователь сможет снова присоединиться</i>"
     ),
     'no_admin_rights': '❌ Только администраторы могут использовать эту команду.',
     'no_restrict_rights': '❌ У вас недостаточно прав.',

src/modules/help.py

@@ -0,0 +1,24 @@
+from telebot.async_telebot import AsyncTeleBot
+from telebot.types import Message
+import logging
+
+from config import COMMAND_MESSAGES
+
+logger = logging.getLogger(__name__) # Получаем логгер для текущего модуля
+
+def register_handlers(bot: AsyncTeleBot): # Регистрирует все обработчики команд
+
+    @bot.message_handler(commands=['help']) # Обработчик команды /help
+    async def help_command(message: Message):
+
+        # Отправка сообщения в тему или обычный чат
+        send_message = bot.reply_to if message.is_topic_message else bot.send_message
+        chat_id = message if message.is_topic_message else message.chat.id
+
+        try:
+
+            await send_message(chat_id, COMMAND_MESSAGES['help'])
+            logger.info(f"Пользователь {message.from_user.id} запустил /help.")
+
+        except Exception as e:
+            logger.error(f"Пользователь {message.from_user.id} запустил /help: {str(e)}")