Бот — участник группы для ИИ и ваших систем

Бот NCraft — такой же участник группы, как человек: своя личность, своё место в группе, тот же журнал. Он всегда на связи и управляется не экраном, а REST — человеком, ИИ-ассистентом или вашей системой задач.

Что умеет

• BotApi v1 — тот же словарь методов ядра, что у браузера: группы, состав, заметки, задачи, сообщения, темы, непрочитанное.
• Запрещено боту: добавлять и отзывать устройства, создавать, восстанавливать и забывать личность, выдавать 24 слова.
• Мост MCP nb_bot — для ассистентов вроде Claude Code и Codex: здоровье, методы, вызов метода, вести.
• Посредник системы задач: личный разговор с ботом, @ник, задача на бота, ответ на вопрос системы.
• Пометка «Бот» в составе и в чате.

Как подключить

• Позвать в группу может владелец: код из 26 знаков, бот «стучится», обе стороны сверяют шесть цифр — как с человеком.
• «Настройки бота» у владельца: состояние, система задач (ключ уходит боту), профили логики, права бота, логи бота.
• «Добавить бота» → «Уже стоит на сервере» — окно приглашения с командами для сервера (см. «Linux» ниже); версия бота и «есть новее» — в окне бота. На macOS (и в сборке App Store) и iPhone; Windows и Android — позже.
• «Поставить бота» — на ваш сервер по ssh: выпуск с проверкой подписи и sha256, установка, вступление по коду. Хосты: Linux, macOS, Windows. Только в сборках с сайта — в сборках App Store и Microsoft Store этой функции нет.
• REST бота слушает только 127.0.0.1 и требует токен.

Linux

Бот для Linux — пакет ncraft из репозитория https://dl.ncraft.live/apt (Debian и Ubuntu, amd64 и arm64). Справка на сервере — man ncraft.

Установка. Подключите репозиторий и поставьте пакет:

sudo curl -fsSL https://dl.ncraft.live/apt/ncraft.gpg -o /usr/share/keyrings/ncraft.gpg
echo "deb [signed-by=/usr/share/keyrings/ncraft.gpg] https://dl.ncraft.live/apt stable main" | sudo tee /etc/apt/sources.list.d/ncraft.list
sudo apt update && sudo apt install ncraft

Пакет ставит программу ncraft, службу systemd nb-bot и системного пользователя nbbot. Службу установка не запускает: личность бот получает при первом ncraft join.

Вступление в группу.

1. В NCraft откройте меню группы, выберите «Позвать человека» и скопируйте код приглашения. Звать бота может только владелец группы.
2. На сервере выполните sudo ncraft join <код>. В первый раз команда заводит бота (имя по умолчанию «NCraft Bot», другое — --name <имя>) и запускает службу.
3. Команда печатает шесть цифр. Сверьте их с цифрами в окне приглашения и отвечайте «да», только если они совпали: цифры защищают от того, кто подсмотрел код. Затем подтвердите в приложении.

В другую группу — снова sudo ncraft join с кодом этой группы.

Владелец. Владелец бота — владелец первой группы, в которую он вступил: только он меняет настройки бота из приложения. Сменить владельца — sudo -u nbbot ncraft owner --dir /var/lib/nb-bot --person <ключ> (ключ личности, 64 знака hex), затем перезапустить службу. Команды owner и system запускаются от пользователя nbbot: файлы, записанные от root, служба не прочтёт.

Служба. systemctl status nb-bot — работает ли бот; journalctl -u nb-bot — журнал: только виды событий, без содержимого сообщений; ncraft version — версия. Данные бота — в /var/lib/nb-bot, доступны только пользователю nbbot; резервная копия — вместе с сервером.

Обновление. sudo apt update && sudo apt upgrade ставит новую версию и перезапускает работающую службу.

Удаление. sudo apt remove ncraft останавливает службу и оставляет личность и данные бота — его можно поставить снова. sudo apt purge ncraft стирает и личность с данными: восстановить бота после этого нельзя. Уберите его из групп в приложении.

Статус

Бот из apt проверен живьём: установка, вступление в группу владельца, обновление, удаление. Сборки бота для установки по ssh (Linux, macOS, Windows) раздаются с asia.ncraft.live и проверяются подписью.