mcub-commander

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