コードコメントおよびドキュメント文字列（Docstrings）：コメントのみを翻訳し、コード本体は変更しない方法とは？

現状の主要診断

“ソースコードファイルをそのまま翻訳ツールに投入すると、変数名や論理キーワード（if/for）まで翻訳され、コードが動作しなくなる場合があります。”

根本原因の分析

商译 AI は正規表現によるマッチングだけでなく、軽量な構文解析も可能です。Pythonの場合、`'''...'''` で囲まれた Docstrings を正確に認識できます。Java/JS に対しては、`/**...*/` ブロックを識別できます。

コメントブロック内部では、`@param`、`@return`、`@author` などの特定ディレクティブに対し、システムはディレクティブヘッダを保持し、その後の説明文のみを翻訳することで、API ドキュメント（Javadoc、Sphinx など）生成時の書式を正しく維持します。

オープンソースプロジェクトの多言語ドキュメントを迅速に生成し、世界中の開発者による貢献のハードルを下げます。