“Ao inserir diretamente o ficheiro de código-fonte no tradutor, frequentemente até os nomes de variáveis e palavras-chave lógicas (if/for) acabam por ser traduzidos, o que pode inutilizar o código.”

Análise da causa raiz

Reconhecimento ao nível da AST (Árvore de Sintaxe Abstrata)

A AI da Shangyi não se limita à correspondência por expressões regulares, conseguindo também realizar uma análise sintática leve. Para Python, consegue identificar com precisão as docstrings delimitadas por `'''...'''`; Para Java/JS, consegue identificar blocos `/**...*/`.

Preservação de instruções

No interior de blocos de comentários, para diretivas específicas como `@param`, `@return`, `@author`, o sistema preserva o cabeçalho da diretiva e traduz apenas o texto descritivo subsequente, assegurando a formatação correta na geração de documentação de API (como Javadoc, Sphinx).

Resumo da solução final

Ajuda projetos open-source a gerar rapidamente documentação multilingue, reduzindo a barreira de entrada para programadores de todo o mundo.