# Alibaba Open Code Review: diegimas ir pirmoji peržiūra

> Nustatykite „Open Code Review“ modelį, patikrinkite „Git“ pakeitimus ir peržiūrėkite rezultatus. Delegavimo režimas naudoja jūsų agento modelį.

Source: https://ailoot.ai/blog/lt/alibaba-open-code-review/
Canonical: https://ailoot.ai/blog/lt/alibaba-open-code-review/
Language: lt
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-187
Revision: sha256-b0ad5af90c7118dad82eaae545b3ef65fc45da99a9273f1f6d6f5223f67a3c8c


[Ailoot dokumentacija: API, raktai ir integracija](https://ailoot.ai/docs/).

## Ką daro Open Code Review

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway for this section">

Pagrindinė mintis

Open Code Review, arba OCR, yra komandinės eilutės įrankis kodui peržiūrėti. Jis nuskaito „Git“ pakeitimus, siunčia failus sukonfigūruotam kalbos modeliui ir pateikia komentarus, susietus su konkrečiomis eilutėmis. Tai papildoma peržiūra, o ne įrodymas, kad kode nėra klaidų.

</div>

Projektas paskelbtas oficialioje „Alibaba“ saugykloje pagal Apache-2.0 licenciją. README faile kūrėjai aprašo programinio failų parinkimo ir taisyklių derinimą su kodą analizuojančiu agentu. Taip pat yra `ocr scan` komanda, skirta visiems failams tikrinti, kai nėra prasmingo diff — „Git“ pakeitimų rinkinio.

Pradėkite nuo pirmosios peržiūros ir įvertinkite komentarus apie savo kodą. Jūsų projekto tokenų sutaupymas čia nebuvo matuotas. Kodėl naudinga atskirai tikrinti agento rezultatus, paaiškinta [straipsnyje apie melagingus teiginius, kad darbas „baigtas“](https://ailoot.ai/blog/lt/ai-agent-says-done/).

## Paruoškite saugyklą ir įdiekite OCR

Šiam diegimo būdui reikės „Git“ 2.41 ar naujesnės versijos ir npm. Pradėkite nuo bandomosios saugyklos, kurioje nėra slaptų duomenų. Agentas gali skaityti visus failus ir ieškoti kodų bazėje, o darbo katalogo režimas taip pat apima nesekamus failus. Patikrinkite visą saugyklą, įskaitant naujus failus: joje neturi būti raktų ar duomenų, kurių negalima siųsti jūsų pasirinktam modeliui.

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

Įdiegus galima naudoti komandą `ocr`. Diegimo parinktis ir patį paketą tikrinkite pagal oficialų README, o ne pagal atsitiktinį panašaus pavadinimo paketą.

## Sukonfigūruokite modelį ir atlikite peržiūrą

Terminale paleiskite:

```bash
ocr config provider
ocr config model
```

Interaktyvioji sąsaja paprašys pasirinkti teikėją, įvesti API raktą ir sukonfigūruoti modelį, tada patikrins ryšį. Raktą įveskite tam skirtoje sąsajoje, o ne projekto failuose ar commit pranešimuose. Prieš atlikdami peržiūrą išsiaiškinkite, kaip apmokestina jūsų pasirinktas teikėjas: nemokama OCR licencija nereiškia, kad modelio užklausos nieko nekainuoja.

Pereikite į projekto katalogą ir atlikite peržiūrą. Pakeiskite `your-project` savo projekto keliu:

```bash
cd your-project
ocr review
```

Šiuo režimu `ocr review` tikrina paruoštus, neparuoštus ir naujus nesekamus pakeitimus. Norėdami išsaugoti komentarus JSON formatu, galite naudoti:

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

Automatiškai nepridėkite ataskaitos prie commit: pirmiausia patikrinkite, ar joje nėra jautraus kodo ar duomenų. Yra atskira komanda visiems katalogo failams peržiūrėti, neatsižvelgiant į pakeitimus:

```bash
ocr scan --path internal/agent
```

`internal/agent` yra pavyzdys iš README; pakeiskite jį esamu savo projekto keliu. Pradėkite nuo mažo katalogo, kad įvertintumėte komentarų naudingumą ir tikrąją kainą prieš tikrindami viską.

## Kaip įvertinti, ar peržiūra naudinga

Atverkite kiekvieną komentarą, raskite atitinkamą eilutę ir patikrinkite, ar problemą galima atkurti. Pataisymą patvirtinkite testu, o klaidingus teigiamus rezultatus registruokite atskirai. Tai, kad komentarų nėra, nepakeičia funkcinių testų ir prieigos kontrolės patikrų.

Palyginime kūrėjai README pažymi, kad OCR aptinka mažesnę dalį problemų nei bendrosios paskirties agentai. Tai kūrėjų teiginys, pateiktas jų tyrimo sąlygomis, o ne jūsų projekto kokybės matas. Nepriklausomas OCR tikslumo matavimas čia nebuvo atliktas.

## Kuo skiriasi delegavimas

Įprastu režimu naudojamas OCR sukonfigūruotas modelis. Delegavimo režimu OCR parenka failus ir nustato taisykles, o jūsų AI agentas peržiūri kodą naudodamas savo modelį. Šiuo režimu nereikia atskirai konfigūruoti modelio ir OCR API rakto.

Paruošimo komandos iš README:

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

Pakeiskite kelius savais. Įvykdę šias komandas, perduokite analizę prijungtam agentui: failų paruošimas dar nėra kodo peržiūra. Jo apmokėjimo sąlygos ir limitai vis tiek galioja, todėl „atskiro rakto nereikia“ nereiškia „peržiūra nemokama“.

Saugykloje aprašytos integracijos su Claude Code, Codex ir kitais agentais. Jei naudojate Codex, pirmiausia susipažinkite su [Codex įgūdžių veikimu](https://ailoot.ai/blog/lt/codex-skills/); apie kitą palaikomą įrankį skaitykite [Kimi Code įvade](https://ailoot.ai/blog/lt/kimi-code-install/). Integraciją prijunkite tada, kai jau suprantate įprastą ataskaitą, o ne užuot ją perskaitę.

## Jei paleidus negaunama jokio rezultato

Patikrinkite, ar įdiegta reikiama „Git“ versija, ar esate tinkamame projekto kataloge ir ar veikia ryšys su modeliu. Jei nėra ką peržiūrėti, tuščio rezultato nevadinkite visos kodų bazės peržiūra: visiems failams naudojama scan komanda. Neįjunkite automatinio commit blokavimo remdamiesi viena nepažįstama ataskaita.

Komandos patikrintos pagal oficialų README, atitinkantį fiksuotą saugyklos reviziją. Mokamas paleidimas naudotojo projekte nebuvo atliktas. Sėkmingo pirmojo bandymo kriterijus — aiškūs komentarai, kuriuos galėjote pagrįstai patvirtinti arba atmesti.

<div class="section" role="doc-bibliography" aria-label="Sources">

### Šaltiniai

- [Oficiali dokumentacija](https://raw.githubusercontent.com/alibaba/open-code-review/486022daaf14f7142275eddb9b3cacc3cc5dadfa/README.md)

</div>



Jei jums reikia prieigos prie AI modelių per Ailoot, apsilankykite [Ailoot](https://ailoot.ai/).

## Klausimai ir atsakymai

### Ar OCR ataskaita be komentarų įrodo, kad kodas teisingas?

Ne. Patikrinkite, ar iš tikrųjų peržiūrėti numatyti Git pakeitimai, ir išlaikykite funkcinius bei prieigos kontrolės testus. Kiekvienai nurodytai problemai peržiūrėkite susietą eilutę ir atkurkite ją; klaidingus teigiamus rezultatus fiksuokite atskirai.

### Ar delegavimo režimas padaro peržiūrą nemokamą?

Ne. Jis leidžia išvengti atskiros OCR modelio konfigūracijos, analizę perduodamas prijungtam agentui, kuriam vis tiek taikomos jo mokėjimo sąlygos ir limitai. Peržiūros bei taisyklių komandos paruošia perdavimą; jos nėra užbaigta peržiūra.


## Ailoot · Įmonė ir jos projektų portfelis

Ailoot remiasi sukaupta veiklos patirtimi, plačia klientų baze, stabiliomis paslaugomis ir nuolatine KPI kontrole.

Įmonė ir jos projektų portfelis: milijonai klientų; mėnesio pardavimai siekia milijardus.

Ailoot šią veiklos patirtį pritaiko teikdama API prieigą prie DI funkcijų klientų produktuose, agentuose, programose ir automatizavimo sprendimuose.