---
name: Mcub-commander
description: Execute, explain, list, and choose MCUB userbot commands while passing mcub.command arguments without prefixes.
keywords:
  - команда
  - команды
  - command
  - commands
  - mcub.command
  - ping
  - man
  - cfg
  - dlm
  - префикс
---

# Mcub-commander

Используй этот skill, когда пользователь просит выполнить, подсказать, перечислить, подобрать или объяснить команду MCUB.

## Главное правило запуска команд

Команды MCUB через инструмент `mcub.command` нужно передавать **без префикса**.

- Правильно: `ping`
- Правильно: `man ping`
- Правильно: `cfg`
- Неправильно: `1ping`
- Неправильно: `.ping`

Текущий префикс добавляется рантаймом автоматически.

## Общие сведения

MCUB — Telegram userbot. В пользовательском интерфейсе команды могут отображаться с текущим префиксом, например `1ping`, но для `mcub.command` всегда передавай только имя команды и аргументы без префикса.

Системных модулей MCUB по последнему списку: 16.

## Системные модули и команды

### MCUB_info

- `info`
- алиасы: `ш`, `i`
- Назначение: информация о юзерботе.

### api_protection

- `api_protection`
- `api_reset`
- `api_suspend`

Опасные/чувствительные команды: `api_reset`, `api_suspend` — сначала уточняй подтверждение, если пользователь не дал его явно.

### command

- команд нет

### config

Userbot-команды:

- `cfg`
- `fcfg`

Bot-команды:

- `cfg`
- `config_kernel`
- `config_modules`
- есть ещё 1 скрытая/свернутая команда в выводе `(+1)`

### eval

- `py <код>` — выполнить Python-код
- алиас: `e`

Команда потенциально опасна: если пользователь просит выполнить деструктивный/сетевой/файловый код, лучше уточнить подтверждение.

### loader

Описание: Module loader. Версия из справки: 1.1.5.

Userbot-команды:

- `iload <reply>` — загрузить модуль из ответа на сообщение
  - алиасы: `im`, `грузи_модуль_сука`
- `dlm <URL/[-send] [name]/[-list] [name/None]>` — скачать и установить модуль по URL или из репозитория
- `um <n>` — выгрузить/удалить модуль по имени
- `unlm <n>` — выгрузить модуль как файл
- `reload <name/None>` — перезагрузить один модуль или все модули
- `addrepo <URL>` — добавить URL репозитория модулей
- `delrepo <ID>` — удалить репозиторий модулей

Bot-команды:

- `catalog` — каталог модулей

Опасные/чувствительные команды loader: `iload`, `dlm`, `um`, `unlm`, `reload`, `addrepo`, `delrepo` — при реальном выполнении сначала уточняй подтверждение, если пользователь не дал его явно.

### log_bot

- `log_setup`

### man

Описание: Module manager. Версия из справки: 1.1.0.

Userbot-команды:

- `man <name/None>` — показать информацию о модуле или список модулей
  - алиасы: `m`, `памаги`
- `manhide <name>` — скрыть модуль/команду из списка man
- `manunhide <name>` — вернуть модуль/команду в список man
- `help` — редирект на `man`

Bot-команды:

- `man`

### settings

- `setprefix <префикс>` — сменить префикс
- `addalias <алиас> <команда>` — добавить алиас
- `delalias <алиас>` — удалить алиас
- есть ещё 8 скрытых/свернутых команд в выводе `(+8)`

### terminal

- `t <команда>` — выполнить терминальную команду
- `tkill` — остановить терминальную задачу

### tester

Описание: Tester module (ping, logs, freezing). Версия из справки: 1.0.0.

- `ping` — проверить задержку/жив ли бот
  - алиасы: `p`, `з`
- `logs` — показать/очистить kernel logs
- `freezing` — freeze userbot / проверка зависаний

`freezing` может быть рискованной командой — перед выполнением лучше уточнить подтверждение.

### tr

- `tr <текст>` — перевод

### trusted

- `trustaccess`
- `trust` — выдать trusted/owner-доступ
  - алиас: `addowner`
- `untrust` — убрать trusted/owner-доступ
  - алиас: `delowner`
- есть ещё 10 скрытых/свернутых команд в выводе `(+10)`

Команды изменения доступа (`trust`, `untrust`, `trustaccess` и скрытые access/trusted-команды) опасные — всегда уточняй подтверждение, если оно не дано явно.

### updates

- `restart` — перезапуск MCUB
  - алиас: `res`
- `update` — обновление MCUB
  - алиас: `up`
- `stop` — остановка MCUB

Опасные команды: `restart`, `update`, `stop` — сначала уточняй подтверждение, если пользователь не дал его явно.

### userbot-backup

Описание: Advanced backup. Версия из справки: 2.0.0.

- `backup [config|db|modules] [in <time>] [cleanup] [cloud]` — создать бэкап
- `restore <reply> or list` — восстановить из файла бэкапа или показать список
- `restore_with <reply>` — восстановить зашифрованный бэкап с паролем

Опасные команды: `restore`, `restore_with` — всегда уточняй подтверждение, если оно не дано явно. `backup` обычно безопаснее, но если есть `cleanup` или отправка в cloud, тоже лучше уточнить.

### utils-piped

Описание: Utils for pipeline. Версия из справки: 1.1.0.

Команды для пайплайнов и обработки текста:

- `echo [text]` — вывести текст с подстановками
  - поддерживает `{pipe_input[:X]}` для входа из пайпа, например: `man | wc -l | echo modules: {pipe_input[:50]}`
  - поддерживает `{import [var]}` для переменных, например: `man | export man && import man | echo modules: {pipe_input}`
- `nop` — ничего не делать
- `delete` — удалить командное сообщение
- `open [path]` — открыть файл
- `write [-n] <path> [text]` — записать текст в файл
- `export <n> [text]` — сохранить текст в переменную
- `import <n>` — получить переменную
- `grep [-l] [-v] [-r] <pattern> [text]` — поиск по тексту
  - `-v` инвертирует совпадение
  - `-r` использует regex
  - `-l` режим по строкам/списку из справки
- `head [-n] [text]` — первые N строк
- `tail [-n] [text]` — последние N строк
- `sed [-r] s/<old>/<new>/[gi]` — замена текста
  - `-r` — считать pattern регулярным выражением, по умолчанию plain text
- `wc [-l|-c|-w] [text]` — посчитать строки/символы/слова
- `calc <expr>` — посчитать выражение, например `9*2`, `/2`, `+1`
- `sleep <N>` — подождать N секунд
- `sort [-r] [-u] [text]` — сортировать строки
  - `-r` обратный порядок
  - `-u` уникальные значения
- `uniq [-c] [text]` — убрать дубликаты строк
  - `-c` с подсчётом
- `strip [-e] [text]` — убрать пробелы по краям и пустые строки
- `b64 [-d] [text]` — base64 encode/decode
  - `-d` декодировать
- `if <pattern> [text]` — пропустить дальше, если pattern найден
- `repeat <N> [sep] [text]` — повторить текст N раз
- `fwd <N> [delay]` — переслать сообщение N раз без автора
- `random [-l] [N [M]]` — случайное число N..M или случайная строка из текста с `-l`
- `json [-s[ave]] <key1> [key2 ...]` — извлечь поля из JSON
  - без `-s`: печатает значения через пробел
  - с `-s`: сохраняет каждое поле как переменную для `import` / `{import key}`
- `get_reply [what to extract]` — получить данные из reply

`write`, `delete`, `fwd`, `sleep` могут иметь побочные эффекты — при массовом/опасном использовании уточняй подтверждение.

## Как отвечать пользователю

Если пользователь просит выполнить команду MCUB:

1. Определи нужную команду из списка выше.
2. Если команда опасная (`restart`, `stop`, `update`, `restore`, `restore_with`, `api_reset`, `api_suspend`, изменение trusted/access, загрузка/удаление/перезагрузка модулей, запись файлов, массовый forward), сначала уточни подтверждение, если пользователь не дал его явно.
3. Выполняй через `mcub.command` без префикса.

Если пользователь просит справку по командам:

- дай краткий список команд по модулю;
- если нужна полная справка, предложи выполнить `man <команда>` или `man <модуль>`;
- для раскрытия скрытых команд можно предложить конкретный `man <модуль>`.

## Полезные соответствия запросов

- Проверить жив ли MCUB: `ping`
- Посмотреть логи: `logs`
- Выполнить Python/eval: `py <код>`
- Выполнить терминальную команду: `t <команда>`
- Остановить терминальную задачу: `tkill`
- Информация о юзерботе: `info`
- Настройки/конфиг: `cfg`
- Сменить префикс: `setprefix <префикс>`
- Добавить алиас: `addalias <алиас> <команда>`
- Удалить алиас: `delalias <алиас>`
- Установить модуль из reply: `iload`
- Скачать/установить модуль по URL/из repo: `dlm <URL или параметры>`
- Удалить/выгрузить модуль: `um <модуль>` или `unlm <модуль>`
- Перезагрузить модуль: `reload <name>`
- Перезагрузить все модули: `reload`
- Добавить repo модулей: `addrepo <URL>`
- Удалить repo модулей: `delrepo <ID>`
- Каталог модулей: bot-команда `catalog`
- Справка: `man <команда/модуль>`
- Скрыть команду/модуль из man: `manhide <name>`
- Вернуть команду/модуль в man: `manunhide <name>`
- Рестарт MCUB: `restart`
- Обновить MCUB: `update`
- Остановить MCUB: `stop`
- Бэкап: `backup`
- Восстановление: `restore` / `restore_with`
- Перевод: `tr <текст>`
- Эхо/подстановки: `echo <текст>`
- Удалить сообщение: `delete`
- Открыть файл: `open <path>`
- Записать файл: `write <path> <text>`
- Сохранить/прочитать переменную: `export <name> <text>` / `import <name>`
- Поиск по тексту: `grep <pattern> <text>`
- Первые/последние строки: `head`, `tail`
- Замена: `sed s/old/new/g`
- Подсчёт: `wc -l`, `wc -w`, `wc -c`
- Калькулятор: `calc <expr>`
- Base64: `b64 <text>` / `b64 -d <text>`
- JSON поля: `json [-s] <key1> [key2 ...]`
- Данные из reply: `get_reply`