Concluir uma pequena tarefa de edição remota

Conecte a um desktop VNC existente, digite uma linha em um documento vazio e confira em uma nova captura. Este guia descreve o rdp-cli 0.1.0 com base nas validações de setembro de 2026; ele não representa um novo teste. O fluxo de Mac de 20 de setembro usou Ubuntu 24.04, TigerVNC 1.13.1 e xterm. As validações posteriores de Linux também usaram TigerVNC com autenticação. O texto abaixo é um exemplo didático, não uma reprodução dessas sessões.

Preparar o servidor e o cliente

Instale o download adequado e siga o início rápido. O computador remoto já deve ter um servidor VNC acessível, e você precisa de autorização para visualizar e controlar seu desktop. Prepare um documento vazio em um editor remoto. O rdp-cli não instala o servidor nem fornece um modelo de IA.

O VNC usa por padrão a porta 5900 e autenticação por senha. Os modos de segurança compatíveis não criptografam o transporte do desktop: use uma rede confiável ou uma VPN. A autenticação VNC clássica considera apenas os primeiros oito bytes UTF-8 da senha. Não acrescente opções exclusivas do RDP, como --user, --domain, organização de telas ou certificados.

Conectar com o protocolo correto

Substitua o endereço de exemplo e a porta. No macOS ou Linux, execute este bloco em Bash; no macOS, você pode iniciar bash antes. No Linux, substitua rdp-cli pelo comando instalado ou pelo caminho do executável da sua arquitetura.

IFS= read -r -s -p 'Password: ' vnc_password
printf '\n'
printf '%s' "$vnc_password" | rdp-cli connect --protocol vnc --host 192.0.2.20 --port 5900 --password-stdin
unset vnc_password

No Windows, abra o PowerShell na pasta do EXE:

$secret = Read-Host 'Password' -AsSecureString
$savedEncoding = $OutputEncoding
try {
  $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
  [System.Net.NetworkCredential]::new('', $secret).Password |
    .\rdp-cli.exe connect --protocol vnc --host 192.0.2.20 --port 5900 --password-stdin
} finally {
  $OutputEncoding = $savedEncoding
  $secret.Dispose()
}

Leia o JSON e guarde data.session como SESSION. Verifique ok e qualquer error.code; uma falha não justifica alterar silenciosamente a autenticação. --vnc-security none serve apenas para um servidor configurado deliberadamente sem autenticação: a opção deve ser explícita e não pode usar uma fonte de senha. Uma credencial salva com --credential-ref substitui --password-stdin; não é uma segunda fonte de senha.

Observar, agir e conferir novamente

Nos próximos comandos do Windows, substitua rdp-cli por .\rdp-cli.exe; no Linux, mantenha o caminho correto do executável.

rdp-cli status --session SESSION
rdp-cli screenshot --session SESSION --out vnc-before.png

Abra vnc-before.png, confirme o desktop e o editor desejados e guarde o data.observation dessa captura como OBSERVATION. Confira o protocolo e os estados de conexão e controle. Use as coordenadas reais do documento remoto em X e Y:

rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out vnc-focused.png

Confira o foco em vnc-focused.png e use o data.observation dessa resposta como NEW_OBSERVATION:

rdp-cli type --session SESSION --text "VNC command check" --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out vnc-after.png

Abra vnc-after.png e confirme que “VNC command check” aparece exatamente no documento pretendido. Enviar uma entrada não prova que o aplicativo a aceitou. Não reutilize coordenadas deste guia nem observações antigas após redimensionamento, reconexão ou mudança de controle.

Acompanhar ou recuperar a sessão

A janela local é opcional. Para uma pessoa acompanhar a mesma sessão:

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

Ela inicia em modo somente leitura. Pausa, tomada e devolução de controle são explícitas; o agente deve parar enquanto a entrada estiver pausada ou uma pessoa controlar a sessão. Reconexão e redimensionamento pelo servidor invalidam as observações e deixam o controle pausado. Examine uma captura nova antes de qualquer retomada autorizada.

Se a conexão falhar, verifique endereço, porta, autenticação e rede; consulte o erro em vez de tentar senhas repetidamente. Se o texto sair diferente, confira foco, layout do teclado e método de entrada. Eventos Unicode do VNC não garantem que toda combinação de servidor e aplicativo aceite qualquer caractere. Se o resultado de uma entrada for incerto, examine a tela e consulte a operação original antes de repeti-la.

Respeitar os limites do VNC

O VNC oferece o fluxo comum de capturas, entradas e visualização, mas não arquivos por unidade de troca, som, microfone ou organização de telas solicitada pelo cliente. Essas operações retornam CAPABILITY_UNAVAILABLE. Texto UTF-8 na área de transferência exige a negociação de clipboard_utf8; caso contrário, a codificação compatível é Latin-1. O visualizador não acrescenta recursos ausentes no protocolo.

Consulte as opções exatas na referência de comandos, escolha entre RDP e VNC na comparação de protocolos e veja a instalação da sua plataforma no início rápido.