> For the complete documentation index, see [llms.txt](https://farmnet.gitbook.io/youtube-uploader-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://farmnet.gitbook.io/youtube-uploader-documentation/cli.md).

# Командная строка (для продвинутых)

Управление программой из скриптов и ИИ-агентов — команды с ответом в JSON

Всё, что делается в окне программы, — профили, группы, прокси, запуск задач, сценарии, расписания, настройки, лицензия — можно делать и командами из командной строки. Каждая команда отвечает одним JSON-документом, а успех или ошибку сообщает кодом выхода.

Это нужно для автоматизации: своих скриптов, Планировщика заданий Windows, ИИ-агентов (например, Claude или ChatGPT с доступом к терминалу). Если вы работаете в окне программы, этот раздел можно пропустить.

{% hint style="info" %}
Командная строка не заменяет окно полностью. Вход в учётную запись FARMNET выполняется только в окне программы, а задача `Ручной режим` из командной строки не запускается — ей нужен человек.
{% endhint %}

## Перед началом

1. Хотя бы один раз запустите программу обычным способом. При первом запуске она создаёт свою базу данных (`data\profiles.db` в папке программы).
2. Там же, в окне, активируйте лицензию или войдите в учётную запись FARMNET — см. [Лицензия и доступ](https://farmnet.gitbook.io/youtube-uploader-documentation/licenzii.md). Командная строка пользуется той же лицензией.
3. Откройте терминал (cmd или PowerShell).

## Как запустить

В папке программы есть три способа, и все отвечают одинаково:

| Способ                                   | Когда удобен                                                                                                |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `farmnet-cli.bat <команда>`              | в терминале: ждёт окончания команды и возвращает её код выхода                                              |
| `"Farmnet Launcher.exe" --cli <команда>` | в скриптах, которые сами читают вывод программы                                                             |
| `"FARMNET Uploader.exe" --cli <команда>` | старое имя программы — работает как раньше, с тем же ответом и кодом выхода; старые скрипты менять не нужно |

`Farmnet Launcher.exe` — программа с окном, поэтому интерактивная командная строка Windows не ждёт её завершения. В терминале пользуйтесь `farmnet-cli.bat`.

Примеры для cmd:

```bat
cd /d "C:\Farmnet Launcher"
farmnet-cli.bat schema
farmnet-cli.bat doctor --pretty
```

Для PowerShell:

```powershell
cd "C:\Farmnet Launcher"
.\farmnet-cli.bat doctor --pretty
.\farmnet-cli.bat tasks list
```

Файл `farmnet-cli.bat` можно вызывать и по полному пути из любой папки — данные всё равно берутся из папки программы (если не указан `--root`, см. ниже).

## С чего начать

| Команда                 | Что делает                                                                                                                                                                                                                                                                        |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `schema`                | полное описание всех команд, их аргументов, кодов выхода и задач — в JSON. ИИ-агенту стоит начинать с неё                                                                                                                                                                         |
| `doctor`                | проверка установки: база данных, лицензия, модули, браузер, ffmpeg, настройки, прокси. Ничего не меняет. Если какая-то проверка провалена — код 5: в `data.errors` названия проваленных проверок, а в `data.checks` — подробности по каждой и, где это возможно, подсказка `hint` |
| `modules list`          | какие модули установлены, какие загрузились, а какие нет и почему                                                                                                                                                                                                                 |
| `tasks list`            | список задач с кратким описанием                                                                                                                                                                                                                                                  |
| `tasks describe upload` | одна задача: её параметры и готовые примеры                                                                                                                                                                                                                                       |

У каждой команды есть справка: `farmnet-cli.bat run --help`.

## Формат ответа

В стандартный вывод (stdout) команда пишет ровно **один** JSON-документ. Успех:

```json
{"ok": true, "command": "profiles.list", "data": { ... }, "warnings": []}
```

Ошибка:

```json
{"ok": false, "command": "run",
 "error": {"code": "missing_proxy", "message": "...", "hint": "как исправить", "details": { ... }},
 "warnings": []}
```

* `ok` говорит о самой команде. Запуск, в котором часть профилей не справилась, — это `"ok": true` с кодом выхода 6.
* В `error.code` — машинный код ошибки, в `error.hint` — подсказка, как её исправить.
* Журнал работы идёт в поток ошибок (stderr; уровень — `--log-level`, по умолчанию `WARNING`), а целиком — в файл журнала в папке `data\logs`.
* Кириллица по умолчанию выводится как `\u0441...`, чтобы её не испортила кодировка консоли Windows. `--utf8` выводит текст как есть, `--pretty` — с отступами.
* Пароли, секреты 2FA и пароли прокси в ответах скрыты. Показать их можно флагом `--show-secrets`.

## Коды выхода

| Код | Значение                                                                                                                                            |
| --- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 0   | успешно                                                                                                                                             |
| 1   | внутренняя ошибка программы — подробности в `data\logs`                                                                                             |
| 2   | неверные аргументы или параметры — исправьте ввод                                                                                                   |
| 3   | не найден профиль, группа, прокси, шаблон, расписание или запуск                                                                                    |
| 4   | лицензия недействительна или не открывает модуль, из которого задача — см. `license status`, `modules list`                                         |
| 5   | отказ: нужно подтверждение `--yes` или не выполнено условие (нет базы, прокси, ключа SMS, профили заняты и т. п.) — см. `error.code` и `error.hint` |
| 6   | выполнено частично: часть профилей не справилась или пропущена, либо часть строк импорта не прошла — всё перечислено в `data`                       |
| 130 | запуск остановлен до конца (Ctrl+C, `--timeout`, `runs stop`) или процесс, который его вёл, завершился                                              |

## Общие параметры

Их можно ставить до или после команды.

| Параметр         | Что делает                                                               |
| ---------------- | ------------------------------------------------------------------------ |
| `--root ПАПКА`   | папка с данными (см. ниже)                                               |
| `--pretty`       | JSON с отступами                                                         |
| `--utf8`         | кириллица без `\u`-экранирования                                         |
| `--log-level`    | подробность журнала в stderr: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `OFF` |
| `--show-secrets` | показывать пароли и секреты в ответах                                    |
| `--init`         | разрешить создать новую пустую базу данных в папке `--root`              |

## Папка с данными (--root)

* По умолчанию команды работают с данными в папке программы — там, где лежит `Farmnet Launcher.exe`, из какой бы папки вы их ни запускали.
* `--root D:\farm2` — работать с другой папкой данных: своя база профилей, свои журналы и результаты. То же задаёт переменная окружения `UNI_UPLOADER_ROOT` (старое имя, сохранено для совместимости); `--root` важнее неё.
* В этой папке должна быть база `data\profiles.db`. Если её нет, команда откажет с кодом `no_database` — это защита от опечатки в пути. Новую пустую базу создаёт флаг `--init`.
* Настройки программы, шаблоны уникализатора и лицензия — одни на всю установку программы: их видят окно и все команды, с любым `--root`.
* Модули берутся из установки программы, а не из папки данных.
* **Относительные пути** в командах и в JSON-файлах считаются от папки, **из которой вы запускаете команду**, а не от `--root`. Исключения — строки файла со списком видео (они считаются от папки самого списка) и путь к файлу куки внутри файла импорта (он сначала ищется рядом с этим файлом).

## Как передавать JSON

Параметры задач (`--params`), описание запуска (`--spec`) и другие JSON-аргументы принимаются:

* строкой прямо в команде;
* путём к файлу `.json` (или `@путь`);
* символом `-` — тогда JSON читается со стандартного ввода.

{% hint style="warning" %}
Windows PowerShell 5.1 съедает кавычки внутри JSON, написанного прямо в команде. В PowerShell всегда передавайте JSON **файлом**. Файлы должны быть в кодировке UTF-8 или UTF-16 (в PowerShell 5.1: `Out-File -Encoding utf8`).
{% endhint %}

## Защита от ошибок

* **Удаление, сброс и другие необратимые действия ничего не делают без `--yes`.** Без флага команда отвечает списком того, что было бы затронуто (код 5, `confirmation_required`). Это удобно как предварительный просмотр.
* **`run` отказывает там же, где отказывает кнопка `Старт` в окне:** нет подходящих профилей; у профилей нет прокси, а пул пуст; в очереди привязка номера, а ключ SMS не задан; профили уже заняты в другом запуске (`profiles_busy`).
* Профили со статусом `Забанен` и `Ограничен` в запуск не берутся, пока не указан `--include-terminal`.
* Профили другой платформы, чем у задач, отбрасываются (они перечисляются в плане запуска); задачи двух разных платформ в одном запуске не допускаются.
* Окно программы и командная строка могут вести запуски одновременно, но один профиль не может работать в двух запусках сразу.

## Основные команды

Идентификаторы профилей записываются списком с диапазонами: `1,2,5-9`. Группу можно указать номером или точным названием.

### Профили — profiles

```bat
farmnet-cli.bat profiles list --group Farm1 --status error
farmnet-cli.bat profiles show 12
farmnet-cli.bat profiles formats
farmnet-cli.bat profiles import C:\accounts\batch.txt --new-group Batch-0925 --dry-run
farmnet-cli.bat profiles import C:\accounts\batch.txt --new-group Batch-0925
farmnet-cli.bat profiles add --login user@gmail.com --password YOUR_PASSWORD --proxy host:port:user:pass --group Farm1
farmnet-cli.bat profiles tag 1-20 --add warmup
farmnet-cli.bat profiles move 5,7 --group Farm2
farmnet-cli.bat profiles export --group Farm1 --out farm1.json
farmnet-cli.bat profiles results 12
farmnet-cli.bat profiles delete 5 --yes
```

* `profiles formats` описывает все форматы файлов, которые понимает импорт, с примерами. Импорт читает те же форматы, что и окно (подробнее — [Профили, группы и прокси](https://farmnet.gitbook.io/youtube-uploader-documentation/upravlenie-akkauntami-i-proksi.md)).
* `--dry-run` у импорта ничего не создаёт и показывает, что получится.
* `profiles export` сохраняет профили в полном формате — вместе с отпечатком браузера и cookies (у запускавшегося профиля — из его браузера).
* Если программа закрылась аварийно и профиль остался в статусе `Активен`, верните его командой `profiles update 12 --status inactive`.

### Группы — groups

```bat
farmnet-cli.bat groups list
farmnet-cli.bat groups create Farm2 --description "Новые аккаунты"
farmnet-cli.bat groups update Farm2 --name Farm-02
farmnet-cli.bat groups merge Farm2 Farm3 --into Farm1 --yes
farmnet-cli.bat groups delete Farm2 --keep-profiles --yes
```

{% hint style="danger" %}
Как и в окне, `groups delete` удаляет группу **вместе с её профилями** и прокси группы. Чтобы сохранить профили, добавьте `--keep-profiles` — они переедут в группу `Unsorted`. `groups merge` переносит профили в целевую группу, а исходные группы удаляет вместе с их собственными прокси.
{% endhint %}

### Прокси — proxies

```bat
farmnet-cli.bat proxies add --file C:\proxies.txt --group Farm1 --check
farmnet-cli.bat proxies list --status dead
farmnet-cli.bat proxies check --all --geo
farmnet-cli.bat proxies assign --group Farm1 --dry-run
farmnet-cli.bat proxies assign --group Farm1 --mode missing --yes
farmnet-cli.bat proxies unbind 12
```

* Формат строк: `host:port`, `host:port:user:pass`, `user:pass:host:port`, `user:pass@host:port`, `host:port@user:pass` или `схема://…` (`http`, `https`, `socks4`, `socks5`). Порт обязателен.
* Без `--group` прокси попадают в общий пул — прокси без группы, из которого берут профили любой группы (см. «Общий пул» в разделе [Профили, группы и прокси](https://farmnet.gitbook.io/youtube-uploader-documentation/upravlenie-akkauntami-i-proksi.md)).
* `--check` у добавления и `--geo` у проверки заодно определяют страну живых прокси.
* `proxies assign` закрепляет прокси из пула за профилями один к одному. Режимы: `missing` — только профилям без прокси (по умолчанию), `all` — всем, сохраняя существующие пары, `rebuild` — раздать заново. План, который отнимает у профиля прокси или сажает два профиля на один IP, требует `--yes`.

### Задачи — tasks

```bat
farmnet-cli.bat tasks list
farmnet-cli.bat tasks describe upload
```

Имена задач для команд:

| Имя в командах     | Задача в окне                |
| ------------------ | ---------------------------- |
| `login`            | `Вход в аккаунт` (YouTube)   |
| `upload`           | `Загрузка видео`             |
| `connect_number`   | `Привязка номера`            |
| `create_channel`   | `Создание канала`            |
| `edit_channel`     | `Редактирование канала`      |
| `warm_up`          | `Прогрев`                    |
| `gather_stats`     | `Сбор статистики`            |
| `check_status`     | `Проверка статуса`           |
| `instagram_login`  | `Вход в аккаунт` (Instagram) |
| `instagram_upload` | `Загрузка Reels`             |

Задачи появляются только от загруженных модулей: если модуль не установлен или на него нет лицензии, его задач в списке не будет (`tasks list` скажет почему).

### Запуск задач — run

```bat
farmnet-cli.bat run --task check_status --group Farm1 --dry-run
farmnet-cli.bat run --task warm_up --params warm.json --profiles 3,7-9 --workers 2
farmnet-cli.bat run --task login --task upload --params upload.json --tag new --stream
farmnet-cli.bat run --spec run.json --timeout 120
```

Как это устроено:

* **Задачи** — `--task ИМЯ`, у каждой свои `--params` сразу после неё. Задачи выполняются в том порядке, в каком указаны.
* **Профили** — `--profiles 1,2,5-9`, `--group Farm1` (можно несколько раз), `--all`. Фильтры `--tag`, `--status`, `--search` (часть логина) и `--limit` сужают выбор.
* **Параметры запуска** — `--use-proxy` / `--no-use-proxy`, `--auto-login` / `--no-auto-login`, `--store-to-db` / `--no-store-to-db`, `--proxy-country US` (страна прокси из пула; `any` — любая), `--workers 2` (число потоков), `--headless on|off|virtual` (режим браузера только для этого запуска, в настройки не сохраняется; при `on` браузеры работают без окон, и Google чаще показывает им капчу — см. [Настройки](https://farmnet.gitbook.io/youtube-uploader-documentation/funkcii/nastroiki.md)). Не указанные параметры берутся из `--spec`, а затем из настроек программы.
* **`--dry-run`** проверяет всё — параметры задач, профили, прокси, ключ SMS, лицензию — и показывает план, ничего не запуская. Делайте его перед каждым новым запуском.
* **`--timeout 120`** — остановить запуск через 120 минут (код 130).
* **`--force`** — запустить и профили, оставшиеся в статусе `Активен` после аварийного завершения.

Пример файла параметров для залива (`upload.json`, режим списка):

```json
{
  "videos": [
    {"file_path": "C:/videos/clip1.mp4", "title": "My title", "description": "Line one",
     "hashtags": "#shorts #fun", "visibility": "unlisted"},
    {"file_path": "C:/videos/clip2.mp4", "auto_title": true, "auto_description": true,
     "auto_hashtags": true, "publish_at": "2030-01-20T18:30", "publish_timezone": "Moscow"}
  ],
  "identifier_template": "vertical"
}
```

`identifier_template` — имя вашего шаблона уникализатора (список — `identifiers list`); без этого поля загружаются исходные видео. Все поля, режим папки и формат файла со списком видео показывает `tasks describe upload`. Что означают параметры залива — в статье [Загрузка видео (залив)](https://farmnet.gitbook.io/youtube-uploader-documentation/zadachi-youtube/zaliv.md).

Пример описания всего запуска (`run.json`):

```json
{
  "tasks": [
    {"task": "warm_up", "params": {"hashtags": "#cats", "duration_minutes": 15}},
    {"task": "upload", "params": {"videos_file": "C:/videos/list.json"}}
  ],
  "profiles": {"groups": ["Farm1"], "tags": ["new"], "limit": 10},
  "options": {"use_proxy": true, "auto_login": true, "workers": 2,
              "headless": "off", "proxy_country": "US", "timeout_minutes": 90}
}
```

**Что возвращает `run`.** Команда ждёт, пока все профили закончат, и отвечает итогом: счётчики (`totals`: всего, успешно, с ошибкой, пропущено, не закончено), по каждому профилю — статус, ошибку (для ошибок прокси — с подсказкой `hint`) и ссылки на загруженные видео, общий список ссылок `video_urls` и пути к текстовому итогу и файлу истории. Для профилей с ошибкой прикладываются шаги, на которых они остановились (`--include-steps` — для всех профилей).

Запуск из командной строки попадает и в окно программы — в `История` на вкладке `Задачи`.

### Управление запуском — runs

Пока `run` работает в терминале, Ctrl+C останавливает его аккуратно: текущие шаги доделываются, браузеры закрываются, итог записывается. Второй Ctrl+C выдаёт итог, не дожидаясь браузеров.

Если скрипт запускает `run` в фоне, управлять им можно из другого окна терминала:

```bat
farmnet-cli.bat runs list --live
farmnet-cli.bat runs show 3f2a
farmnet-cli.bat runs wait 3f2a --timeout 3600
farmnet-cli.bat runs pause 3f2a
farmnet-cli.bat runs resume 3f2a
farmnet-cli.bat runs cancel-profile 3f2a 12
farmnet-cli.bat runs stop 3f2a
```

* Запуск указывается по его номеру (queue id) или по уникальному началу номера.
* `runs wait` ждёт окончания запуска и отвечает как `runs show`, с кодом выхода самого запуска. Его `--timeout` — в **секундах** (у `run` — в минутах).
* `runs stop` останавливает аккуратно: текущие шаги доделываются, браузеры закрываются, копии уникализатора прекращаются, итог записывается.
* `runs pause` ставит на паузу после текущих шагов, `runs resume` продолжает, `runs cancel-profile` пропускает один профиль.
* Запуски, начатые в окне программы, можно посмотреть (`runs show`), но управлять ими из командной строки нельзя.

**Поток событий.** С флагом `--stream` команда `run` вместо одного ответа пишет по строке JSON на каждое событие: `run_started`, `profile_finished` (по профилю), `control`, `stopping` и в конце — итог с `"event": "result"`. `--stream-logs` добавляет строки журнала. Читайте этот поток до конца: если его никто не читает, запуск может встать.

### Сценарии — scenarios

```bat
farmnet-cli.bat scenarios list
farmnet-cli.bat scenarios show Nightly
farmnet-cli.bat scenarios create Nightly --task login --task upload --params upload.json --group Farm1
farmnet-cli.bat scenarios run Nightly --dry-run
farmnet-cli.bat scenarios run Nightly --stream
farmnet-cli.bat scenarios delete Nightly --yes
```

* Сценарий — сохранённый набор задач, профилей и параметров запуска, тот же, что в окне (см. [Сценарии и расписание](https://farmnet.gitbook.io/youtube-uploader-documentation/planirovshik-i-shablony.md)).
* `--profiles` закрепляет за сценарием конкретные профили; `--group` берёт тех, кто состоит в группе на момент запуска.
* `scenarios run` отвечает и завершается так же, как `run`.
* `scenarios delete` удаляет вместе со сценарием и его расписания.

{% hint style="warning" %}
Сценарии с ветвлениями (`--graph`) и с этапами на разных платформах — новая функция, как и [Конструктор сценариев](https://farmnet.gitbook.io/youtube-uploader-documentation/konstruktor-scenariev.md). Формат описан в `farmnet-cli.bat scenarios create --help`. Проверяйте новый сценарий на паре аккаунтов, а если что-то работает не так — отправьте лог в поддержку.
{% endhint %}

### Расписания — schedules

```bat
farmnet-cli.bat schedules list
farmnet-cli.bat schedules create --scenario Nightly --kind daily --times 03:00,15:00
farmnet-cli.bat schedules create --scenario Upload --kind once --at "2030-01-20 18:30"
farmnet-cli.bat schedules create --scenario Stats --kind weekly --weekday mon --times 09:00
farmnet-cli.bat schedules create --scenario Stats --kind monthly --day 1 --times 10:00
farmnet-cli.bat schedules disable 4
farmnet-cli.bat schedules enable 4
farmnet-cli.bat schedules delete 4 --yes
farmnet-cli.bat schedules run-due
```

* Время — по часам этого компьютера; время в прошлом не принимается.
* Открытое окно программы само запускает расписания (проверяет их каждые 30 секунд). Когда окно закрыто, расписания никто не запускает.
* `schedules run-due` — один «тик» такого планировщика: запускает всё, чему пришло время, по очереди, и ждёт окончания. Поставьте его в Планировщик заданий Windows (например, каждые 10–15 минут), и расписания будут работать без открытого окна.

{% hint style="danger" %}
Не используйте `schedules run-due` при открытом окне программы: окно запускает те же расписания само, и одно расписание может сработать дважды.
{% endhint %}

### Настройки — settings

```bat
farmnet-cli.bat settings list
farmnet-cli.bat settings get worker_count
farmnet-cli.bat settings set worker_count 3
farmnet-cli.bat settings set browser_headless off
farmnet-cli.bat settings set sms_activate_api_key ВАШ_КЛЮЧ
farmnet-cli.bat settings reset --browser-only --yes
```

Логические значения — `true` / `false`. Меняйте настройки при закрытом окне программы: открытое окно показывает старые значения до перезапуска и может записать поверх свои. Если окно открыто — перезапустите его после изменения.

Соответствие настроек в окне (см. [Настройки](https://farmnet.gitbook.io/youtube-uploader-documentation/funkcii/nastroiki.md)) и ключей:

| Настройка в окне                                 | Ключ                                                                                                                               | Значения                                              |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| `Расширенный режим (показать скрытые параметры)` | `advanced_mode_enabled`                                                                                                            | `true` / `false`                                      |
| `Сохранять результаты в базу данных`             | `task_store_to_db`                                                                                                                 | `true` / `false`                                      |
| `Параллельные потоки:`                           | `worker_count`                                                                                                                     | число                                                 |
| `Язык:`                                          | `ui_language`                                                                                                                      | `en`, `ru`                                            |
| `Режим headless:`                                | `browser_headless`                                                                                                                 | `on` (`Вкл`), `off` (`Выкл`), `virtual`               |
| `Человечный курсор:`                             | `browser_humanize`, `browser_humanize_max_time`                                                                                    | `on`, `off`, `custom`; секунды                        |
| `Размер окна (0 = авто):`                        | `browser_window_width`, `browser_window_height`                                                                                    | пиксели, 0 — авто                                     |
| `Использовать прокси`                            | `task_use_proxy`                                                                                                                   | `true` / `false`                                      |
| `Если нет прокси в регионе:`                     | `proxy_search_strict`                                                                                                              | `true` — прервать, `false` — любой живой              |
| `Спрашивать страну прокси перед запуском`        | `proxy_country_prompt`, `proxy_country`                                                                                            | `true` / `false`; код страны (`US`) или пусто         |
| `Операционная система:`                          | `browser_os`                                                                                                                       | `any`, `auto`, `windows`, `macos`, `linux`            |
| `GeoIP:`                                         | `browser_geoip`, `browser_geoip_custom`                                                                                            | `auto`, `off`, `custom`; IP-адрес                     |
| Галочки блокировок                               | `browser_block_images`, `browser_block_webrtc`, `browser_block_webgl`, `browser_disable_coop`                                      | `true` / `false`                                      |
| `API ключ SMS :`                                 | `sms_activate_api_key`                                                                                                             | ключ                                                  |
| страна номеров для привязки                      | `sms_country`                                                                                                                      | название страны, как на YouTube, например `Indonesia` |
| `Авто-вход в аккаунты перед запуском задач`      | `task_auto_login`                                                                                                                  | `true` / `false`                                      |
| окно `Подтверждение запуска`                     | `skip_task_confirm`                                                                                                                | `true` — не показывать                                |
| паузы между шагами                               | `pacing_enabled`, `pacing_block_min_s`, `pacing_block_max_s`, `pacing_task_min_s`, `pacing_task_max_s`, `pacing_long_pause_chance` | `true` / `false`; секунды; доля (0.08 = 8 %)          |

Две настройки есть только здесь — они касаются загрузки файлов куки по ссылкам при импорте профилей:

* `import_ca_file` — путь к дополнительному корневому сертификату (файл PEM). Нужен, если антивирус или сеть компании проверяет защищённые соединения своим сертификатом и загрузка по ссылке из-за этого не проходит.
* `import_allow_plain_http` — разрешить загрузку куки по ссылке `http://` без шифрования (по умолчанию `false`). Такую ссылку программа сначала пробует открыть через `https://`, и обычно этого достаточно. Включайте настройку, только если продавец аккаунтов вообще не поддерживает `https://`: по незашифрованной ссылке куки могут подменить. Безопаснее скачать файл куки самому и указать при импорте путь к нему.

### Шаблоны уникализатора — identifiers

```bat
farmnet-cli.bat identifiers list
farmnet-cli.bat identifiers show vertical
farmnet-cli.bat identifiers example --pretty > start.json
farmnet-cli.bat identifiers create --from start.json --name vertical-2
farmnet-cli.bat identifiers delete vertical-2 --yes
```

Шаблоны общие с окном программы. Имя шаблона указывается в параметре залива `identifier_template`; без шаблона загружаются исходные видео. Как устроены шаблоны — [Уникализатор: как пользоваться](https://farmnet.gitbook.io/youtube-uploader-documentation/unikalizator.md).

### Статистика — stats

```bat
farmnet-cli.bat stats list --group Farm1 --latest
farmnet-cli.bat stats list --profile 12 --limit 10
```

Показывает снимки аналитики, которые собирает задача `Сбор статистики` модуля YouTube (см. [Сбор статистики и база данных](https://farmnet.gitbook.io/youtube-uploader-documentation/zadachi-youtube/sbor-v-bd.md)). Команда появляется, только когда модуль YouTube загружен.

### Лицензия — license

```bat
farmnet-cli.bat license status
farmnet-cli.bat license activate --key ВАШ_КЛЮЧ
farmnet-cli.bat license hwid
```

* `license status` проверяет лицензию и сразу обновляет её данные через интернет. Код 4 — если программу не открывает ни ключ, ни учётная запись FARMNET, в которую вошли в окне программы.
* `license activate` активирует ключ.
* `license hwid` показывает идентификатор этого компьютера — его может попросить поддержка.

Войти в учётную запись FARMNET из командной строки нельзя — только в окне программы. Подробнее — [Лицензия и доступ](https://farmnet.gitbook.io/youtube-uploader-documentation/licenzii.md).

## Пример: от импорта до залива

1. Проверить установку: `farmnet-cli.bat doctor --pretty`.
2. Импортировать аккаунты в новую группу: `farmnet-cli.bat profiles import C:\accounts\batch.txt --new-group Farm5`.
3. Добавить прокси группы, сразу проверив их и определив страны: `farmnet-cli.bat proxies add --file C:\proxies.txt --group Farm5 --check`.
4. Закрепить прокси за профилями: `farmnet-cli.bat proxies assign --group Farm5 --dry-run`, посмотреть план, затем ту же команду без `--dry-run` (если план забирает у кого-то прокси или сажает два профиля на один IP — ещё и с `--yes`).
5. Проверить запуск: `farmnet-cli.bat run --task login --task upload --params upload.json --group Farm5 --dry-run`.
6. Запустить: `farmnet-cli.bat run --task login --task upload --params upload.json --group Farm5 --timeout 180`.
7. Разобрать итог: код выхода (0 — все успешно, 6 — есть ошибки), затем по каждому профилю `status`, `error`, `hint` и `video_urls`.

## Советы для ИИ-агентов и скриптов

* Начинайте с `schema` и `doctor`; параметры задачи берите из `tasks describe`.
* Перед каждым новым запуском делайте `--dry-run`.
* Решения принимайте по коду выхода и `error.code`, а не по тексту сообщения; `error.hint` подсказывает, что исправить.
* Ограничивайте время: `run --timeout` (минуты) и `runs wait --timeout` (секунды).
* В PowerShell передавайте JSON файлами.
* Не давайте агенту `--show-secrets` без необходимости.
