CLI — 워크플로 및 보고
sync
개요: ai-i18n-tools sync [options]
추출(활성화된 경우), UI 번역, features.translateSVG 및 config.svg가 설정된 경우 translate-svg, 문서 번역, features.translateJson 및 json[]가 설정된 경우 translate-json 순으로 실행됩니다 — 단, --no-ui, --no-svg, --no-docs 또는 --no-json로 건너뛴 경우는 예외입니다.
주요 옵션: -l, -p / -f, --dry-run, -j, -b, --force, --force-update, --check-cache, --recheck-glossary-warnings, --no-ui, --no-svg, --no-docs, --no-json
--force은(는) 문서, JSON, SVG 세그먼트 캐시 및 파일 추적을 지웁니다. UI 번역으로 전달되지 않습니다. strings.json을(를) 다시 번역하려면 translate-ui --force 또는 sync-ui --force를(을) 사용하세요. --force-update는 문서, JSON, SVG에 적용됩니다(UI에는 적용되지 않음). --no-ui, --no-svg, --no-docs, --no-json은(는) 한 번 실행할 때 해당 단계를 건너뜁니다. --file는 번역되는 파일을 제한하지만, 문서 블록의 모든 마크다운 파일을 사용하여 플랫 형제 링크를 여전히 다시 작성합니다. --check-cache은(는) 문서, JSON, SVG로 전달됩니다. 파일 추적이 건너뛸 경우에도 기본 스크립트가 강제 적용되는 로케일에 대해 캐시된 세그먼트를 다시 검증합니다. 문서 단계는 또한 --emphasis-placeholders(translate-docs와(과) 동일한 의미)을(를) 전달합니다. 전역 --debug-failed은(는) 체인의 모든 모델이 실패할 때뿐만 아니라, 폐기된 각 모델 시도(SVG/문서 스크립트 대체 포함)에 대해 cacheDir 아래에 FAILED-TRANSLATION 로그를 작성합니다. --prompt-format은(는) sync 플래그가 아닙니다. 문서 및 JSON 단계는 내장된 기본값(json-array)을(를) 사용합니다.
status
개요: ai-i18n-tools status [--max-columns <n>]
features.translateUIStrings가 켜져 있으면 로케일별 UI 적용 범위(Translated / Missing / Placeholder issues / Total)를 출력합니다. Placeholder issues는 저장된 번역이 플레이스홀더의 이름을 바꾸거나, 삭제하거나, 새로 만들거나, 대상을 변경하는 행을 계산합니다. 그런 다음 파일 × 로케일별 마크다운 번역 상태를 출력합니다(--locale 필터는 적용되지 않으며, 로케일은 구성에서 가져옵니다). features.translateJson가 켜져 있고 json[]가 구성되어 있으면 블록별 JSON 번들 상태도 출력합니다. 큰 로케일 목록은 터미널에서 줄이 좁게 유지되도록 최대 n개의 로케일 열(기본값 9)로 구성된 반복 테이블로 분할됩니다.
주요 옵션: --max-columns
statistics
개요: ai-i18n-tools statistics [--max-columns <n>]
문서 캐시 및 strings.json 통계를 출력합니다(번역 대시보드 → 통계와 동일한 집계). --max-columns: 모델 × 로케일 테이블당 최대 로케일 열 수(기본값 6).
주요 옵션: --max-columns
참고: 대시보드 통계
usage
개요: ai-i18n-tools usage [--since <when>] [--provider <name>] [--model <id>] [--operation <name>] [-l <code>] [--outcome accepted|discarded] [--clear] [--older-than <when>] [--dry-run]
기록된 모델 API 호출 통계(호출 횟수, 토큰, 단일 USD 비용)를 출력합니다. 비용은 제공업체의 usage.cost가 존재할 경우( 0 포함) 해당 값을 사용하며, 그렇지 않으면 해당 모델의 providers.<name>.modelPricing, 그 다음으로는 제공업체 전체 providers.<name>.pricing 기본값, 마지막으로 해당 모델 ID에 대한 models.dev 입출력 정가를 사용합니다. 보고된 비용과 명시적 구성 요율은 절대 대체되지 않습니다. 알 수 없는 비용은 —로 유지되며 $0.00로 표시되지 않습니다. 새 호출은 금액을 저장하며, 토큰은 있지만 저장된 비용이 없는 이전 행은 보고서 실행 시 추정됩니다. Translation Dashboard → Usage & costs와 동일한 집계 방식을 사용합니다. 7일(UTC 기준)이 지난 세부 행은 월별 api_totals으로 통합되며, 보고서는 두 테이블을 모두 결합합니다. --since은 YYYY-MM-DD, 기간(30m, 1h, 6h, 12h, 24h, 7d, 30d), 또는 달력 기준 월 단위(1mo, 2mo, 3mo)를 허용합니다. --clear는 세부 행과 월별 합계를 삭제합니다(--older-than은 1mo, 2mo, 3mo, 6mo, 1y 또는 all입니다. --dry-run은 삭제하지 않고 개수만 보고합니다).
주요 옵션: --since, --provider, --model, --operation, -l / --locale, --outcome, --clear, --older-than, --dry-run
참고: 대시보드 사용량 및 비용