Быстрый старт

Сначала проверьте версию и справку, затем клиент. doctor --output-json — диагностический отчёт; проверяйте поля и код выхода.

ml-cli --version
ml-cli doctor --output-json
ml-cli status
ml-cli env list --page-no 1 --page-size 20
ml-cli cloudphone list --page-no 1 --page-size 20

При необходимости передайте API ID и API Key в login. Bearer-ключ Local API передаётся отдельно при вызовах. Ниже заполнители. Приоритет: --port → ML_PORT → IPC.

ml-cli login --api-id YOUR_API_ID --api-key YOUR_API_KEY
export ML_API_KEY="YOUR_LOCAL_API_KEY"
ml-cli --port 40000 env list

$env:ML_API_KEY = "YOUR_LOCAL_API_KEY"
ml-cli --port 40000 env list

--json-data (псевдоним --json) задаёт базовый объект; явные флаги имеют приоритет. Пропущенные сохраняют JSON. Логические параметры приложений требуют явного true или false; false сохраняется. Обязательные поля см. в справке.

ml-cli --format table env list
ml-cli --fail-on-business-error cloudphone info --id "$PHONE_ID"
ml-cli --verbose env list
ml-cli --quiet env list
ml-cli env list | jq ".data.dataList"

По умолчанию JSON. --format table — сокращённый вид; для вложенных полей и конвейеров используйте JSON. --verbose выводит диагностику в stderr и скрывает известные секретные поля; --quiet подавляет успешный stdout. Вместе они недопустимы.

• 0: нормальное завершение. Без строгой проверки HTTP 2xx может содержать бизнес-ошибку.

• 1: ненулевой бизнес-code при --fail-on-business-error либо неподдерживаемая операция, например env arrange в Linux.

• 2: неверные аргументы/JSON, локальная проверка, ошибки порта/сети, HTTP не 2xx или вывода. Ошибки обнаружения и строгой проверки клиента также дают 2; проверяйте статус.

Тайм-аут по умолчанию 15 секунд, для env core-download — 1810. --timeout переопределяет его. Для браузера задавайте 30 секунд, для открытия/включения телефона — 120.

IPC: /tmp/MoreLogin-cli в macOS/Linux и \\.\pipe\MoreLogin-cli в Windows. При connect EPERM 127.0.0.1:<port> проверьте локальные разрешения ИИ и статус до повторного запуска. Тайм-аут не доказывает сбой; перед повторной записью прочитайте состояние.