rdp-cli

Начало работы с RDP из командной строки в Windows, Mac и Linux

Подключитесь, посмотрите, действуйте и проверьте. Локальное окно необязательно.
Посмотрите, как работает rdp-cli

Какая команда RDP вам нужна?

Автоматизировать работу с помощью ИИ-агента

rdp-cli работает в Windows, macOS и Linux. Агент подключается без окна просмотра, читает снимки экрана, отправляет нажатия клавиш и щелчки мыши, передаёт файлы. Вы можете присоединиться к тому же сеансу через GUI или веб-интерфейс и взять управление на себя.

Подключиться шаг за шагом →Найти команды по задаче →

Открыть окно удалённого рабочего стола

В Windows команда mstsc открывает встроенное приложение удалённого рабочего стола. Замените desktop.example.net адресом компьютера и войдите в открывшемся окне.

mstsc /v:desktop.example.net

НАЧНИТЕ СО СВОЕГО КОМПЬЮТЕРА

Выберите платформу.
Начните удалённую задачу.

Выберите компьютер для rdp-cli.
Подготовьте инструменты удалённой работы для агента.

01 / УСТАНОВКА И ПРОВЕРКА

Подготовьте EXE и откройте PowerShell.

Для Windows 10 или 11 на процессоре ARM выберите ARM64. Для процессоров Intel или AMD выберите x64, если Windows 64-разрядная, или x86, если она 32-разрядная. Скачайте соответствующий файл rdp-cli.exe и запустите его в PowerShell.

Для каждой архитектуры предусмотрен отдельный EXE-файл.

PowerShell
.\rdp-cli.exe --help
2. Подключите рабочий стол

Включите RDP на целевом компьютере. Замените 192.0.2.20 и USER. Скрытый запрос передаст пароль через стандартный ввод. Сохраните data.session из JSON-ответа.

PowerShell
$secret = Read-Host 'Пароль' -AsSecureString
$savedEncoding = $OutputEncoding
try {
  $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
  [System.Net.NetworkCredential]::new('', $secret).Password |
    .\rdp-cli.exe connect --host 192.0.2.20 --user USER --password-stdin
} finally {
  $OutputEncoding = $savedEncoding
  $secret.Dispose()
}
3. Сначала посмотрите на экран

Замените SESSION значением из ответа подключения. Откройте before.png, найдите цель и сохраните data.observation из ответа снимка.

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. Действуйте и проверяйте

Найдите поле на изображении и замените X, Y и OBSERVATION. После щелчка сделайте новый снимок и используйте новую observation для ввода. Проверьте результат в after.png.

PowerShell
.\rdp-cli.exe click --session SESSION --desktop --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./focused.png
.\rdp-cli.exe type --session SESSION --text "Удалённая задача выполнена." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. Пригласите человека наблюдать

Откройте существующий сеанс, когда нужен просмотр. Окна начинают в режиме только чтения. Приостанавливайте, берите и возвращайте управление. После передачи или переподключения агенту нужно новое наблюдение.

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / УСТАНОВКА И ПРОВЕРКА

Откройте DMG и включите CLI.

Перетащите rdp-cli в «Программы» и выполните команды в Терминале macOS (zsh).

Выберите DMG для своего Mac: Apple silicon (macOS 13 и новее) или Intel (macOS 12 и новее). Доступность версий указана на странице загрузки.

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. Подключите рабочий стол

Включите RDP на целевом компьютере. Замените 192.0.2.20 и USER. Скрытый запрос передаст пароль через стандартный ввод. Сохраните data.session из JSON-ответа.

zsh
read -r -s "rdp_password?Пароль: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Сначала посмотрите на экран

Замените SESSION значением из ответа подключения. Откройте before.png, найдите цель и сохраните data.observation из ответа снимка.

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. Действуйте и проверяйте

Найдите поле на изображении и замените X, Y и OBSERVATION. После щелчка сделайте новый снимок и используйте новую observation для ввода. Проверьте результат в after.png.

zsh
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out ./focused.png
rdp-cli type --session SESSION --text "Удалённая задача выполнена." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. Пригласите человека наблюдать

Откройте существующий сеанс, когда нужен просмотр. Окна начинают в режиме только чтения. Приостанавливайте, берите и возвращайте управление. После передачи или переподключения агенту нужно новое наблюдение.

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / УСТАНОВКА И ПРОВЕРКА

Запуск одного файла

Скачайте файл Linux x86_64, разрешите его выполнение и запустите в терминале. Права администратора не нужны.

Версия x86_64 предназначена для перечисленных ниже систем Linux. Совместимость с другими версиями не проверена.

Целевые системы →

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. Подключите рабочий стол

Включите RDP на целевом компьютере. Замените 192.0.2.20 и USER. Скрытый запрос передаст пароль через стандартный ввод. Сохраните data.session из JSON-ответа.

Bash
IFS= read -r -s -p 'Пароль: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-x86_64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Сначала посмотрите на экран

Замените SESSION значением из ответа подключения. Откройте before.png, найдите цель и сохраните data.observation из ответа снимка.

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. Действуйте и проверяйте

Найдите поле на изображении и замените X, Y и OBSERVATION. После щелчка сделайте новый снимок и используйте новую observation для ввода. Проверьте результат в after.png.

Bash
./rdp-cli-linux-x86_64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-x86_64 type --session SESSION --text "Удалённая задача выполнена." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. Пригласите человека наблюдать

Откройте существующий сеанс, когда нужен просмотр. Окна начинают в режиме только чтения. Приостанавливайте, берите и возвращайте управление. После передачи или переподключения агенту нужно новое наблюдение.

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / УСТАНОВКА И ПРОВЕРКА

Запуск одного файла

Скачайте файл Linux ARM64 для 64-разрядной системы ARM Linux, разрешите его выполнение и запустите от имени обычного пользователя.

Один статический ELF-файл ARM64 для перечисленных систем Linux, Raspberry Pi 4 и DGX Spark. 32-разрядная Raspberry Pi OS не поддерживается.

Целевые системы →

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. Подключите рабочий стол

Включите RDP на целевом компьютере. Замените 192.0.2.20 и USER. Скрытый запрос передаст пароль через стандартный ввод. Сохраните data.session из JSON-ответа.

Bash
IFS= read -r -s -p 'Пароль: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-arm64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Сначала посмотрите на экран

Замените SESSION значением из ответа подключения. Откройте before.png, найдите цель и сохраните data.observation из ответа снимка.

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. Действуйте и проверяйте

Найдите поле на изображении и замените X, Y и OBSERVATION. После щелчка сделайте новый снимок и используйте новую observation для ввода. Проверьте результат в after.png.

Bash
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-arm64 type --session SESSION --text "Удалённая задача выполнена." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. Пригласите человека наблюдать

Откройте существующий сеанс, когда нужен просмотр. Окна начинают в режиме только чтения. Приостанавливайте, берите и возвращайте управление. После передачи или переподключения агенту нужно новое наблюдение.

Bash
./rdp-cli-linux-arm64 watch --session SESSION --viewer window
./rdp-cli-linux-arm64 watch --session SESSION --viewer web

Замените адрес и значения примера. Используйте session и observation из реальных ответов, а результат проверяйте новым снимком.

VNC

Рабочий стол VNC

Используйте доступный VNC-сервер, к которому у вас есть разрешение. Замените адрес и порт. В примере применяется классическая парольная аутентификация VNC без шифрования; работайте в доверенной LAN или VPN. Передайте пароль через стандартный ввод и завершите ввод. Сохраните data.session как SESSION. В PowerShell замените rdp-cli на .\rdp-cli.exe, а в Linux при необходимости укажите путь к исполняемому файлу.

rdp-cli connect --protocol vnc --host 192.0.2.20 --port 5900 --password-stdin

Откройте before.png, выберите реальные координаты и используйте data.observation из ответа как OBSERVATION. После каждого действия делайте новый снимок и проверяйте результат. Полный пример подключения и требования к серверу приведены в руководстве VNC.

rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png
Подключение к VNC и проверка ввода из командной строки →

Возможности →

Android · USB / Wi-Fi

Настоящий экран Android для вашего ИИ-агента.

Подключите телефон по USB или Wi-Fi. Агент просматривает экран, нажимает, вводит текст и получает результаты командами, а вы наблюдаете за тем же сеансом в окне или браузере.

Телефон Android · USB / Wi-Fi →

Загрузки с поддержкой Android: macOS · Apple silicon · macOS · Intel · Windows · x64 · Windows · x86 · Windows · ARM64 · Linux · x86_64 · Linux · ARM64

Наблюдать и действовать

Получайте реальный снимок экрана, выполняйте нажатия, смахивания, перетаскивания и жесты двумя пальцами, затем проверяйте результат новым снимком.

Текст, файлы и приложения

Явно вставляйте текст Unicode, передавайте файлы и папки, устанавливайте, запускайте и останавливайте приложения из одного APK.

Общий сеанс

Агент, нативное окно и авторизованные браузеры используют один постоянный сеанс. При необходимости приостановите его или перехватите управление.

Минимальная поддерживаемая версия — Android 12. Проверенное устройство — Google Pixel 3 с Android 12. Это не означает проверку всех производителей и последующих версий Android.

Подготовка телефона

  1. Включите параметры разработчика и отладку по USB, подключите кабель для передачи данных и подтвердите разрешение на разблокированном телефоне.
  2. Для Wi-Fi включите беспроводную отладку и используйте показанные телефоном код и порт сопряжения. Порт подключения отличается; USB-кабель не нужен.
  3. Для USB в Windows нужен драйвер WinUSB, подходящий телефону и архитектуре компьютера, в том числе ARM64. rdp-cli не устанавливает драйверы и не закрывает другие средства отладки. В Linux (x86_64 / ARM64) предоставьте обычному пользователю доступ к USB-устройству телефона через подходящее правило udev или группу устройств и выполняйте команды ниже в Bash. Запускайте rdp-cli без sudo. macOS использует системный USB-интерфейс.

Замените DEVICE_SERIAL, SESSION, OBSERVATION, PHONE_IP и оба порта реальными значениями. Сохраните data.session из connect и используйте data.observation каждого снимка. Вместо wifi:PHONE_GUID укажите полученный идентификатор wifi:. Выберите имя PHONE_REF для сохранения сопряжения на этом компьютере. По запросу введите текущий шестизначный код; команда передаст его через стандартный ввод.

macOS / Linux

Обнаружение и подключение

Явно выберите обнаруженный ID устройства. Подключение не открывает окно и не включает звук.

rdp-cli android devices
rdp-cli connect --protocol adb --device usb:DEVICE_SERIAL --transport usb

Наблюдение, действие, проверка

Посмотрите before.png и используйте координаты и значение наблюдения из этого снимка. Проверьте реальный результат приложения в after.png.

rdp-cli screenshot --session SESSION --out before.png
rdp-cli android touch --session SESSION --kind tap --x 300 --y 900 --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

Беспроводное подключение

Wi-Fi — альтернатива USB. Если у телефона уже есть USB-сеанс, сначала выполните disconnect --session SESSION. Затем выполните сопряжение и подключитесь с полученным ID устройства и текущим портом подключения. Сохраните новый data.session и сделайте новый снимок перед вводом.

printf '%s' 'Код сопряжения: '
IFS= read -r -s rdp_pair_code
printf '\n'
printf '%s' "$rdp_pair_code" | rdp-cli android pair --host PHONE_IP --port PAIR_PORT --code-stdin --save-device-auth PHONE_REF
unset rdp_pair_code
rdp-cli connect --protocol adb --device wifi:PHONE_GUID --transport wifi --host PHONE_IP --port CONNECT_PORT --device-auth-ref PHONE_REF

Завершение

Выключите звук телефона и отключитесь. Готовые файлы и пользовательские приложения останутся на телефоне.

rdp-cli audio android --session SESSION --source off
rdp-cli disconnect --session SESSION
Windows · PowerShell

Обнаружение и подключение

Явно выберите обнаруженный ID устройства. Подключение не открывает окно и не включает звук.

.\rdp-cli.exe android devices
.\rdp-cli.exe connect --protocol adb --device usb:DEVICE_SERIAL --transport usb

Наблюдение, действие, проверка

Посмотрите before.png и используйте координаты и значение наблюдения из этого снимка. Проверьте реальный результат приложения в after.png.

.\rdp-cli.exe screenshot --session SESSION --out before.png
.\rdp-cli.exe android touch --session SESSION --kind tap --x 300 --y 900 --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

Беспроводное подключение

Wi-Fi — альтернатива USB. Если у телефона уже есть USB-сеанс, сначала выполните disconnect --session SESSION. Затем выполните сопряжение и подключитесь с полученным ID устройства и текущим портом подключения. Сохраните новый data.session и сделайте новый снимок перед вводом.

$pairingCode = Read-Host 'Код сопряжения' -AsSecureString
try {
  [System.Net.NetworkCredential]::new('', $pairingCode).Password |
    .\rdp-cli.exe android pair --host PHONE_IP --port PAIR_PORT --code-stdin --save-device-auth PHONE_REF
} finally {
  $pairingCode.Dispose()
}
.\rdp-cli.exe connect --protocol adb --device wifi:PHONE_GUID --transport wifi --host PHONE_IP --port CONNECT_PORT --device-auth-ref PHONE_REF

Завершение

Выключите звук телефона и отключитесь. Готовые файлы и пользовательские приложения останутся на телефоне.

.\rdp-cli.exe audio android --session SESSION --source off
.\rdp-cli.exe disconnect --session SESSION

Особенности работы

ИИ-агент управляет удалёнными устройствами. Вы можете подключиться в любой момент.

Подключитесь, изучите экран, отправьте короткую последовательность действий и проверьте результат. Сохраните ID сессии; после возврата управления человеком получите новое изображение.

Один исполняемый файл для вашей ОС и процессора. Перед использованием команд ниже проверьте возможности скачанного файла.

Смотрите нужную область

Запрашивайте фрагмент экрана или уменьшенное изображение. Сравнивайте с предыдущим наблюдением и не получайте изображение повторно, если ничего не изменилось. Координаты сохраняют связь с удалённым экраном.

Ждите изменений или завершения передачи

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

Короткая последовательность с остановкой для проверки

Объединяйте выбранные агентом действия, добавляйте наблюдение и останавливайтесь на контрольной точке. Ошибка или смена управления прекращает последующие шаги; отправленные действия не откатываются.

Сохраняйте прогресс и продолжайте после проверки

Записывайте ход задачи, контрольные точки и выбранные изображения, экспортируйте локальный отчёт. После прерывания проверяйте выполненное и отправляйте новые шаги, не повторяя действий с неизвестным результатом.

Явная передача управления между агентами и человеком

Зарегистрированные агенты явно передают управление друг другу. Человек может принять его через GUI или веб-интерфейс и вернуть выбранному агенту, который сначала заново изучит экран.

Подключайте агента и проверяйте соединение

Используйте встроенный в файл MCP или CLI. Сохраняйте именованные профили со ссылками на учётные данные и проверяйте уровни соединения командой doctor.

Выбирайте основной или виртуальный экран телефона

На совместимом Android явно создавайте виртуальный экран и запускайте на нём приложение. Агент, GUI и веб-интерфейс используют этот экран; поведение приложения и системные разрешения на звук остаются в силе.

Windows · PowerShell
.\rdp-cli.exe --version
.\rdp-cli.exe --help-json
.\rdp-cli.exe screenshot --session SESSION --max-width 640
.\rdp-cli.exe screenshot --session SESSION --region X,Y,WIDTH,HEIGHT --max-width 640
.\rdp-cli.exe wait --session SESSION --condition changed --region X,Y,WIDTH,HEIGHT --timeout-ms 10000
.\rdp-cli.exe doctor --session SESSION
.\rdp-cli.exe mcp stdio
macOS / Linux
rdp-cli --version
rdp-cli --help-json
rdp-cli screenshot --session SESSION --max-width 640
rdp-cli screenshot --session SESSION --region X,Y,WIDTH,HEIGHT --max-width 640
rdp-cli wait --session SESSION --condition changed --region X,Y,WIDTH,HEIGHT --timeout-ms 10000
rdp-cli doctor --session SESSION
rdp-cli mcp stdio

Linux · X11 / SSH · Wayland RDP / VNC

Управление приложениями Linux через X11 и SSH с ИИ-агентом

Подключите существующий рабочий стол Linux или отдельное X11-приложение, работайте командами и снимками экрана, забирайте файлы и передавайте человеку тот же сеанс.

Скачать: macOS · Apple siliconmacOS · IntelWindows · x64Windows · x86Windows · ARM64Linux · x86_64Linux · ARM64

До подключения выберите для FILE_ROOT существующий удалённый каталог с правом чтения и записи. Для режима рабочего стола получите DISPLAY и XAUTHORITY в терминале внутри активного графического сеанса целевого пользователя. В SSH-сеансе значения могут отличаться. Если они пусты, уточните их у владельца рабочего стола или администратора.

macOS / Linux

Один сеанс для агента и человека

rdp-cli позволяет ИИ-агенту видеть приложение Linux и управлять им командами. Агент получает снимок, действует по увиденному и проверяет следующий снимок. Вы можете открыть собственное окно просмотра или авторизованный веб-интерфейс, чтобы наблюдать, приостановить ввод или принять управление тем же сеансом.

Подготовьте разрешённое подключение

На компьютере Linux уже должны быть доступ по SSH и установленное X11-совместимое приложение. Замените адрес, пользователя, путь к закрытому ключу и независимо проверенный файл known-hosts. В Windows PowerShell используйте .\rdp-cli.exe вместо rdp-cli. Убедитесь, что --version возвращает true для embedded_ssh, x11_desktop и x11_application.

Откройте отдельное приложение

Пример запускает уже установленный Gedit на изолированном экране, встроенном в rdp-cli. Локальное окно просмотра автоматически не открывается. Сохраните data.session из ответа как SESSION. На узле с обычным рабочим столом Wayland также можно перенаправить X11-совместимое приложение таким способом.

rdp-cli connect --protocol x11 --mode application --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --application /usr/bin/gedit --app-args '["--standalone","--new-window"]'

Или подключите существующий рабочий стол X11

Укажите действительный display и путь к существующему файлу авторизации. Учётной записи SSH нужен доступ к этому display: успешная аутентификация SSH сама по себе не даёт доступа к рабочему столу. Режим подключает существующий рабочий стол, а не создаёт новый сеанс входа.

rdp-cli connect --protocol x11 --mode desktop --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --display DISPLAY --xauthority XAUTHORITY_PATH

Наблюдайте, действуйте и проверяйте

Откройте полученный PNG и сохраните data.observation. Замените X и Y действительными координатами изображения. После выбора поля сделайте новый снимок и используйте новый токен. Явный метод вставки заменяет удалённый буфер обмена, не меняя локальный. Ответ подтверждает отправку ввода, поэтому затем проверьте видимый результат.

rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out focused.png
rdp-cli linux text --session SESSION --method clipboard --text 'Проверка завершена.' --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

Заберите полученные файлы

Откройте remote_path из результата загрузки в приложении Linux, отредактируйте и сохраните файл, затем скачайте результат. Сохраняйте каждый transfer_id и ждите completed перед использованием файла. Сначала сохраните файл; существующие имена по умолчанию не перезаписываются. При ошибке проверьте состояние задачи, прежде чем повторять передачу.

Замените FILE_ROOT на существующий удалённый каталог, доступный этой учётной записи SSH для чтения и записи. Файловые команды работают только внутри этого каталога; указание пути не создаёт каталог и не добавляет прав.

rdp-cli files list --session SESSION
rdp-cli files upload --session SESSION --local ./report.txt --path report.txt
rdp-cli files status --session SESSION --transfer-id UPLOAD_TRANSFER
rdp-cli files download --session SESSION --path report.txt --local ./result.txt
rdp-cli files status --session SESSION --transfer-id DOWNLOAD_TRANSFER

Передайте управление человеку

Открывайте просмотр, когда хотите наблюдать. Сначала он доступен только для чтения. Принятие управления останавливает ввод агента; после исправления верните управление, чтобы продолжить ту же задачу. Авторизованный веб-просмотр использует тот же сеанс. Право ручного управления одновременно принадлежит только одному просмотру. Закрытие просмотра только для чтения не разрывает подключение.

rdp-cli watch --session SESSION --viewer window

Учитывайте границы протокола

Нативный X11 не перенаправляет воспроизведение звука или микрофон. Для всего рабочего стола Wayland нужна уже настроенная совместимая конечная точка RDP или VNC с фактически согласованными возможностями. rdp-cli не устанавливает и не включает удалённые службы. Приложение может завершиться при разрыве соединения с экраном: сначала сохраните работу и не рассчитывайте на автоматический перезапуск или сохранённое рабочее пространство.

Ввод текста в Wayland зависит от существующего сервера. GNOME 46 и Krfb 23.08 могут не распознавать некоторые клавиши Unicode — проверяйте результат. Явную вставку из буфера используйте только там, где она действительно работает: Krfb в Plasma Wayland может заявлять поддержку буфера, не передавая текст приложениям. Сложный ввод и быстрые последовательности разбивайте на небольшие шаги и проверяйте следующий снимок.

Проверенные точки рабочего стола: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

Перейти к быстрому началу

Windows · PowerShell

Один сеанс для агента и человека

rdp-cli позволяет ИИ-агенту видеть приложение Linux и управлять им командами. Агент получает снимок, действует по увиденному и проверяет следующий снимок. Вы можете открыть собственное окно просмотра или авторизованный веб-интерфейс, чтобы наблюдать, приостановить ввод или принять управление тем же сеансом.

Подготовьте разрешённое подключение

На компьютере Linux уже должны быть доступ по SSH и установленное X11-совместимое приложение. Замените адрес, пользователя, путь к закрытому ключу и независимо проверенный файл known-hosts. В Windows PowerShell используйте .\rdp-cli.exe вместо rdp-cli. Убедитесь, что --version возвращает true для embedded_ssh, x11_desktop и x11_application.

Откройте отдельное приложение

Пример запускает уже установленный Gedit на изолированном экране, встроенном в rdp-cli. Локальное окно просмотра автоматически не открывается. Сохраните data.session из ответа как SESSION. На узле с обычным рабочим столом Wayland также можно перенаправить X11-совместимое приложение таким способом.

.\rdp-cli.exe connect --protocol x11 --mode application --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --application /usr/bin/gedit --app-args '["--standalone","--new-window"]'

Или подключите существующий рабочий стол X11

Укажите действительный display и путь к существующему файлу авторизации. Учётной записи SSH нужен доступ к этому display: успешная аутентификация SSH сама по себе не даёт доступа к рабочему столу. Режим подключает существующий рабочий стол, а не создаёт новый сеанс входа.

.\rdp-cli.exe connect --protocol x11 --mode desktop --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --display DISPLAY --xauthority XAUTHORITY_PATH

Наблюдайте, действуйте и проверяйте

Откройте полученный PNG и сохраните data.observation. Замените X и Y действительными координатами изображения. После выбора поля сделайте новый снимок и используйте новый токен. Явный метод вставки заменяет удалённый буфер обмена, не меняя локальный. Ответ подтверждает отправку ввода, поэтому затем проверьте видимый результат.

.\rdp-cli.exe screenshot --session SESSION --out before.png
.\rdp-cli.exe click --session SESSION --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out focused.png
.\rdp-cli.exe linux text --session SESSION --method clipboard --text 'Проверка завершена.' --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

Заберите полученные файлы

Откройте remote_path из результата загрузки в приложении Linux, отредактируйте и сохраните файл, затем скачайте результат. Сохраняйте каждый transfer_id и ждите completed перед использованием файла. Сначала сохраните файл; существующие имена по умолчанию не перезаписываются. При ошибке проверьте состояние задачи, прежде чем повторять передачу.

Замените FILE_ROOT на существующий удалённый каталог, доступный этой учётной записи SSH для чтения и записи. Файловые команды работают только внутри этого каталога; указание пути не создаёт каталог и не добавляет прав.

.\rdp-cli.exe files list --session SESSION
.\rdp-cli.exe files upload --session SESSION --local ./report.txt --path report.txt
.\rdp-cli.exe files status --session SESSION --transfer-id UPLOAD_TRANSFER
.\rdp-cli.exe files download --session SESSION --path report.txt --local ./result.txt
.\rdp-cli.exe files status --session SESSION --transfer-id DOWNLOAD_TRANSFER

Передайте управление человеку

Открывайте просмотр, когда хотите наблюдать. Сначала он доступен только для чтения. Принятие управления останавливает ввод агента; после исправления верните управление, чтобы продолжить ту же задачу. Авторизованный веб-просмотр использует тот же сеанс. Право ручного управления одновременно принадлежит только одному просмотру. Закрытие просмотра только для чтения не разрывает подключение.

.\rdp-cli.exe watch --session SESSION --viewer window

Учитывайте границы протокола

Нативный X11 не перенаправляет воспроизведение звука или микрофон. Для всего рабочего стола Wayland нужна уже настроенная совместимая конечная точка RDP или VNC с фактически согласованными возможностями. rdp-cli не устанавливает и не включает удалённые службы. Приложение может завершиться при разрыве соединения с экраном: сначала сохраните работу и не рассчитывайте на автоматический перезапуск или сохранённое рабочее пространство.

Ввод текста в Wayland зависит от существующего сервера. GNOME 46 и Krfb 23.08 могут не распознавать некоторые клавиши Unicode — проверяйте результат. Явную вставку из буфера используйте только там, где она действительно работает: Krfb в Plasma Wayland может заявлять поддержку буфера, не передавая текст приложениям. Сложный ввод и быстрые последовательности разбивайте на небольшие шаги и проверяйте следующий снимок.

Проверенные точки рабочего стола: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

Перейти к быстрому началу

Работа с вашим агентом

Укажите путь программы, разрешённую цель или сеанс и желаемый результат. Необязательный навык rdp-cli-agent описывает процесс; SKILL.md можно читать напрямую. Для подключения устанавливать навык не требуется.

rdp-cli-agent / SKILL.md ↓

Подключение и доступ

По умолчанию политика сертификата RDP — ignore для совместимости. Изучите connect --help и настройте проверку для своей среды. Сайт не передаёт сеансы и не собирает учётные данные. Браузер предназначен для LAN/VPN, VNC требует доверенной сети.

rdp-cli@weerocks.com