액션이 Azure와 어떻게 소통하나요?
마이크로소프트의 공식 @azure-rest/ai-translation-text SDK를 통해 @azure/core-rest-pipeline 위에 레이어드되었습니다. 이 기능은 408/429/5xx 자동 재시도, 타이핑된 요청 및 응답 모델, 인증 헤더 처리 등 이전에는 수동으로 axios 호출로 처리되던 모든 기능을 무료로 제공합니다. 공개 액션 표면(입력, 출력, 파일 출력)은 변함이 없습니다.
왜 번역이 때때로 브랜드에 맞지 않거나 어조가 맞지 않는 걸까요?
기계 번역은 기본적으로 범용 모델을 사용합니다. 세 가지 노브가 도움이 됩니다: 어려운 용어 덮어를 위한 용어집, 당신의 어조와 어휘로 훈련된 미세 조정 모델을 위한 커스텀 번역기 카테고리, 그리고 욕설을 지우거나 표시하는 profanityAction.
같은 파일을 두 번 번역하지 않으려면 어떻게 해야 하나요?
소스 로컬 파일에만 맞는 paths에서 워크플로우를 트리거하세요, 예를 들어 **/*.en.resx. 이 액션은 GITHUB_TOKEN가 설정되었을 때 트리거별로 별도의 파일 필터를 포함하여, 작업을 최신 커밋된 파일로 좁힙니다.
오프라인으로 진행할 수 있나요?
꼭 그렇진 않아요 — Azure AI Translator는 런타임 두뇌입니다. 하지만 HTTP 변환 요청을 하지 않고도 파싱과 설정을 검증하기 위해 dryRun: true 실행할 수 있습니다.
이 액션은 어떤 노드 버전에서 실행되나요?
v3는 GitHub Actions node24 런타임에서 실행됩니다. 번들로 제공되는 자바스크립트는 노드 20, 22, 24와 호환되며, 이 부분이 CI가 테스트하는 대상입니다.
번들된 dist/은 어디서 나오나요?
GitHub JS 액션은 컴파일된 JS를 저장소에 제공합니다. dist-build 워크플로우는 매번 병합 후 데이터를 재구성하여 드리프트가 발생하는지 main하고, dist-check 오래된 출력물이 떨어지는 PR을 차단합니다.
다른 자료 형식은 어떤가요?
오늘: .resx, .xliff, .po, .json, .ini, .restext. 이슈를 열어 다른 방법이 필요하다면, 파서 인터페이스가 작아서(파→ 맵 파싱 → 변환 적용 → 형식) 그리고 기여도 환영합니다.