Übersicht
Der Befehl verbatra: seine neun Unterbefehle, die gemeinsamen Flags, wie er deine Umgebung liest und der Exit-Code-Vertrag.
Maschinell übersetzte Seite
@verbatra/cli liefert das verbatra-Binary, einen dünnen Wrapper über @verbatra/sdk. Neun Befehle erledigen die Arbeit:
| Befehl | Was er tut |
|---|---|
init | eine verbatra-Konfiguration und .env.example für dieses Projekt anlegen |
translate | jedes Ziel-Locale einmal übersetzen, dann beenden |
watch | bei jeder Quelländerung neu übersetzen, bis unterbrochen wird |
check | melden, welche Keys pro Locale fehlen oder veraltet sind, schreibgeschützt |
diff | die genauen Keys pro Locale listen, die hinzugefügt oder neu übersetzt würden oder verwaist sind, schreibgeschützt |
doctor | die Projekteinrichtung prüfen und alle Probleme auf einmal melden, ohne einen Provider aufzurufen |
export | unübersetzte Strings in eine Excel-Arbeitsmappe für eine menschliche Übersetzerin exportieren |
import | eine ausgefüllte Arbeitsmappe zurück in die Locale-Dateien importieren |
studio | Verbatra Studio starten, das lokale Übersetzungs-Dashboard |
Installieren und aufrufen
Installiere @verbatra/cli als Dev-Dependency und starte das Binary über deinen Paketmanager:
npm install --save-dev @verbatra/cli
npx verbatra translate # or: pnpm verbatra translate, yarn verbatra translateDu brauchst Node.js >=22.14.0.
Gemeinsame Konventionen
--cwd <path>löst die Konfiguration und die Locale-Dateien von diesem Verzeichnis statt vom aktuellen aus auf. Jeder Befehl nimmt es.--config <path>lädt diese Konfigurationsdatei, statt eine zu suchen. Jeder Befehl außerinitnimmt es; die Suchreihenfolge steht in Konfigurationsdatei.--jsongibt einen maschinenlesbaren Envelope auf stdout aus, eine Zeile pro Datensatz, und hält stdout sauber zum Weiterleiten. Verzweige auf seinok-Feld: ein Erfolg trägt die Daten des Befehls unterresult, ein fehlgeschlagener Lauf trägt denselben stabilen Fehlercode, den auch die stderr-Zeile nennt. Die menschenlesbare Fehlerzeile geht in beiden Fällen auf stderr.translate,watch,check,diff,doctor,exportundimportunterstützen es;initundstudionicht.--helpund--versiongeben aus und enden mit0. Ein unbekannter Befehl oder ein unbekanntes Flag endet mit2.
Umgebungsdateien
translate, watch, doctor und studio laden .env.local und dann .env aus dem Arbeitsverzeichnis, bevor sie laufen. Eine bereits in deiner echten Umgebung gesetzte Variable gewinnt immer. API-Keys werden nur aus der Umgebung gelesen, nie aus der Konfigurationsdatei oder einem Flag: siehe Provider. Die schreibgeschützten Befehle (check, diff) und die Arbeitsmappen-Befehle (export, import) rufen nie einen Provider auf und laden keine .env-Dateien.
Exit-Codes
Der Exit-Code ist der Vertrag, auf den ein CI-Schritt oder Skript verzweigt:
| Code | Bedeutung |
|---|---|
0 | Erfolg (auch --help und --version) |
1 | translate oder import lief durch, aber einige Locales schlugen fehl oder blieben partial, check fand ein Locale nicht synchron, diff fand ausstehende Änderungen, oder doctor fand ein Einrichtungsproblem |
2 | konnte nicht laufen: ein Fehler des gesamten Laufs (Konfiguration, Quelle, Provider, Lock) oder ein Verwendungsfehler |
130 | watch oder studio wurde durch einen zweiten Interrupt zwangsbeendet |
Jede Befehlsseite erklärt, wie diese Codes für sie gelten. Wie du sie in eine Pipeline einbaust, steht in CI und Exit-Codes.
Edit on GitHubStudio mit einem Browser-Agenten bedienen
Mach die Review-Aktionen von Verbatra Studio als WebMCP-Tools verfügbar, damit ein KI-Agent im Browser dieselben Operationen aus deinem offenen, authentifizierten Dashboard-Tab heraus steuern kann.
verbatra init
Lege eine verbatra-Konfiguration und ein .env-Beispiel für dieses Projekt an.