Manual do usuário do Myna Recorder

Primeiros passos

O Myna Recorder — “Recorder” neste manual, Recorder.exe no disco — é um gravador de macros para Windows 10 e 11, 64 bits. Ele grava seu teclado e seu mouse, deixa você editar o resultado como um script legível e o reproduz em qualquer aplicativo. Baixe aqui.

Ativação

1. Crie uma conta e confirme seu e-mail.
2. No Recorder, entre na conta no canto superior direito com seu e-mail e sua senha. A barra passa então a mostrar seu plano e o saldo de créditos de IA.

O Recorder continua conectado e segue funcionando mesmo se a conexão cair. Sair libera a vaga deste computador para outra máquina.

Sua primeira macro

Pressione Iniciar gravação (F2), faça a tarefa à mão, pressione Parar gravação (F3) e depois Iniciar reprodução (F4) para reproduzi-la e Parar reprodução (F6) para encerrar uma execução antes do fim. A tabela completa de atalhos está em Reprodução.

Quando este manual cita uma tecla, trata-se da tecla padrão. As teclas são alteradas em Configurações → Teclas de atalho.

Uma macro envia entradas reais para o que estiver na frente dela. Saiba qual é a sua tecla de Parar reprodução antes de começar; ela funciona mesmo quando o Recorder não é a janela ativa.

A janela

Seis guias. Quatro editam um mesmo projeto; o Agente faz uma tarefa por você e o Clicker clica por você.

Lado a lado mostra a lista de passos e o script ao mesmo tempo. O botão Variáveis abre um painel que mostra todas as variáveis ao vivo durante uma execução.

Arquivos

• .recproj — um projeto: a macro, seus recortes e suas configurações em um único arquivo. É o que você normalmente salva.
• .recscript — um script sozinho, como texto.

A macro em edição é salva automaticamente, inclusive o texto da guia Script que ainda não foi aplicado.

Gravação

Iniciar gravação começa e Parar gravação encerra (F2 e F3 por padrão). A gravação é global: ela captura o que você faz em qualquer aplicativo, com o tempo original.

Configurações → Gravação escolhe o que é gravado: teclado, cliques do mouse, movimento do mouse, roda do mouse. Sem o movimento do mouse, a macro fica muito mais curta e clica direto em cada alvo; grave o movimento só para desenhar ou para passar o mouse sobre algo.

As coordenadas gravadas são pixels absolutos da tela. Mova a janela, mude a resolução ou reproduza em outra máquina e um clique gravado vai parar no lugar errado. A solução são as âncoras de imagem.

Usar todos os monitores estende a captura por todas as telas. Deixe desligado se você tem uma tela só.

Reprodução

As sete são globais, e uma tecla que o Recorder reserva é consumida: os outros aplicativos nunca a recebem. Altere ou desative as teclas em Configurações → Teclas de atalho.

Parar reprodução é a única forma global de interromper uma macro em execução. Mantenha a tecla definida; ocultar a janela durante a execução e o Agente se recusam a começar sem ela.

Velocidade e repetição

A reprodução vai de 0,25× a 10×. A velocidade altera as esperas gravadas, não as chamadas de sleep() que você escreveu, e não faz um aplicativo responder mais rápido. Se uma macro falha a 4× mas funciona a 1×, substitua a temporização por wait_for().

Repetir executa a macro um número determinado de vezes; 0 significa “até parar”. Para repetir dentro de uma mesma execução, use os blocos de loop.

Execuções de teste

Testar na guia Gravador reproduz apenas as linhas selecionadas. Testar seleção na guia Script compila e reproduz o texto selecionado, inclusive as edições ainda não aplicadas. A macro nunca é alterada.

• Um teste roda uma vez, a 1×, independentemente do que digam Repetir e Velocidade.
• Um loop selecionado pela metade é ampliado para o bloco inteiro; um cabeçalho de seção selecionado vale por tudo o que está dentro dele.
• Primeiro há uma contagem regressiva (Configurações → Gravação → Esperar antes de iniciar um teste, 0–30 segundos, padrão 3). Parar cancela a contagem.

Ocultar durante a execução

Configurações → Janela → Ocultar esta janela durante a gravação ou a reprodução oculta o Recorder durante uma execução, inclusive nos testes. É preciso ter uma tecla de Parar reprodução definida.

Editar uma macro

Seções

Uma seção é um título de capítulo na lista de passos. Use uma por fase real da tarefa.

with section("Log in"):
    click_crop("Username")
    type_text("user")

with section("Export"):
    click_crop("Export")

As seções nunca se aninham e começam na margem esquerda. Loops e condições podem ficar dentro de uma seção, com recuo de quatro espaços por nível.

Rótulos e saltos

label="name" em qualquer comando o torna um destino de salto; label("name") sozinho em uma linha é um passo que não faz nada, só serve de destino; goto("name") salta para lá.

with section("Retry"):
    click_crop("Refresh", label="again")
    wait_for("Done", timeout_ms=20000, on_fail="again")
    label("done")

Todo goto("x"), on_no="x", on_fail="x" e cada seta de wait_any -> "x" precisa de um passo que carregue label="x", ou a reprodução para com um erro. Os rótulos devem ser únicos.

Funções: veja a referência do script.

Imagens e recortes

Um recorte é uma imagem nomeada de algo na tela: um botão, um ícone, um título. O Recorder o encontra na hora da reprodução e age onde ele estiver naquele momento, de modo que a macro sobrevive a uma janela movida, a uma nova resolução ou a outra máquina.

Capture um na guia Imagens, dê um nome a ele e depois use o nome:

wait_for("Save dialog", timeout_ms=10000, abort=True)
click_crop("Save button")

Capture justo. Um recorte deve conter a parte característica e nada mais; o fundo incluído nele faz a correspondência falhar quando o fundo muda.

Leitura de texto na tela

read_text lê uma região da tela para uma variável. Limpe o resultado com métodos e use-o em condições, em contas ou como ${name} dentro de qualquer argumento de texto.

total = read_text(region=(820, 400, 180, 40), single_line=True)
message_box("The order total was ${total}")

Sempre passe region. Ler a área de trabalho inteira a reduz até o texto comum da interface ficar ilegível.

Três leitores

O leitor é escolhido por passo. engine="ai" transcreve; para raciocinar sobre a tela, use ask_ai.

Limpar o que voltou

total = read_text(region=(820, 400, 180, 40)).to_number()
if total < 1000:
    notify("Total looks low: ${total}")

Os métodos estão listados em Limpar o que você leu. Uma região em branco guarda "" e a execução continua. single_line=True junta o resultado em uma única linha.

Perguntar à IA

ask_ai faz uma pergunta sobre parte da tela a um modelo de visão e guarda a resposta: “quantas linhas estão em vermelho?”, “há uma caixa de diálogo de erro?”.

n = ask_ai("how many error icons are visible", role="count", region=(0, 0, 800, 600))
if n:
    click(n.1.x, n.1.y)

Cada chamada custa créditos e impede a exportação; veja Créditos. Uma execução é limitada a 60 chamadas de IA.

Três papéis

Escolher um modelo

model= recebe um nome curto. A lista atual, com os preços calculados para a região que o seu passo lê, está no formulário de configurações (dê um duplo clique na chamada ask_ai na guia Script). A configuração recomendada é o modelo padrão no nível de raciocínio padrão dele: deixe model= e reasoning= fora da chamada e o servidor os escolhe, atualmente glm. A tabela está aí para o caso de você ter um motivo para fazer diferente; o modelo mais caro não é o mais preciso para toda pergunta, e o gemma, o mais barato, foi medido como o mais preciso em um recorte pequeno.

Sempre dê a ele um region=. Um modelo consegue contar coisas em toda a área de trabalho sem conseguir depois localizá-las; uma macro que quer clicar precisa de uma imagem pequena. O mesmo vale para o read_text e para as linhas de vigilância com IA.

Referência do script

O script parece Python e se limita a uma fatia pequena dele: variáveis, aritmética, if/else, loops while e repeat, chamadas de comandos e funções def, indentação de quatro espaços, comentários com #. Os blocos se aninham; só as seções precisam ficar na margem esquerda. Não existem listas, junção de texto com + nem imports.

A referência completa — todos os comandos, todos os argumentos que cada um aceita, os nomes das teclas e um exemplo prático de cada — fica dentro do aplicativo, ao lado do editor em que você escreve os scripts. Na guia Script, abra a lista de comandos e clique com o botão direito em qualquer comando para ver a página de manual dele; selecione um e pressione Inserir para colocar uma chamada válida no cursor. Dê um duplo clique em uma chamada para abrir o formulário de configurações dela, que lista todas as opções que aquele comando aceita.

Os argumentos nomeados podem ser passados em ordem, sem os nomes: press("a", 0.5) é press("a", hold=0.5). Todo comando também aceita label="name".

Vigilância

Uma vigilância é um vigia de tela. Ela observa a tela enquanto uma macro é executada, ou sozinha depois de Iniciar vigilância, à espera daquilo que pode acontecer: uma caixa de diálogo de travamento, um banner de sessão expirada, um aviso de produto esgotado. Um wait_for observa só onde você o colocou; uma vigilância observa o tempo todo.

O que uma linha vigia

O botão Vigiar com escolhe um dos dois: uma imagem para encontrar ou uma pergunta para fazer.

Quando ela dispara

O resto da linha

O que ela faz quando dispara

Pop-up, Telegram, Discord e uma captura de tela anexada. Os botões na linha escolhem os meios de envio; as Configurações fornecem as credenciais. Parar macro para a macro e para a vigilância. Uma linha Analisar dispara a cada verificação, então ela não pode parar a macro.

As configurações de uma linha também guardam um período de silêncio entre mensagens, separado da frequência com que ela olha. Configurações → Notificações também pode enviar uma imagem da tela em intervalos regulares enquanto a vigilância está ativa.

Exportação

O botão Exportar leva junto toda linha de vigilância que esteja ativada e tenha uma imagem, com o recorte e as configurações dela. O programa exportado as inicia a cada execução e as para quando a execução termina, exatamente como o Executar faz aqui. As linhas que perguntam à IA são recusadas na exportação, pelo nome; desative-as antes. Se os alertas delas no Telegram ou no Discord vão chegar até você depende da pergunta sobre credenciais feita na exportação.

Clicker automático

A guia Clicker clica, ou pressiona uma tecla, sem parar até você mandar parar: no cursor, em um ponto fixo ou percorrendo uma sequência de pontos que você grava clicando neles. Ela não é uma macro — nada vai para o projeto — mas tudo na guia fica guardado para a próxima vez.

Três modos

As configurações

Gravar uma sequência

Em Uma sequência de pontos, pressione Gravar pontos e clique com o botão esquerdo em cada lugar, um de cada vez, no próprio programa. Cada clique acrescenta uma linha enquanto você olha. O clique que pressiona Parar — e qualquer outro clique na janela do Recorder — não é contado. Cada linha passa então a ter sua própria espera, botão e tipo de clique, e Escolher move um ponto em uma tela congelada.

Maneiras de pará-lo

• O botão Parar, a tecla de parar o Clicker, a tecla de parar a reprodução ou Esc enquanto o Recorder estiver em primeiro plano.
• Modo segurar: ele clica só enquanto a tecla Iniciar está pressionada, e a tecla continua chegando ao programa sob o ponteiro.
• Parar quando o cursor tocar o topo da tela: empurre o mouse contra a borda superior e ele para, em todos os modos — uma saída que não precisa de teclado.
• Parar se o mouse for movido à mão: no momento em que o ponteiro estiver em um lugar onde o clicker não o colocou.

O botão Iniciar espera um instante primeiro, para o mouse poder sair da janela; a tecla de atalho inicia na hora.

O que cada plano inclui

O clicker em si está em todos os planos: um clique ou uma tecla em um ritmo exato, no cursor ou em um ponto fixo, com o número de cliques, o limite de tempo e todas as maneiras de pará-lo. O Basic e o Pro acrescentam o Humanizado (o cursor se desloca até cada clique e o tempo pressionado varia), as duas variações aleatórias, a dispersão, as sequências de pontos e a caixa para vagar. No Free esses controles ficam acinzentados, com um cadeado ao lado, e o que você ajustou sob um plano fica guardado para quando ele voltar a ser coberto.

O movimento humanizado existe para fazer uma execução se comportar como uma mão no mouse em aplicativos comuns. O Recorder não faz nada para se esconder de nenhum programa.

Exportar como programa

Arquivo → Exportar como programa… gera um único .exe contendo a macro, seus recortes e o leitor de texto com que ela foi ajustada. Ele não precisa de instalador, nem de ambiente de execução, nem de uma cópia do Recorder.

• A caixa de diálogo de exportação oferece uma janela de controle: Executar, Pausar e Parar com suas teclas, Repetir e Velocidade, e uma linha de status. Sem ela, o programa é executado assim que é aberto, não mostra nada e fecha quando a macro termina — o certo para algo iniciado por um agendador, o errado para uma primeira tentativa. Marque a janela para qualquer coisa que você for iniciar à mão: assim um problema aparece em uma mensagem em vez de passar despercebido.
• Suas teclas de Executar, Pausar e Parar vão junto como estavam definidas em Configurações → Teclas de atalho no momento da exportação, e o mesmo vale para as linhas de vigilância que estiverem ativadas e para a configuração de repetição do teclado.
• As macros que usam a IA (ask_ai, ou read_text com engine="ai") são recusadas na exportação, com os passos nomeados. Os dois leitores locais vão dentro do arquivo.
• Se a macro ou uma linha de vigilância envia para o Telegram ou o Discord e um deles está configurado, o Recorder pergunta se deve incluir essas credenciais; quem tiver o arquivo consegue lê-las. Sem elas, os passos notify e os alertas não enviam nada. O Telegram e o Discord precisam do Basic ou do Pro: no Free a pergunta não é feita e os dados nunca vão junto.

Parar um programa exportado

Sua tecla de Parar reprodução como ela estava definida no momento da exportação, F6 a menos que você a tenha alterado. Uma tecla Parar que você desativou volta a ser F6, porque uma macro que não pode ser parada não será executada.

Se outro aplicativo for o dono dessa tecla, o programa a tenta com Ctrl+Shift, depois com Ctrl+Alt, e diz qual delas ficou antes do primeiro passo. Se nenhuma puder ser registrada, a macro não chega a ser executada e informa o motivo.

Um programa exportado contém tudo o que há na macro, inclusive qualquer texto que você digitou. Verifique se há senhas e tokens antes de enviá-lo a alguém. O arquivo não tem assinatura de código, então o SmartScreen pode exibir um aviso na primeira vez que ele for executado.

Assistente de IA

Descreva a macro que você quer e o assistente escreve o script. Nada chega ao seu editor até você aprovar: leia a resposta e depois pressione Usar ou Substituir. Toda resposta é verificada pelo compilador; se ela não compilar, o assistente faz uma tentativa automática de correção, que gasta um crédito.

Dois modos. Criar escreve a macro. Planejar pergunta sobre a tarefa e não escreve nada até você pressionar Escrever a macro; comece por aí para qualquer coisa além de alguns passos. Ctrl+Enter envia; Nova começa uma conversa do zero e apaga a transcrição guardada.

Modelo e Raciocínio: deixe os dois em Padrão. Médio e Máximo são modelos diferentes, não melhores, e mais raciocínio custa mais por mensagem e raramente muda o script. Usar recuperação faz a macro encontrar sozinha o caminho de volta depois de um clique que falhou, em vez de parar; Adicionar pequenas pausas após cliques faz uma breve pausa depois de cada clique, para que o próximo passo não se antecipe à tela. Os dois normalmente ficam ativados.

Como obter uma boa resposta

• Capture seus recortes primeiro. O assistente é informado de quais nomes de recorte existem. Sem nenhum, ele só consegue escrever coordenadas.
• Diga como a tela é, não só o objetivo. "Clique em Atualizar tudo, espere a barra de status dizer Concluído" vale mais do que "atualize a planilha".
• Refine conversando. "Espere a caixa de diálogo Salvar em vez de usar um sleep" é uma continuação normal.

Créditos

Os créditos são gastos por tudo o que chega ao servidor: as mensagens do assistente (inclusive a tentativa de correção), os passos ask_ai, as linhas de vigilância com IA, o read_text com engine="ai" e cada passo de uma execução do agente. Gravar, reproduzir, as âncoras de imagem, os dois leitores de texto locais e a exportação nunca custam nada. Seu saldo aparece ao lado do estado de conexão da conta, no painel do assistente e na página da sua conta; cada passo de IA registra a cobrança dele no log da execução. Os planos e os pacotes de créditos estão na página de preços.

Todo passo de IA em uma macro (ask_ai, read_text com engine="ai", uma linha de vigilância com IA) gasta créditos, exige uma conta conectada e impede a exportação. Um programa exportado não tem conta para cobrar.

Agente

A guia Agente é a terceira visão. Escreva um objetivo e a IA o executa na sua área de trabalho, um passo de cada vez, conferindo a tela depois de cada passo. Isto é computer use, na sua própria área de trabalho, com o mouse e o teclado de verdade. Vai melhor em tarefas curtas e visíveis em uma só tela — abrir uma página, preencher um formulário, passar por algumas telas; um trabalho longo ou fora do comum é melhor gravado como macro. Acompanhe as primeiras vezes.

Cada passo é uma chamada de IA, cobrada nos mesmos créditos do ask_ai — inclusive os passos de uma execução que não chega lá. O agente vê apenas a tela; o texto que está nela nunca é uma instrução para ele.

Ele não é o assistente. O assistente escreve uma macro que você guarda e reproduz; o agente faz a tarefa agora e não deixa nada para trás.

Executar uma tarefa

1. Escreva o objetivo: abrir a pasta de downloads e ordená-la por data. Salvar o guarda na lista Salvos; Excluir remove um.
2. Pressione Iniciar ou Ctrl+Enter. O Recorder pergunta uma vez por execução, Deixar o agente assumir o controle?, repetindo o objetivo e o que ele pode usar. Ele não começa sem uma tecla de atalho de Parar reprodução; veja Reprodução.
3. Acompanhe a linha do tempo. Cada passo mostra o que o agente viu, o veredito dele sobre o passo anterior (sim, não ou incerto), o que ele está fazendo agora e quanto custou. O rodapé mantém o total da execução e os créditos que restam para você.
4. Pressione Parar, ou sua tecla de atalho de parar, a qualquer momento.

Uma execução termina como Concluído, Travado ou Parado, com seus créditos, seus passos e o motivo: um passo que falhou três vezes, quarenta passos sem terminar, o limite de créditos ou sua tecla Parar.

Quando a tarefa é uma pergunta (diga em que plano a conta está) a resposta volta como um relato: uma caixa de mensagem, ou o que estiver ativado entre área de trabalho, Telegram e Discord em Configurações → Notificações.

As opções

O que ele pode fazer

A linha abaixo das caixas diz o que o agente pode usar: mouse, teclado, temporização, abrir programas e mensagens por padrão. Permissões abre Configurações → Agente, onde cada um é uma caixa de seleção em Ele pode:

Deixe as duas últimas desativadas. Uma linha de comando com os seus direitos pode fazer tudo o que você pode, e o agente não sabe distinguir um comando seguro de um destrutivo.

Ele para quando define os limites: passos em uma execução, falhas de um mesmo passo e créditos por execução (0 para sem limite). Ritmo define quanto tempo o agente espera a tela estabilizar, entre passos e entre as ações dentro de um mesmo passo. Aumente o último para um aplicativo que não acompanha o clicar e digitar.

Configurações

Clique em Configurações na barra de menus. Sete guias: Teclas de atalho, Gravação, Teclado, Janela, Notificações, Log e Agente. OK aplica, Cancelar descarta e Restaurar padrões redefine tudo, menos suas credenciais do Telegram e do Discord.

Teclas de atalho

As sete teclas de atalho globais são padrões, não valores fixos. Cada uma pode ser reatribuída ou desativada aqui, e esta guia é o único lugar que mostra as configurações atuais. Clique em um campo e pressione a combinação; Esc a limpa. Duas ações não podem compartilhar uma tecla, e o Recorder avisa se outro aplicativo já reservou alguma. Os padrões estão em Reprodução.

Gravação e Teclado

Gravação reúne as opções de captura e a contagem regressiva do teste. Teclado controla se uma tecla mantida pressionada se repete como em um teclado de verdade: desativado por padrão, com atraso, frequência, uma variação opcional e Igualar a este PC para copiar as configurações do Windows. A configuração vai junto com um programa exportado.

Janela

Ocultar durante a execução, Usar todos os monitores, o tema escuro e o Tamanho do texto, de 85% a 140%. Os dois últimos são aplicados na hora.

Notificações

Desativadas por padrão. Uma vez ativadas, o Recorder pode avisar você quando uma gravação termina, quando uma reprodução termina e quando uma reprodução é interrompida, por notificação da área de trabalho, Discord, Telegram ou qualquer combinação deles. As notificações da área de trabalho estão em todos os planos; o Telegram e o Discord precisam do Basic ou do Pro. No Free as duas caixas ficam acinzentadas, com o motivo abaixo delas, e um token ou webhook que você digitar fica guardado para quando seu plano passar a cobri-lo. A Vigilância usa os mesmos canais, com botões por linha. Qualidade da imagem define o tamanho das capturas de tela anexadas, de Muito baixa a Sem perdas.

Discord

Um único campo: a URL do webhook.

1. Crie um webhook no Discord. Abra Configurações do Servidor → Integrações → Webhooks, escolha Novo Webhook, selecione o canal, dê um nome a ele e pressione Copiar URL do Webhook. Você precisa da permissão Gerenciar Webhooks.
2. Cole no Recorder. Configurações → Notificações, marque Discord, cole a URL.
3. Envie um teste. Uma mensagem deve aparecer no canal em alguns segundos.

A URL do webhook é uma senha. Qualquer pessoa que a tenha pode publicar naquele canal. Se ela vazar, exclua o webhook no Discord e crie outro; exportar um programa que a usa pergunta antes.

Telegram

Você precisa de um token de bot do BotFather e do id numérico do chat da conversa. Os dois vão em Configurações → Notificações.

A captura de tela periódica

Enviar uma imagem da tela durante a vigilância publica uma captura de tela no Telegram e no Discord a cada N segundos, da área que você escolher ou da tela inteira. Só funciona enquanto Iniciar vigilância está ativo e nunca usa o balão da área de trabalho.

O que é enviado

As mensagens vão direto do seu computador para o Discord ou o Telegram, nunca pelos nossos servidores.

Log de diagnóstico

Exibir → Log mostra o que uma execução está fazendo, e Configurações → Log escolhe o que ele registra. Ative Cada passo primeiro quando uma macro se comportar mal. Conteúdo do texto registra em texto simples os caracteres lidos da sua tela; desative de novo assim que você tiver encontrado o problema.

Sua licença

Um computador por vez

Para mudar para outra máquina, saia da conta na antiga e depois entre na nova. Se o computador antigo não estiver mais disponível, entre no novo mesmo assim: depois que a máquina antiga passar 30 dias sem dar sinal, a nova fica com a vaga.

Trabalhando offline

Uma queda de conexão não interrompe uma execução; a barra mostra “Conectado (trabalhando offline)” e o Recorder continua funcionando. Ele só para depois de ficar muito tempo offline.

Recursos que seu plano não cobre

Seis coisas dependem do plano: os recursos de IA, a leitura de texto da tela, a vigilância de tela, a exportação como programa, os alertas do Telegram e do Discord e os extras do clicker automático (cliques humanizados, variação aleatória, dispersão, sequências de pontos e a caixa para vagar). Um controle que seu plano não cobre fica vermelho, e clicar nele explica o motivo; as duas caixas de notificação e os controles extras do clicker ficam acinzentados, com um cadeado e o motivo ao lado.

As alterações entram em vigor em cerca de meia hora. A caixa de diálogo Conta mostra seu plano e seu saldo de créditos.

Solução de problemas