Консольная команда

English · Руководство · Операции · Пресеты · ИИ-агент

Содержание

• Команды
• Запуск операции
• Кадр до и после
• Вывод
• Итог и коды выхода
• Куда ложится результат
• Остановка

vs_cli.cmd в корне программы запускает то же, что кнопки окна: пресет, профиль или службу, с теми же полями. Окно — лицо этой команды: всё, что оно запускает, оно запускает через неё, и первая строка каждого прогона в его журнале — готовая команда, которую можно повторить в консоли.

Команда нужна, когда пресет запускает не человек у окна: пакетный файл, другая программа, ИИ-агент, долгая ночь расчётов.

Команды

--root ПАПКА перед командой называет другую копию программы; --language ru или en — язык журнала (без него — язык окна).

Запуск операции

copy.\vs_cli.cmd run --operation film_35mm
.\vs_cli.cmd run --operation film_35mm --set stock=500T --set intensity=1.2 --encoder prores_422hq
.\vs_cli.cmd run --operation shadow_denoise_sota --set vs_accel=cpu --source D:\Footage --target D:\Clean
.\vs_cli.cmd run --operation profile_run --set profile=filmic_warm_35mm --source D:\Footage\take.mov
.\vs_cli.cmd run --operation deband_safe --dry-run
.\vs_cli.cmd run --operation doctor

Относительные --source и --target считаются от корня программы; --result, --params, --cancel-file — от папки того, кто зовёт.

Поля, которые есть у каждого пресета, — обработка, карточки кодера и прогон:

<!-- map:machine --> Эти поля стоят на каждой странице: обработка и карточки кодера одни на всё окно - заданные на одной странице, они заданы на всех.

Куда ложится результат. <Назначение>\<Палитра>\<пресет>_<кодер>\<папки Источника>\<имя>.<расш>; профиль - <Назначение>\Profiles\<профиль>_<кодер>\.... Имя исходника сохраняется. Готовый результат пропускается, если не включено Перезаписать. <!-- /map -->

Аппаратный кодер, который эта машина не прошла (СЕРВИС → «Возможности оборудования»), заменяется процессором, и строка [NOTE] об этом говорит. vs_accel что-то меняет только у пресетов с BM3D и нейросетевых; у остальных принимается и ничего не делает.

Значение проверяется до прогона. Число вне диапазона, вариант, которого у поля нет, поле, которого нет у операции, --dry-run у операции, которая не умеет говорить свои команды, — неверный вызов: код 2 и причина, ничего не запускается. Значение никогда не подвигается в диапазон молча.

JSON-значение из PowerShell. Поле со значением JSON (profile_values у profile_save) передаётся через --params ФАЙЛ: PowerShell портит кавычки JSON по пути в .cmd.

Кадр до и после

copy.\vs_cli.cmd frame --operation polaroid --source D:\Footage\take.mov
.\vs_cli.cmd frame --operation mild_denoise --set strength=strong --source D:\Footage\take.mov --at 0.25 --out D:\Look --max-width 0

Исполняется тот же .vpy с теми же значениями, что у прогона; в Назначение ничего не пишется. Ответ — одна строка JSON: before и after с path, frame, frames, width, height, fps; seconds, params и noise у шумодава. Пресет, который меняет число кадров (RIFE), читается на той же доле длины. Если не выходит — нет движка, нейросетевой пресет без MLRT, нет видео, — ok равен false, error говорит почему, код 1; неверный вызов — код 2.

Вывод

Журнал — обычные строки:

copy[PREFLIGHT] OK engine: installed
[PREFLIGHT] OK Source: 3 video(s) in D:\Footage
[RUN] preset: film_looks/film_35mm, encoder h264_crf14, BM3D auto
[FILE] 1/3 take_01.mov
[PROGRESS] take_01.mov [##########--------------]  42% 105/250 18.40 fps ETA 00:08
Frame: 105/250 (18.40 fps)
[OK] take_01.mp4: 48,210,334 B in 13.6 s
[DONE] 3 done, 0 passed over, 0 failed

[NOISE] mild_denoise: noise 5.34 / 3.44 / 2.75 (8-bit, Y/U/V) -> DFTTest sigma 57.1 — что шумодав измерил и что из этого сделал. [SKIP] — результат уже есть; [FAIL] — файл не вышел, следующий идёт дальше; [DRY RUN], [STOPPED], [REFUSED], [NOTE] говорят то, что говорят. Тот, кто читает вывод трубой, получает ещё служебные строки ::vs::{...} (started, progress, activity, finished); консоль — нет. Журнал каждого прогона — logs\<время>_<операция>.log, отчёт — report\<время>_<операция>\run_report.json и .md, рядом JSON каждого файла.

Итог и коды выхода

--result ФАЙЛ пишется при любом исходе:

copy{"operation": "film_35mm", "outcome": "done", "ok": true, "message": "Operation finished.",
 "processed": 3, "skipped": 0, "failed": 0, "parameters": {"stock": "250D", "...": "..."}, "seconds": 41.2,
 "log_file": "...", "source": "D:\\Footage", "target": "E:\\...\\output", "data": {"files": ["..."], "encoder": "h264_crf14"}}

outcome — done, failed, refused или stopped. Файл — .json вне Источника.

Куда ложится результат

<Назначение>\<Палитра>\<пресет>_<кодер>\<папки Источника>\<имя>.<расш> — Precision\, Film Looks\, Retro\, Restoration\; профиль — <Назначение>\Profiles\<профиль>_<кодер>\…. Имя исходника сохраняется. Результат пишется как <имя>.writing-<pid>-<метка>.<расш> и получает своё имя, только когда дописан. Готовый результат пропускается, если не --set overwrite=true, так что второй прогон в то же Назначение даёт done с processed 0.

Кодеры и карточки, которым каждый соответствует:

<!-- map:encoders -->

<!-- /map -->

Остановка

--cancel-file ФАЙЛ: когда файл появляется, движок гасит vspipe и FFmpeg, убирает недописанный файл и оставляет готовые; итог — stopped, код 130. СТОП окна — этот файл.