Ir para o conteúdo
Promovaweb

Colagem no campo ativo

StayCloudVPS Agêntica

30% off na sua VPS Agêntica nos 2 primeiros meses

A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

Aproveitar a Black Friday

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

Depois de transcrever, o Handy cola o texto no campo com o cursor, na maioria dos casos copiando para a área de transferência e simulando a tecla de colar. São seis métodos de colagem, porque terminais, apps abertos como administrador e teclados fora do padrão americano exigem caminhos diferentes.

Sumário da página

  1. O texto aparece onde você estava
  2. O caminho pela área de transferência
  3. Os seis métodos
  4. Terminais
  5. Linux e as ferramentas de digitação
  6. Quando a colagem falha
  7. Envio automático e espaço no fim

O texto aparece onde você estava

A transcrição só serve se chegar ao lugar certo. O Handy não mostra o texto numa janela própria para você copiar. Ele cola no campo que estava ativo quando você começou a falar: a caixa do chat, o editor, o formulário do navegador, o prompt do agente no terminal. Para o aplicativo de destino, o efeito é o mesmo de colar um texto ou digitar muito rápido.

A documentação de métodos de colagem explica que o jeito de fazer isso depende do método configurado na aba Advanced. No macOS, o padrão costuma funcionar sem ajuste. No Windows e no Linux, alguns aplicativos exigem outro método.

O caminho pela área de transferência

O método padrão no macOS e no Windows usa a área de transferência. O Handy copia a transcrição e simula o atalho comum de colar, Cmd+V ou Ctrl+V. É o método mais confiável para uso geral, segundo a documentação.

  1. Cópia

    O Handy coloca a transcrição na área de transferência.

  2. Atraso

    Ele espera o tempo configurado, 60 ms por padrão, antes da tecla de colar.

  3. Colagem

    A tecla simulada cola o texto no campo ativo do aplicativo.

  4. Restauração

    Com Don't Modify Clipboard, o conteúdo copiado antes volta para a área de transferência.

O método padrão de colagem: a transcrição passa pela área de transferência, que volta ao conteúdo anterior no fim.

O último passo preserva o que você tinha copiado. Com a opção Don’t Modify Clipboard, o Handy restaura o conteúdo anterior depois de colar. O seu histórico de cópias fica intacto. Com Copy to Clipboard, a transcrição fica na área de transferência, útil quando você quer colar o mesmo texto em outro lugar.

Os seis métodos

MétodoComo funcionaQuando usar
ClipboardCopia e simula Cmd+V ou Ctrl+V.Padrão no macOS e no Windows, para a maioria dos apps.
Ctrl+Shift+VCopia e simula Ctrl+Shift+V, no Windows e no Linux.Apps que usam o Ctrl+V para outra coisa e terminais do Linux.
Shift+InsertCopia e simula o atalho antigo de colar, no Windows e no Linux.Windows Terminal, Prompt de Comando, PowerShell, SSH e terminais do Linux.
Direct InputDigita caractere por caractere, sem a área de transferência.Apps que não aceitam colar, só com teclado no padrão americano.
NoneCopia sem simular tecla.Quando você troca de janela e prefere colar à mão.
External ScriptEntrega o texto a um script seu, só no Linux.Configurações próprias de Wayland.

O Direct Input tem uma armadilha. A documentação avisa que ele não considera teclados fora do padrão americano: com AZERTY, QWERTZ ou outros layouts, o texto sai embaralhado. O README acrescenta que, no Linux, a digitação direta pode perder maiúsculas e caracteres acentuados. Para textos em português com acentos, um método pela área de transferência evita o problema.

Terminais

O terminal recebe uma atenção especial porque é onde vivem os agentes de código. No Windows, a documentação recomenda o Shift+Insert para o Windows Terminal, o Prompt de Comando e o PowerShell, que tratam o Ctrl+V de outro jeito. Nos terminais do Linux, a sugestão é o Ctrl+Shift+V ou o Shift+Insert. Em sessões SSH, o Shift+Insert.

A 0.10.1 mudou o padrão no Linux. As instalações novas colam com Shift+Insert. O Handy põe a transcrição na área de transferência e na seleção primária ao mesmo tempo. Os apps gráficos leem a primeira e terminais como kitty, Ghostty, Alacritty e GNOME Terminal leem a segunda, então a mesma tecla serve para os dois. Depois, o Handy restaura as duas.

Linux e as ferramentas de digitação

No Linux, o Handy precisa de uma ferramenta para mandar a tecla de colar ou para digitar. A configuração Typing Tool, que só aparece no Linux, escolhe a ferramenta. O modo Auto pega a melhor disponível. O xdotool atende o X11. No Wayland, a documentação indica o wtype para Sway e Hyprland, o kwtype, o ydotool ou o dotool para o KDE. O GNOME tem uma discussão própria no repositório. O README informa que o dotool exige o usuário no grupo input. Desde a 0.10.1, quando uma ferramenta falha, o Handy tenta a próxima.

Quando a colagem falha

O problema mais comum tem nome na documentação: o Handy cola o conteúdo que você tinha copiado antes, em vez da transcrição. Isso acontece quando o aplicativo de destino lê a área de transferência depois que o Handy já restaurou o conteúdo antigo. A transcrição correta continua no histórico. A solução indicada é aumentar o atraso da colagem nas configurações de depuração, com valores entre 60 e 200 ms. No macOS e no Windows, o README cita ainda a opção experimental Reliable Paste, que espera o aplicativo ler a área de transferência antes de restaurar.

No macOS, a colagem em outros aplicativos depende da permissão de acessibilidade, solicitada na primeira abertura junto com a do microfone e concedida por você nos ajustes do sistema. Sem ela, o texto não chega ao campo.

Envio automático e espaço no fim

Duas opções da aba Advanced mexem no que acontece logo depois da colagem. O Auto Submit aperta uma tecla depois de inserir o texto: Enter, Cmd+Enter, Super+Enter ou Ctrl+Enter. Ele vem desligado e serve para chats e linhas de comando que enviam com essas teclas. Num agente de código, ligar o envio automático significa mandar o prompt sem ler. O hub de ditado para agentes explica por que a revisão vale os segundos que custa.

O Append Trailing Space acrescenta um espaço depois do texto colado. Ele serve para ditar em vários trechos seguidos, com as frases separadas sem digitar nada entre elas. A partir da 0.10.1, o Handy também deixa de colar uma transcrição que seja só um ponto.