Kodkommentarer och docstrings: Hur översätter man bara kommentarerna utan att röra själva koden?

Diagnostik av aktuell status

Om du placerar källkodsfiler direkt i en översättare översätts ofta även variabelnamn och logiska nyckelord (if/for), vilket resulterar i att koden blir obrukbar.

Grundorsaksanalys

1

AST (Abstrakt syntaxträd)-baserad igenkänning

Shangyi AI bygger inte bara på reguljära uttryck, utan kan även genomföra lättviktig syntaxanalys. För Python kan verktyget exakt identifiera docstrings som omsluts av `'''...'''`. För Java/JS kan den känna igen `/**...*/`-block.

2

Bevarar direktiv

I kommentarsblock bevarar systemet direktivhuvuden för specifika instruktioner såsom `@param`, `@return`, `@author` och översätter endast den beskrivande texten efter dessa, vilket säkerställer att API-dokumentation (t.ex. Javadoc, Sphinx) får rätt format.

Sammanfattning av slutgiltig lösning

Hjälper open source-projekt att snabbt skapa flerspråkig dokumentation och sänker tröskeln för globala utvecklares bidrag.