Gå til hovedinnhold

kapi translate

kapi translate [files...]

Oversett filer gjennom den innebygde oversettelsesflyten: gjenbruk et bundet content memory først (ingen operasjon uten ett), oversett resten med den konfigurerte AI-leverandøren, og kjør deretter de deterministiske kontrollene (plasshodere, inline-koder, uoversatt tekst) over det som ble produsert.

Dette er den sikrede stavemåten: den samme tre-trinns flyten 'kapi up' looper over et prosjekt, brukt på ad hoc-filer. Det rå oversettelsesverktøyet (ingen Memory-pass, ingen kontroller) er fortsatt tilgjengelig som 'kapi exec translate'. For å holde et helt prosjekt oppdatert, bruk 'kapi up'.

Commandtranslate
Grouplanguages
Try it (demo)

Demo mode — illustrative output from a built-in stub, not a real model. Install the CLI to run with your own API key.

kapi translate messages.json --target-lang fr
Flags
FlagTypeDefaultDescription
--api-key stringAPI-nøkkel for AI-leverandøren
--batching stringhvor mange blokker som deler ett LLM-kall: auto (standard), single
--concurrency , -jint0antall filer som behandles samtidig (0 = auto)
--context stringhva modellen får vite om en blokk utover blokken: none, key (standard), neighbours
--credential stringnavn på lagret legitimasjon som skal brukes (se 'kapi credentials list')
--encoding , -estringtegnkoding for inndatafil
--engine stringformat engine for detected files: native or a plugin name (default: native, then plugins)
--explain boolfalseskriv ut de løste kilde → mål-bindingene og avslutt uten å kjøre
--fail-on-unknown boolfalseavslutt med feil hvis en fil ikke kan behandles (standard: hopp over med en advarsel)
--format , -fstringoverstyr gjenkjenning av inngangsformat
--input , -istringSliceinnfilsti(er); gjenta for flere filer
--instruction stringekstra veiledning til modellen under oversettelse (f.eks. "uformelt register; behold produktnavn på engelsk")
--memory stringnavngitt Memory for resirkuleringsflyt (løses fra KAPI_HOME)
--model stringnavn på AI-modell
--output , -ostringutdatasti eller mal (f.eks. ./out/{name}_{lang}.{ext})
--pack boolfalsenår du transformerer en .kpz, skriv også resultatet tilbake til .kpz (auto-pack)
--parallel-blocks int0fordel blokkbehandling på N goroutiner (0 = av)
--print-ops boolfalsewrite no file and print the change set the run would apply, for kapi apply
--progress stringstrøm fremdriftshendelser til stderr som NDJSON (verdi: jsonl); hendelser bruker vokabularet for flyt-kjøringshendelser
--project , -pstringsti til en kapi.yaml-prosjektoppskrift eller dens mappe (oppdages automatisk fra cwd hvis utelatt)
--provider stringanthropicAI-leverandør (anthropic, openai, ollama)
--source-lang stringkildespråk (f.eks. en, en-US; standard er prosjektets source_language, ellers en)
--stats boolfalseinkluder del-/blokkantall i utdata
--strict boolfalsealias for --fail-on-unknown
--target-lang stringmålspråk (f.eks. fr, de-DE)
--termstore stringnavngitt termlager for term-oppslag/håndhevelse (løses fra KAPI_HOME)
--trace stringskriv flyt-sporing som JSON til fil (for flytvisualisering)
More examples
kapi translate docs/*.md --target-lang de -o out/{name}_{lang}.{ext}
kapi translate app.xliff --target-lang ja --provider ollama

← Back to the Command Reference