AlertaScript

Linguagem de script de gráficos independente para AlertaChart

Visão Geral da Linguagem

Manual de Referência do AlertaScript

AlertaScript é a nossa própria camada de linguagem de script para análise de gráficos e desenvolvimento de estratégias no AlertaChart. É desenvolvida e mantida pela nossa equipa, executa no nosso runtime e está documentada como uma interface de produto de primeira classe. Esta página descreve o que é o AlertaScript, como executa, como é tratada a compatibilidade e que suporte de referência existe atualmente na plataforma.

O Que É o AlertaScript

AlertaScript é um ambiente de script de gráficos independente, projetado para análise técnica, sobreposições visuais e fluxos de trabalho orientados a estratégia. Os utilizadores podem escrever lógica de script que opera sobre dados do gráfico, produzir saídas visuais e definir regras que podem ser analisadas num contexto de runtime consistente.

Do ponto de vista do produto, o AlertaScript não é um wrapper fino em torno de um backend de execução externo. O parser, o comportamento de runtime, o tratamento de estado e a geração de comandos do gráfico são controlados dentro da base de código do AlertaChart.

Princípios de Design

A linguagem é construída em torno de quatro princípios: legibilidade para autores de scripts, semântica de runtime estável, documentação transparente e crescimento consciente da compatibilidade.

Outro princípio fundamental é a segurança operacional. Priorizamos a execução limitada e verificações robustas de runtime para que os scripts permaneçam utilizáveis em escala.

Modelo de Execução

O AlertaScript executa num runtime centrado em gráficos que foca em processamento determinístico de barras, comportamento confiável de séries e transições de estado claras.

A linguagem suporta análise no estilo de indicadores, instruções de saída visual e comportamentos relacionados a estratégias através de built-ins documentados e expectativas de argumentos tipados.

Compatibilidade com Pine

O AlertaScript inclui áreas de superfície compatíveis com Pine onde aplicável, com mapeamento explícito e classificação de paridade.

Em resumo: apoiamos a compatibilidade como um objetivo de produto, preservando uma identidade independente de linguagem/runtime. A compatibilidade com Pine é fornecida numa base versionada para sintaxe e superfícies invocáveis suportadas; não implica equivalência um-para-um para todas as funções/comportamentos.

Para facilitar a migração de scripts Pine mais antigos, também são suportados input(defval, title=..., type=...), iff(), tr como variável de série e aliases de estilo de plot sem namespace, como histogram/cross. Para novo código AlertaScript, são preferidos input.bool/input.int, expressões ternárias e style.histogram/style.cross.

AlertaScript é uma linguagem e runtime independentes. O termo compatibilidade Pine é fornecido como uma camada de referência para ajudar os utilizadores a fazer a transição com nomes de funções familiares, padrões de sintaxe e fluxos de trabalho de indicadores assistidos por IA. Não significa equivalência um-para-um com Pine em todos os cenários. Como o AlertaScript é um sistema novo e em ativa evolução, a validação final para casos avançados ou extremos deve sempre basear-se na documentação de referência AlertaScript mais recente.

Suporte de Referência

O nosso catálogo de referência é versionado e estruturado para que os autores de scripts possam descobrir rapidamente o que é atualmente suportado.

A pesquisa de referência no editor permanece disponível para assinaturas e exemplos exatos. Esta página de manual complementa isso ao explicar a superfície da linguagem em formato narrativo longo.

Escopo e Segurança

Este manual descreve intencionalmente capacidades, princípios de comportamento e escopo de suporte num nível elevado de sinal-ruído. Não expomos detalhes internos de implementação que não estejam relacionados com os resultados de autoria de scripts.

À medida que o AlertaScript evolui, esta página continuará a descrever a direção da linguagem e o envelope de suporte, enquanto as referências invocáveis detalhadas permanecem vinculadas ao inventário de documentação versionado.

Links Rápidos

No ecrã do gráfico, abra o menu ƒχ na barra superior e, em seguida, use Docs (Cmd+K) dentro do Editor de Scripts para acesso rápido a esta superfície de referência.

Abrir Ecrã do Gráfico (ƒχ)