Open Code Review od Alibaba: inštalácia a vaša prvá kontrola

Dokumentácia Ailoot: API, kľúče a integrácia.

Čo robí Open Code Review#

Projekt je zverejnený v oficiálnom repozitári Alibaba pod licenciou Apache-2.0. Vývojári v súbore README opisujú kombináciu programového výberu súborov a pravidiel s agentom, ktorý analyzuje kód. K dispozícii je aj príkaz ocr scan na kontrolu celých súborov, keď neexistuje zmysluplný diff — súbor zmien v Gite.

Začnite prvou kontrolou a posúďte komentáre k vlastnému kódu. Úspora tokenov vo vašom projekte tu nebola meraná. Prečo je užitočné samostatne overovať výsledky agenta, vysvetľuje článok o nepravdivých tvrdeniach, že je „hotovo“.

Príprava repozitára a inštalácia OCR#

Na tento spôsob inštalácie budete potrebovať Git 2.41 alebo novší a npm. Začnite v testovacom repozitári, ktorý neobsahuje žiadne tajné údaje. Agent môže čítať celé súbory a vyhľadávať v kódovej základni; režim pracovného adresára zahŕňa aj nesledované súbory. Skontrolujte celý repozitár vrátane nových súborov: nesmie obsahovať kľúče ani údaje, ktoré nemožno odoslať modelu, ktorý ste si vybrali.

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

Po inštalácii bude dostupný príkaz ocr. Možnosti inštalácie aj samotný balík si overte podľa oficiálneho súboru README, nie podľa náhodného balíka s podobným názvom.

Konfigurácia modelu a spustenie kontroly#

V termináli spustite:

ocr config provider
ocr config model

Interaktívne rozhranie vás vyzve, aby ste vybrali poskytovateľa, zadali kľúč API a nakonfigurovali model; potom skontroluje pripojenie. Kľúč zadajte v určenom rozhraní, nie do súborov projektu ani do správ commitov. Pred spustením kontroly si zistite, ako váš vybraný poskytovateľ účtuje poplatky: bezplatná licencia OCR neznamená, že volania modelu sú bezplatné.

Prejdite do adresára projektu a spustite kontrolu. Nahraďte your-project cestou k svojmu projektu:

cd your-project
ocr review

V tomto režime príkaz ocr review kontroluje pripravené zmeny, nepripravené zmeny a nové nesledované súbory. Komentáre môžete uložiť vo formáte JSON takto:

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

Správu nepridávajte automaticky do commitu: najprv skontrolujte, či neobsahuje citlivý kód alebo údaje. Na kontrolu celých súborov v adresári bez ohľadu na zmeny slúži samostatný príkaz:

ocr scan --path internal/agent

Cesta internal/agent je príklad zo súboru README; nahraďte ju existujúcou cestou vo svojom projekte. Začnite malým adresárom, aby ste posúdili užitočnosť komentárov a skutočné náklady pred kontrolou všetkého.

Ako posúdiť, či je kontrola užitočná#

Otvorte každý komentár, nájdite príslušný riadok a overte, či sa problém dá reprodukovať. Opravu potvrďte testom a falošne pozitívne výsledky zaznamenajte samostatne. To, že kontrola nevytvorí žiadne komentáre, nenahrádza funkčné testy ani kontroly prístupových práv.

Vývojári vo svojom porovnaní uvedenom v súbore README poznamenávajú, že OCR odhalí menší podiel problémov než agenti na všeobecné použitie. Ide o tvrdenie vývojárov za podmienok ich štúdie, nie o meranie kvality vášho projektu. Presnosť OCR tu nebola nezávisle meraná.

V čom sa líši delegovanie#

Bežný režim používa model nakonfigurovaný v OCR. V režime delegation OCR vyberá súbory a určuje pravidlá, zatiaľ čo váš AI agent kontroluje kód pomocou vlastného modelu. V tomto režime nie je potrebná samostatná konfigurácia modelu ani kľúč API pre OCR.

Prípravné príkazy zo súboru README:

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

Nahraďte cesty vlastnými. Po spustení týchto príkazov odovzdajte analýzu pripojenému agentovi: príprava súborov ešte nie je kontrola kódu. Stále platia jeho podmienky a limity účtovania, takže „samostatný kľúč netreba“ neznamená „kontrola je bezplatná“.

Repozitár opisuje integrácie s Claude Code, Codexom a ďalšími agentmi. Ak používate Codex, najprv sa oboznámte s tým, ako fungujú zručnosti Codexu; pre iný podporovaný nástroj je tu úvod do Kimi Code. Integráciu pripojte až potom, čo porozumiete bežnej správe, nie namiesto jej prečítania.

Ak sa po spustení nezobrazí žiadny výsledok#

Skontrolujte, či máte nainštalovanú požadovanú verziu Gitu, či ste v správnom adresári projektu a či funguje pripojenie k modelu. Ak neexistujú žiadne zmeny na kontrolu, nepovažujte prázdny výsledok za kontrolu celej kódovej základne: na kontrolu celých súborov slúži príkaz scan. Nepridávajte automatické blokovanie commitov na základe jedinej správy, s ktorou ešte nemáte skúsenosti.

Príkazy boli overené podľa oficiálneho súboru README pri pripnutej revízii repozitára. V projekte používateľa sa nespustila žiadna platená kontrola. Úspešný prvý pokus znamená, že výsledkom sú jasné komentáre, ktoré ste dokázali odôvodnene potvrdiť alebo odmietnuť.

Ak potrebujete prístup k modelom AI cez Ailoot, pozrite si Ailoot.