Open Code Review od Alibaba: instalacja i pierwsza recenzja

Dokumentacja Ailoot: API, klucze i integracja.

Do czego służy Open Code Review#

Projekt jest opublikowany w oficjalnym repozytorium Alibaba na licencji Apache-2.0. W README twórcy opisują połączenie programistycznego wyboru plików i reguł z agentem, który analizuje kod. Dostępne jest też ocr scan, służące do sprawdzania całych plików, gdy nie ma znaczącego diffu — zestawu zmian w Git.

Zacznij od pierwszej recenzji i oceń komentarze dotyczące własnego kodu. Oszczędności tokenów w Twoim projekcie nie zostały tutaj zmierzone. W artykule o fałszywych deklaracjach „gotowe” wyjaśniono, dlaczego warto osobno sprawdzać wyniki agenta.

Przygotuj repozytorium i zainstaluj OCR#

Ta metoda instalacji wymaga Git w wersji 2.41 lub nowszej oraz npm. Zacznij od testowego repozytorium, które nie zawiera sekretów. Agent może odczytywać całe pliki i przeszukiwać bazę kodu, a tryb katalogu roboczego obejmuje także pliki nieśledzone. Sprawdź całe repozytorium, w tym nowe pliki: nie mogą zawierać kluczy ani danych, których nie można wysłać do wybranego modelu.

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

Po instalacji dostępne jest polecenie ocr. Sprawdź sposób instalacji i sam pakiet w oficjalnym README, zamiast korzystać z przypadkowego pakietu o podobnej nazwie.

Skonfiguruj model i uruchom recenzję#

W terminalu uruchom:

ocr config provider
ocr config model

Interfejs interaktywny poprosi o wybór dostawcy, podanie klucza API i skonfigurowanie modelu, a następnie sprawdzi połączenie. Wprowadź klucz w wyznaczonym interfejsie, a nie w plikach projektu ani w wiadomościach commitów. Przed uruchomieniem recenzji sprawdź, jak rozlicza się wybrany dostawca: bezpłatna licencja OCR nie oznacza, że wywołania modelu są bezpłatne.

Przejdź do katalogu projektu i uruchom recenzję. Zastąp your-project ścieżką do projektu:

cd your-project
ocr review

W tym trybie ocr review sprawdza zmiany przygotowane do commita, nieprzygotowane do commita oraz nowe, nieśledzone. Aby zapisać komentarze w formacie JSON, użyj:

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

Nie dodawaj raportu automatycznie do commita. Najpierw sprawdź, czy nie zawiera wrażliwego kodu lub danych. Do przeglądania całych plików w katalogu, niezależnie od wprowadzonych zmian, służy osobne polecenie:

ocr scan --path internal/agent

internal/agent to przykład z README; zastąp go istniejącą ścieżką w swoim projekcie. Zanim przeskanujesz wszystko, zacznij od małego katalogu, aby ocenić przydatność komentarzy i rzeczywisty koszt.

Jak ocenić, czy recenzja jest przydatna#

Otwórz każdy komentarz, znajdź wskazany wiersz i sprawdź, czy problem da się odtworzyć. Potwierdź poprawkę testem, a fałszywe alarmy zapisuj osobno. Brak komentarzy nie zastępuje testów funkcjonalnych ani kontroli dostępu.

W porównaniu opisanym w README twórcy zauważają, że OCR wykrywa mniejszy odsetek problemów niż agenci ogólnego przeznaczenia. To twierdzenie twórców w warunkach ich badania, a nie pomiar jakości Twojego projektu. Nie przeprowadzono tu niezależnego pomiaru dokładności OCR.

Czym różni się delegowanie#

W trybie zwykłym używany jest model skonfigurowany w OCR. W trybie delegowania OCR wybiera pliki i ustala reguły, a Twój agent AI przegląda kod przy użyciu własnego modelu. W tym trybie nie jest potrzebna osobna konfiguracja modelu ani klucz API dla OCR.

Polecenia przygotowawcze z README:

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

Zastąp ścieżki własnymi. Po wykonaniu tych poleceń przekaż analizę podłączonemu agentowi: przygotowanie plików nie jest jeszcze przeglądem kodu. Nadal obowiązują warunki płatności i limity agenta, więc „nie potrzeba osobnego klucza” nie oznacza „bezpłatna recenzja”.

Repozytorium opisuje integracje z Claude Code, Codex i innymi agentami. Jeśli używasz Codex, najpierw zapoznaj się z działaniem umiejętności Codex; jeśli korzystasz z innego obsługiwanego narzędzia, przeczytaj wprowadzenie do Kimi Code. Podłącz integrację, gdy zrozumiesz już zwykły raport, a nie zamiast jego przeczytania.

Gdy uruchomienie nie zwraca wyniku#

Sprawdź, czy zainstalowano wymaganą wersję Git, czy jesteś we właściwym katalogu projektu i czy połączenie z modelem działa. Jeśli nie ma zmian do sprawdzenia, nie nazywaj pustego wyniku recenzją całej bazy kodu: do sprawdzania całych plików służy scan. Nie blokuj automatycznie commitów na podstawie jednego, nieznanego Ci raportu.

Polecenia sprawdzono na podstawie oficjalnego README z przypiętej rewizji repozytorium. Nie przeprowadzono płatnego uruchomienia na projekcie użytkownika. Kryterium udanej pierwszej próby są jasne komentarze, które możesz uzasadnioną argumentacją potwierdzić albo odrzucić.

Jeśli potrzebujesz dostępu do modeli AI przez Ailoot, zajrzyj na stronę Ailoot.