Codekommentare und Docstrings: Wie übersetzt man nur Kommentare, ohne den Code zu verändern?
“Wird eine Quellcodedatei direkt in den Übersetzer geladen, werden häufig sogar Variablennamen und logische Schlüsselwörter (if/for) übersetzt, wodurch der Code unbrauchbar wird.”
Ursachenanalyse
AST (Abstrakter Syntaxbaum)-basierte Erkennung
Shangyi AI setzt nicht nur auf Regex-Matching, sondern ermöglicht auch eine leichte syntaktische Analyse. Für Python kann das Tool Docstrings, die mit `'''...'''` umschlossen sind, präzise erkennen; Für Java/JS kann das System `/**...*/`-Blöcke erkennen.
Direktiven werden beibehalten
Innerhalb von Kommentarblöcken behält das System bei bestimmten Direktiven wie `@param`, `@return`, `@author` usw. den Direktivenkopf bei und übersetzt nur den beschreibenden Text dahinter, um sicherzustellen, dass beim Generieren von API-Dokumentationen (z. B. Javadoc, Sphinx) das korrekte Format erhalten bleibt.
Zusammenfassung der finalen Lösung
Unterstützt Open-Source-Projekte dabei, mehrsprachige Dokumentationen schnell zu erstellen und senkt die Einstiegshürden für Entwickler weltweit.