Commenti del codice e docstring: come tradurre solo i commenti senza modificare il codice?
“Inserendo direttamente il file sorgente nel traduttore, spesso vengono tradotti anche i nomi delle variabili e le parole chiave logiche (if/for), rendendo così il codice inutilizzabile.”
Analisi delle cause principali
Riconoscimento a livello di AST (Abstract Syntax Tree)
L'AI Shāngyì non si limita al matching tramite regex, ma è in grado di eseguire anche analisi sintattiche leggere. Per Python, può identificare con precisione i docstring racchiusi tra `'''...'''`; Per Java/JS, è in grado di riconoscere i blocchi `/**...*/`.
Istruzione mantenuta
All'interno dei blocchi di commento, per direttive specifiche come `@param`, `@return`, `@author` ecc., il sistema manterrà la sola intestazione della direttiva, traducendo esclusivamente il testo descrittivo seguente, garantendo così il corretto formato della documentazione API (ad esempio Javadoc, Sphinx).
Riepilogo soluzione finale
Supporta i progetti open source nella generazione rapida di documentazione multilingue, riducendo la barriera di accesso per gli sviluppatori a livello globale.