Blogg

Alibabas Open Code Review: installation och din första granskning

Markdown

Konfigurera en modell för Open Code Review, kontrollera Git-ändringar och granska resultaten. Delegeringsläget använder din agents modell.

Läs hela artikeln

Ailoot-dokumentation: API, nycklar och integration.

Vad Open Code Review gör

Det viktigaste

Open Code Review, eller OCR, är ett kommandoradsverktyg för kodgranskning. Det läser Git-ändringar, skickar filer till den konfigurerade språkmodellen och returnerar kommentarer kopplade till specifika rader. Det är en kompletterande granskning, inte ett bevis på att koden saknar fel.

Projektet publiceras i Alibabas officiella repository under licensen Apache-2.0. I README-filen beskriver utvecklarna hur programmatisk filurval och regler kombineras med en agent som analyserar koden. Det finns också ocr scan för hela filer när det inte finns någon meningsfull diff – en uppsättning Git-ändringar.

Börja med din första granskning och bedöm kommentarerna på din egen kod. Tokenbesparingar i ditt projekt har inte mätts här. Varför det är bra att kontrollera en agents resultat separat förklaras i artikeln om falska påståenden om att något är ”klart”.

Förbered repositoryt och installera OCR

Du behöver Git 2.41 eller senare och npm för den här installationsmetoden. Börja med ett testrepository som inte innehåller några hemligheter. Agenten kan läsa hela filer och söka igenom kodbasen, och läget för arbetskatalogen omfattar även ospårade filer. Kontrollera hela repositoryt, inklusive nya filer: det får inte innehålla nycklar eller data som inte kan skickas till den modell du valt.

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

Efter installationen är kommandot ocr tillgängligt. Kontrollera installationsalternativen och själva paketet mot den officiella README-filen, inte mot ett godtyckligt paket med liknande namn.

Konfigurera modellen och kör en granskning

Kör följande i terminalen:

ocr config provider
ocr config model

Det interaktiva gränssnittet ber dig välja en leverantör, ange en API-nyckel och konfigurera modellen och kontrollerar sedan anslutningen. Ange nyckeln i det avsedda gränssnittet, inte i projektfiler eller commit-meddelanden. Ta reda på hur den valda leverantören tar betalt innan du kör en granskning: OCR:s fria licens innebär inte att modellkörningar är gratis.

Gå till projektkatalogen och kör en granskning. Ersätt your-project med sökvägen till ditt projekt:

cd your-project
ocr review

I det här läget kontrollerar ocr review ändringar som är staged, ostagade och nya ospårade ändringar. Om du vill spara kommentarerna som JSON kan du använda:

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

Lägg inte automatiskt till rapporten i en commit: kontrollera först att den inte innehåller känslig kod eller data. Det finns ett separat kommando för att granska hela filer i en katalog, oavsett ändringar:

ocr scan --path internal/agent

internal/agent är ett exempel från README-filen; ersätt det med en befintlig sökväg i ditt projekt. Börja med en liten katalog för att bedöma hur användbara kommentarerna är och den faktiska kostnaden innan du genomsöker allt.

Så avgör du om en granskning är användbar

Öppna varje kommentar, leta upp raden och kontrollera om problemet går att återskapa. Bekräfta korrigeringen med ett test och notera falska positiva resultat separat. Att det inte finns några kommentarer ersätter inte funktionstester och åtkomstkontroller.

I sin jämförelse noterar utvecklarna i README-filen att OCR upptäcker en mindre andel problem än agenter för allmänna ändamål. Det är utvecklarnas påstående under studiens förutsättningar, inte en mätning av kvaliteten på ditt projekt. Ingen oberoende mätning av OCR:s träffsäkerhet gjordes här.

Hur delegering skiljer sig

Normalläget använder modellen som har konfigurerats i OCR. I delegeringsläget väljer OCR filer och fastställer regler, medan din AI-agent granskar koden med sin egen modell. Separat modellkonfiguration och en API-nyckel för OCR krävs inte i det här läget.

Förberedande kommandon från README-filen:

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

Ersätt sökvägarna med dina egna. När du har kört dessa kommandon lämnar du över analysen till den anslutna agenten: att förbereda filer är ännu inte en kodgranskning. Betalningsvillkor och begränsningar gäller fortfarande, så ”ingen separat nyckel krävs” betyder inte ”gratis granskning”.

Repositoryt beskriver integrationer med Claude Code, Codex och andra agenter. Om du använder Codex bör du först läsa på om hur Codex-färdigheter fungerar; för ett annat verktyg som stöds finns en introduktion till Kimi Code. Anslut integrationen när du förstår den vanliga rapporten, inte i stället för att läsa den.

Om körningen inte ger något resultat

Kontrollera att den version av Git som krävs är installerad, att du befinner dig i rätt projektkatalog och att anslutningen till modellen fungerar. Om det inte finns några ändringar att granska ska du inte kalla ett tomt resultat för en granskning av hela kodbasen: scan används för hela filer. Lägg inte till automatisk blockering av commits baserat på en enda rapport som du inte känner till.

Kommandona kontrollerades mot den officiella README-filen vid den låsta repositoryrevisionen. Ingen betald körning på en användares projekt utfördes. Kriteriet för ett lyckat första försök är tydliga kommentarer som du kunde bekräfta eller avvisa med en motivering.

Om du behöver tillgång till AI-modeller via Ailoot kan du ta en titt på Ailoot.

Fler detaljer

Frågor om den här guiden: Alibabas Open Code Review: installation och din första granskning

Bevisar en OCR-rapport utan kommentarer att koden är korrekt?

Nej. Kontrollera att avsedda Git-ändringar faktiskt granskades och behåll funktions- och åtkomstkontrolltester. Granska hänvisad rad och reproducera varje rapporterat problem; dokumentera falska positiva separat.

Gör delegeringsläget granskningen kostnadsfri?

Nej. Det undviker separat OCR-modellkonfiguration genom att lämna analysen till din anslutna agent, vars egna betalningsvillkor och gränser fortfarande gäller. Förhandsvisnings- och regelkommandona förbereder överlämningen; de är ingen slutförd granskning.

Alla artiklar