Комментарии и документационные строки (Docstrings): как переводить только комментарии, не затрагивая сам код?
“Если просто загрузить исходный файл кода в переводчик, часто переводятся даже имена переменных и управляющие ключевые слова (if/for), что приводит к поломке кода.”
Анализ первопричин
Распознавание на уровне AST (абстрактного синтаксического дерева)
商译 AI не ограничивается регулярными выражениями, а дополнительно выполняет лёгкий синтаксический анализ. Для Python система может точно распознавать докстринги, заключённые в `'''...'''`; Для Java/JS инструмент распознаёт блоки `/**...*/`.
Сохранение директивы
Внутри блока комментариев для специальных директив, таких как `@param`, `@return`, `@author` и других, система сохраняет заголовок директивы, переводя только описательную часть, чтобы обеспечить корректный формат при генерации API-документации (например, Javadoc, Sphinx).
Итоговое резюме решения
Помогает open-source проектам быстро создавать многоязычную документацию и снижает барьер входа для разработчиков по всему миру.