# Open Code Review od Alibaba: instalacja i pierwsza recenzja
> Skonfiguruj model dla Open Code Review, sprawdź zmiany w Git i przejrzyj wyniki. Tryb delegowania korzysta z modelu agenta.
Source: https://ailoot.ai/blog/pl/alibaba-open-code-review/
Canonical: https://ailoot.ai/blog/pl/alibaba-open-code-review/
Language: pl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-187
Revision: sha256-a359f05f77031b9be64486d50b75c915f15a2c0dc3300dc757bed70fccd44313
[Dokumentacja Ailoot: API, klucze i integracja](https://ailoot.ai/docs/).
## Do czego służy Open Code Review
Najważniejsze informacje
Open Code Review, w skrócie OCR, to narzędzie wiersza poleceń do przeglądania kodu. Odczytuje zmiany w Git, wysyła pliki do skonfigurowanego modelu językowego i zwraca komentarze przypisane do konkretnych wierszy. To dodatkowa recenzja, a nie dowód, że kod nie zawiera błędów.
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”](https://ailoot.ai/blog/pl/ai-agent-says-done/) 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.
```bash
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:
```bash
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:
```bash
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:
```bash
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:
```bash
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:
```bash
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](https://ailoot.ai/blog/pl/codex-skills/); jeśli korzystasz z innego obsługiwanego narzędzia, przeczytaj [wprowadzenie do Kimi Code](https://ailoot.ai/blog/pl/kimi-code-install/). 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ć.
### Źródła
- [Oficjalna dokumentacja](https://raw.githubusercontent.com/alibaba/open-code-review/486022daaf14f7142275eddb9b3cacc3cc5dadfa/README.md)
Jeśli potrzebujesz dostępu do modeli AI przez Ailoot, zajrzyj na stronę [Ailoot](https://ailoot.ai/).
## Pytania i odpowiedzi
### Czy raport OCR bez uwag dowodzi poprawności kodu?
Nie. Sprawdź, czy faktycznie przejrzano zamierzone zmiany Git, i zachowaj testy funkcjonalne oraz kontroli dostępu. Dla każdego zgłoszonego problemu obejrzyj wskazany wiersz i odtwórz błąd; fałszywe alarmy zapisuj osobno.
### Czy tryb delegowania sprawia, że przegląd jest bezpłatny?
Nie. Unika osobnej konfiguracji modelu OCR, przekazując analizę podłączonemu agentowi, którego własne warunki płatności i limity nadal obowiązują. Polecenia podglądu i reguł przygotowują przekazanie; nie są ukończonym przeglądem.
## Ailoot · Firma i jej portfel projektów
Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.
Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.
Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.