Kodekommentarer og dokumentasjonsstrenger (docstrings): Hvordan oversette kun kommentarer uten å endre koden?

Diagnose av kjernesituasjon

Dersom man legger kildekodefiler direkte inn i en oversetter, blir ofte både variabelnavn og logiske nøkkelord (if/for) oversatt, noe som kan gjøre koden ubrukelig.

Analyse av grunnleggende årsak

1

AST (abstrakt syntaktre)-basert gjenkjenning

Shanyi AI bruker ikke bare regulære uttrykk, men utfører også lettvekts syntaksanalyse. For Python kan den nøyaktig identifisere docstrings omsluttet av `'''...'''`. For Java/JS kan den identifisere `/**...*/`-blokker.

2

Bevaring av instruksjoner

I kommentarfeltet, for spesifikke instruksjoner som `@param`, `@return`, `@author` vil systemet beholde instruksjonshodet og kun oversette den beskrivende teksten etterpå, for å sikre korrekt format ved generering av API-dokumentasjon (som Javadoc, Sphinx).

Oppsummering av endelig løsning

Bidrar til at åpne kildekodeprosjekter raskt kan generere flerspråklig dokumentasjon og senker terskelen for bidrag fra utviklere globalt.