Komentar Kode dan Docstring: Bagaimana Menerjemahkan Hanya Komentar Tanpa Mengubah Kode?

Diagnosis Kondisi Inti

Jika file source code langsung dimasukkan ke penerjemah, nama variabel dan kata kunci logika (if/for) sering ikut diterjemahkan, sehingga kode menjadi tidak dapat digunakan.

Analisis Akar Penyebab

1

Pengenalan pada Tingkat AST (Abstract Syntax Tree)

AI Shangyi tidak hanya berbasis pencocokan regex, tapi juga dapat melakukan analisis sintaksis ringan. Untuk Python, AI ini dapat secara akurat mengenali Docstring yang dibungkus dengan `'''...'''`; Untuk Java/JS, sistem dapat mengenali blok `/**...*/`.

2

Instruksi dipertahankan

Di dalam blok komentar, untuk instruksi khusus seperti `@param`, `@return`, `@author`, sistem hanya mempertahankan kepala instruksi dan menerjemahkan teks deskripsi setelahnya, memastikan format dokumentasi API (seperti Javadoc, Sphinx) tetap benar.

Ringkasan Solusi Akhir

Membantu proyek open source menghasilkan dokumentasi multibahasa dengan cepat, menurunkan hambatan kontribusi bagi pengembang global.