Coroid übersetzt Ihr Produkt mit demselben Engine, das es für seine eigenen dreizehn Sprachen nutzt. Ihre Kataloge bleiben als Dateien in Ihrem Repository. Jede Änderung daran kommt als normaler Task und pull request herein – nur neue, geänderte oder fehlerhafte Zeichenfolgen werden an ein Modell gesendet.
Die Übersetzungen befinden sich unter Qualitätskontrolle → Übersetzungen. Die Liste zeigt jedes Projekt, ob Übersetzungen konfiguriert sind und den letzten Scan an. Öffnen Sie ein Projekt, um dessen Arbeitsbereich zu nutzen.
- Storefront
- Docs-Seite
- Mobile App
| Sprache | Fehlend | Veraltet |
|---|---|---|
| de | 0 | 2 |
| fr | 14 | 0 |
| ja | 14 | 1 |
| ar | 14 | 0 |
- ÜbersetzungenTask-QA und Pull Requests · nur geänderte ZeichenfolgenVeröffentlicht
- ÜbersetzungsauditGeplant · jede Katalog- und SprachseiteEntwurf
Qualitätskontrolle → Übersetzungen für ein Projekt: die neueste Übersetzungsprüfung pro Sprache sowie die Steuerungen für Übersetzungen und Übersetzungsaudits. Beispieldaten.
Was Ihr Repository benötigt
Coroid liest Kataloge in diesen Formaten:
| Format | Verwenden Sie es für |
|---|---|
| ICU JSON | Nachrichtendateien mit ICU-Pluralformen und -Auswahlen |
| i18next JSON | i18next- und react-i18next-Kataloge, einschließlich Plural-Suffixe |
| Vue i18n JSON | vue-i18n-Nachrichten, einschließlich verknüpfter Nachrichten und Pipe-Pluralformen |
| Rails YAML | config/locales/*.yml, mit %{name} Interpolation und Plural-Schlüsseln |
| gettext PO | .po Dateien und einer .pot Vorlage, mit Plural-Forms pro Sprache |
| Markdown und MDX | Dokumentationsseiten unter einem Sprachordner (docs/en/…): Text, Bildbeschreibungen und ausgewählte Frontmatter-Felder; Code und Markup bleiben unverändert. |
| Benutzerdefiniert | Jedes andere Format über einen kleinen Adapter-Befehl in Ihrem Repository. |
Sie benötigen noch keine Übersetzungen. Falls Ihr Projekt kein i18n hat, kann Coroid dieses einführen.
Einrichten
Das Setup Reiter führt durch drei Schritte.
- Erkennen. Coroid bereitet einen Entdeckungs-Task vor. Es führt die festgelegte Übersetzungs-Engine gegen Ihr Repository aus und protokolliert den Stack, die Kataloge, welche Sprache die Quelle ist und alles, worüber es unsicher ist.
- Auswählen. Wählen Sie Bestehendes i18n übernehmen aus, um Ihr Framework und die Kataloge beizubehalten und Coroid's Prüfungen sowie Delta-Engine hinzuzufügen. Wählen Sie i18n einführen aus, damit Coroid Ihr Framework verdrahtet, repräsentative Zeichenfolgen extrahiert und Locale-Routing, Fallbacks sowie Unterstützung für von rechts nach links orientierte Schriften hinzufügt.
- Erstellen. Coroid erstellt den Setup-Task mit einer Spezifikation und Akzeptanzkriterien. Das Ergebnis ist ein pull request, das Sie wie jeder andere prüfen.
- Storefront
- Docs-Seite
- Mobile App
- Erkennen
- 2Auswählen
- 3Erstellen
Ihr aktuelles Framework und die Kataloge bleiben erhalten; zusätzlich werden die Übersetzungsprüfungen und der Delta-Engine von Coroid hinzugefügt.
Ihr Framework anbinden, repräsentative Zeichenfolgen extrahieren und anschließend Sprachrouting, Fallbacks sowie RTL-Verhalten einrichten.
- Quellsprache
- en
- Zielsprachen
- de, fr, ja, ar
Die Registerkarte „Setup“ nach der Erkennung: bestehendes i18n übernehmen oder einführen, inklusive Quell- und Zielsprachen. Beispieldaten.
Das Setup ist fertig, sobald dieser pull request in den Standardzweig Coroid synchronisiert wird. Bis dahin geht der Arbeitsbereich davon aus, dass nichts anderes vorhanden ist.
Die Repository-Datei
Beim Setup wird .coroid/i18n.jsongeschrieben. Sie beschreibt Ihr Repository, liegt also in Ihrem Repository und ändert sich über Pull Requests:
{
"version": 1,
"cli": { "version": "1.7.0", "sha256": "…" },
"sourceLocale": "en",
"targetLocales": ["de", "fr", "ja", "ar"],
"catalogs": [
{
"id": "ui",
"format": "i18next-json",
"source": "messages/{locale}.json"
}
],
"localeTier": { "ja": "escalation" }
}clifixiert die exakte Engine-Version und deren Prüfsumme. Coroid lädt diese Version herunter und verifiziert sie vor jedem Lauf, sodass ein Update Ihre Ausgabe nicht unerwartet verändert.sourceLocalekann jede Sprache sein. Eine schwedische Quelle, die ins Englische und Deutsche übersetzt wird, funktioniert auf dieselbe Weise.localeTierfordert die stärkere Übersetzungsroute für eine Locale an. Sie wählen ein Tier aus – niemals ein Modell.
Die Datei kann auch ein Glossar, geschützte Begriffe, Produktkontext und Anweisungen pro Locale enthalten.
Um sie zu ändern, bearbeiten Sie den Vorschlag auf dem Konfiguration Reiter und wählen Sie Änderung vorschlagen. Coroid öffnet einen Task, der genau diese Datei anwendet und alle betroffenen Übersetzungen repariert.
Derselbe Reiter enthält die Einstellungen, die zu Coroid statt zu Ihrem Repository gehören: Welche Seiten den Vorschlagsauswähler öffnen dürfen, ob Vorschläge standardmäßig überprüft werden und das Ausgabenlimit für Übersetzungen des Projekts.
Jede Änderung prüfen
Übersetzungen werden durch zwei Qualitätskontrollen Teil der Verifizierung. Fügen Sie sie vom Übersicht Reiter hinzu.
- Übersetzungen läuft im Task-QA und bei Pull Requests. Es prüft nur die Zeichenfolgen, die von einer Änderung betroffen sind.
- Übersetzungs-Audit läuft nach einem Zeitplan. Es prüft jeden Katalog und jede Locale und kann einen Browser-Test der Locale-Seiten einschließen, um Layouts von rechts nach links, Überlauf und nicht übersetzten Text auf der Seite zu überprüfen.
Ein neuer Kontrollpunkt bereitet einen Richtlinienentwurf vor. Überprüfen Sie ihn und veröffentlichen Sie ihn unter Qualitätsrichtlinien um ihn zu aktivieren.
Jedes Problem wird zu einem Befund mit einem Issue-Code:
| Code | Bedeutung | Blockiert standardmäßig |
|---|---|---|
missing | Die Zeichenfolge hat keine Übersetzung | Ja |
invalid_syntax | Die Übersetzung lässt sich nicht parsen – beispielsweise fehlerhafte ICU-Struktur | Ja |
placeholder_mismatch | Platzhalter weichen von der Quelle ab | Ja |
plural_categories | Eine für die Region erforderliche Pluralform fehlt. | Ja |
stale | Der Quelltext hat sich nach der Übersetzung der Zeichenfolge geändert. | Nein |
Sie wählen in den Einstellungen des Steuerelements aus, welche Codes blockiert werden sollen. Das Glossar sowie die Regeln zu Länge und verbotenen Begriffen geben bei der Konfiguration Ihrer Datei ihre jeweiligen Codes an.
missingui · checkout.total · frNicht übersetztstaleui · nav.deals · deQuelle wurde seit der Übersetzung geändertplaceholder_mismatchui · cart.items · jaPlatzhalter weichen vom Quelltext abplural_categoriesui · cart.count · arFür diese Sprache fehlen Pluralformen
Qualitätsmängel aus der Übersetzungsprüfung – jeweils ein Fehlercode pro Fund. Beispieldaten.
Wenn ein Übersetzungsfehler eine Aufgabe blockiert, behebt der Entwickler-Agent dies stets auf dieselbe Weise: Er öffnet eine Übersetzungssitzung für die Aufgabe und führt den Engine auf den geänderten Zeichenfolgen aus. Er bearbeitet Kataloge im Zielformat niemals manuell.
Das Translator-Modell
Übersetzung hat in AI-Profilen ihre eigene Rolle, Übersetzer, neben Architekt, Entwickler, QA und Rezensent. Standardmäßig wird Hy-MT2 als Übersetzungsmodell verwendet, wobei GPT-6 Luna als Fallback zum Einsatz kommt, sofern die Richtlinien Ihres Unternehmens dies zulassen. Die Zuordnung kann wie bei jeder anderen Rolle in einem AI-Profil geändert werden.
Der Engine gruppiert Zeichenfolgen außerdem nach Größe, überprüft jede Antwort auf Platzhalter und Pluralregeln und wiederholt den Vorgang oder leitet die betreffende Zeichenfolge weiter, falls ein Fehler auftritt.
Kosten
Übersetzungen sind in jedem Plan verfügbar. Übersetzungsanfragen werden über das Übersetzungs-Gateway von Coroid geleitet und als Modellnutzung für Ihr Unternehmen abgerechnet – genauso wie der Betrieb der Agenten. Einrichtungsaufgaben zählen wie jede andere Aufgabe zur verfügbaren Agenten-Stunden-Zahl Ihres Plans.
Mit der Standard-Route des Übersetzers kosten Übersetzungen etwa zwei Cent pro 1.000 Zeichenfolgen und Sprache. Die Übersetzung eines 2.000 Zeichenfolgen umfassenden Katalogs in zehn Sprachen kostete laut unseren Messungen etwa 0,33 $.
- Nur Änderungen verursachen Kosten. Der Engine speichert einen Cache, der über den Quelltext indiziert ist; unveränderte Zeichenfolgen werden daher nie erneut gesendet.
- Jede Aufgabe hat eine Übersetzungsgrenze. Eine Sitzung endet bei Erreichen des Ausgabegrenzbetrags der Aufgabe – standardmäßig 1 $. Ein Projekt kann einen niedrigeren Grenzwert festlegen unter Konfiguration → Zugriff und Ausgaben.
- Prüfungen initiieren keine Modellaufrufe. Das Steuerelement „Übersetzungen“ sowie die Überprüfung lesen Ihre Kataloge aus; sie übersetzen jedoch nicht.
Übersetzen außerhalb von Coroid
Der Engine ist ein Befehlszeilen-Tool, coroid-i18n. Ihr eigenes CI-System kann dieselbe festgelegte Version mit seinem eigenen OpenRouter-Schlüssel ausführen. Innerhalb von Coroid nutzen Aufgaben stets das Übersetzungs-Gateway, sodass Ausgaben und Grenzwerte an einem Ort bleiben.