Colagem no campo ativo
VPS 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.
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
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.
Cópia
O Handy coloca a transcrição na área de transferência.
Atraso
Ele espera o tempo configurado, 60 ms por padrão, antes da tecla de colar.
Colagem
A tecla simulada cola o texto no campo ativo do aplicativo.
Restauração
Com Don't Modify Clipboard, o conteúdo copiado antes volta para a área de transferência.
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
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.