Penjelasan Komen Kod dan Docstrings: Bagaimana Menterjemah Komen Sahaja Tanpa Mengubah Kod?
“Jika fail kod sumber dimasukkan terus ke dalam penterjemah, kebiasaannya nama pemboleh ubah dan kata kunci logik (if/for) turut diterjemahkan, menyebabkan kod gagal berfungsi.”
Analisis Punca Akar
Pengecaman Peringkat AST (Abstrak Pokok Sintaks)
AI Shangyi bukan sekadar padanan regex, malah boleh menjalankan analisis sintaks ringan. Bagi Python, ia dapat mengenal pasti secara tepat Docstrings yang dibalut oleh `'''...'''`; Bagi Java/JS, sistem mampu mengenal pasti blok `/**...*/`.
Arahan dikekalkan
Di dalam blok komen, untuk arahan tertentu seperti `@param`, `@return`, `@author` dan lain-lain, sistem akan mengekalkan pengepala arahan dan hanya menterjemah teks deskriptif selepasnya, memastikan format dokumentasi API (seperti Javadoc, Sphinx) adalah tepat.
Ringkasan Penyelesaian Akhir
Membantu projek sumber terbuka menjana dokumentasi berbilang bahasa dengan pantas, seterusnya mengurangkan halangan penyertaan pembangun global.