NeoScript

O NeoScript deixa você escrever, gravar, guardar e rodar scripts em JavaScript que controlam o NeoMath: montar equações, exportar em SVG, PNG ou EPS, converter pastas inteiras, reconhecer equações de imagens, abrir e salvar arquivos, trocar de aba, mudar preferências e disparar ações da interface. Tudo isso por um objeto global pronto, o neo.

Para que serve#

• Repetir tarefas: exportar dezenas de equações, converter uma pasta, padronizar cores e estilos.
• Gerar equações a partir de dados: uma tabela de fórmulas, os termos de uma série, uma lista de exercícios.
• Gravar o que você faz no editor e transformar em código (macros).
• Deixar uma IA escrever e rodar scripts com o servidor MCP.

Regras de ouro#

1. Todas as funções do neo são síncronas: o script espera cada uma terminar.
2. Erros viram exceções JavaScript comuns; try/catch funciona.
3. Sem disco e sem rede por padrão. O script só toca nas pastas que você liberar.
4. Um script nunca roda sozinho: só quando você manda (botão, atalho ou linha de comando).
5. O botão Parar interrompe o script na hora, mesmo num laço infinito.

Primeiro script#

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

A equação aparece no editor e \frac{a}{b}+1 aparece na aba Saída.

A tela do NeoScript#

• Esquerda: a lista de scripts. A bolinha marca o script ativo (o que o botão rápido roda). Acima: novo, duplicar, mover e apagar.
• Direita, em cima: o editor de código com cores, números de linha, nome, atalho, Salvar, Formatar, Gravar macro e Rodar (vira Parar).
• Direita, embaixo: Saída (o que o script escreve, avisos e erros com a linha) e Permissões (pastas liberadas).
• Documentação (F1): abre a apostila no navegador, em PDF ou copia tudo para uma IA.

Formatar é conservador: recua com dois espaços e organiza espaços e chaves, mas nunca troca aspas, nunca reordena e não mexe em nada se houver parênteses ou chaves desencontrados.

Onde os scripts ficam#

Cada script é um arquivo Nome.neoscript.js. A ordem, os atalhos, o script ativo e as pastas liberadas ficam em indice.json. Dá para versionar ou editar os arquivos por fora.

Gravador de macros#

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

Cliques do mouse na equação e o que acontece dentro de caixas de diálogo do sistema não são gravados.

Botão rápido e atalhos#

Ao lado do botão de OCR fica o botão do NeoScript: o clique roda o script ativo (e vira Parar enquanto roda); a seta abre a lista de scripts, Gravar macro e Gerenciar scripts….

Cada script pode ter um atalho: F6 a F12 ou Ctrl+Shift com uma das letras J K L M Q R T U. Um script nunca dispara num atalho que o perfil do NeoMath já usa.

Segurança e permissões#

O script roda isolado, sem require, import, fetch, process nem acesso direto ao disco.

• Na aba Permissões, libere uma pasta por vez, somente leitura ou leitura e escrita.
• .., caminhos relativos e links simbólicos não furam a barreira: o caminho é resolvido até o destino real antes de cada acesso.
• neo.acao não dispara sair, diálogos nem as ações do próprio NeoScript.

Estourar o tempo termina o script e não pode ser contornado com try/catch. A saída é limitada a 1 MB por execução.

Próximos passos#