Dicta les revisions de codi en la teva llengua

Hi ha una assumpció silenciosa cuita dins de gairebé tot l'utillatge per a desenvolupadors: el codi és en anglès, o sigui que el desenvolupador també ho ha de ser. Les paraules clau són angleses. Els noms de les biblioteques són anglesos. Els missatges d'error són anglesos. I per tant, segueix el raonament, el dictat per a desenvolupadors pot ser només en anglès i ningú no s'hi queixarà.

La revisió de codi trenca aquesta assumpció immediatament. Un comentari de revisió no és codi. És una frase adreçada a una persona, i en moltíssims equips aquella persona comparteix la teva primera llengua. Un equip romanès que revisa un servei en Rust escriu comentaris en romanès sobre identificadors anglesos. Un equip polonès fa el mateix en polonès, un d'alemany en alemany. El codi es queda en anglès; la conversa sobre el codi, no.

El dictat és insòlitament bo per als comentaris de revisió, perquè revisar és una activitat de lectura i escriure interromp la lectura. Però només és bo si funciona en la llengua en què el comentari realment és. Aquest article va de fer que això funcioni: quines llengües cobreix el Keebye on-device, com es comporta la fixació de llengua i on són les vores. Si vols l'argument de per què tot això importa, el dictat no hauria de ser només en anglès el fa; això és el seguiment pràctic.

Per què els comentaris de revisió són l'objectiu ideal per al dictat

Un comentari de revisió té tres propietats que el fan encaixar amb la veu millor que gairebé qualsevol altre text de desenvolupament.

És curt. La majoria de comentaris fan d'una a tres frases. Això és un alè, una hotkey mantinguda, una locució.

És prosa. A diferència d'un missatge de commit amb un format rígid o d'un fitxer de configuració amb sintaxi exacta, un comentari de revisió és senzillament com explicaries el problema en veu alta. «Això reintenta per sempre si el socket no respon mai; posa-hi un límit.» Les versions dita i escrita són gairebé idèntiques.

Passa mentre tens els ulls ocupats. Estàs llegint un diff. En el moment que t'atures per escriure, hi perds el fil. Dictar et permet continuar llegint i dir el comentari dins la casella on ja has clicat.

Ara afegeix-hi la dimensió lingüística. Si el teu equip revisa en polonès, una eina de dictat només en anglès et força a triar: revisar en anglès (poc natural, i potser els teus companys ho llegiran més a poc a poc) o escriure (perdent el benefici). Cap de les dues és el que volies.

Què admet realment el Keebye

Aquí importen dos motors on-device, i val la pena ser exacte amb tots dos.

El motor per defecte està afinat per a l'anglès. És ràpid, és el que fa servir més gent i no és el que vols per a un comentari de revisió en polonès. Apuntat cap a parla no anglesa, produirà anglès fonèticament plausible que no és el que has dit.

El segon motor, el Canary, cobreix exactament 25 llengües: alemany, anglès, búlgar, croat, danès, eslovac, eslovè, espanyol, estonià, finès, francès, grec, hongarès, italià, letó, lituà, maltès, neerlandès, polonès, portuguès, romanès, rus, suec, txec i ucraïnès. És opcional, es baixa una vegada i després funciona sense connexió com tota la resta del Keebye. No cent llengües; vint-i-cinc, llistades, i si la teva no hi és, aquest article encara no et pot ajudar.

També hi ha l'opció de fer servir el reconeixement de veu natiu d'Apple com a motor, que aporta la seva pròpia cobertura de llengües al teu Mac. Aquest és un camí a part amb característiques diferents; la resta d'aquest article va del Canary.

Fixa la llengua; no deixis que endevini

L'ajust més important per a la revisió no anglesa és la fixació de llengua.

La detecció automàtica sona com el bon valor per defecte i és el dolent per a desenvolupadors. Els comentaris de revisió són densos d'identificadors anglesos: noms de funcions, noms de paquets, les paraules «null» i «async» i «callback». Un comentari que és vuitanta per cent romanès i vint per cent tokens anglesos dona a un detector de llengua exactament el senyal mixt que porta pitjor. O bé bascularà a mitja frase, o bé decidirà que tot plegat era anglès, i obtindràs una transcripció confiadament equivocada. Fixa la llengua del dictat recorre el fracàs amb detall.

Amb el Canary, el Keebye et deixa establir la llengua explícitament. Fixa el romanès i el model descodifica romanès; els identificadors anglesos dins de la teva frase es tracten com a manlleus i no com a prova que has canviat de llengua. El reconeixement d'un identificador poc habitual encara pot ser imperfecte, però la llengua deixa de ser una moneda a l'aire.

Un detall de comportament que val la pena saber: la llengua fixada es llegeix per a la locució següent. Canvia la fixació i el dictat que estàs a punt de fer la fa servir; el que ja has deixat anar no es torna a transcriure. A la pràctica això vol dir: canvia, després parla. Si revises en dues llengües al llarg del dia, el canvi és barat. La safata de la barra de menús exposa una llista curta d'11 llengües per canviar ràpidament, i la configuració exposa les 25.

Una sessió de revisió, dictada

Això és el que sembla una sessió en un equip que revisa en romanès.

Obres la pull request. La safata ja mostra el romanès fixat des d'ahir, o sigui que no cal fer res. Llegeixes el primer fitxer. Tercer bloc, un bucle de reintents sense límit. Cliques a la casella de comentari, mantens la ⌘ dreta, dius el comentari en romanès, deixes anar. El text cau, amb un «um» i una arrencada falsa eliminats per la neteja basada en regles, i l'identificador reconnectSocket intacte perquè el vas afegir al diccionari personalitzat fa una setmana.

Fitxer següent. El comentari que vols deixar és un suggeriment de codi, no prosa. Aquest l'escrius; dictar un diff és una mala experiència en qualsevol llengua.

Més tard, un col·laborador d'un altre equip s'afegeix al fil i escriu en anglès. Vols respondre en anglès. Cliques la safata, tries l'anglès de la llista curta i la locució següent es descodifica com a anglès. Respons i tornes a canviar.

Res d'això necessita una finestra. El Keebye es queda a la barra de menús; la hotkey funciona en l'aplicació que tingui el focus, sigui una pestanya del navegador amb la revisió, un client Git d'escriptori o un terminal amb una eina de revisió per CLI.

Límits sincers

Vint-i-cinc llengües, no totes. Si revises en turc, japonès, àrab o qualsevol llengua fora de la llista del Canary, el segon motor no la cobreix. El motor natiu d'Apple potser sí, segons el suport lingüístic del teu sistema, però és un motor diferent amb un comportament diferent.

La llista curta de la safata és d'onze. L'anglès, el romanès, el francès, l'alemany, l'espanyol, l'italià, el portuguès, el neerlandès, el polonès, el rus i l'ucraïnès són a dos clics. Les altres catorze són a la configuració. Si la teva parella diària inclou, posem, el txec i el finès, un dels dos costats passa per la configuració.

Els identificadors continuen sent identificadors. Un model de veu en qualsevol llengua pateix amb els snake_case_names. El diccionari ajuda amb els recurrents; la resta els arregles a mà. Llegeix el comentari abans de publicar-lo.

Cap transcripció en directe. El Canary transcriu en deixar anar la tecla, com un sol lot. No veuràs les paraules mentre les dius. Per a un comentari de revisió, d'una a tres frases, això gairebé no es nota.

El poliment és opcional i literal per defecte. Si actives el poliment amb un LLM local, endreça l'estructura de les frases i una guarda de fidelitat recorre a la transcripció en brut quan la sortida mostra una pèrdua greu de tokens, una expansió o una repetició. Aquella guarda és una heurística; no comprova que el teu sentit hagi sobreviscut. Per als comentaris de revisió, on una negació invertida canvia el veredicte, la majoria de gent deixa el poliment desactivat i deixa que la neteja basada en regles faci la feina.

On encaixa això

Si la fixació de llengua és la funcionalitat que més t'importa, Keebye vs Wispr Flow compara tots dos en on s'executa la veu i com es tracta la llengua, incloent-hi on encaixa millor el Wispr Flow. Per al cas més ampli de dictar amb les mans al diff, la guia per a desenvolupadors cobreix el dia a dia, i la guia per a Mac cobreix la configuració.

L'assumpció que els desenvolupadors només parlen anglès no va ser mai certa. Simplement era còmoda per a les eines. Revisar en la teva llengua, per veu, amb parla que no surt mai de la teva màquina, no és una petició de nínxol. És el que faria una fracció ben grossa de la gent que escriu programari si l'utillatge els ho deixés fer.