Diktáld a kódreview-idat a saját nyelveden

A fejlesztői eszközök nagy részébe csendben beépült egy feltételezés: a kód angol, tehát a fejlesztő is az. A kulcsszavak angolok. A könyvtárnevek angolok. A hibaüzenetek angolok. És így — szól a gondolatmenet — a fejlesztői diktálás lehet csak angol nyelvű, senkinek sem fog hiányozni semmi.

A kódreview azonnal megtöri ezt a feltételezést. Egy review-megjegyzés nem kód. Egy mondat, amely egy emberhez szól, és nagyon sok csapatban ez az ember ugyanazt az anyanyelvet beszéli, mint te. Egy román csapat román nyelvű megjegyzéseket ír egy Rust-szolgáltatás angol azonosítóiról. Egy lengyel csapat ugyanezt lengyelül, egy német csapat németül. A kód angol marad; a kódról szóló beszélgetés nem.

A diktálás szokatlanul jó review-megjegyzésekhez, mert a review olvasási tevékenység, a gépelés pedig megszakítja az olvasást. De csak akkor jó, ha azon a nyelven működik, amelyen a megjegyzés valójában íródik. Ez a bejegyzés arról szól, hogyan lehet ezt működésre bírni: mely nyelveket fedi le a Keebye az eszközön, hogyan viselkedik a nyelvrögzítés, és hol vannak a peremek. Ha az érvelés érdekel, hogy mindez miért számít, azt a fejlesztői diktálás ne legyen csak angol nyelvű írás tartalmazza; ez a gyakorlati folytatás.

Miért a review-megjegyzés az ideális diktálási cél

Egy review-megjegyzésnek három olyan tulajdonsága van, amitől jobban illik a hanghoz, mint szinte bármely más fejlesztői szöveg.

Rövid. A megjegyzések többsége egy-három mondat. Az egy lélegzet, egy gyorsbillentyű-nyomás, egy megnyilatkozás.

Próza. Egy szigorú formátumú commit-üzenettel vagy egy pontos szintaxisú konfigurációs fájllal ellentétben a review-megjegyzés egyszerűen az, ahogy hangosan elmagyaráznád a problémát. „Ez örökké újrapróbálkozik, ha a socket sosem válaszol; korlátozd.” A kimondott és a begépelt változat szinte azonos.

Akkor történik, amikor a szemed el van foglalva. Egy diffet olvasol. Abban a pillanatban, amikor megállsz gépelni, elveszíted benne a helyedet. A diktálás lehetővé teszi, hogy tovább olvass, és a megjegyzést belemondd abba a beviteli mezőbe, amelybe már belekattintottál.

Most add hozzá a nyelvi dimenziót. Ha a csapatod lengyelül review-zik, egy csak angolul tudó diktálóeszköz választásra kényszerít: review angolul (természetellenes, és a kollégáid talán lassabban olvassák), vagy gépelés (elvész az előny). Egyik sem az, amit akartál.

Mit támogat valójában a Keebye

Két, eszközön futó motor számít itt, és érdemes pontosan fogalmazni róluk.

Az alapértelmezett motor angolra van hangolva. Gyors, ezt használja a legtöbb ember, és nem ez az, amit egy lengyel review-megjegyzéshez akarsz. Nem angol beszédre irányítva fonetikailag hihető angolt fog előállítani, amely nem az, amit mondtál.

A második motor, a Canary, pontosan 25 nyelvet fed le: bolgár, horvát, cseh, dán, holland, angol, észt, finn, francia, német, görög, magyar, olasz, lett, litván, máltai, lengyel, portugál, román, orosz, szlovák, szlovén, spanyol, svéd és ukrán. Külön be kell kapcsolni, egyszer letöltődik, és utána a Keebye minden más részéhez hasonlóan offline fut. Nem száz nyelv: huszonöt, felsorolva — és ha a tiéd nincs a listán, ez a bejegyzés egyelőre nem tud segíteni.

Van arra is lehetőség, hogy az Apple natív beszédfelismerése legyen a motor, amely a saját nyelvi lefedettségét hozza a Macedre. Az külön út, más jellemzőkkel; a bejegyzés többi része a Canaryről szól.

Rögzítsd a nyelvet, ne hagyd találgatni

A nem angol nyelvű review egyetlen legfontosabb beállítása a nyelvrögzítés.

Az automatikus felismerés jó alapértelmezésnek hangzik, és fejlesztőknél rossz. A review-megjegyzések sűrűn tele vannak angol azonosítókkal: függvénynevek, csomagnevek, a „null”, az „async” és a „callback” szó. Egy nyolcvan százalékban román és húsz százalékban angol tokenekből álló megjegyzés pontosan azt a vegyes jelet adja egy nyelvfelismerőnek, amelyet a legrosszabbul kezel. Vagy mondat közben átvált, vagy úgy dönt, hogy az egész angol volt, és magabiztosan hibás átiratot kapsz. A Rögzítsd a diktálás nyelvét részletesen végigveszi ezt a hibát.

A Canaryvel a Keebye engedi, hogy kifejezetten beállítsd a nyelvet. Rögzítsd a románt, és a modell románul dekódol; a mondatodban lévő angol azonosítókat jövevényszóként kezeli, nem annak bizonyítékaként, hogy nyelvet váltottál. Egy szokatlan azonosító felismerése továbbra sem lesz tökéletes, de maga a nyelv többé nem pénzfeldobás.

Egy viselkedésbeli részlet, amit érdemes tudni: a rögzített nyelvet a rendszer a következő megnyilatkozáshoz olvassa be. Ha átállítod, a most következő diktálás már azt használja; az, amelyet már elengedtél, nem íródik át újra. A gyakorlatban ez annyit tesz: előbb válts, aztán beszélj. Ha a napod során két nyelven review-zol, a váltás olcsó. A menüsor tálcája 11 nyelvet kínál gyorsváltáshoz, a Beállításokban pedig mind a 25 elérhető.

Egy diktált review-munkamenet

Így néz ki egy munkamenet egy olyan csapatnál, amely románul review-zik.

Megnyitod a pull requestet. A tálcán már ott van a tegnapról rögzített román, tehát nincs teendő. Elolvasod az első fájlt. A harmadik hunkban egy retry-hurok korlát nélkül. Belekattintasz a megjegyzésmezőbe, nyomva tartod a jobb Commandot, elmondod a megjegyzést románul, elengeded. A szöveg megérkezik, a „hm” és egy elrontott kezdés a szabályalapú tisztításnak köszönhetően eltűnik, a reconnectSocket azonosító pedig épségben megmarad, mert egy hete felvetted az egyéni szótárba.

Következő fájl. A megjegyzés, amelyet hagyni akarsz, kódjavaslat, nem próza. Azt begépeled; egy diffet diktálni bármely nyelven kellemetlen élmény.

Később bekapcsolódik a szálba egy másik csapat hozzájárulója, és angolul ír. Angolul akarsz válaszolni. Rákattintasz a tálcára, kiválasztod az angolt a rövid listáról, és a következő megnyilatkozás angolként dekódolódik. Válaszolsz, aztán visszaváltasz.

Ehhez semmihez nem kell ablak. A Keebye a menüsorban marad; a gyorsbillentyű abban az appban működik, amelyik fókuszban van — legyen az egy böngészőfül a review-val, egy asztali Git-kliens vagy egy terminál, amelyben CLI-s review-eszköz fut.

Őszinte korlátok

Huszonöt nyelv, nem az összes. Ha törökül, japánul, arabul vagy a Canary-listán kívüli bármely nyelven review-zol, a második motor nem fedi le. Az Apple natív motorja talán igen, a rendszered nyelvi támogatásától függően, de az másik motor, más viselkedéssel.

A tálca rövid listája tizenegy elemű. Az angol, a román, a francia, a német, a spanyol, az olasz, a portugál, a holland, a lengyel, az orosz és az ukrán két kattintásra van. A másik tizennégy a Beállításokban. Ha a napi párosod mondjuk a csehet és a finnt tartalmazza, annak az egyik fele a Beállításokon át vezet.

Az azonosítók továbbra is azonosítók. Bármely nyelv beszédmodellje küzd a snake_case_names típusú nevekkel. A szótár segít a visszatérőknél; a többit kézzel javítod. Olvasd el a megjegyzést, mielőtt elküldöd.

Nincs élő átirat. A Canary a billentyű elengedésekor, egyetlen batchben ír át. Nem fogod látni a szavakat, ahogy kimondod őket. Egy egy-három mondatos review-megjegyzésnél ez alig érzékelhető.

A csiszolás opcionális, és alapból szó szerinti. Ha bekapcsolod az eszközön futó lokális LLM-es csiszolást, az rendezi a mondatszerkezetet, és egy hűségőr visszaesik a nyers átiratra, ha a kimenet súlyos tokenvesztést, felduzzadást vagy ismétlést mutat. Ez az őr heurisztika; nem ellenőrzi, hogy a jelentésed túlélte-e. Review-megjegyzéseknél, ahol egy megfordított tagadás megváltoztatja az ítéletet, a legtöbben kikapcsolva hagyják a csiszolást, és hagyják, hogy a szabályalapú tisztítás végezze a munkát.

Hova illeszkedik ez

Ha a nyelvrögzítés az a funkció, amely a legjobban érdekel, a Keebye vs Wispr Flow összeveti a kettőt abban, hol fut a beszédfelismerés és hogyan kezelik a nyelvet — azt is elmondva, hol illik jobban a Wispr Flow. A tágabb esethez, amikor a kezed a diffen van, a fejlesztői útmutató veszi végig a mindennapokat, a Mac-útmutató pedig a beállítást.

Az a feltételezés, hogy a fejlesztők csak angolul tudnak, soha nem volt igaz. Csak kényelmes volt az eszközöknek. A saját nyelveden review-zni, hanggal, olyan beszédfelismeléssel, amely soha nem hagyja el a gépedet, nem niche kérés. Ezt tenné a szoftvert író emberek nagy hányada, ha az eszközök engednék.