Manual de usuario de Myna Recorder

Primeros pasos

Myna Recorder — “Recorder” en este manual, Recorder.exe en el disco — es un grabador de macros para Windows 10 y 11, de 64 bits. Graba tu teclado y tu ratón, te permite editar el resultado como un script legible y lo reproduce en cualquier aplicación. Descárgalo aquí.

Activación

1. Crea una cuenta y confirma tu correo electrónico.
2. En Recorder, inicia sesión arriba a la derecha con tu correo electrónico y tu contraseña. La barra superior mostrará entonces tu plan y tu saldo de créditos de IA.

Recorder sigue conectado y continúa funcionando aunque se pierda la conexión. Cerrar sesión libera el puesto de este equipo para otra máquina.

Tu primera macro

Pulsa Iniciar grabación (F2), haz la tarea a mano, pulsa Detener grabación (F3), luego Iniciar reproducción (F4) para reproducirla y Detener reproducción (F6) para terminar una ejecución antes de tiempo. La tabla completa de atajos está en Reproducción.

Donde este manual nombra una tecla, se refiere a la predeterminada. Las teclas se cambian en Configuración → Teclas rápidas.

Una macro envía entradas reales a lo que esté en primer plano. Averigua cuál es tu tecla de Detener reproducción antes de empezar; funciona incluso cuando Recorder no es la ventana activa.

La ventana

Seis vistas. Cuatro editan un mismo proyecto; el Agente hace una tarea por ti, y el Clicker hace clic por ti.

En paralelo muestra la lista de pasos y el script a la vez. El botón Variables abre un panel que muestra cada variable en vivo durante una ejecución.

Archivos

• .recproj — un proyecto: la macro, sus recortes y su configuración en un solo archivo. Esto es lo que normalmente guardas.
• .recscript — un script por su cuenta, como texto.

La macro en curso se guarda automáticamente, incluido el texto sin aplicar de la pestaña Script.

Grabación

Iniciar grabación empieza y Detener grabación termina (F2 y F3 de forma predeterminada). Grabar es global: captura lo que haces en cualquier aplicación, con la temporización original.

Configuración → Grabación elige qué se graba: teclado, clics del ratón, movimiento del ratón, rueda del ratón. Sin el movimiento del ratón, la macro es mucho más corta y hace clic directo en cada objetivo; graba el movimiento solo para dibujar o para pasar el cursor por encima de algo.

Las coordenadas grabadas son píxeles absolutos de la pantalla. Si mueves la ventana, cambias la resolución o reproduces en otra máquina, un clic grabado caerá en el lugar equivocado. La solución son las anclas de imagen.

Usar todos los monitores extiende la captura a todas las pantallas. Déjalo desactivado si solo tienes una pantalla.

Reproducción

Las siete son globales, y una tecla que Recorder retiene queda consumida: ninguna otra aplicación llega a verla. Cámbialas o desactívalas en Configuración → Teclas rápidas.

Detener reproducción es la única forma global de interrumpir una macro en marcha. Mantenla asignada; tanto ocultar la ventana mientras se ejecuta como el Agente se niegan a empezar sin ella.

Velocidad y repetición

La reproducción va de 0,25× a 10×. La velocidad escala las esperas grabadas, no las llamadas a sleep() que hayas escrito, y no puede hacer que una aplicación responda más rápido. Si una macro falla a 4× pero funciona a 1×, sustituye la temporización por wait_for().

Repetir ejecuta la macro un número determinado de veces; 0 significa “hasta detener”. Para repetir dentro de una misma ejecución, usa los bloques de bucle.

Ejecuciones de prueba

Probar en la pestaña Grabación reproduce solo las filas seleccionadas. Probar selección en la pestaña Script compila y reproduce el texto seleccionado, incluidas las ediciones sin aplicar. La macro nunca se modifica.

• Una prueba se ejecuta una sola vez, a 1×, sea lo que sea lo que digan Repetir y Velocidad.
• Un bucle seleccionado solo a medias se amplía a todo el bloque; el encabezado de una sección seleccionada representa todo lo que hay dentro de ella.
• Primero se ejecuta una cuenta atrás (Configuración → Grabación → Esperar antes de que empiece una prueba, 0–30 segundos, 3 por defecto). Detener la cancela.

Ocultar mientras se ejecuta

Configuración → Ventana → Ocultar esta ventana mientras se graba o se reproduce oculta Recorder durante una ejecución, pruebas incluidas. Necesita tener asignado un atajo de Detener reproducción.

Edición de una macro

Secciones

Una sección es un encabezado de capítulo en la lista de pasos. Usa una por cada fase real de la tarea.

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

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

Las secciones nunca se anidan y empiezan en el margen izquierdo. Los bucles y las condiciones sí pueden ir dentro de una, con una sangría de cuatro espacios por nivel.

Etiquetas y saltos

label="name" en cualquier comando lo convierte en un destino de salto; label("name") en su propia línea es un paso que no hace nada, pensado para saltar a él; goto("name") salta hasta allí.

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" y toda flecha de wait_any -> "x" necesita un paso que lleve label="x", o la reproducción se detiene con un error. Las etiquetas deben ser únicas.

Funciones: consulta la referencia del script.

Imágenes y recortes

Un recorte es una imagen con nombre de algo en la pantalla: un botón, un icono, un encabezado. Recorder lo busca en el momento de reproducir y actúa donde sea que esté ahora, así que la macro sobrevive a una ventana movida, una resolución nueva o otra máquina.

Captura uno en la vista Imágenes, ponle un nombre y luego usa ese nombre:

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

Captura de forma ajustada. Un recorte debe contener la parte distintiva y nada más; el fondo que incluya hace fallar la coincidencia cuando ese fondo cambia.

Lectura de texto de la pantalla

read_text lee una región de la pantalla y la guarda en una variable. Limpia el resultado con métodos y úsalo en condiciones, operaciones aritméticas, o como ${name} dentro de cualquier argumento de texto.

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

Pasa siempre region. Leer todo el escritorio lo reduce de escala hasta que el texto normal de la interfaz queda ilegible.

Tres lectores

El motor se elige por paso. engine="ai" transcribe; para razonar sobre la pantalla, usa ask_ai.

Limpiar lo que se obtuvo

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

Los métodos están listados en Limpiar lo que lees. Una región en blanco guarda "" y la ejecución continúa. single_line=True une el resultado en una sola línea.

Preguntar a la IA

ask_ai le hace una pregunta sobre una parte de la pantalla a un modelo de visión y guarda la respuesta: “¿cuántas filas son rojas?”, “¿hay un cuadro de diálogo de error?”.

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 llamada cuesta créditos y bloquea la exportación; consulta Créditos. Una ejecución tiene un límite de 60 llamadas a la IA.

Tres roles

Elegir un modelo

model= toma un nombre corto. La lista en vivo, con el precio calculado para la región que lee tu paso, está en el formulario de configuración (haz doble clic en la llamada ask_ai en la pestaña Script). La opción recomendada es el modelo predeterminado con su nivel de razonamiento predeterminado: deja model= y reasoning= fuera de la llamada y el servidor los elige, actualmente glm. La tabla está ahí para cuando tengas un motivo para elegir otro; el modelo más caro no es el más preciso para cada pregunta, y gemma, el más barato, fue el que resultó más preciso en un recorte pequeño.

Dale siempre una region=. Un modelo puede contar cosas en todo el escritorio que luego no es capaz de localizar; una macro que quiere hacer clic necesita una imagen pequeña. Lo mismo se aplica a read_text y a las filas de vigilancia con IA.

Referencia del script

El script se parece a Python y se limita a una pequeña parte de él: variables, aritmética, if/else, bucles while y repeat, llamadas a comandos y funciones def, sangría de cuatro espacios, comentarios #. Los bloques se anidan; solo las secciones deben quedarse en el margen izquierdo. No hay listas, no hay unión de cadenas con +, ni imports.

La referencia completa — cada comando, cada argumento que acepta, los nombres de las teclas y un ejemplo resuelto de cada uno — vive dentro de la aplicación, junto al editor donde escribes los scripts. En la pestaña Script, abre la lista de comandos y haz clic derecho en cualquier comando para ver su página de manual; selecciona uno y pulsa Insertar para colocar una llamada válida en el cursor. Haz doble clic en una llamada para abrir su formulario de configuración, que enumera todas las opciones que acepta ese comando.

Los argumentos con nombre pueden darse en orden sin su nombre: press("a", 0.5) es press("a", hold=0.5). Todos los comandos también aceptan label="name".

Vigilancia

Una fila de vigilancia es un vigilante. Observa la pantalla mientras se ejecuta una macro, o por su cuenta después de Iniciar vigilancia, a la espera de lo que pueda pasar: un cuadro de diálogo de fallo, un aviso de sesión caducada, una advertencia de que se ha agotado el stock. Un wait_for observa solo donde lo colocas; una fila de vigilancia observa todo el tiempo.

Qué observa una fila

El chip Vigilar con elige uno: una imagen que buscar, o una pregunta que hacer.

Al avisar

El resto de la fila

Qué hace al activarse

Ventana emergente, Telegram, Discord, y una captura de pantalla adjunta. Los chips de la fila eligen los medios de envío; Configuración aporta las credenciales. Detener macro detiene la macro y detiene la vigilancia. Una fila Analizar se activa en cada comprobación, así que no puede detener la macro.

La configuración de una fila también guarda un periodo de silencio entre mensajes, aparte de la frecuencia con la que mira. Configuración → Notificaciones también puede enviar una imagen de la pantalla cada cierto tiempo mientras la vigilancia está activa.

Exportación

El botón Exportar lleva consigo cada fila de vigilancia que está activada y tiene una imagen, junto con su recorte y su configuración. El programa exportado las inicia en cada ejecución y las detiene cuando la ejecución termina, igual que hace aquí Ejecutar. Las filas que preguntan a la IA se rechazan al exportar, por nombre; desactívalas antes. Que sus alertas de Telegram o Discord te lleguen depende de la pregunta sobre credenciales al exportar.

Clicker automático

La pestaña Clicker hace clic, o pulsa una tecla, una y otra vez hasta que la detienes: en el cursor, en un punto fijo, o mediante una secuencia de puntos que grabas haciendo clic en ellos. No es una macro — nada de esto entra en el proyecto — pero todo lo de la pestaña se recuerda para la próxima vez.

Tres modos

La configuración

Grabar una secuencia

En Una secuencia de puntos, pulsa Grabar puntos y haz clic izquierdo en cada lugar por turno, en el propio programa. Cada clic añade una fila mientras lo ves. El clic que pulsa Detener — y cualquier otro clic en la ventana de Recorder — no se cuenta. Cada fila tiene entonces su propia espera, botón y tipo de clic, y Elegir mueve un punto en una pantalla congelada.

Formas de detenerlo

• El botón Detener, la tecla Detener clicker, la tecla Detener reproducción, o Esc mientras Recorder está en primer plano.
• Modo mantener pulsado: solo hace clic mientras se mantiene pulsada la tecla de inicio, y la tecla sigue llegando al programa que está bajo el puntero.
• Detener cuando el cursor toca la parte superior de la pantalla: empuja el ratón contra el borde superior y se detiene, en todos los modos — una salida que no necesita teclado.
• Detener si el ratón se mueve a mano: en el momento en que el puntero está en un lugar donde el clicker no lo puso.

El botón Iniciar espera un momento antes para que el ratón pueda salir de la ventana; la tecla rápida empieza de inmediato.

Qué incluye cada plan

El clicker en sí está en todos los planes: un clic o una tecla a un ritmo exacto, en el cursor o en un punto fijo, con el número, el límite de tiempo y todas las formas de detenerlo. Basic y Pro añaden Humanizado (el cursor se desplaza hasta cada clic y la duración de la pulsación varía), las dos variaciones aleatorias, la dispersión, las secuencias de puntos y el recuadro de deambulación. En Free esos controles aparecen en gris con un candado al lado, y lo que configures bajo un plan se conserva para cuando vuelva a estar cubierto.

El movimiento humanizado existe para que una ejecución se comporte como una mano sobre el ratón en aplicaciones normales. Recorder no hace nada para ocultarse de ningún programa.

Exportar como programa

Archivo → Exportar como programa… escribe un único .exe con la macro, sus recortes y el lector de texto con el que la ajustaste. No necesita instalador, ni entorno de ejecución, ni ninguna copia de Recorder.

• El diálogo de exportación ofrece una ventana de control: Ejecutar, Pausa y Detener con sus teclas, Repetir y Velocidad, y una línea de estado. Sin ella, el programa se ejecuta en cuanto se abre, no muestra nada y se cierra cuando la macro termina — correcto para algo que arranca un programador de tareas, incorrecto para una primera prueba. Marca la ventana para cualquier cosa que vayas a iniciar a mano: entonces un problema se muestra en un mensaje en lugar de pasar en silencio.
• Tus teclas de Ejecutar, Pausa y Detener viajan tal y como estaban asignadas en Configuración → Teclas rápidas en el momento de exportar, igual que las filas de vigilancia que están activadas y la configuración de repetición del teclado.
• Las macros que usan la IA (ask_ai, o read_text con engine="ai") se rechazan al exportar, señalando los pasos. Los dos lectores locales viajan dentro del archivo.
• Si la macro o una fila de vigilancia envía algo a Telegram o Discord y hay uno configurado, Recorder pregunta si quieres incluir esas credenciales; cualquiera que tenga el archivo puede leerlas. Sin ellas, los pasos de notificación y las alertas no envían nada. Telegram y Discord necesitan Basic o Pro: en Free no se hace la pregunta y los datos nunca viajan.

Detener un programa exportado

Tu tecla de Detener reproducción tal y como estaba asignada al exportar, F6 si no la has cambiado. Si has desactivado la tecla de detener, se usa F6 en su lugar, porque una macro que no se puede detener no se ejecuta.

Si otra aplicación ya tiene esa tecla, el programa la prueba con Ctrl+Shift y después con Ctrl+Alt, y dice cuál antes del primer paso. Si no consigue registrar ninguna, la macro no se ejecuta en absoluto y explica por qué.

Un programa exportado contiene todo lo que hay en la macro, incluido cualquier texto que hayas escrito. Comprueba que no haya contraseñas ni tokens antes de enviárselo a nadie. El archivo no está firmado digitalmente, así que SmartScreen puede avisar la primera vez que se ejecute.

Asistente de IA

Describe la macro que quieres y el asistente escribe el script. Nada llega a tu editor hasta que lo apruebas: lee la respuesta y luego pulsa Usar o Reemplazar. El compilador revisa cada respuesta; si no compila, el asistente hace un intento automático de reparación, que gasta un crédito.

Dos modos. Construir escribe la macro. Planificar pregunta sobre la tarea y no escribe nada hasta que pulsas Escribir la macro; empieza por ahí para cualquier cosa que pase de unos pocos pasos. Ctrl+Enter envía; Nuevo empieza una conversación nueva y borra el historial guardado.

Modelo y Razonamiento: deja ambos en Predeterminado. Intermedio y Máximo son modelos distintos, no mejores, y más razonamiento cuesta más por turno y rara vez cambia el script. Usar recuperación hace que la macro encuentre por sí sola el camino de vuelta tras un clic fallido en lugar de detenerse; Añadir pausas breves tras los clics introduce una breve pausa tras cada clic para que el siguiente paso no se adelante a la pantalla. Normalmente se dejan las dos activadas.

Cómo conseguir una buena respuesta

• Captura tus recortes primero. El asistente sabe qué nombres de recortes existen. Sin ninguno, solo puede escribir coordenadas.
• Cuenta cómo es la pantalla, no solo el objetivo. «Haz clic en Actualizar todo, espera a que la barra de estado diga Listo» funciona mejor que «actualiza la hoja de cálculo».
• Afina la conversación. «Espera al cuadro de diálogo Guardar en vez de una pausa fija» es una continuación normal.

Créditos

Los créditos los gasta todo lo que llega al servidor: los turnos del asistente (incluido el intento de reparación), los pasos ask_ai, las filas de vigilancia con IA, read_text con engine="ai", y cada paso de una ejecución del agente. Grabar, reproducir, las anclas de imagen, los dos lectores de texto locales y exportar nunca cuestan uno. Tu saldo se muestra junto al estado de la sesión, en el panel del asistente y en la página de tu cuenta; cada paso de IA anota su gasto en el registro de la ejecución. Los planes y los paquetes de créditos están en la página de precios.

Todo paso de IA en una macro (ask_ai, read_text con engine="ai", una fila de vigilancia con IA) gasta créditos, necesita una cuenta con la sesión iniciada y bloquea la exportación. Un programa exportado no tiene ninguna cuenta a la que cobrar.

Agente

La pestaña Agente es la tercera vista. Escribe un objetivo y la IA lo lleva a cabo en tu escritorio, paso a paso, comprobando la pantalla después de cada paso. Esto es uso del equipo, «computer use», en tu propio escritorio, con el ratón y el teclado reales. Va mejor en tareas cortas y visibles en una sola pantalla — abrir una página, rellenar un formulario, pasar por unas cuantas pantallas; un trabajo largo o poco habitual es mejor grabarlo como una macro. Obsérvalo las primeras veces.

Cada paso es una llamada a la IA, facturada en los mismos créditos que ask_ai — incluidos los pasos de una ejecución que no llega a terminar. El agente solo ve la pantalla; el texto que hay en ella nunca es una instrucción para él.

No es el asistente. El asistente escribe una macro que conservas y reproduces; el agente hace la tarea ahora y no deja nada detrás.

Ejecutar una tarea

1. Escribe el objetivo: abre la carpeta de descargas y ordénala por fecha. Guardar lo guarda en la lista Guardados; Eliminar quita uno.
2. Pulsa Iniciar o Ctrl+Enter. Recorder pregunta una vez por ejecución, ¿Dejar que el agente tome el control?, repitiendo el objetivo y lo que puede usar. No se pone en marcha sin un atajo de Detener reproducción asignado; consulta Reproducción.
3. Observa la línea temporal. Cada paso muestra lo que vio el agente, su veredicto sobre el paso anterior (sí, no o no está claro), qué está haciendo ahora y cuánto costó. El pie mantiene el total de la ejecución y tus créditos restantes.
4. Pulsa Detener, o tu atajo de Detener, en cualquier momento.

Una ejecución termina en Terminado, Atascado o Detenido, con sus créditos, sus pasos y el motivo: un paso que falló tres veces, cuarenta pasos sin terminar, el límite de créditos, o tu tecla de detener.

Cuando la tarea es una pregunta (dime en qué plan está la cuenta) la respuesta vuelve como un informe: un cuadro de mensaje, o el que tengas activado en Configuración → Notificaciones: de escritorio, Telegram o Discord.

Las opciones

Qué puede hacer

La línea debajo de las casillas dice qué puede usar el agente: ratón, teclado, tiempos, abrir y mensaje de forma predeterminada. Permisos abre Configuración → Agente, donde cada uno es una casilla bajo Puede:

Deja las dos últimas desactivadas. Una línea de comandos con tus permisos puede hacer cualquier cosa que tú puedas hacer, y el agente no sabe distinguir un comando seguro de uno destructivo.

Se detiene cuando fija los límites: pasos por ejecución, fallos de un mismo paso, y créditos por ejecución (0 para sin límite). Ritmo fija cuánto espera el agente a que la pantalla se asiente, entre pasos, y entre las acciones dentro de un mismo paso. Sube el último para una aplicación que no puede seguir el ritmo de clic y luego escribir.

Configuración

Haz clic en Configuración en la barra de menús. Siete pestañas: Teclas rápidas, Grabación, Teclado, Ventana, Notificaciones, Registro, y Agente. Aceptar aplica, Cancelar descarta, y Restaurar valores predeterminados reinicia todo excepto tus credenciales de Telegram y Discord.

Teclas rápidas

Las siete teclas rápidas globales son valores predeterminados, no fijos. Cada una se puede reasignar o desactivar aquí, y esta pestaña es el único lugar que muestra la configuración actual. Haz clic en un campo y pulsa la combinación; Esc la borra. Dos acciones no pueden compartir una tecla, y Recorder avisa si otra aplicación ya la tiene. Los valores predeterminados están en Reproducción.

Grabación y Teclado

Grabación contiene los interruptores de captura y la cuenta atrás de las pruebas. Teclado controla si una tecla mantenida se repite como en un teclado real: desactivado por defecto, con retraso, ritmo, una variación opcional, y Igualar con este PC para copiar tu configuración de Windows. El ajuste viaja con un programa exportado.

Ventana

Ocultar mientras se ejecuta, Usar todos los monitores, el tema oscuro y Tamaño del texto de 85% a 140%. Los dos últimos se aplican al momento.

Notificaciones

Desactivado por defecto. Una vez activado, Recorder puede avisarte cuando termina una grabación, cuando termina una reproducción y cuando se aborta una reproducción, por notificación de escritorio, Discord, Telegram, o cualquier combinación. Las notificaciones de escritorio están en todos los planes; Telegram y Discord necesitan Basic o Pro. En Free las dos casillas aparecen en gris con el motivo debajo, y un token o un webhook que introduzcas se guarda para cuando tu plan lo cubra. Vigilancia usa los mismos canales, con interruptores por fila. Calidad de imagen fija el tamaño de las capturas de pantalla adjuntas, de Muy baja a Sin pérdida.

Discord

Un solo campo: la URL del webhook.

1. Crea un webhook en Discord. Abre Configuración del servidor → Integraciones → Webhooks, elige Nuevo webhook, selecciona el canal, ponle un nombre y pulsa Copiar URL de webhook. Necesitas el permiso Administrar webhooks.
2. Pégalo en Recorder. Configuración → Notificaciones, marca Discord, pega la URL.
3. Envía una prueba. Debería aparecer un mensaje en el canal en cuestión de segundos.

La URL del webhook es una contraseña. Cualquiera que la tenga puede publicar en ese canal. Si se filtra, elimina el webhook en Discord y crea uno nuevo; exportar un programa que lo use lo pregunta antes.

Telegram

Necesitas un token de bot de BotFather y el id numérico del chat de la conversación. Los dos van en Configuración → Notificaciones.

La captura de pantalla periódica

Enviar una imagen de la pantalla mientras se vigila publica una captura de pantalla en Telegram y Discord cada N segundos, del área que elijas o de la pantalla entera. Solo funciona mientras Iniciar vigilancia está activo y nunca usa la notificación de escritorio.

Qué se envía

Los mensajes van directamente desde tu equipo a Discord o Telegram, nunca a través de nuestros servidores.

Registro de diagnóstico

Ver → Registro muestra lo que está haciendo una ejecución, y Configuración → Registro elige qué se anota. Activa primero Cada paso cuando una macro se comporta mal. Contenido de texto anota en texto plano los caracteres leídos de tu pantalla; desactívalo de nuevo en cuanto encuentres el problema.

Tu licencia

Un equipo a la vez

Para cambiar a otra máquina, cierra sesión en la antigua y luego inicia sesión en la nueva. Si el equipo antiguo ya no está, inicia sesión en el nuevo de todas formas: en cuanto el equipo antiguo lleve 30 días sin dar señales, el nuevo se queda con la plaza.

Trabajar sin conexión

Una conexión que se corta no detiene una ejecución; la barra muestra “Sesión iniciada (trabajando sin conexión)” y Recorder sigue funcionando. Solo se detiene después de llevar mucho tiempo sin conexión.

Funciones que tu plan no cubre

Seis cosas dependen del plan: las funciones de IA, la lectura de texto de la pantalla, la vigilancia de pantalla, la exportación como programa, las alertas de Telegram y Discord, y los extras del clicker automático (clics humanizados, variación aleatoria, dispersión, secuencias de puntos y el recuadro de deambulación). Un control que tu plan no cubre se pone en rojo, y al hacer clic explica por qué; las dos casillas de notificaciones y los controles extra del clicker aparecen en gris con un candado y el motivo al lado.

Los cambios surten efecto en aproximadamente media hora. El cuadro de Cuenta muestra tu plan y tu saldo de créditos.

Solución de problemas