Перейти до вмісту

Швидкий старт

Спочатку перевірте версію та довідку, потім клієнт. 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, вивід і коди виходу

--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> перевірте локальні дозволи ШІ й статус до повторного запуску. Тайм-аут не доводить збій; перед повторним записом прочитайте стан.