# Alibaban Open Code Review: asennus ja ensimmäinen katselmointi
> Määritä malli Open Code Review’lle, tarkista Git-muutokset ja käy tulokset läpi. Delegointitilassa käytetään agenttisi mallia.
Source: https://ailoot.ai/blog/fi/alibaba-open-code-review/
Canonical: https://ailoot.ai/blog/fi/alibaba-open-code-review/
Language: fi
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-187
Revision: sha256-5347071e412643cc0a591efc5bfd4316044520c784f2e6c3d0662f44f5f90373
[Ailoot-dokumentaatio: API, avaimet ja integraatio](https://ailoot.ai/docs/).
## Mitä Open Code Review tekee
Tärkein asia
Open Code Review eli OCR on komentorivityökalu koodin katselmointiin. Se lukee Git-muutokset, lähettää tiedostot määritetylle kielimallille ja palauttaa tiettyihin riveihin liittyviä kommentteja. Se on täydentävä katselmointi, ei todiste siitä, ettei koodissa ole virheitä.
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ä](https://ailoot.ai/blog/fi/ai-agent-says-done/) 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.
```bash
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:
```bash
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:
```bash
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:
```bash
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:
```bash
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:
```bash
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](https://ailoot.ai/blog/fi/codex-skills/); toiselle tuetulle työkalulle on [Kimi Code -esittely](https://ailoot.ai/blog/fi/kimi-code-install/). 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.
### Lähteet
- [Virallinen dokumentaatio](https://raw.githubusercontent.com/alibaba/open-code-review/486022daaf14f7142275eddb9b3cacc3cc5dadfa/README.md)
Jos tarvitset Ailootin kautta pääsyn AI-malleihin, tutustu [Ailootiin](https://ailoot.ai/).
## Kysymyksiä tästä oppaasta: Alibaban Open Code Review: asennus ja ensimmäinen katselmointi
### Todistaako kommentiton OCR-raportti koodin oikeaksi?
Ei. Varmista, että tarkoitetut Git-muutokset todella katselmoitiin, ja säilytä toiminnalliset sekä pääsynhallinnan testit. Tarkista jokaisen raportoidun havainnon viitattu rivi ja toista ongelma. Kirjaa väärät hälytykset erikseen.
### Tekeekö delegointitila katselmoinnista ilmaisen?
Ei. Se välttää erillisen OCR-mallimäärityksen antamalla analyysin yhdistetylle agentillesi, jonka omat maksuehdot ja rajat pätevät yhä. Esikatselu- ja sääntökomennot valmistelevat luovutusta; ne eivät ole valmis katselmointi.
## Ailoot · Yritys ja sen projektisalkku
Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.
Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.
Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.