Update 86 files

- /rag/commands/expert.py
- /core/services/__init__.py
- /core/services/embedding_service.py
- /core/services/file_service.py
- /core/services/giga_client.py
- /core/services/kb_service.py
- /core/services/postgres_service.py
- /core/services/qdrant_service.py
- /core/services/reranker_service.py
- /core/functions/__init__.py
- /core/functions/check_consistency.py
- /core/functions/check_spelling.py
- /core/functions/critique_answer.py
- /core/functions/expand_query.py
- /core/functions/extract_metrics.py
- /core/functions/file_processor.py
- /core/functions/generate_document.py
- /core/functions/intent_classify.py
- /core/functions/rerank_context.py
- /core/functions/summarize_document.py
- /core/utils/__init__.py
- /core/utils/arg_parser.py
- /core/utils/config_loader.py
- /core/utils/layout_converter.py
- /core/utils/logger.py
- /core/utils/text_utils.py
- /core/utils/web_utils.py
- /bots/commands/__init__.py
- /bots/commands/base.py
- /bots/commands/create.py
- /core/commands/global_remove.py
- /core/commands/help.py
- /core/commands/info.py
- /core/commands/kb.py
- /core/commands/learn.py
- /core/commands/other.py
- /core/commands/registry.py
- /core/commands/stats.py
- /core/commands/template.py
- /core/handlers/__init__.py
- /core/handlers/message_handler.py
- /core/workers/__init__.py
- /core/workers/indexing_worker.py
- /core/xmpp/__init__.py
- /core/xmpp/client.py
- /bots/commands/global_remove.py
- /bots/commands/help.py
- /bots/commands/info.py
- /bots/commands/kb.py
- /bots/commands/registry.py
- /bots/commands/other.py
- /bots/commands/template.py
- /bots/commands/learn.py
- /bots/commands/stats.py
- /bots/handlers/message_handler.py
- /bots/handlers/__init__.py
- /bots/workers/__init__.py
- /bots/workers/indexing_worker.py
- /bots/xmpp/__init__.py
- /bots/xmpp/client.py
- /rag/services/qdrant_service.py
- /rag/services/giga_client.py
- /rag/services/embedding_service.py
- /rag/services/reranker_service.py
- /rag/services/__init__.py
- /rag/services/file_service.py
- /rag/services/postgres_service.py
- /rag/services/kb_service.py
- /rag/functions/check_spelling.py
- /rag/functions/__init__.py
- /rag/functions/extract_metrics.py
- /rag/functions/generate_document.py
- /rag/functions/expand_query.py
- /rag/functions/critique_answer.py
- /rag/functions/file_processor.py
- /rag/functions/check_consistency.py
- /rag/functions/summarize_document.py
- /rag/functions/rerank_context.py
- /rag/functions/intent_classify.py
- /rag/utils/__init__.py
- /rag/utils/layout_converter.py
- /rag/utils/text_utils.py
- /rag/utils/arg_parser.py
- /rag/utils/config_loader.py
- /rag/utils/logger.py
- /rag/utils/web_utils.py

bots/commands/help.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+"""
+Команда !help – показывает справку по всем командам или конкретной команде.
+Алиасы: !справка, /help, /справка.
+"""
+
+import logging
+from core.commands.base import Command
+
+logger = logging.getLogger(__name__)
+
+
+class HelpCommand(Command):
+    name = "!help"
+    aliases = ["!справка", "/help", "/справка"]
+
+    async def execute(self, msg, args: str, user_jid: str, room_jid: str = None):
+        """
+        Если указано имя команды – показывает справку по ней.
+        Иначе – список всех доступных команд.
+        """
+        _, flags, pos = self.parse_args(args)
+        if pos:
+            cmd_name = pos[0].lower()
+            cmd_obj = self.bot.commands.get(cmd_name)
+            if cmd_obj:
+                help_text = cmd_obj.get_help()
+                reply = msg.reply(help_text)
+                if reply:
+                    reply.send()   # исправлено
+                else:
+                    logger.error("Не удалось отправить справку по команде")
+            else:
+                reply = msg.reply(f"❓ Команда '{cmd_name}' не найдена. Напишите `!help` для списка команд.")
+                if reply:
+                    reply.send()   # исправлено
+                else:
+                    logger.error("Не удалось отправить сообщение о неизвестной команде")
+        else:
+            # Общая справка
+            lines = ["**Доступные команды:**"]
+            # Сортируем по имени команды
+            for name, cmd in sorted(self.bot.commands.items()):
+                if name == cmd.name:   # только основные имена (без алиасов)
+                    lines.append(f"  • {cmd.name} – {cmd.get_help().splitlines()[0]}")
+            reply = msg.reply("\n".join(lines))
+            if reply:
+                reply.send()   # исправлено
+            else:
+                logger.error("Не удалось отправить общий список команд")
+
+    def get_help(self) -> str:
+        return "Показывает справку. Использование: `!help` или `!help команда`"