Alibaban Open Code Review: asennus ja ensimmäinen katselmointi

Ailoot-dokumentaatio: API, avaimet ja integraatio.

Mitä Open Code Review tekee#

Projekti on julkaistu Alibaban virallisessa repositoriossa Apache-2.0-lisenssillä. README-tiedostossa kehittäjät kuvaavat, miten ohjelmallinen tiedostojen valinta ja säännöt yhdistetään koodia analysoivaan agenttiin. Koko tiedostojen tarkasteluun on myös ocr scan, kun mielekästä diffiä eli Git-muutosten joukkoa ei ole.

Aloita ensimmäisellä katselmoinnilla ja arvioi oman koodisi kommentteja. Tässä ei ole mitattu projektisi token-säästöjä. Artikkelissa ”valmis”-väitteistä selitetään, miksi agentin tulokset kannattaa tarkistaa erikseen.

Valmistele repositorio ja asenna OCR#

Tarvitset tähän asennustapaan Git 2.41:n tai uudemman sekä npm:n. Aloita testirepositoriosta, joka ei sisällä salaisuuksia. Agentti voi lukea kokonaisia tiedostoja ja etsiä koodikannasta, ja työhakemistotila sisältää myös seuraamattomat tiedostot. Tarkista koko repositorio uusine tiedostoineen: siinä ei saa olla avaimia tai tietoja, joita ei voi lähettää valitsemallesi mallille.

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

Asennuksen jälkeen ocr-komento on käytettävissä. Tarkista asennusvaihtoehdot ja paketti itse virallisesta README-tiedostosta, älä satunnaisesta samannimisestä paketista.

Määritä malli ja suorita katselmointi#

Suorita terminaalissa:

ocr config provider
ocr config model

Vuorovaikutteinen käyttöliittymä pyytää valitsemaan palveluntarjoajan, antamaan API-avaimen ja määrittämään mallin, minkä jälkeen se tarkistaa yhteyden. Syötä avain sille tarkoitettuun käyttöliittymään, älä projektitiedostoihin tai commit-viesteihin. Selvitä valitsemasi palveluntarjoajan hinnoittelu ennen katselmoinnin suorittamista: OCR:n maksuton lisenssi ei tarkoita, että mallikutsut olisivat maksuttomia.

Siirry projektihakemistoon ja suorita katselmointi. Korvaa your-project projektisi polulla:

cd your-project
ocr review

Tässä tilassa ocr review tarkistaa staged- ja unstaged-muutokset sekä uudet seuraamattomat muutokset. Voit tallentaa kommentit JSON-muodossa näin:

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

Älä lisää raporttia automaattisesti commitiin: tarkista ensin, ettei se sisällä arkaluonteista koodia tai tietoja. Kokonaisten tiedostojen tarkistamiseen hakemistossa muutoksista riippumatta on erillinen komento:

ocr scan --path internal/agent

internal/agent on README-tiedostosta otettu esimerkki; korvaa se projektissasi olemassa olevalla polulla. Aloita pienestä hakemistosta ja arvioi kommenttien hyödyllisyyttä ja todellisia kustannuksia, ennen kuin skannaat kaiken.

Miten arvioit katselmoinnin hyödyllisyyttä#

Avaa jokainen kommentti, etsi kyseinen rivi ja tarkista, voiko ongelman toistaa. Vahvista korjaus testillä ja kirjaa väärät positiiviset tulokset erikseen. Kommenttien puuttuminen ei korvaa toiminnallisia testejä eikä käyttöoikeustarkistuksia.

Kehittäjät huomauttavat README-tiedostossa vertailunsa yhteydessä, että OCR havaitsee pienemmän osuuden ongelmista kuin yleiskäyttöiset agentit. Tämä on kehittäjien väite heidän tutkimuksensa olosuhteissa, ei mittaus projektisi laadusta. OCR:n tarkkuutta ei mitattu tässä riippumattomasti.

Miten delegointi eroaa#

Tavallinen tila käyttää OCR:ssä määritettyä mallia. Delegointitilassa OCR valitsee tiedostot ja määrittää säännöt, ja AI-agenttisi tarkistaa koodin omalla mallillaan. Tässä tilassa ei tarvita erillistä mallimääritystä eikä OCR:n API-avainta.

README-tiedoston valmistelukomennot:

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

Korvaa polut omillasi. Näiden komentojen jälkeen siirrä analyysi yhdistetylle agentille: tiedostojen valmistelu ei vielä ole koodin katselmointia. Maksuehdot ja rajoitukset ovat silti voimassa, joten ”erillistä avainta ei tarvita” ei tarkoita ”katselmointi on maksuton”.

Repositorio kuvaa Claude Coden, Codexin ja muiden agenttien integraatioita. Jos käytät Codexia, tutustu ensin siihen, miten Codex-taidot toimivat; toiselle tuetulle työkalulle on Kimi Code -esittely. Ota integraatio käyttöön, kun ymmärrät tavallisen raportin, älä sen lukemisen sijasta.

Jos suoritus ei tuota tulosta#

Tarkista, että vaadittu Git-versio on asennettu, olet oikeassa projektihakemistossa ja yhteys malliin toimii. Jos tarkistettavia muutoksia ei ole, älä kutsu tyhjää tulosta koko koodikannan katselmoinniksi: kokonaisia tiedostoja varten käytetään scan-komentoa. Älä estä commiteja automaattisesti yhden ennestään tuntemattoman raportin perusteella.

Komennot tarkistettiin virallista README-tiedostoa vasten kiinnitetyssä repositorioversiossa. Käyttäjän projektissa ei tehty maksullista suoritusta. Ensimmäisen onnistuneen yrityksen kriteerinä ovat selkeät kommentit, jotka pystyit perustellusti vahvistamaan tai hylkäämään.

Jos tarvitset Ailootin kautta pääsyn AI-malleihin, tutustu Ailootiin.