ADDT 기술 문서
ADDT 플러그인의 기술 구현 및 향후 계획에 대해 자세히 알아보기
목차
프로젝트 개요
ADDT(Dev Docus Translation for Apple) 플러그인은 개발자들의 Apple 공식 문서 읽기 요구에서 탄생했습니다. Apple은 풍부한 개발 문서를 제공하지만, 이러한 문서들은 주로 영어로 제공되어 비영어권 개발자들에게 이해의 장벽이 되고 있습니다. ADDT는 브라우저 플러그인 형태로 전 세계 개발자들에게 실시간으로 정확한 Apple 개발 문서 번역 서비스를 제공하여 Apple 기술을 더 효율적으로 학습하고 사용할 수 있도록 돕는 것을 목표로 합니다. 이 프로젝트는 2024년 말에 시작되어 여러 차례 개선을 거쳐 현재는 많은 개발자의 워크플로우에서 필수적인 도구가 되었습니다.
기술 구현
ADDT 플러그인의 핵심 기술 구현 원리 이해하기
문서 분석 및 처리
ADDT 플러그인은 요청 가로채기 데코레이터 패턴을 채택하여 페이지 데이터 내용과 문서 데이터 구조를 충분히 분석한 후 사전을 정확히 매칭하여 문서 내용에 AI 번역을 적용합니다. 브라우저가 제공하는 WebExtension API를 최대한 활용하여 콘텐츠 스크립트 주입, 백그라운드 처리, 메시지 전달 등의 핵심 기능을 구현했습니다. 이 과정에서 페이지 요소의 내용을 변경하지 않고 Apple의 기존 데이터 렌더링 방식을 완전히 따라 표시함으로써 페이지의 순수성과 스타일의 일관성, 아름다움을 보장합니다.
번역 엔진
여러 언어를 지원하기 위해 다른 자연 언어에 따라 다른 대규모 언어 모델을 사용합니다. 일본어, 중국어, 번체 중국어는 QWen2.5-14B, QWen2.5-32B, Grok-2를 사용하며, 인간 검토 및 검증 시스템을 포함합니다. 한국어는 현재의 모든 대규모 모델에서 번역 효과가 만족스럽지 않아 더 비싼 Grok-2를 사용하고 광범위한 수동 수정을 수행합니다. 향후 스페인어, 독일어, 프랑스어 등의 서양 언어에 대해서는 Grok-2와 GPT-3.5를 사용하여 번역 품질을 보장할 예정입니다. 기술 문서의 특성에 맞게 번역 엔진을 최적화하여 특히 프로그래밍 용어, API 이름, 기술 개념 처리에 중점을 두었습니다. 시스템은 전문 용어 데이터베이스를 유지하여 기술 용어의 번역이 정확하고 일관되게 유지되도록 합니다. 또한 컨텍스트 인식 번역을 구현하여 번역 결과가 기술 문서의 맥락에 적합하도록 했습니다. 모델에 대한 미세 조정도 수행하여 번역의 정확성을 보장했습니다.
성능 최적화 및 캐싱
원활한 사용자 경험을 제공하기 위해 ADDT 플러그인은 Cloudflare의 KV를 인증에, R2를 번역 사전 저장에 사용합니다. Cloudflare의 글로벌 엣지 네트워크 캐싱 메커니즘에 의존하여 사용자가 동일한 페이지를 다시 방문할 때 플러그인이 가장 가까운 위치에서 즉시 번역 결과를 제공할 수 있습니다. 또한 플러그인은 비동기 처리 모드를 채택하여 번역 프로세스가 페이지의 정상적인 로딩과 상호작용을 차단하지 않도록 했습니다.
기술 스택
ADDT 플러그인 뒤에 있는 핵심 기술 탐색
Plasmo
ADDT 플러그인은 Plasmo 프레임워크로 개발되었으며, 이는 컴포넌트 기반 개발 모델과 풍부한 API를 제공하여 확장 프로그램 개발 프로세스를 단순화하고 브라우저 간 호환성을 보장합니다.
Cloudflare
Cloudflare는 우수한 글로벌 CDN 제공업체로, ADDT 플러그인에 고속 번역 결과 캐싱 서비스를 제공합니다.
TypeScript + HeroUI
TypeScript는 우수한 타입 시스템으로, ADDT 플러그인의 빠른 개발에 필수적인 견고성을 제공합니다. HeroUI는 우수한 UI 컴포넌트 라이브러리로, ADDT 플러그인에 아름다운 UI 디자인을 제공합니다.
Paddle
Paddle은 우수한 결제 플랫폼으로, ADDT 플러그인에 안전한 결제 서비스를 제공합니다.
향후 계획
ADDT 플러그인의 개발 로드맵 및 향후 기능 탐색
문서 범위 확장
번역 문서의 범위를 확장하여 UIKit, AppKit, Core Data, Metal 등의 프레임워크를 포함한 더 많은 Apple 플랫폼 기술 문서를 지원할 계획입니다. 특히 visionOS 및 Apple Vision Pro 개발을 위한 새로운 문서에 대해 우선적으로 번역 지원을 제공하여 개발자가 이러한 최첨단 기술을 빠르게 습득할 수 있도록 도울 것입니다. 또한 WWDC 비디오 자막 번역 기능도 추가하여 개발자가 Apple 기술을 더 포괄적으로 학습할 수 있도록 할 예정입니다.
번역 품질 향상
번역 품질 향상은 우리가 지속적으로 중점을 두는 부분입니다. 앞으로 더 발전된 번역 모델, 특히 기술 문서에 최적화된 대규모 언어 모델을 도입할 계획입니다. 또한 커뮤니티 검토 메커니즘을 구축하여 전문 개발자가 번역 검토 및 개선에 참여할 수 있게 하여 함께 번역의 정확성을 높여 나갈 것입니다. 더 나아가 더 스마트한 용어 관리 시스템을 개발하여 기술 용어가 다른 문서 간에 일관된 번역을 유지하도록 하여 사용자의 읽기 경험을 향상시킬 것입니다.
크로스 플랫폼 지원 및 기능 확장
ADDT 플러그인을 더 많은 브라우저 플랫폼, 특히 Safari로 확장하기 위해 노력하고 있습니다. 동시에 오프라인 번역 기능을 제공하여 네트워크 연결이 없는 상황에서도 개발자가 번역 서비스를 이용할 수 있도록 할 것입니다. 기능 측면에서는 개인화 설정 옵션을 추가하여 특정 용어를 번역하지 않고 유지하거나 번역 스타일을 조정하는 등 사용자가 번역 환경설정을 커스터마이즈할 수 있도록 할 예정입니다. 또한 협업 번역 기능도 도입하여 팀 구성원이 번역 설정을 공유하고 동기화할 수 있도록 할 계획입니다.