Alibaba’s Open Code Review: installatie en je eerste review

Ailoot-documentatie: API, sleutels en integratie.

Wat doet Open Code Review?#

Het project is gepubliceerd in de officiële repository van Alibaba onder de Apache-2.0-licentie. In de README beschrijven de ontwikkelaars hoe ze programmatische bestandsselectie en regels combineren met een agent die de code analyseert. Er is ook ocr scan voor volledige bestanden wanneer er geen betekenisvolle diff is: een reeks Git-wijzigingen.

Begin met je eerste review en beoordeel de opmerkingen over je eigen code. De tokenbesparing in je project is hier niet gemeten. Waarom het nuttig is om de resultaten van een agent afzonderlijk te controleren, wordt uitgelegd in het artikel over valse claims dat iets “klaar” is.

De repository voorbereiden en OCR installeren#

Voor deze installatiemethode heb je Git 2.41 of hoger en npm nodig. Begin met een testrepository die geen geheimen bevat. De agent kan volledige bestanden lezen en in de codebase zoeken; de werkmapmodus omvat ook niet-gevolgde bestanden. Controleer de hele repository, inclusief nieuwe bestanden: deze mag geen sleutels of gegevens bevatten die niet naar het door jou gekozen model mogen worden gestuurd.

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

Na de installatie is de opdracht ocr beschikbaar. Controleer de installatieopties en het pakket zelf aan de hand van de officiële README, en niet aan de hand van een willekeurig pakket met een vergelijkbare naam.

Het model configureren en een review uitvoeren#

Voer in de terminal het volgende uit:

ocr config provider
ocr config model

De interactieve interface vraagt je een provider te kiezen, een API-sleutel in te voeren en het model te configureren. Daarna wordt de verbinding gecontroleerd. Voer de sleutel in via de daarvoor bestemde interface, niet in projectbestanden of commitberichten. Zoek voordat je een review uitvoert uit hoe je gekozen provider kosten berekent: de gratis licentie van OCR betekent niet dat modelaanroepen gratis zijn.

Ga naar de map van je project en voer een review uit. Vervang your-project door het pad naar je project:

cd your-project
ocr review

In deze modus controleert ocr review gestagede, niet-gestagede en nieuwe niet-gevolgde wijzigingen. Gebruik het volgende om de opmerkingen als JSON op te slaan:

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

Voeg het rapport niet automatisch aan een commit toe: controleer eerst of het geen gevoelige code of gegevens bevat. Er is een aparte opdracht om alle bestanden in een map te beoordelen, ongeacht de wijzigingen:

ocr scan --path internal/agent

internal/agent is een voorbeeld uit de README; vervang het door een bestaand pad in je project. Begin met een kleine map om te beoordelen hoe nuttig de opmerkingen zijn en wat de daadwerkelijke kosten zijn voordat je alles scant.

Hoe bepaal je of een review nuttig is?#

Open elke opmerking, zoek de regel op en controleer of je het probleem kunt reproduceren. Bevestig de oplossing met een test en houd foutpositieven apart bij. Geen opmerkingen krijgen vervangt geen functionele tests en controles van toegangsrechten.

In hun vergelijking merken de ontwikkelaars in de README op dat OCR een kleiner deel van de problemen detecteert dan agents voor algemene doeleinden. Dit is een claim van de ontwikkelaars onder de omstandigheden van hun onderzoek, geen meting van de kwaliteit van jouw project. De nauwkeurigheid van OCR is hier niet onafhankelijk gemeten.

Wat is het verschil bij delegatie?#

In de normale modus gebruikt OCR het geconfigureerde model. In de delegatiemodus selecteert OCR bestanden en bepaalt het de regels, terwijl je AI-agent de code beoordeelt met zijn eigen model. In deze modus is geen afzonderlijke modelconfiguratie of API-sleutel voor OCR nodig.

Voorbereidingsopdrachten uit de README:

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

Vervang de paden door je eigen paden. Draag de analyse na deze opdrachten over aan de gekoppelde agent: bestanden voorbereiden is nog geen codebeoordeling. De betalingsvoorwaarden en limieten van die agent blijven gelden, dus “geen afzonderlijke sleutel nodig” betekent niet “gratis beoordeling”.

De repository beschrijft integraties met Claude Code, Codex en andere agents. Als je Codex gebruikt, lees dan eerst hoe Codex-vaardigheden werken; voor een ander ondersteund hulpmiddel is er een introductie tot Kimi Code. Koppel de integratie pas nadat je het normale rapport begrijpt, en gebruik deze niet als vervanging voor het lezen ervan.

Als de uitvoering geen resultaat oplevert#

Controleer of de vereiste Git-versie is geïnstalleerd, of je in de juiste projectmap staat en of de verbinding met het model werkt. Als er geen wijzigingen zijn om te beoordelen, noem een leeg resultaat dan geen beoordeling van de volledige codebase: voor volledige bestanden gebruik je scan. Blokkeer commits niet automatisch op basis van één onbekend rapport.

De opdrachten zijn gecontroleerd aan de hand van de officiële README bij de vastgelegde revisie van de repository. Er is geen betaalde uitvoering op een project van een gebruiker gedaan. Het criterium voor een geslaagde eerste poging is dat de opmerkingen duidelijk zijn en dat je ze met onderbouwing kunt bevestigen of afwijzen.

Als je via Ailoot toegang tot AI-modellen nodig hebt, neem dan een kijkje bij Ailoot.