Kodui gimusi produkto kopija: kaip UI tekstas išlieka nuoseklus ir paruoštas lokalizavimui saugykloje

Kodui gimusi produkto kopija reiškia, kad vartotojui matomos eilutės, kurias jūsų produktas išsiunčia, gyvena saugykloje kaip vienintelis tiesos šaltinis, o ne dizaino faile, kurį žmogus rankiniu būdu laiko sinchronizuotą. globalize.now yra kodui gimusi kopijos valdymo sistema su integruotu lokalizavimu: kopija yra vieno šaltinio saugykloje, o jos lokalizavimas yra ta pati operacija, o ne atskiras perdavimas.

Tai dabar svarbu daugiau nei prieš tris metus, nes kopija nustojo keistis tik tada, kai ją keičia rašytojas.

Kas yra kodui gimusi produkto kopija?

Kodui gimusi produkto kopija yra architektūra, o ne rašymo procesas: patvirtinta formuluotė ir išsiųsta formuluotė yra tas pats artefaktas, saugomas saugykloje, ir kiekvienas jo pakeitimas atsiranda kaip skirtumas.

Skirtumą lengviausia matyti iš to, ką kiekvienas metodas gali stebėti. Darbo erdvės įrašo produktas laiko formuluotę kažkur už kodo ribų ir priklauso nuo to, kad kažkas ją įstumtų arba ją atsiimtų, kai juda viena ar kita pusė. Tai gera vieta nuspręsti, ką turėtų sakyti mygtukas. Tai struktūriškai negali pastebėti, kad mygtukas dabar sako ką nors kita, nes įvykis, kuris jį pakeitė, buvo commit ir darbo erdvė niekada nepamatė commit.

Kodui gimusi sistema tai apverčia. Darbo vienetas yra skirtumas, ir klausimas, į kurį ji gali atsakyti, yra tas, kuris iš tikrųjų sutraukia komandas į bėdą: eilutė ką tik pasikeitė — ar tai turėjo nutikti?

Nieko iš to nėra argumentas apie tai, kur vyksta rašymas. Rašytojai gali kurti bet kur. Tai argumentas apie tai, kuri kopija yra tikra, kai dvi nesutinka.

Kas yra kopijos nukrypimas?

Kopijos nukrypimas yra vartotojui matomų tekstų nukrypimas nuo jų patvirtinto šaltinio per paviršius ir laikui bėgant, kai nėra vieno tiesos šaltinio, nuo kurio nukrypti.

Trys nesėkmės supainiojamos viena su kita, ir joms reikalingi skirtingi sprendimai:

• Eilutė, kuri niekada nebuvo suformuota raktais, yra hardcoded eilutė. Ji yra nematoma jūsų katalogui ir vertimui, tačiau formuluotė gali būti visiškai teisinga. Šį šabloną aprašėme kodėl AI kodavimo įrankiai nuolat prideda hardcoded eilutes.
• Katalogai, kurie egzistuoja ir nesinchronizuoja vienas su kitu, yra nesinchronizuoti vertimo failai. Šaltinis yra gerai; išvestinės kopijos yra pasenusios.
• Kopijos nukrypimas nėra nei vienas, nei kitas. Eilutė yra suformuota raktais, failai yra sinchronizuoti, ir pati formuluotė pasikeitė be sprendimo — todėl rinkodaros puslapis žada „Pradėti nemokamą bandomąjį laikotarpį‟, nukreipimo puslapis sako „Išbandykite nemokamai‟, o produkto mygtukas rodo „Pradėti‟.

Nukrypimas yra brangus, nes nieks nėra sugadinta. Joks build nepavyksta, joks testas nenueis į raudoną, joks vertimas nėra praleistas. Produktas tiesiog kalba trimis balsais ir niekas negali nukazinti momento, kai tai prasidėjo. Terminą visiškai apibrėžiame kopijos nukrypimas: kas tai yra, kas tai sukelia ir kaip tai išvengti.

Kodėl AI kodavimo agentai sukelia kopijos nukrypimą?

Kodavimo agentai keičia formuluotę, kurios jie nebuvo paprašyti keisti, nes netoliese esančios eilutės perrašymas neatskiriamas nuo komponento tvarkos.

Paprašykite agento pridėti įkrovimo būseną ir jis taip pat gali sutrumpinti etiketę, sakinį-didelėmis raidėmis paversti antraštę arba pakeisti „Prisijungti‟ į „Prisijungti‟ būdamas faile. Kiekvienas redagavimas yra ginčytinas savaime. Nė vienas iš jų nebuvo prašytas, ir nė vienas iš jų nėra pažymėtas kaip kopijos pakeitimas, nes įrankiams tai yra eilutės literalas JSX atribute kaip ir bet kuris kitas.

Bendruomenės atsakas iki šiol buvo taisyklių failas — AGENTS.md, .cursorrules, „UI kopijos politikos‟ blokas iš anksto. Tai padeda, ir verta turėti. Tačiau konvencija nėra patikra. Tai sumažina, kaip dažnai agentas perrašo jūsų kopiją; jis jums nepasako, kada jis tai padarė.

Kur iš tikrųjų gyvena produkto kopija daugumoje komandų?

Keturiose vietose vienu metu, kiekviena su skirtingu savininku ir skirtingu redagavimo keliu.

Yra rinkodaros svetainė, paprastai turėta turinio valdymo sistemoje. Yra nukreipimo puslapis, dažnai prižiūrimas atskirai ir atnaujinamas greičiausiai, nes tai yra dalykas, kuris aktyviai eksperimentuojamas. Yra eilutės produkto viduje, išsidėsčiusios per komponentus. Ir yra lokalės failai, kurie yra žemiau produkto eilučių ir nesinchronizuoti su visais trimis.

Kiekvienas iš tų paviršių gali būti viduje nuoseklus, o produktas kaip visuma nėra. Tai yra tikroji problemos forma, ir todėl šios problemos traktavimas tik kaip produkto kopijos problema yra nepakankamas.

Kaip jūs išlaikote UI kopijos nuoseklumą saugykloje?

Padarykite saugyklą tiesos šaltiniu ir padarykite eilutę peržiūrėtiną vienetą — viskas kita seka iš šių dviejų žingsnių.

Praktikoje tai reiškia tris dalykus. Kiekviena vartotojui matomų eilutė gyvena viename kataloge, o ne įterpta komponentuose. Komponentai nurodo raktą, o ne literalą, todėl ta pati formuluotė negali egzistuoti dviejose vietose ir tyliai nukrypti. Ir katalogo pakeitimas atsiranda skirtume, kur recenzentas jį mato taip, kaip jis mato bet kurį kitą pakeitimą.

Tas paskutinis punktas yra tas, kuris atlieka darbą. Kopijos nuoseklumas paprastai traktuojamas kaip drausmės problema — komanda turi stilistinį vadovą, kažkas turi atsiminti. Kai formuluotė yra skirtume, ji nustoja priklausyti nuo atminties. Jis tampa matomas peržiūros metu, kuris yra vienintelis momentas, kai kas nors patikimai žiūri.

Komandos, kurios siunčiasi su AI kodavimo įrankiais, paprastai tai pasitinka anksčiau ir sunkiau, todėl apie tai rašome kūrėjams ir žmonėms kurie kuria su AI įrankiais konkrečiai.

Kodėl kopijos nuoseklumas ir lokalizavimas yra ta pati problema?

Abu nepavyksta dėl tos pačios priežasties: nėra sutarto šaltinio, su kuriuo būtų nuoseklus arba iš kurio būtų verčiama.

Komanda, kuri negali pasakyti, kuris iš trijų frazavimų yra patvirtintas, taip pat negali teisingai lokalizuoti nė vieno iš jų. Siųskite visus tris vertimui ir gausite tris vertimus, kiekviena kalba, o nuoseklumo nėra dabar padauginta iš jūsų lokalės skaičiaus, o ne sutverta anglų kalba. Tai yra mechanizmas, kuris stovi už daugumą to, kas atrodo kaip bloga vertimo kokybė — šaltinis jau buvo dviprasmiškas.

Paleiskite jį priešinga kryptimi ir abi problemos susilies į vieną. Kai kiekviena eilutė yra vieno šaltinio ir suformuota raktais, vertimas yra išvestinis to katalogo artefaktas. Nėra atskiro projekto su savo tiesos kopija, nes yra tik viena tiesos kopija. Tai yra tai, ką „lokalizavimas integruotas‟ reiškia architektūriškai: ne tai, kad mes taip pat atliekame vertimą, bet kad vertimas yra ta pati operacija, atliekama tame pačiame objekte. Apie tai, kaip šis pertvarkymas įvyko, rašėme ką AI parašytas kodas padarė lokalizavimui.

Ką apie kopiją už produkto ribų?

Tai yra dalis, kurią kategorija neišsprendė, ir mes nepretenduojame priešingai: kopijos standartizavimas per rinkodarą, nukreipimo puslapius ir produktą kaip vieną sistemą yra tai, ką mes kuriame, o ne kažkas, ką galite įjungti šiandien.

Štai kodėl tai neišspręsta. Kiekvienas esamas įrankis šioje erdvėje valdo vieną paviršių. Produkto kopijos įrankiai valdo eilutes programoje. Turinio platformos valdo rinkodaros svetainę. Nė vienas negali matyti kito, todėl frazavimas puslapyje, kuris įgijo vartotoją, ir frazavimas ekrane, kuris juos įtraukia, yra prižiūrimi skirtingų žmonių skirtinguose įrankiuose be mechanizmo, kuris kada nors pastebėtų, kad jie nesutinka.

Atsakymo forma seka iš jau aprašytos architektūros. Jei patvirtinta formuluotė gyvena vienoje vietoje ir kiekvienas paviršius ją nurodo pagal raktą, o ne ją pakartoja, tada nukreipimo puslapis ir produkto mygtukas yra ta pati eilutė, ir jos pakeitimas yra vienas sprendimas, o ne trys. Dėl to yra kelrodis globalize.now. Tai dabar tiksliai pavadinti atrodo geriau nei pretendavimas, kad jis jau siunčiasi.

Kuo tai skiriasi nuo kopijos įrankio, pastatyto ant dizaino failo?

Skirtumas yra architektūrinis, o ne kategorinis — abu yra kopijos valdymo sistemos, ir jie nesutinka apie tai, kur gyvena tiesa.

Du pastebėjimai, kurie verta daryti su data, nes pardavėjo būsena juda. Nuo 2026-08-29, dittowords.com/llms.txt grąžina 404, o tai reiškia, kad pagrindinė citata šioje kategorijoje neturi mašininio skaitymo objekto failo. Ir tą pačią dieną, Ditto savasis lokalizavimo produkto puslapis aprašo varianto pridėjimą kiekvienai kalbai ir vertimų peržiūrą dizaino metu — jis nepretendavo gaminti vertimus. Tai yra siūlė: įrankis gali turėti formuluotę ir vis tiek perduoti kalbos darbą kam nors kitam.

Mes taip pat nekonkuruojame su vertimo varikliais ar runtime i18n bibliotekomis. Tai yra skirtingi sluoksniai ir jie lieka ten, kur jie yra.