NeoScript

NeoScript te permite escribir, grabar, guardar y ejecutar scripts en JavaScript que controlan NeoMath: montar ecuaciones, exportar a SVG, PNG o EPS, convertir carpetas enteras, reconocer ecuaciones de imágenes, abrir y guardar archivos, cambiar de pestaña, cambiar preferencias y disparar acciones de la interfaz. Todo por un objeto global ya listo, neo.

Para qué sirve#

• Repetir tareas: exportar decenas de ecuaciones, convertir una carpeta, estandarizar colores y estilos.
• Generar ecuaciones a partir de datos: una tabla de fórmulas, los términos de una serie, una lista de ejercicios.
• Grabar lo que haces en el editor y convertirlo en código (macros).
• Dejar que una IA escriba y ejecute scripts con el servidor MCP.

Reglas de oro#

1. Todas las funciones de neo son síncronas: el script espera a que cada una termine.
2. Los errores se vuelven excepciones comunes de JavaScript; try/catch funciona.
3. Sin disco y sin red de forma predeterminada. El script solo toca las carpetas que permitas.
4. Un script nunca se ejecuta solo: solo cuando tú lo mandas (botón, atajo o línea de comandos).
5. El botón Detener interrumpe el script al instante, incluso en un bucle infinito.

Primer script#

neo.equacao.limpar();
neo.inserir("\\frac{a}{b}");
neo.digitar("+1");
console.log(neo.equacao.latex());

La ecuación aparece en el editor y \frac{a}{b}+1 aparece en la pestaña Salida.

La pantalla de NeoScript#

• Izquierda: la lista de scripts. El punto marca el script activo (el que ejecuta el botón rápido). Arriba: nuevo, duplicar, mover y borrar.
• Derecha, arriba: el editor de código con colores, números de línea, nombre, atajo, Guardar, Formatear, Grabar macro y Ejecutar (pasa a Detener).
• Derecha, abajo: Salida (lo que escribe el script, avisos y errores con la línea) y Permisos (carpetas permitidas).
• Documentación (F1): abre el manual en el navegador, en PDF o copia todo para una IA.

Formatear es conservador: sangra con dos espacios y organiza espacios y llaves, pero nunca cambia las comillas, nunca reordena y no toca nada si hay paréntesis o llaves desemparejados.

Dónde se guardan los scripts#

Cada script es un archivo Nombre.neoscript.js. El orden, los atajos, el script activo y las carpetas permitidas están en indice.json. Puedes versionar o editar los archivos por fuera.

Grabador de macros#

neo.digitar("x+1");
neo.inserir("m:fracao");
neo.digitar("a");
neo.tecla("direita");
neo.digitar("b");

Los clics del ratón en la ecuación y lo que ocurre dentro de los diálogos del sistema no se graban.

Botón rápido y atajos#

Junto al botón de OCR está el botón de NeoScript: el clic ejecuta el script activo (y pasa a Detener mientras corre); la flecha abre la lista de scripts, Grabar macro y Administrar scripts….

Cada script puede tener un atajo: F6 a F12 o Ctrl+Shift con una de las letras J K L M Q R T U. Un script nunca se dispara con un atajo que el perfil de NeoMath ya usa.

Seguridad y permisos#

El script corre aislado, sin require, import, fetch, process ni acceso directo al disco.

• En la pestaña Permisos, permite una carpeta cada vez, solo lectura o lectura y escritura.
• .., rutas relativas y enlaces simbólicos no saltan la barrera: la ruta se resuelve hasta el destino real antes de cada acceso.
• neo.acao no dispara sair, diálogos ni las acciones del propio NeoScript.

Superar el tiempo límite termina el script y no se puede sortear con try/catch. La salida se limita a 1 MB por ejecución.

Próximos pasos#