Kodekommentarer og docstrings: Hvordan oversætter man kun kommentarerne uden at ændre koden?

Diagnose af nuværende kernesituation

Hvis man lægger kildekodefiler direkte i oversættelsesværktøjet, bliver ofte både variabelnavne og logiske nøgleord (if/for) oversat, hvilket ødelægger koden.

Analyse af grundlæggende årsag

1

AST (abstrakt syntakstræ)-baseret genkendelse

Shanyi AI bruger ikke kun regulære udtryk, men kan også udføre letvægts syntaktisk analyse. For Python kan den præcist genkende docstrings omsluttet af `'''...'''`. For Java/JS kan den genkende `/**...*/`-blokke.

2

Bevarelse af instruktioner

Inde i kommentarblokke bevarer systemet kun instruktionens hoved for specifikke instruktioner som `@param`, `@return`, `@author` og oversætter kun den beskrivende tekst bagefter, for at sikre korrekt format ved generering af API-dokumentation (f.eks. Javadoc, Sphinx).

Endelig løsningssammenfatning

Hjælper open source-projekter med hurtigt at generere flersprogede dokumentationer, og gør det lettere for udviklere over hele verden at bidrage.