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 서버로 제공됩니다.
• 결정론적 검토: 번역의 최신성과 링크 유효성을 검증할 수 있는 도구를 포함합니다.