Solución de problemas

Instalación#

Windows muestra “editor desconocido”#

Mientras el instalador no esté firmado con el certificado definitivo, SmartScreen avisa en la primera ejecución. Si descargaste el archivo desde el enlace del correo de la compra, elige Más información › Ejecutar de todos modos.

El Gatekeeper de macOS bloquea la aplicación#

Abre Ajustes del Sistema › Privacidad y seguridad y elige Abrir de todos modos.

NeoMath no es el programa predeterminado de los archivos .eps#

Windows no permite que un programa se declare predeterminado de un tipo que ya tiene dueño. Usa Configuración › Aplicaciones predeterminadas de Windows, que el instalador abre ya en el producto, o haz clic con el botón derecho en un EPS y elige Abrir con.

Licencia y actualizaciones#

La clave de licencia no se acepta#

Comprueba que se pegó completa, sin espacios, que la licencia está activa y que incluye el programa que estás abriendo. Mira Activar la licencia.

La versión nueva no se instala sola en Linux o macOS#

En estos sistemas el programa solo avisa que hay una versión nueva; instala el paquete nuevo desde el enlace del correo.

Ecuaciones y archivos#

El archivo se abre, pero sin las fuentes y tamaños originales#

Si otro programa modificó el archivo, NeoMath puede abrir la ecuación sin el estilo original. Rehaz el archivo a partir del original o aplica el estilo de nuevo.

El estilo por lotes ignoró archivos#

El informe dice el motivo de cada uno: sem_dados (PNG o SVG sin los datos de NeoMath), de_terceiros (EPS de otro programa), somente_leitura o mudou_durante_a_execucao. Nada se modifica en silencio. Mira Estilo en lote.

Una fuente del estilo no existe en el equipo#

NeoMath usa la fuente instalada y recurre a las fuentes de reserva (Liberation y STIX Two Math). La preferencia acepta fuentes que faltan, con aviso. Instala la fuente para que el dibujo salga como en el original.

La construcción LaTeX no está admitida#

NeoMath avisa que no admite la construcción, y dice cuál (en la API, código 422). Reescríbela con el comando equivalente de la lista de Comandos LaTeX admitidos.

Word#

El PNG no se reabre con el estilo original#

El PNG insertado en Word puede perder el estilo al reabrirse. Prefiere Imagen SVG o Ecuación de Word.

Los atajos de envío no funcionan#

Exigen Word abierto, en Windows. Comprueba en el perfil de atajos que Ctrl+Enter, Ctrl+Shift+Enter y Ctrl+Shift+W no se hayan desactivado en atalhos.json.

El complemento no recupera el código de la ecuación#

Eso exige Word con la API WordApi 1.4. Sin ella, el panel lee la ecuación por el OMML y pierde macros y \ce{}.

InDesign#

“Documento no guardado”#

Guarda el documento antes de insertar ecuaciones.

No se conecta a NeoMath#

Deja activada la API local (NeoMath --servidor, o la opción del instalador) y usa Leer del servidor.json en el panel. Si cambió el puerto, compruébalo en el servidor.json. Mira Adobe InDesign.

InDesign no escribe los archivos#

Comprueba que tienes permiso de escritura en la carpeta elegida. El mensaje muestra la ruta intentada.

Atajos y OCR#

Ctrl+Shift+A abre la búsqueda de pestañas del navegador#

Eso ocurre en el navegador. En la aplicación, el atajo de OCR se registra en el sistema (Windows) y funciona con cualquier programa al frente. Si otro programa ya usa la combinación, la barra de estado avisa; cambia el atajo.

Mi atajo personalizado no funciona#

El atalhos.json se lee una vez por ejecución. Vuelve a abrir la aplicación. Las combinaciones no válidas, las acciones desconocidas y los conflictos se ignoran, y los avisos aparecen en la ventana de ayuda de atajos. Recuerda que el atajo de NeoScript nunca se dispara con una combinación que el perfil ya usa.

El OCR no reconoce bien la ecuación#

Selecciona solo la ecuación, con un margen pequeño y en buena resolución. Mira NeoCR para cambiar de proveedor.

API local y MCP#

Respuesta	Causa	Qué hacer
401	sin token o token incorrecto	lee el token del servidor.json y envíalo en Authorization: Bearer
403	origen de navegador no autorizado o carpeta fuera de la raíz	pasa --origem URL o ajusta --raiz
413	cuerpo mayor que 16 MB	divide la petición (64 MB solo en /v1/lote-zip)
421	Host distinto de 127.0.0.1 o localhost	usa una de esas direcciones
422	construcción no admitida o imagen sin ecuación	mira el mensaje de error
501	ruta que solo existe en la aplicación	usa NeoMath --servidor

reading outside the allowed folders is blocked (MCP)#

La ruta está fuera de NEOMATH_MCP_ROOTS. Incluye la carpeta en la variable del cliente MCP (separada por ; en Windows y : en los demás).

El MCP se niega a sobrescribir#

Por seguridad, no se sobrescribe nada sin overwrite: true; un lote omite los archivos que ya existen.

NeoScript#

“sin permiso”#

La carpeta no está permitida para el script. En Permisos, permite la carpeta (solo lectura o lectura y escritura). En la línea de comandos, usa --permitir.

El script no termina#

Detener interrumpe el script incluso en un bucle infinito. Superar el tiempo límite también lo termina, y eso no se puede sortear con try/catch.

import, fetch o require no existen#

El script está aislado a propósito. Usa las funciones del objeto neo y, para datos externos, neo.arquivo.ler.

¿Todavía necesitas ayuda?#

Habla con nuestro equipo y cuéntanos la versión del producto, el sistema operativo y el mensaje exacto que aparece.