Коментари в кода и документационни низове (Docstrings): Как да се превеждат само коментарите, без да се променя кодът?
“Когато директно поставите изходни файлове в преводача, често дори имената на променливите и ключовите думи (като if/for) се превеждат, което прави кода неизползваем.”
Анализ на основната причина
AST (Абстрактно синтактично дърво) разпознаване
Shangyi AI не разчита само на регулярни изрази – то може да извършва и лек синтактичен анализ. За Python той може прецизно да разпознава документационни низове, оградени с `'''...'''`; За Java/JS системата разпознава блокове от тип `/**...*/`.
Запазване на инструкциите
В рамките на коментарните блокове, при специфични инструкции като `@param`, `@return`, `@author` и други, системата запазва заглавната част на инструкцията и превежда само описателния текст след нея, за да гарантира правилен формат при генериране на API документация (например Javadoc или Sphinx).
Обобщение на крайното решение
Съдейства за бързото създаване на многоезична документация в отворени проекти, намалявайки прага за принос на разработчици от цял свят.