6. CLI и агенты
Управляйте Saba-chan из терминала и поручите это своему ИИ-агенту, например Claude Code или Codex.
6. CLI и агенты
saba-chan-cli — инструмент для работы с Saba-chan из терминала. Терминал — это окно, в которое вводят команды. Всё, что умеет приложение, умеет и CLI. Как и приложение, CLI только просит демона и никогда сама не трогает файлы серверов. Ею удобно пользоваться людям, и она умеет выдавать машиночитаемый вывод, поэтому с её помощью можно передать Saba-chan своему ИИ-агенту.
Работа с CLI
CLI лежит в папке, куда установлен Saba-chan (по умолчанию C:\Program Files\Saba-chan\saba-chan-cli.exe). Установщик не меняет системный PATH (список папок, где Windows ищет команды). Вызывайте CLI по полному пути или добавьте эту папку в PATH сами. В Linux установщик создаёт ~/.local/bin/saba-chan-cli.
- Без аргументов открывается интерактивный экран.
- Если демон не запущен, CLI спросит, запустить ли его. После закрытия CLI демон и серверы продолжают работать.
- Достаточно части имени сервера.
| Что нужно | Команда |
|---|---|
| Общее состояние | saba-chan-cli status |
| Добавить сервер | saba-chan-cli server add |
| Запуск · остановка · перезапуск | saba-chan-cli start pal · stop pal · restart pal |
| Консоль · игровая команда | saba-chan-cli console pal · saba-chan-cli run выходн say Привет |
| Бэкапы · задачи по расписанию | saba-chan-cli backup … · saba-chan-cli schedule … |
| Подключить Discord | saba-chan-cli bot pair (показывает код и ждёт подключения) |
| Права на команды · команды по уровням | saba-chan-cli perm … · perm commands |
| Уровень уточняющих вопросов в Discord | saba-chan-cli bot confirm |
| Префикс сервера Discord · вид слэш-команд | saba-chan-cli bot prefix … · bot slash … |
| Читающая Saba-chan · управление сервером Discord | saba-chan-cli bot tts … · bot moderation · bot channel … |
| Инструменты Говорящей Saba-chan | saba-chan-cli chatbot tools (изменить: chatbot set tools=[lol,pubg] --guild …) |
| Подключённые ИИ-агенты (удалённые): просмотр · отключение | saba-chan-cli bot agent · bot agent --unlink |
| Обновления Saba-chan | saba-chan-cli update check · update apply |
| Удалённый демон | saba-chan-cli remote … · --daemon <имя> у любой команды (Удалённый демон) |
| Перейти в приложение | saba-chan-cli gui |
| Удалить все мои данные | saba-chan-cli bot erase |
| Подробная справка | saba-chan-cli <команда> --help |
Подключение своего ИИ-агента
Любой ИИ-агент, который умеет выполнять команды терминала, например Claude Code или Codex, может присматривать за Saba-chan вместо вас. Агент принимает просьбы обычными словами, как человек, за кадром запускает saba-chan-cli и читает результат.
Чтобы агенты могли на неё полагаться, CLI соблюдает такие правила.
--json: в стандартный вывод идёт ровно один JSON-документ. Подсказки и ход выполнения идут в стандартный поток ошибок. При неудаче в нём естьerror,error_codeи, если есть,suggestions.- Коды выхода:
0успех,1ошибка,2неверное использование или несколько подходящих целей,3нет связи с демоном,4цель не найдена,130отменено. help --json: полное дерево команд, аргументы, глобальные параметры и таблица кодов выхода в JSON. Работает даже при выключенном демоне. Пусть агент сначала читает это, а не заучивает команды.--json-stream: долгие задачи (установка сервера, обновления) сообщают о ходе выполнения по одному JSON-объекту в строке, результат — в последней строке.events --json: построчно следит за событиями демона (запуск и остановка серверов, ход установки и т. п.).do: список действий, которые предлагает демон.do действие --planпоказывает, что изменится, ещё до выполнения.
Что человек делает сам
- Команды, требующие подтверждения, вне терминала не спрашивают, а останавливаются и выполняются только с
--yes. Пусть агент спрашивает вас, прежде чем добавить--yesк необратимому действию, например удалению или сбросу сервера. - Принять EULA игры и согласиться запускать непроверенный модуль без изоляции нельзя через
--yesили--json. Это делает человек в терминале или в приложении.
Пример для инструкций агента
Добавьте в файл инструкций агента (например AGENTS.md или CLAUDE.md) что-то вроде этого. Поправьте путь под свою папку установки.
## Игровые серверы Saba-chan
- Управлять игровыми серверами только через saba-chan-cli: "C:\Program Files\Saba-chan\saba-chan-cli.exe"
- Один раз прочитать команды и аргументы через `saba-chan-cli help --json`.
- Добавлять --json к каждой команде и проверять код выхода (0 успех, 1 ошибка, 2 использование или неоднозначно, 3 нет демона, 4 не найдено).
- Спрашивать человека, прежде чем добавить --yes к необратимому действию, например удалению или сбросу сервера.
- Принятие EULA и отключение изоляции оставлять человеку.
Подключение ИИ-агента удалённо (MCP)
Даже если ИИ-агент вроде ChatGPT или Claude не может пользоваться терминалом вашего ПК, его можно подключить к облаку Saba-chan как удалённый MCP и поручить ему игровые серверы на вашем ПК. Он управляет всеми ПК, подключёнными к вашему аккаунту Discord, так же, как приложение.
- На экране добавления коннектора (удалённого MCP-сервера) в агенте введите
https://saba-chan.online/mcp. Этот адрес также виден на экране Настройки → Подключение приложения, в/mysaba agentи вsaba-chan-cli bot agent. - Когда в браузере откроется вход в Discord, войдите в аккаунт Discord, к которому подключён ваш ПК, и разрешите доступ на экране согласия Saba-chan.
- Просите агента обычными словами. Например: «Покажи состояние сервера Minecraft», «Перезапусти сервер Palworld».
Что стоит знать.
- К одному аккаунту Discord подключается только один агент. Если вы разрешите другого агента, ранее подключённый отключается.
- Об опасных командах, остановке и перезапуске агент спрашивает ещё раз на своём экране перед выполнением (те же правила, что и в приложении). Через Discord он не спрашивает.
- То, что заблокировано в Saba-chan веб (настройки только для ПК, например пути и пароли, обновление Saba-chan и т. п.), нельзя сделать и через агента.
- Отключение: кнопка
Отключить агентана экране Настройки → Подключение приложения,/mysaba agentв Discord илиsaba-chan-cli bot agent --unlink. Подключение, которым не пользовались 90 дней, обрывается само.