Daļēji internacionalizēts? Lūk, ko globalize.now dara (un nedara).

Ja jūsu repozitorijā jau ir iestrādāts next-intl, react-i18next, i18next vai Lingui — lokalizācijas mapes diskā, atkarības package.json, starpprogrammatūra vai konfigurācijas faili — jums nav vajadzīgs vēl viens rīks, kas izliekas, ka sākat no nulles. globalize.now ir AI darbināta lokalizācijas infrastruktūra. L1 (jau internacionalizētā) režīmā produkts izlaiž destruktīvo iestatīšanas procesu un paliek sinhronizācijas režīmā: nolasa jūsu avota valodu, salīdzina citas lokalizācijas pēc katra push, atver pull request ar aizpildījumiem. Šajā rakstā aprakstīts, ko šis režīms skar, ko tas atsakās skart un ko darīt, ja noteikšana kļūdās.

Kāpēc lielākā daļa i18n padomu pieņem, ka sākat no nulles?

i18n rīku mārketinga teksti joprojām apraksta «zaļā lauka» gadījumu: nav instalētas bibliotēkas, nav lokalizācijas failu, izgūšana nav veikta. Lielākā daļa produkcijas kodu repozitoriju tādi nav.

Pēdējo pāris nedēļu laikā trīs nesaistītas pirmās tikšanās ar klientiem noritēja pēc viena un tā paša scenārija: komanda mēģināja ieviest i18n vienreiz, dabūja kaut ko pusceļā strādājošu un apstājās — jo izraut to visu un pārtaisīt no jauna šķita ļaunāk nekā dzīvot ar haosu.

Ja tā ir jūsu situācija, tad šis raksts ir rakstīts tieši jums.

Kā izskatās daļēji internacionalizēts kodu repozitorijs?

Šie modeļi atkārtojas atkal un atkal (dati anonimizēti):

• Next.js + next-intl lietotne, kur lielākā daļa komponentu izmanto t(), bet vecākie maršruti joprojām izlaiž burtiski iekodētu angļu tekstu, jo pirmais migrācijas posms tā arī netika pabeigts.
• React + i18next projekts, kura lokalizācijas faili gan eksistē, bet satur tikai angļu valodas vērtības — tulkošana vienmēr tika atlikta uz nākamo ceturksni.
• messages/ mapju struktūra, kurā en.json ir pilns, bet es.json ir gandrīz tukšs.
• Valodas pārslēdzējs, kas iestrādāts izkārtojumā un dažreiz izmet 404 kļūdu, jo maršrutēšana bija migrēta tikai uz pusi.

Nevienam no šiem projektiem nav vajadzīgs, lai globalize.now sāktu no jauna. Tiem vajadzīgs, lai tas pabeigtu iesākto darbu.

Kādus signālus globalize.now meklē pirmajā palaišanas reizē?

Noteikšana notiek divos soļos, nevis vienā.

Vispirms norādiet globalize.now uz repozitoriju. Pieslēdzot to lietotnē, noteikšana un vienreizējā konvertēšana notiek automātiski. Ja vēlaties, lai šo pirmo pārbaudi veiktu jūsu aģents lokāli, instalējiet skills — tas ievieto dažus rokasgrāmatas failus .claude/skills/ un neko citu jūsu repozitorijā nemaina:

npx skills add globalize-now/globalize-skills

Tad iedodiet uzdevumu savam aģentam — Claude Code, Cursor vai Codex. Aģents nolasa instalētos skills un izmanto tos, lai skenētu jūsu repozitoriju:

Set up localization for my project

Tieši šajā otrajā solī notiek pati noteikšana. Aģents meklē:

• package.json atkarības: next-intl, react-i18next, i18next, @lingui/core, @lingui/react, @lingui/macro vai jebkuru i18next-* spraudni.
• Lokalizācijas mapes: messages/ repozitorija saknē, locales/ mapi vai src/i18n/ ar lokalizāciju apakšmapēm.
• Esošie lokalizācijas faili: en.json, en.po, en.yml, en.yaml vai noklusējuma valodas fails, ko jūsu bibliotēka jau sagaida.
• Ietvaram specifiska konfigurācija: i18n.config.ts, next-intl starpprogrammatūra, lingui.config.js vai to ekvivalenti.

Ja klāt ir vismaz divi no šiem signāliem, projekts tiek uzskatīts par L1 — jau internacionalizētu — un iestatīšanas plūsma sazarojas, nevis izpilda pilnu zaļā lauka scenāriju. Vairāk informācijas atrodams Palīdzības centra rakstā par esošu i18n.

Ko L1 režīms atsakās mainīt?

Šī ir tā daļa, kas lietotājiem interesē visvairāk. L1 režīmā globalize.now ne:

• Neizpilda plašu teksta izgūšanas pārbaudi, kas skenē komponentus, meklējot burtiski iekodētus tekstus.
• Neģenerē jaunas tulkošanas atslēgas un nepārkārto atslēgu struktūru, kurai jūs jau esat apņēmušies.
• Neveido lokalizācijas failus valodām, kuras vēl neesat konfigurējuši.
• Neievieš valodas pārslēdzēju. Ja tāds jums jau ir, tas paliek. Ja nav, mēs to nepievienojam.
• Nepārraksta maršrutēšanu, starpprogrammatūru vai ietvara konfigurāciju jūsu vietā.

Jūsu esošais i18n iestatījums paliek jūsu. Šajā režīmā mēs to nepārstrukturējam.

Ko L1 sinhronizācijas režīms dara pēc noteikšanas?

L1 ir vērsts primāri uz sinhronizāciju. Kad noteikšana ir pabeigta:

1. Mēs nolasām jūsu esošos lokalizācijas failus, lai uzzinātu pašreizējo atslēgu struktūru un to, kura valoda ir patiesības avots.
2. Jūs pieslēdzat GitHub repozitoriju, izmantojot globalize.now CLI vai tīmekļa lietotni.
3. Ar katru push jūsu galvenajā zarā mēs salīdzinām avota valodas failu ar pārējām lokalizācijām. Trūkstošie tulkojumi tiek aizpildīti ar AI ģenerētu tekstu, kas ievēro jūsu konfigurēto glosāriju un stila vadlīnijas.
4. Tiek izveidots pull request ar atjauninātiem lokalizācijas failiem. Jūs to pārskatāt un apvienojat. Mēs nekad neapvienojam jūsu vietā.

Tas arī ir viss cikls. Nav tulkošanas informācijas paneļa, kas jāuzrauga. Nav manuālu eksportu. Nav faila formātu žonglēšanas.

Salīdziniet to ar L0 pamācību rakstā Kā 15 minūtēs pievienot i18n Cursor veidotai Next.js lietotnei? — tas pats produkts, cits ieejas ceļš.

Ko darīt, ja tikai daļa UI izmanto tulkošanas izsaukumus?

Tas ir tipisks migrācijas vidusposma stāvoklis: jaunie ekrāni izmanto t(), bet vecākie ekrāni joprojām izlaiž burtiski iekodētu tekstu. Ārpus sinhronizācijas režīma skills darbplūsma uzskata jau ar atslēgām aprīkotos tekstus par nemaināmiem: tā koncentrējas uz vēl neapstrādātajiem burtiskajiem tekstiem un saglabā esošās atslēgas. Komandas, kas izlaiž jaunas versijas katru nedēļu, atrodoties šīs migrācijas pusceļā, ir tipiskais «jauktā L1» lietotājs mūsu datos.

Pilnu aģenta veiktu konvertēšanas stāstu par sarežģītu koka struktūru skatiet Kas notiek, kad AI aģents internacionalizē reālu monorepozitoriju?.

Ko darīt, ja iestatīšanas process tomēr izveidoja visu no jauna?

Mēs pilnveidojam noteikšanas loģiku, lai nepareizais zars neaktivizētos, taču, ja npx skills add globalize-now/globalize-skills jau ir izveidojis 100+ failu izmaiņu kopu, kas pārraksta jūsu lokalizācijas mapi, ievieto pārslēdzēju, ko neprasījāt, vai pārveido maršrutēšanu — nepievienojiet izmaiņas (commit). Izmantojiet atsauksmju logrīku (labajā apakšējā stūrī), norādot savu package.json atkarību sarakstu un īsu piezīmi par to, kā izkārtotas jūsu lokalizācijas mapes; mēs varam manuāli novirzīt repozitoriju uz L1. Drīzumā tiks izlaists pašapkalpošanās --existing-i18n CLI karogs.

Atgūšana jūsu datorā ir git restore . plus, ja nepieciešams, git clean -fd. Nekas netika nosūtīts (push); nekas produkcijā netika salauzts; aģents skāra tikai jūsu lokālo zaru. Pilns apraksts atrodams globalize_skills veica pārāk daudz izmaiņu — kas notika?.

Kāpēc «mēs mēģinājām ieviest i18n un apstājāmies» tagad ir tipisks stāsts?

Tas nav sauklis — tas ir modelis. Trīs neatkarīgas pirmās tikšanās sešu nedēļu laikā, trīs versijas par «jā, mēs to mēģinājām; tagad tas ir šķebīgi». Chrome paplašinājums ar desmitiem tūkstošu lietotāju piedzīvoja korejiešu trafika lēcienu un aktivizēja uz pusi pabeigtu next-intl migrāciju. Ar Lovable veidota lietotne salauza savu būvēšanas procesu, pievienojot daudzvalodu atbalstu, un izmaiņas tika atceltas. Ar «vibe coding» pieeju veidots React + Vite repozitorijs iestrādāja i18next, aizpildīja aptuveni trešdaļu atslēgu un apstājās.

Pilnīgi tīrs L0 kodu repozitorijs, kas meklē bibliotēku, patiešām eksistē, taču tas nav vājā vieta. Vājā vieta ir kodu repozitorijs, kas jau reiz to mēģinājis un kuram tagad neviens negrib uzņemties atbildību par sekām.

L1 režīms pastāv tieši šādam kodu repozitorijam.

Cik tas maksā?

20 € mēnesī. Viens plāns. Iekļauti aptuveni 16 000 vārdu (aptuveni 80 tipiski lietotnes ekrāni). 5 € tulkošanas kredīts, reģistrējoties. Vienalga, vai jums ir L0 un zaļais lauks, vai L1 ar trīs gadu lokalizācijas parādu — cena ir vienāda; mēs mērām caurlaidspēju un automatizāciju, nevis to, cik nekārtīgs bija pirmais commit.

Kurus rakstus un Palīdzības centra dokumentus vajadzētu izlasīt tālāk?

• L0 iestatīšanas pamācība Cursor veidotai Next.js lietotnei
• Monorepozitorija gadījuma izpēte — ko aģents patiešām skāra
• Kāpēc klasiskie TMS rīki cīnās ar mūsdienu Git veidotajiem tehnoloģiju stekiem
• Palīdzības centrs: man jau ir i18n — ko dara globalize.now?
• Palīdzības centrs: globalize_skills veica pārāk daudz izmaiņu

Izlaidiet valodas, kuras jūsu trafiks jau sagaida — pieslēdziet repozitoriju vietnē globalize.now vai izlasiet, kā Git-push automatizācija iederas jūsu esošajā komandas darbplūsmā.