Alibabas Open Code Review: installasjon og din første gjennomgang

Ailoot-dokumentasjon: API, nøkler og integrasjon.

Hva gjør Open Code Review?#

Prosjektet er publisert i Alibabas offisielle repository under Apache-2.0-lisensen. I README-filen beskriver utviklerne hvordan de kombinerer programmatisk filvalg og regler med en agent som analyserer koden. Det finnes også ocr scan for hele filer når det ikke finnes en meningsfull diff – et sett med Git-endringer.

Start med din første gjennomgang, og vurder kommentarene til din egen kode. Hvor mange token du sparer i prosjektet ditt, er ikke målt her. Hvorfor det er nyttig å kontrollere en agents resultater separat, forklares i artikkelen om falske påstander om at noe er «ferdig».

Klargjør repositoryet og installer OCR#

Du trenger Git 2.41 eller nyere og npm for denne installasjonsmetoden. Start med et test-repository som ikke inneholder hemmeligheter. Agenten kan lese hele filer og søke i kodebasen, og arbeidskatalogmodus omfatter også filer som ikke er sporet. Kontroller hele repositoryet, inkludert nye filer: Det må ikke inneholde nøkler eller data som ikke kan sendes til modellen du har valgt.

git --version
npm install -g @alibaba-group/open-code-review

Etter installasjonen er kommandoen ocr tilgjengelig. Kontroller installasjonsalternativene og selve pakken mot den offisielle README-filen, ikke mot en tilfeldig pakke med lignende navn.

Konfigurer modellen og gjennomfør en gjennomgang#

Kjør følgende i terminalen:

ocr config provider
ocr config model

Det interaktive grensesnittet ber deg velge en leverandør, oppgi en API-nøkkel og konfigurere modellen. Deretter kontrolleres tilkoblingen. Oppgi nøkkelen i det angitte grensesnittet, ikke i prosjektfiler eller commit-meldinger. Finn ut hvordan leverandøren du har valgt, beregner kostnader før du gjennomfører en gjennomgang: OCRs gratis lisens betyr ikke at modellkall er gratis.

Gå til prosjektkatalogen og gjennomfør en gjennomgang. Erstatt your-project med stien til prosjektet ditt:

cd your-project
ocr review

I denne modusen kontrollerer ocr review endringer som er staged, ikke-staged og nye filer som ikke er sporet. For å lagre kommentarene som JSON kan du bruke:

ocr review --format json --output result.json

Ikke legg rapporten automatisk til i en commit: Kontroller først at den ikke inneholder sensitiv kode eller data. Det finnes en egen kommando for å gjennomgå alle filer i en katalog, uavhengig av endringer:

ocr scan --path internal/agent

internal/agent er et eksempel fra README-filen; erstatt det med en eksisterende sti i prosjektet ditt. Begynn med en liten katalog for å vurdere hvor nyttige kommentarene er og hva den faktiske kostnaden blir, før du skanner alt.

Slik vurderer du om en gjennomgang er nyttig#

Åpne hver kommentar, finn linjen og kontroller om problemet kan gjenskapes. Bekreft rettingen med en test, og før falske positiver separat. At du ikke får noen kommentarer, erstatter ikke funksjonstester og kontroller av tilgangsstyring.

I sammenligningen sin påpeker utviklerne i README-filen at OCR oppdager en mindre andel problemer enn agenter for generelle formål. Dette er utviklernes påstand under betingelsene for studien deres, ikke en måling av kvaliteten på prosjektet ditt. Det er ikke gjort noen uavhengig måling av OCRs nøyaktighet her.

Hvordan skiller delegering seg ut?#

Normal modus bruker modellen som er konfigurert i OCR. I delegeringsmodus velger OCR filer og fastsetter regler, mens AI-agenten din gjennomgår koden med sin egen modell. I denne modusen kreves det ikke en separat modellkonfigurasjon eller API-nøkkel for OCR.

Klargjøringskommandoer fra README-filen:

ocr delegate preview
ocr delegate rule src/main.go src/handler.go

Erstatt stiene med dine egne. Etter disse kommandoene overfører du analysen til den tilkoblede agenten: Å klargjøre filer er ikke det samme som å gjennomføre en kodegjennomgang. Betalingsvilkårene og grensene for agenten gjelder fortsatt, så «ingen separat nøkkel kreves» betyr ikke «gratis gjennomgang».

Repositoryet beskriver integrasjoner med Claude Code, Codex og andre agenter. Hvis du bruker Codex, bør du først sette deg inn i hvordan Codex-ferdigheter fungerer; for et annet støttet verktøy finnes det en introduksjon til Kimi Code. Koble til integrasjonen etter at du har forstått den vanlige rapporten, ikke i stedet for å lese den.

Hvis kjøringen ikke gir noe resultat#

Kontroller at den nødvendige Git-versjonen er installert, at du er i riktig prosjektkatalog, og at tilkoblingen til modellen fungerer. Hvis det ikke finnes endringer å gjennomgå, må du ikke kalle et tomt resultat en gjennomgang av hele kodebasen: Bruk scan for hele filer. Ikke innfør automatisk blokkering av commits basert på én ukjent rapport.

Kommandoene ble kontrollert mot den offisielle README-filen ved den fastlåste revisjonen av repositoryet. Det ble ikke gjennomført en betalt kjøring på en brukers prosjekt. Kriteriet for et vellykket første forsøk er tydelige kommentarer som du kan bekrefte eller avvise med begrunnelse.

Hvis du trenger tilgang til AI-modeller gjennom Ailoot, kan du ta en titt på Ailoot.