변경 사항​

Quality Gate (5가지 검사)​

이제 모든 번역은 디스크에 기록되기 전에 5가지 결정론적 유효성 검사를 통과해야 해요:

1. Empty/blank — 모델이 아무것도 반환하지 않음
2. Source echo — 모델이 영어 입력값을 그대로 반환함
3. Hallucination loop — 반복되는 트라이그램(trigram) 패턴
4. Length inflation — 출력값이 원본보다 4배 이상 김
5. Script compliance — 로케일에 맞지 않는 잘못된 문자 체계(script)

이 5가지 검사를 모두 통과하지 못한 번역은 기록되지 않아요. 실패한 번역은 로그에 남고 다시 시도돼요.

Retry Cascade​

배치가 실패하면, rosetta는 점진적으로 더 작은 배치 단위로 다시 시도해요:

Full batch (30 keys) → parse error
  └→ Half batch (15 keys) → 2 failures
      └→ Individual keys (1 each) → isolates the problem keys

보안 강화​

• Prototype pollution guard — 파싱 시점에 __proto__, constructor 키를 거부해요
• Path traversal guard — 조작된 로케일 코드가 설정된 디렉터리 외부에 쓰기 작업을 할 수 없도록 막아요
• Response validation — 전송된 키만 응답으로 다시 허용해요

테스트 인프라​

프롬프트 캐싱​

이제 시스템 메시지가 사용자 메시지와 분리되어, Anthropic 및 Google과 같은 제공업체에서 프롬프트 캐시 적중(cache hits)이 가능해졌어요. 이를 통해 다중 배치 동기화 시 토큰 비용을 크게 줄일 수 있어요.

전체 기술 세부 정보는 Quality Gate 문서와 보안 문서를 확인해 주세요.

콘텐츠 인식 번역​

Markdown을 번역할 때 원본 파일을 LLM에 그대로 보낼 수는 없어요. Code block이 번역되거나, shortcode가 손상되거나, Hugo template variable이 망가질 수 있거든요.

Rosetta v3.1.0은 Unicode sentinel shielding으로 이 문제를 해결해요:

1. 번역하기 전에 구조화된 블록(code fence, shortcode, inline code, HTML)을 고유한 sentinel token으로 교체해요.
2. LLM은 번역 가능한 텍스트만 받게 돼요.
3. 번역이 끝나면 sentinel을 원래 콘텐츠로 복원해요.

LLM은 code block을 전혀 볼 수 없으므로, 이를 손상시킬 수 없어요.

Front Matter 지원​

YAML(---) 및 TOML(+++) front matter 구분자를 모두 지원해요. 기본적으로 title, description, summary, subtitle, caption, linkTitle가 번역돼요. 그 외의 모든 필드(date, draft, tags, weight)는 그대로 유지돼요.

설정​

{
  "contentDir": "./content"
}

npx i18n-rosetta sync   # now translates content too

자세한 내용은 콘텐츠 번역 가이드를 참고해 주세요.

변경 사항​

이전 버전에서는 모든 언어 쌍에 대해 단일 번역 방식을 사용했어요. v3.0.0은 이러한 결합을 분리하여, 각 source→target 쌍마다 다른 방식, 모델, 품질 설정을 사용할 수 있어요.

{
  "version": 3,
  "pairs": {
    "en:fr": { "method": "google-translate" },
    "en:ja": { "method": "llm", "model": "google/gemini-2.5-pro" },
    "en:crk": { "methodPlugin": "crk-coached-v1" }
  }
}

왜 Per-Pair인가요?​

이 아키텍처는 한 프로젝트에서 프랑스어에는 Google Translate를, 토착어에는 coached FST 파이프라인을 동일한 sync 명령어 내에서 동시에 실행해야 했기 때문에 만들어졌어요.

Google Translate는 약 130개의 언어를 지원해요. 하지만 전 세계에는 7,000개가 넘는 언어가 있어요. per-pair 시스템은 rosetta가 어떤 언어로든 확장될 수 있다는 것을 의미해요. 해당 언어 쌍에 맞는 방식만 있으면 되니까요.

기타 주요 사항​

• Plugin 시스템 — eval harness에서 사전 패키징된 번역 방식을 설치할 수 있어요.
• Config 버전 3 — pair 수준의 override가 포함된 새로운 스키마예요.
• Quality tiers — Standard, High, Research, Verified — status에서 각 쌍별로 표시돼요.

전체 생태계 설계에 대해서는 Architecture 문서를 확인해 보세요.