도구 UI 언어
ai-i18n-tools는 프로젝트의 sourceLocale / targetLocales와 무관하게 자체 사용자 인터페이스 — CLI 도움말 텍스트, 빈번한 로그/요약/오류 메시지, 번역 대시보드 — 를 현지화합니다. 별도의 구성이 필요하지 않으며, 기본적으로 도구는 OS 로케일을 따릅니다.
로케일 결정
UI 로케일은 다음 소스에서 결정되며, 우선순위가 높은 순서입니다:
-L/--ui-lang <code>전역 플래그(예:-L pt-BR).AI_I18N_LANG환경 변수(예:export AI_I18N_LANG=es).ai-i18n-tools.config.json의uiLanguage구성 키(BCP-47 문자열).- 호스트 OS 로캘(
Intl.DateTimeFormat().resolvedOptions().locale경유).
매칭 및 폴백
요청된 로케일은 배포된 UI 언어와 정확하게 일치하거나 가장 가까운 변형과 일치합니다(예: pt-PT은 pt-BR로, en-US는 en-GB으로 확인됨). 일치하는 항목이 없으면 소스 로케일(en-GB)로 대체됩니다. 플래그, 환경 변수 또는 uiLanguage를 통해 명시적으로 UI 언어가 요청되었지만 배포된 번들이 일치하지 않으면 CLI는 기본 로케일이 사용될 것이라는 경고를 한 번 표시합니다. 호스트 OS에서만 추론된 로케일은 경고하지 않습니다.
제공되는 UI 언어
영어(영국, 원본), 독일어, 스페인어, 프랑스어, 힌디어, 일본어, 한국어, 포르투갈어(브라질), 중국어(간체), 중국어(번체).
번역 대시보드
번역 대시보드는 GET /api/ui-i18n에서 결정된 로케일, 레이아웃 방향, 번역 번들을 읽어 로드 시 적용합니다 (<html lang> / dir를 설정하고 data-i18n* 속성을 통해 정적 마크업을 현지화합니다).
관련 항목
AI_I18N_LANG— 환경 변수 재정의uiLanguage— 설정 키 재정의-L/--ui-lang— CLI 플래그 재정의 (최우선)