Manuale utente di Myna Recorder
Tutto quello che fa Recorder. La sintassi esatta di ogni comando è dentro l'app, accanto all'editor.
Aggiornato il 15 settembre 2026.
Primi passi
Myna Recorder — “Recorder” in questo manuale, Recorder.exe sul disco — è un registratore di macro per Windows 10 e 11, a 64 bit. Registra la tua tastiera e il tuo mouse, ti permette di modificare il risultato come uno script leggibile e lo riproduce dentro qualsiasi applicazione. Scaricalo qui.
Attivazione
- Crea un account e conferma la tua email.
- Dentro Recorder, accedi in alto a destra con la tua email e la tua password. La barra in alto mostra poi il tuo piano e il saldo dei crediti IA.
Recorder resta connesso e continua a funzionare anche se cade la connessione. Esci libera la postazione di questo computer per un'altra macchina.
La tua prima macro
Premi Avvia registrazione (F2), esegui l'attività a mano, premi Ferma registrazione (F3), poi Avvia riproduzione (F4) per riprodurla e Ferma riproduzione (F6) per terminare un'esecuzione in anticipo. La tabella completa dei tasti rapidi si trova in Riproduzione.
Dove questo manuale nomina un tasto, intende quello predefinito. I tasti si cambiano in Impostazioni → Tasti rapidi.
Una macro invia input reali a qualunque cosa si trovi in primo piano. Sappi qual è il tuo tasto Ferma riproduzione prima di cominciare; funziona anche quando Recorder non è la finestra attiva.
La finestra
Sei viste. Quattro modificano un unico progetto; l'Agente svolge un lavoro al posto tuo, e il Clicker fa clic al posto tuo.
| Vista | A che cosa serve |
|---|---|
| Recorder | L'elenco dei passaggi: una riga per ogni azione, con etichette, sezioni e tratti di movimento del mouse raggruppati. Ideale per riordinare, eliminare e cambiare i tempi. |
| Script | La stessa macro come testo. Ideale per cicli, condizioni e modifiche precise. Fai doppio clic su un comando per aprire il suo modulo di impostazioni. Sotto l'editor, Spiega aggiunge una colonna in parole semplici accanto al codice, Completamento automatico propone i nomi mentre scrivi e Controlla sintassi elenca i problemi mentre scrivi. |
| Clicker | Un clicker automatico: un clic, un tasto o una sequenza di punti, di continuo, al ritmo che imposti — vedi Clicker automatico. |
| Agente | Descrivi che cosa vuoi che venga fatto e l'IA lo fa sul mouse e sulla tastiera reali, un passaggio alla volta — vedi Agente. |
| Sorveglianza | Righe di sorveglianza che funzionano insieme alla riproduzione o per conto loro — vedi Sorveglianza. |
| Immagini | I ritagli di schermo con nome che questa macro usa. Qui li acquisisci, li riacquisisci e li rinomini. I ritagli sono condivisi da tutte le macro di questo computer. |
Affiancati mostra l'elenco dei passaggi e lo script insieme. Il pulsante Variabili apre un pannello che mostra in tempo reale ogni variabile durante un'esecuzione.
File
.recproj— un progetto: la macro, i suoi ritagli e le sue impostazioni in un unico file. È questo che salvi di solito..recscript— uno script da solo, come testo.
La macro in corso viene salvata automaticamente, compreso il testo non applicato della scheda Script.
Registrazione
Avvia registrazione comincia e Ferma registrazione termina (F2 e F3 per impostazione predefinita). La registrazione è globale: acquisisce quello che fai in qualsiasi applicazione, con i tempi originali.
Impostazioni → Registrazione sceglie che cosa viene registrato: tastiera, clic del mouse, movimenti del mouse, rotellina del mouse. Senza i movimenti del mouse la macro è molto più corta e va dritta a ogni obiettivo; registra i movimenti solo per disegnare o per posare il puntatore su qualcosa.
Le coordinate registrate sono pixel assoluti dello schermo. Sposta la finestra, cambia la risoluzione o riproduci su un'altra macchina e un clic registrato finisce nel posto sbagliato. La soluzione sono gli ancoraggi a immagine.
Usa tutti i monitor estende l'acquisizione a tutti gli schermi. Lascialo disattivato se hai un solo schermo.
Riproduzione
| Azione | Tasto predefinito |
|---|---|
| Inizia a registrare | F2 |
| Ferma registrazione | F3 |
| Avvia riproduzione | F4 |
| Metti in pausa / riprendi la riproduzione | F5 |
| Ferma riproduzione | F6 |
| Avvia il clicker automatico | F7 |
| Ferma il clicker automatico | F8 |
Tutti e sette sono globali, e un tasto che Recorder tiene per sé viene consumato: le altre applicazioni non lo vedono mai. Cambiali o disattivali in Impostazioni → Tasti rapidi.
Ferma riproduzione è l'unico modo globale per interrompere una macro in esecuzione. Tienilo assegnato: senza di esso non partono né la funzione che nasconde la finestra durante l'esecuzione né l'Agente.
Velocità e ripetizione
La riproduzione va da 0,25× a 10×. La velocità scala le attese registrate, non le chiamate a sleep() che hai scritto tu, e non può far rispondere un'applicazione più in fretta. Se una macro si rompe a 4× ma funziona a 1×, sostituisci i tempi con wait_for().
Ripeti esegue la macro un numero stabilito di volte; 0 significa “fino all'arresto”. Per ripetere all'interno di una sola esecuzione, usa i blocchi di ciclo.
Esecuzioni di prova
Prova nella scheda Registrazione riproduce solo le righe selezionate. Prova selezione nella scheda Script compila e riproduce il testo selezionato, comprese le modifiche non applicate. La macro non viene mai toccata.
- Una prova viene eseguita una sola volta, a 1×, qualunque cosa dicano Ripeti e Velocità.
- Un ciclo selezionato a metà viene allargato all'intero blocco; l'intestazione di una sezione selezionata vale per tutto ciò che contiene.
- Prima parte un conto alla rovescia (Impostazioni → Registrazione → Attesa prima dell'avvio di una prova, 0–30 secondi, 3 per impostazione predefinita). Il pulsante Arresta lo annulla.
Nascondere la finestra durante l'esecuzione
Impostazioni → Finestra → Nascondi questa finestra durante la registrazione o la riproduzione nasconde Recorder durante un'esecuzione, prove comprese. Richiede un tasto rapido Ferma riproduzione assegnato.
Modificare una macro
Sezioni
Una sezione è un titolo di capitolo nell'elenco dei passaggi. Usane una per ogni fase reale dell'attività.
with section("Log in"):
click_crop("Username")
type_text("user")
with section("Export"):
click_crop("Export")
Le sezioni non si annidano mai e cominciano sul margine sinistro. I cicli e le condizioni possono stare dentro una sezione, con un'indentazione di quattro spazi per livello.
Etichette e salti
label="name" su qualsiasi comando lo rende una destinazione di salto; label("name") su una riga a sé è un passaggio che non fa nulla, messo lì apposta per saltarci; goto("name") ci salta.
with section("Retry"):
click_crop("Refresh", label="again")
wait_for("Done", timeout_ms=20000, on_fail="again")
label("done")
Ogni goto("x"), ogni on_no="x", ogni on_fail="x" e ogni wait_any con freccia -> "x" ha bisogno di un passaggio che porti label="x", altrimenti la riproduzione si ferma con un errore. Le etichette devono essere univoche.
Le funzioni: vedi il riferimento dello script.
Immagini e ritagli
Un ritaglio è un'immagine con nome di qualcosa che sta sullo schermo: un pulsante, un'icona, un titolo. Recorder lo trova al momento della riproduzione e agisce dove si trova adesso, così la macro sopravvive a una finestra spostata, a una nuova risoluzione o a un'altra macchina.
Acquisiscine uno nella vista Immagini, dagli un nome, poi usa il nome:
wait_for("Save dialog", timeout_ms=10000, abort=True)
click_crop("Save button")
| Argomento | Che cosa fa |
|---|---|
"crop" | Il nome, tra virgolette, oppure una condizione di nomi: "A" or "B", "A" and "B", con le parentesi per raggruppare. Funziona in wait_for, in click_crop e nei quattro blocchi if_image/while_image; click_crop fa clic sul primo nome scritto. Vedi le condizioni. |
confidence | Quanto deve essere precisa la corrispondenza, 0–1. Predefinito 0.8. Abbassalo per un pulsante che cambia tonalità al passaggio del puntatore; alzalo se corrisponde la cosa sbagliata. |
timeout_ms | Per quanto tempo continuare a cercare. Predefinito 5000. |
abort | Predefinito False: un'immagine che manca è un mancato ritrovamento, non un errore, e l'esecuzione prosegue. Con abort=True si ferma invece. |
on_fail | Un'etichetta a cui saltare quando l'immagine non compare mai. |
region | (x, y, w, h): cerca solo in questo rettangolo. Usalo quando lo stesso controllo compare due volte. Ogni numero può essere una variabile o una somma. |
match | "color" (predefinito, più rigoroso) oppure "shape", solo il contorno, che sopravvive a un cambio di tema. La vecchia forma grayscale=True significa ancora match="shape". |
x_offset / y_offset | Su click_crop: sposta il clic rispetto al centro della corrispondenza. |
pre_click_ms | Su click_crop: per quanto tempo il cursore si ferma sulla corrispondenza prima di premere. Predefinito 200. Vedi Mouse. |
into | Salva la corrispondenza in una variabile, oppure scrivi r = wait_for("crop"). Vedi il risultato della corrispondenza. |
Ritaglia stretto. Un ritaglio dovrebbe contenere la parte distintiva e nient'altro; lo sfondo che resta dentro fa fallire la corrispondenza quando lo sfondo cambia.
Lettura del testo dallo schermo
read_text legge un'area dello schermo in una variabile. Ripulisci il risultato con i metodi e usalo nelle condizioni, nell'aritmetica, oppure come ${name} dentro qualsiasi argomento di testo.
total = read_text(region=(820, 400, 180, 40), single_line=True)
message_box("The order total was ${total}")
Passa sempre una region. Leggere tutto il desktop lo rimpicciolisce finché il normale testo dell'interfaccia non diventa illeggibile.
Tre lettori
engine= | Che cos'è |
|---|---|
"builtin" | Il predefinito. Funziona sul tuo computer, è gratis e viaggia dentro un programma esportato. |
"tesseract" | Anch'esso locale e gratis. Legge alcune schermate meglio e altre peggio del motore integrato. È l'unico che accetta page_mode=, che controlla come l'immagine viene divisa in righe. Provalo quando una lettura ci va vicino ma è sbagliata. |
"ai" | Un modello di trascrizione sul server. Costa crediti e blocca l'esportazione; vedi Crediti. Usalo quando entrambi i motori locali leggono male qualcosa che conta. |
Il motore si sceglie per ogni passaggio. engine="ai" trascrive; per ragionare su quello che c'è sullo schermo, usa ask_ai.
Ripulire il risultato
total = read_text(region=(820, 400, 180, 40)).to_number()
if total < 1000:
notify("Total looks low: ${total}")
I metodi sono elencati sotto Ripulire quello che leggi. Un'area vuota salva "" e l'esecuzione prosegue. single_line=True unisce il risultato in una sola riga.
Chiedere all'IA
ask_ai pone una domanda su parte dello schermo a un modello di visione e ne salva la risposta: “quante righe sono rosse?”, “c'è una finestra di errore?”.
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)
Ogni chiamata costa crediti e blocca l'esportazione; vedi Crediti. Un'esecuzione è limitata a 60 chiamate IA.
Tre ruoli
role= | La risposta |
|---|---|
"count" | Il predefinito. Un numero, e dove si trova ciascuna cosa: n è il conteggio, n.1.x / n.1.y la prima posizione, n.2.x la seconda. L'indice può essere una variabile: click(n.${i}.x, n.${i}.y). Non esiste un ruolo sì/no: if n: significa “c'è?”, if not n: “manca?”. |
"explain" | Una frase, per log() o notify(). |
"read" | Una trascrizione, con il modello che hai scelto — a differenza di read_text(engine="ai"), che usa un modello di trascrizione fisso. |
Scegliere un modello
model= accetta un nome breve. L'elenco aggiornato, con il prezzo calcolato per l'area che il passaggio legge, si trova nel modulo delle impostazioni (doppio clic sulla chiamata ask_ai nella scheda Script). L'impostazione consigliata è il modello predefinito al suo livello di ragionamento predefinito: lascia fuori dalla chiamata sia model= sia reasoning= e ci pensa il server, oggi glm. La tabella serve per quando hai un motivo per scegliere diversamente; il modello più caro non è il più accurato per ogni domanda, e gemma, il più economico, è risultato il più accurato su un piccolo ritaglio.
| Nome | Modello | Livelli di reasoning= | temperature= |
|---|---|---|---|
gemma | Google Gemma 3 12B | — | 0–2 |
glm | GLM 5.3 Flash (predefinito) | — | 0–2 |
qwen-vl | Qwen3-VL 30B | — | 0–2 |
gemini-lite | Gemini 3.1 Flash Lite | — | 0–2 |
gemini | Gemini 3.7 Flash | low, medium, high | — |
haiku | Claude Haiku 4.5 | — | 0–1 |
sonnet | Claude Sonnet 5 | low, medium, high, xhigh, max (predefinito high) | — |
gemini-pro | Gemini 3.1 Pro | low, medium, high | 0–2 |
kimi | Kimi K3 | low, high, max (ragiona sempre; predefinito max) | — |
opus | Claude Opus 5 | low, medium, high, xhigh, max (predefinito high) | — |
Passa sempre una region=. Un modello può contare cose su tutto il desktop senza poi riuscire a localizzarle; una macro che vuole fare clic ha bisogno di un'immagine piccola. Vale anche per read_text e per le righe di sorveglianza IA.
Riferimento dello script
Lo script assomiglia a Python e ne usa solo una piccola parte: variabili, aritmetica, if/else, cicli while e repeat, chiamate di comando e funzioni def, indentazione a quattro spazi, commenti #. I blocchi si annidano; solo le sezioni devono restare sul margine sinistro. Non ci sono liste, né concatenazione di stringhe con +, né importazioni.
Il riferimento completo — ogni comando, ogni argomento che accetta, i nomi dei tasti e un esempio svolto per ciascuno — si trova dentro l'app, accanto all'editor in cui scrivi gli script. Nella scheda Script, apri l'elenco dei comandi e fai clic destro su un comando per la sua pagina di manuale; selezionane uno e premi Inserisci per far comparire una chiamata valida al cursore. Fai doppio clic su una chiamata per aprire il suo modulo di impostazioni, che elenca ogni opzione accettata da quel comando.
Gli argomenti con nome possono essere passati in ordine senza il loro nome: press("a", 0.5) equivale a press("a", hold=0.5). Ogni comando accetta anche label="name".
Sorveglianza
Un monitor è una sorveglianza. Osserva lo schermo mentre una macro è in esecuzione, oppure da sola dopo Avvia sorveglianza, in cerca di ciò che potrebbe succedere: una finestra di crash, un banner di sessione scaduta, un avviso di esaurimento scorte. Un wait_for osserva solo dove lo metti; una sorveglianza osserva per tutta la durata.
Che cosa osserva una riga
Il chip Osserva con ne sceglie una: un'immagine da trovare, o una domanda da porre.
| Tipo | Che cosa fa |
|---|---|
| Immagine | Un ritaglio con nome, confrontato come fa wait_for. Gratis, e quante volte vuoi. |
| Chiedi all'IA | Una domanda a un modello di visione: “c'è una finestra di errore?” La risposta è un conteggio; 0 significa che non è stato trovato nulla. Costa crediti; vedi Crediti. |
Quando scatta
| Impostazione | Significato |
|---|---|
| Appare | L'immagine compare, oppure il conteggio passa da 0 a un numero qualsiasi. |
| Scompare | C'era ed ora non c'è più. La riga deve prima vederla, quindi non scatta mai per qualcosa che non hai ancora aperto. |
| Analizza | Solo righe IA. Nessun fronte: il modello descrive ciò che vede e la riga invia quella frase a ogni controllo. |
Il resto della riga
| Colonna | Che cosa fa |
|---|---|
| Cerca in | Quale parte dello schermo cercare o interrogare. Vuoto significa ovunque. Dai a una riga IA un'area piccola; vedi Chiedere all'IA. |
| Confronto | Righe immagine: Colore è più rigoroso, Forma confronta solo il contorno e sopravvive a un cambio di tema. L'ingranaggio accanto contiene il periodo di silenzio. Le righe IA usano questa cella per modello, ragionamento, temperatura, area e periodo di silenzio. |
| Controlla ogni | Ogni quanto controlla questa riga, in secondi. Una riga IA non può scendere sotto un secondo e per impostazione predefinita vale sessanta. |
| Inizia dopo | Ritardo dopo Avvia sorveglianza prima che questa riga inizi, così un'applicazione fa in tempo a caricarsi. Riarmato ogni volta che la sorveglianza si avvia. |
| Messaggio | Che cosa dice l'avviso. ${name} viene sostituito. Lasciato vuoto, una riga Analizza invia la frase del modello stesso. |
Che cosa fa quando scatta
Finestra a comparsa, Telegram, Discord, e uno screenshot allegato. I pulsanti sulla riga scelgono i canali; le credenziali sono in Impostazioni. Ferma macro ferma la macro e ferma la sorveglianza. Una riga Analizza scatta a ogni controllo, quindi non può fermare la macro.
Le impostazioni di una riga contengono anche un periodo di silenzio tra i messaggi, distinto da quanto spesso controlla. Impostazioni → Notifiche può anche inviare un'immagine dello schermo a intervalli mentre la sorveglianza è attiva.
Esportazione
Il pulsante Esporta porta con sé ogni riga di sorveglianza attiva e con un'immagine, con il suo ritaglio e le sue impostazioni. Il programma esportato le avvia a ogni esecuzione e le ferma quando l'esecuzione finisce, esattamente come fa Esegui qui. Le righe che interrogano l'IA vengono rifiutate all'esportazione, per nome; disattivale prima. Se i loro avvisi su Telegram o Discord ti raggiungono dipende dalla domanda sulle credenziali all'esportazione.
Clicker automatico
La scheda Clicker fa clic, oppure preme un tasto, di continuo finché non lo fermi: sul cursore, su un punto fisso, o lungo una sequenza di punti che registri facendoci clic. Non è una macro — nulla entra nel progetto — ma tutto ciò che è nella scheda viene ricordato per la prossima volta.
Tre modalità
| Modalità | Che cosa fa |
|---|---|
| Un clic | Un clic, ripetuto. Sinistro, destro o centrale; singolo, doppio o triplo. Sul cursore, dove segue il mouse; su un punto fisso che scegli su uno schermo congelato; oppure vagando dentro un riquadro. |
| La pressione di un tasto | Un tasto, premuto più volte di seguito. |
| Una sequenza di punti | Più punti, cliccati in ordine, ciascuno con la propria attesa, il proprio pulsante e il proprio tipo di clic, di nuovo e di nuovo. |
Le impostazioni
| Impostazione | Significato |
|---|---|
| Attesa tra i clic | Il tempo tra un clic e l'altro, in millisecondi, più una variazione casuale opzionale: fino a quel tanto di extra, calcolato di nuovo a ogni clic, così il ritmo non è mai esatto. Il pillolo verde accanto mostra a cosa corrispondono le impostazioni in clic al secondo, contando anche la tenuta e la variazione casuale. |
| Tenuta premuta | Per quanto tempo il pulsante o il tasto resta premuto a ogni clic, con una propria variazione casuale. |
| Fermati dopo | Fino all'arresto, un numero di clic (di passaggi, per una sequenza), oppure un tempo. |
| Dispersione | Quanto può spostarsi ogni clic dal suo punto, in qualsiasi direzione, così un'esecuzione lunga non colpisce sempre lo stesso pixel. 0 è esatto. Tienila più piccola del bersaglio. |
| Vagare dentro un riquadro | Scegli un riquadro, poi da dove partire al suo interno; ogni clic si sposta al massimo di quel tanto dall'ultimo e non esce mai dal riquadro. |
| Tasto rapido | F7 avvia, F8 ferma, da qualsiasi programma. Cambiali in Impostazioni → Tasti rapidi. |
Registrare una sequenza
In Una sequenza di punti, premi Registra punti e fai clic sinistro su ogni punto, in ordine, nel programma stesso. Ogni clic aggiunge una riga mentre osservi. Il clic con cui premi Ferma — e ogni altro clic sulla finestra di Recorder — non viene contato. Ogni riga ha poi la propria attesa, il proprio pulsante e il proprio tipo di clic, e Scegli sposta un punto su uno schermo congelato.
Modi per fermarlo
- Il pulsante Ferma, il tasto Ferma clicker, il tasto Ferma riproduzione, oppure Esc mentre Recorder è in primo piano.
- Modalità tenuta: fa clic solo finché il tasto di avvio è tenuto premuto, e il tasto raggiunge comunque il programma sotto al puntatore.
- Fermati quando il cursore tocca la cima dello schermo: spingi il mouse contro il bordo superiore e si ferma, in ogni modalità — una via d'uscita che non richiede la tastiera.
- Fermati se il mouse viene spostato a mano: nell'istante in cui il puntatore è in un punto in cui il clicker non lo ha messo.
Il pulsante Avvia attende un momento prima, così il mouse può lasciare la finestra; il tasto rapido parte subito.
Che cosa include ogni piano
Il clicker in sé è incluso in ogni piano: un clic o un tasto a un ritmo esatto, sul cursore o su un punto fisso, con il conteggio, il limite di tempo e ogni modo per fermarlo. Basic e Pro aggiungono Umanizzato (il cursore si sposta verso ogni clic e la tenuta varia), le due variazioni casuali, la dispersione, le sequenze di punti e il riquadro vagante. Su Free questi controlli sono disattivati con un lucchetto accanto, e ciò che imposti sotto un piano viene conservato per quando tornerà a essere incluso.
Il movimento umanizzato serve a far comportare un'esecuzione come una mano sul mouse nelle applicazioni comuni. Recorder non fa nulla per nascondersi da nessun programma.
Esportare come programma
File → Esporta come programma… scrive un unico .exe che contiene la macro, i suoi ritagli e il lettore di testo con cui è stata messa a punto. Non richiede né un programma di installazione, né un runtime, né una copia di Recorder.
- La finestra di esportazione propone una finestra di controllo: Esegui, Pausa e Arresta con i loro tasti, Ripeti e Velocità, e una riga di stato. Senza di essa il programma parte nell'istante in cui viene aperto, non mostra nulla e si chiude quando la macro finisce — giusto per qualcosa avviato da un'utilità di pianificazione, sbagliato per una prima prova. Attiva la finestra per tutto ciò che avvierai a mano: così un problema viene mostrato in un messaggio invece di passare in silenzio.
- I tuoi tasti Esegui, Pausa e Arresta viaggiano come sono assegnati in Impostazioni → Tasti rapidi al momento dell'esportazione, e con loro le righe di sorveglianza attive e l'impostazione di ripetizione della tastiera.
- Le macro che usano l'IA (
ask_ai, oppureread_textconengine="ai") vengono rifiutate all'esportazione, con l'indicazione dei passaggi. I due lettori locali viaggiano dentro il file. - Se la macro o una riga di sorveglianza invia messaggi su Telegram o Discord e uno dei due è configurato, Recorder chiede se includere quelle credenziali; chiunque abbia il file può leggerle. Senza di esse i passaggi di notifica e gli avvisi non inviano nulla. Telegram e Discord richiedono Basic o Pro: con Free la domanda non viene posta e quei dati non viaggiano mai.
Fermare un programma esportato
Il tuo tasto Ferma riproduzione come era assegnato quando hai esportato, F6 se non l'hai cambiato. Un tasto di arresto che hai disattivato torna a F6, perché una macro che non si può fermare non viene eseguita.
Se un'altra applicazione occupa già quel tasto, il programma lo prova con Ctrl+Shift, poi con Ctrl+Alt, e dice quale prima del primo passaggio. Se non riesce a registrarne nessuno, la macro non viene eseguita affatto e ne spiega il motivo.
Un programma esportato contiene tutto ciò che è nella macro, compreso qualsiasi testo che hai digitato. Controlla che non ci siano password o token prima di mandarlo a qualcuno. Il file non ha la firma digitale del codice, quindi SmartScreen potrebbe mostrare un avviso la prima volta che viene eseguito.
Assistente IA
Descrivi la macro che vuoi e l'assistente scrive lo script. Niente arriva nel tuo editor finché non lo approvi: leggi la risposta, poi premi Usa questo o Sostituisci tutto. Ogni risposta viene controllata dal compilatore; se non compila, l'assistente fa un tentativo automatico di riparazione, che consuma un credito.
Due modalità. Crea scrive la macro. Pianifica fa domande sul lavoro e non scrive nulla finché non premi Scrivi la macro; parti da lì per qualsiasi cosa vada oltre pochi passaggi. Ctrl+Enter invia; Nuova avvia una conversazione da zero ed elimina la trascrizione salvata.
Modello e Ragionamento: lasciali entrambi su Predefinito. Medio e Massimo sono modelli diversi, non migliori, e più ragionamento costa di più a ogni turno e raramente cambia lo script. Usa il recupero fa sì che la macro ritrovi da sola la strada dopo un clic mancato invece di fermarsi; Aggiungi brevi pause dopo i clic fa una breve pausa dopo ogni clic, così il passaggio successivo non corre avanti rispetto allo schermo. Di norma si lasciano attive entrambe.
Ottenere una buona risposta
- Cattura prima i tuoi ritagli. All'assistente viene detto quali nomi di ritaglio esistono. Senza nessuno, può solo scrivere coordinate.
- Descrivi com'è fatto lo schermo, non solo l'obiettivo. «Fai clic su Aggiorna tutto, aspetta che la barra di stato dica Fatto» è meglio di «aggiorna il foglio di calcolo».
- Perfeziona conversando. «Aspetta la finestra di salvataggio invece di usare uno sleep» è un seguito del tutto normale.
Crediti
I crediti vengono consumati da tutto ciò che raggiunge il server: i turni dell'assistente (compreso il tentativo di riparazione), i passaggi ask_ai, le righe di sorveglianza IA, read_text con engine="ai" e ogni passaggio di un'esecuzione dell'agente. Registrazione, riproduzione, ancoraggi a immagine, i due lettori di testo locali e l'esportazione non ne costano mai uno. Il tuo saldo è mostrato accanto allo stato di accesso, nel pannello dell'assistente e nella pagina del tuo account; ogni passaggio IA scrive il suo addebito nel registro dell'esecuzione. Piani e pacchetti di crediti sono nella pagina dei prezzi.
Ogni passaggio IA in una macro (ask_ai, read_text con engine="ai", una riga di sorveglianza IA) costa crediti, richiede un account con l'accesso effettuato e blocca l'esportazione. Un programma esportato non ha nessun account da addebitare.
Agente
La scheda Agente è la terza vista. Scrivi un obiettivo e l'IA lo porta a termine sul tuo desktop, un passaggio alla volta, controllando lo schermo dopo ogni passaggio. Questo è computer use, sul tuo desktop, con il mouse e la tastiera veri. Riesce meglio nei lavori brevi e visibili su un solo schermo — aprire una pagina, compilare un modulo, passare per qualche schermata; i lavori lunghi o insoliti è meglio registrarli come macro. Guardalo lavorare le prime volte.
Ogni passaggio è una chiamata IA, addebitata negli stessi crediti di ask_ai — compresi i passaggi di un'esecuzione che non arriva in fondo. L'agente vede solo lo schermo; il testo su quello schermo non è mai un'istruzione per lui.
Non è l'assistente. L'assistente scrive una macro che conservi e riproduci; l'agente fa il lavoro adesso e non lascia niente dietro di sé.
Eseguire un lavoro
- Scrivi l'obiettivo: apri la cartella dei download e ordinala per data. Salva lo conserva nell'elenco Salvati; Elimina ne rimuove uno.
- Premi Avvia oppure Ctrl+Enter. Recorder chiede una volta per esecuzione, Lasciare il controllo all'agente?, ripetendo l'obiettivo e quello che può usare. Non parte senza un tasto rapido Ferma riproduzione; vedi Riproduzione.
- Osserva la cronologia. Ogni passaggio mostra che cosa ha visto l'agente, il suo giudizio sul passaggio precedente (sì, no o incerto), che cosa sta facendo ora e quanto è costato. In fondo restano il totale dell'esecuzione e i crediti che ti rimangono.
- Premi Arresta, oppure il tuo tasto rapido di arresto, in qualsiasi momento.
Un'esecuzione si conclude con Terminato, Bloccato o Fermato, insieme ai suoi crediti, ai suoi passaggi e al motivo: un passaggio fallito tre volte, quaranta passaggi senza finire, il limite di crediti oppure il tuo tasto di arresto.
Quando il lavoro è una domanda (dimmi su quale piano è l'account) la risposta torna come rapporto: una finestra di messaggio, oppure quello tra desktop, Telegram e Discord che Impostazioni → Notifiche ha attivato.
Le opzioni
| Modello | Predefinito, Medio o Massimo. Massimo è l'impostazione consigliata e quella con cui parte un nuovo profilo. |
| Ottimizzatore di crediti | Invia uno screenshot più piccolo a ogni passaggio, circa un quinto in meno per esecuzione. Disattivalo se l'agente non vede il testo piccolo. |
| Impara come macro | Non disponibile in questa versione; la casella è disattivata. L'agente non lascia nessuna macro. |
Che cosa può fare
La riga sotto le caselle dice che cosa può usare l'agente: mouse, tastiera, tempi, avvio di programmi e messaggi per impostazione predefinita. Autorizzazioni apre Impostazioni → Agente, dove ciascuna è una casella di spunta sotto Può:
| Autorizzazione | Predefinito |
|---|---|
| Muovere il mouse e fare clic | attivato |
| Scrivere con la tastiera | attivato |
| Attendere | attivato |
| Aprire file, cartelle e pagine web | attivato |
| Riferire cosa ha trovato | attivato |
| Eseguire comandi | disattivato — lascialo disattivato. Non è ancora stato provato abbastanza. |
| Riavviare o spegnere il computer | disattivato |
Lascia disattivate le ultime due. Una riga di comando con i tuoi diritti può fare tutto quello che puoi fare tu, e l'agente non sa distinguere un comando sicuro da uno distruttivo.
Si ferma quando imposta i limiti: i passaggi di un'esecuzione, i fallimenti di un singolo passaggio e i crediti per esecuzione (0 per nessun limite). Ritmo imposta quanto l'agente aspetta che lo schermo si stabilizzi, quanto aspetta tra un passaggio e l'altro e quanto tra le azioni dentro un singolo passaggio. Alza l'ultimo valore per un'applicazione che non tiene il passo con clic-poi-digita.
Impostazioni
Fai clic su Impostazioni nella barra dei menu. Sette schede: Tasti rapidi, Registrazione, Tastiera, Finestra, Notifiche, Registro e Agente. OK applica, Annulla scarta e Ripristina predefiniti riporta tutto ai valori iniziali tranne le tue credenziali di Telegram e Discord.
Tasti rapidi
I sette tasti rapidi globali sono predefiniti, non fissi. Ognuno può essere riassegnato o disattivato qui, e questa scheda è l'unico posto che mostra le assegnazioni attuali. Fai clic su un campo e premi la combinazione; Esc la cancella. Due azioni non possono condividere un tasto, e Recorder avvisa se un'altra applicazione ne ha già preso uno. I valori predefiniti sono in Riproduzione.
Registrazione e Tastiera
Registrazione contiene le opzioni di acquisizione e il conto alla rovescia della prova. Tastiera decide se un tasto tenuto premuto si ripete come sulla tastiera vera: disattivato per impostazione predefinita, con ritardo, frequenza, una variazione opzionale e Come questo PC per copiare le impostazioni di Windows. L'impostazione viaggia con un programma esportato.
Finestra
Nascondi la finestra durante l'esecuzione, Usa tutti i monitor, il tema scuro e Dimensione testo dall'85% al 140%. Le ultime due si applicano subito.
Notifiche
Disattivate per impostazione predefinita. Una volta attivate, Recorder può avvisarti quando una registrazione finisce, quando una riproduzione finisce e quando una riproduzione viene interrotta, con una notifica sul desktop, su Discord, su Telegram o con una qualsiasi combinazione. Le notifiche sul desktop sono in ogni piano; Telegram e Discord richiedono Basic o Pro. Con Free le due caselle sono disattivate con il motivo scritto sotto, e un token o un webhook che inserisci viene conservato per quando il tuo piano lo includerà. La Sorveglianza usa gli stessi canali, con interruttori per ogni riga. Qualità dell'immagine stabilisce quanto sono grandi gli screenshot allegati, da Molto bassa a Senza perdita.
Discord
Un solo campo: l'URL del webhook.
- Crea un webhook in Discord. Apri Impostazioni server → Integrazioni → Webhook, scegli Nuovo webhook, scegli il canale, dagli un nome e premi Copia URL webhook. Serve l'autorizzazione Gestisci webhook.
- Incollalo in Recorder. Impostazioni → Notifiche, spunta Discord, incolla l'URL.
- Invia una prova. Un messaggio dovrebbe comparire nel canale nel giro di pochi secondi.
L'URL del webhook è una password. Chiunque ce l'abbia può scrivere in quel canale. Se esce fuori, elimina il webhook in Discord e creane uno nuovo; esportare un programma che lo usa te lo chiede prima.
Telegram
Ti servono un token del bot da BotFather e l'ID chat numerico della conversazione. Vanno entrambi in Impostazioni → Notifiche.
Lo screenshot a intervalli
Invia un'immagine dello schermo durante la sorveglianza pubblica uno screenshot su Telegram e Discord ogni N secondi, dell'area che scegli o di tutto lo schermo. Funziona solo mentre Avvia sorveglianza è attivo e non usa mai il fumetto sul desktop.
Che cosa viene inviato
| Sempre | Una riga di testo che dice che cosa è finito, oppure il messaggio che hai impostato su una riga di sorveglianza. |
| Facoltativo | Uno screenshot, se lo attivi per una riga di sorveglianza o se attivi lo screenshot a intervalli. Mostra qualunque cosa fosse sullo schermo nell'area scelta in quel momento. |
| Mai | La tua macro, i tuoi script, i tuoi ritagli o qualsiasi cosa riguardi il tuo account. |
I messaggi vanno direttamente dal tuo computer a Discord o Telegram, mai attraverso i nostri server.
Registro diagnostico
Visualizza → Registro mostra che cosa sta facendo un'esecuzione, e Impostazioni → Registro sceglie che cosa viene registrato. Quando una macro si comporta male, attiva per prima cosa Ogni passaggio. Contenuto del testo registra in chiaro i caratteri letti dal tuo schermo; disattivalo di nuovo una volta trovato il problema.
La tua licenza
Un computer alla volta
Per passare a un'altra macchina, esci sul vecchio computer, poi accedi sul nuovo. Se il vecchio computer non c'è più, accedi comunque sul nuovo: quando la vecchia macchina non si fa sentire da 30 giorni, il nuovo computer ne prende la postazione.
Lavorare senza connessione
Una connessione che cade non ferma un'esecuzione; la barra mostra “Accesso effettuato (lavoro offline)” e Recorder continua a funzionare. Si ferma solo dopo essere rimasto senza connessione per parecchio tempo.
Funzioni non incluse nel tuo piano
Sei cose dipendono dal piano: le funzioni IA, la lettura del testo dallo schermo, la sorveglianza dello schermo, l'esportazione come programma, gli avvisi su Telegram e Discord e gli extra del clicker automatico (clic umanizzati, variazione casuale, dispersione, sequenze di punti e riquadro vagante). Un controllo non incluso nel tuo piano diventa rosso, e facendoci clic ti spiega perché; le due caselle delle notifiche e i controlli extra del clicker si disattivano con un lucchetto e il motivo accanto.
Le modifiche hanno effetto entro circa mezz'ora. La finestra Account mostra il tuo piano e il tuo saldo di crediti.
Risoluzione dei problemi
| Sintomo | Causa abituale e soluzione |
|---|---|
| I clic finiscono nel posto sbagliato | Le coordinate registrate sono assolute (vedi Registrazione) e la finestra si è spostata oppure è cambiata la risoluzione. Sostituisci click(x, y) con click_crop("name"). |
| Funziona passo passo, fallisce a piena velocità | All'applicazione serve un attimo. I clic si fermano già sul bersaglio per pre_click_ms=200; prova 400–600 sul clic che fallisce, o meglio, fai un wait_for della cosa che stai per usare. |
wait_for va in timeout anche se l'immagine è visibile |
Il ritaglio comprende dello sfondo che è cambiato, oppure il controllo ha un tema diverso. Ricattura più stretto, abbassa confidence oppure prova match="shape". L'argomento di registro «Ricerche di immagini» mostra i punteggi. |
read_text restituisce risultati senza senso |
Manca la region, oppure è troppo grande. Restringila al solo testo e prova engine="tesseract" se il lettore integrato fa ancora fatica. |
Un passaggio ask_ai o una riga di sorveglianza IA non risponde niente |
Servono un account con l'accesso effettuato e dei crediti, e una region= abbastanza piccola perché la cosa sia leggibile. |
| L'agente non parte | Non è assegnato nessun tasto rapido Ferma riproduzione (la finestra dice L'agente ha bisogno di un tasto di arresto). Assegnane uno in Impostazioni → Tasti rapidi. Servono anche un account con l'accesso effettuato e dei crediti. |
| L'agente finisce Fermato o Bloccato | Ha raggiunto un limite (un passaggio fallito tre volte, quaranta passaggi oppure il limite di crediti) o il modello ha rinunciato; l'ultima riga dice quale. Dividi l'obiettivo in lavori più piccoli, disattiva l'ottimizzatore di crediti oppure alza i limiti in Impostazioni → Agente. |
| La tastiera resta bloccata dopo un'esecuzione | Un key_down senza il suo key_up. Premi e rilascia il modificatore a mano, poi correggi la macro. |
| La riproduzione si ferma con un errore di etichetta sconosciuta | Un goto, un on_no, un on_fail o una freccia di wait_any nomina qualcosa che nessun passaggio ha come etichetta e nessuna sezione ha come nome. Controlla come è scritto; le etichette e i nomi di sezione distinguono maiuscole e minuscole. |
| Un tasto rapido non fa niente | È stato riassegnato, disattivato, oppure un'altra applicazione lo ha registrato per prima; Windows non condivide un tasto globale. Controlla Impostazioni → Tasti rapidi. |
| Un programma esportato non si ferma con F6 | Qualcos'altro occupa il tuo tasto di arresto, quindi il programma lo ha attivato con Ctrl+Shift o Ctrl+Alt e lo ha detto prima di partire. I tasti viaggiano come sono assegnati in Impostazioni → Tasti rapidi al momento dell'esportazione; riesporta dopo averli riassegnati. |
| Non succede niente quando parte la riproduzione | L'applicazione di destinazione è in esecuzione come amministratore e Recorder no. Avvia anche Recorder come amministratore. |
| Un pulsante è rosso | Il tuo piano non include quella funzione. Facci clic; il messaggio dice quale. Vedi La tua licenza. |
| Un programma esportato non fa niente di visibile | È stato esportato senza la finestra di controllo, quindi parte nell'istante in cui viene aperto e si chiude quando la macro finisce. Esportalo di nuovo con Mostra una finestra di controllo spuntato: così Esegui, Pausa e Arresta sono sullo schermo, e tutto ciò che va storto viene mostrato in un messaggio. |
Ancora bloccato?
Scrivi a support@mynarecorder.com. Dire che cosa ti aspettavi e che cosa è successo invece, allegando il registro se ce l'hai, ti fa avere una risposta vera già al primo messaggio.