Comentarios de código y docstrings: ¿Cómo traducir únicamente los comentarios sin modificar el código?
“Si se introduce un archivo de código fuente directamente en el traductor, a menudo se traducen también los nombres de las variables y las palabras clave lógicas (if/for), lo que provoca que el código quede inutilizable.”
Análisis de la causa raíz
Reconocimiento a nivel de AST (Árbol de Sintaxis Abstracta)
La IA de Shangyi no solo utiliza coincidencia por expresiones regulares, sino que también realiza un análisis sintáctico ligero. Para Python, es capaz de identificar con precisión los docstrings delimitados por `'''...'''`; Para Java/JS, es capaz de identificar bloques `/**...*/`.
Directiva conservada
Dentro de los bloques de comentarios, para directivas específicas como `@param`, `@return`, `@author`, etc., el sistema conservará el encabezado de la directiva y únicamente traducirá el texto descriptivo posterior, asegurando que el formato para la generación de documentación API (como Javadoc, Sphinx) sea correcto.
Resumen de la solución definitiva
Facilita que los proyectos de código abierto generen documentación multilingüe de forma rápida, reduciendo la barrera de entrada para desarrolladores de todo el mundo.