Azure/co-op-translator

何を解決するか

Co-op Translator は、大規模な多言語 GitHub ドキュメントリポジトリの同期を困難にしている問題に対処します。ソースコンテンツの変更時に翻訳が古くなりがちな状況を防ぎ、相対リンク、Jupyter ノートブック、画像内のテキストを含む複雑な構造が、異なる言語バージョン間で完全に保持され、正常に機能することを保証します。

動作方法

このツールは、言語スコープのメタデータとソースハッシュを使用して、翻訳をバージョン管理されたソフトウェアアーティファクトとして扱います。変更のないコンテンツはスキップすることで、コストと時間を節約します。コンテンツは4段階のパイプラインで処理されます：

1. 計画：リポジトリをスキャンして、新規または古くなったコンテンツを検出します。
2. 翻訳：Azure OpenAI や OpenAI などのプロバイダーを使用して、Markdown、ノートブックのセル、および Azure AI Vision を通じた画像内のテキストを翻訳します。
3. 保持：コードブロックと URL の宛先を保護しつつ、相対パスを翻訳されたフォルダ構造に合わせて再書き込みします。
4. 追跡：メタデータを保存することで、インクリメンタルな更新と構造的レビューを可能にします。

対象ユーザー

プロセス、コードサンプル、インタラクティブなノートブックを含む多言語リポジトリを管理するオープンソースプロジェクトのメンテナーや技術文書の作成者向けに設計されています。

特徴

• インクリメンタル更新：ソースハッシュに基づいて、変更されたコンテンツのみを翻訳します。
• マルチフォーマット対応：Markdown、Jupyter ノートブック、画像内のテキストを処理できます。
• 構造的整合性：相対リンクを自動的に再書き込みし、コードブロックがAIモデルによって変更されないように保護します。
• 使いやすいインターフェース：CLI、Python API、GitHub Actions、コンテナ、およびエージェントワークフロー用のMCPサーバーとして利用可能。
• 決定論的レビュー：翻訳の新鮮さとリンクの有効性を検証するツールを備えています。