# Alibaba Open Code Review: instalace a první kontrola
> Nastavte model pro Open Code Review, zkontrolujte změny v Gitu a projděte si výsledky. Režim delegování používá model vašeho agenta.
Source: https://ailoot.ai/blog/cs/alibaba-open-code-review/
Canonical: https://ailoot.ai/blog/cs/alibaba-open-code-review/
Language: cs
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-187
Revision: sha256-135567517e847eff9e1c24d7d8a47dc84217749f80ba13aa4e90614c8564b871
[Dokumentace Ailoot: API, klíče a integrace](https://ailoot.ai/docs/).
## Co dělá Alibaba Open Code Review?
Hlavní poznatek
Open Code Review neboli OCR je nástroj příkazového řádku pro kontrolu kódu. Čte změny v Gitu, odesílá soubory nakonfigurovanému jazykovému modelu a vrací komentáře navázané na konkrétní řádky. Jde o doplňkovou kontrolu, nikoli o důkaz, že kód neobsahuje chyby.
Projekt je zveřejněn v oficiálním repozitáři Alibaba pod licencí Apache-2.0. Vývojáři v souboru README popisují kombinaci programového výběru souborů a pravidel s agentem, který kód analyzuje. K dispozici je také `ocr scan` pro celé soubory, když není k dispozici smysluplný diff – sada změn v Gitu.
Začněte první kontrolou a sami posuďte komentáře k vlastnímu kódu. Úspora tokenů na vašem projektu zde nebyla měřena. V [článku o nepravdivých tvrzeních „hotovo“](https://ailoot.ai/blog/cs/ai-agent-says-done/) se vysvětluje, proč je užitečné výsledky agenta kontrolovat samostatně.
## Připravte repozitář a nainstalujte OCR
Pro tento způsob instalace budete potřebovat Git 2.41 nebo novější a npm. Začněte v testovacím repozitáři, který neobsahuje žádná tajemství. Agent může číst celé soubory a prohledávat kódovou základnu; režim pracovního adresáře zahrnuje také nesledované soubory. Zkontrolujte celý repozitář včetně nových souborů: nesmí obsahovat klíče ani data, která nelze odeslat vámi zvolenému modelu.
```bash
git --version
npm install -g @alibaba-group/open-code-review
```
Po instalaci bude k dispozici příkaz `ocr`. Možnosti instalace i samotný balíček ověřte podle oficiálního souboru README, nikoli podle náhodného balíčku s podobným názvem.
## Nakonfigurujte model a spusťte kontrolu
V terminálu spusťte:
```bash
ocr config provider
ocr config model
```
Interaktivní rozhraní vás vyzve k výběru poskytovatele, zadání API klíče a nastavení modelu a poté ověří připojení. Klíč zadejte do určeného rozhraní, nikoli do souborů projektu nebo zpráv commitů. Před spuštěním kontroly zjistěte, jak váš vybraný poskytovatel účtuje: bezplatná licence OCR neznamená, že jsou bezplatná volání modelu.
Přejděte do adresáře svého projektu a spusťte kontrolu. Nahraďte `your-project` cestou k projektu:
```bash
cd your-project
ocr review
```
V tomto režimu `ocr review` kontroluje připravené, nepřipravené i nově přidané nesledované změny. Chcete-li komentáře uložit jako JSON, můžete použít:
```bash
ocr review --format json --output result.json
```
Nepřidávejte report automaticky do commitu: nejprve zkontrolujte, zda neobsahuje citlivý kód nebo data. Pro kontrolu celých souborů v adresáři bez ohledu na změny slouží samostatný příkaz:
```bash
ocr scan --path internal/agent
```
`internal/agent` je příklad ze souboru README; nahraďte jej existující cestou ve svém projektu. Začněte malým adresářem a posuďte užitečnost komentářů i skutečné náklady, než prohledáte vše.
## Jak poznat, zda je výstup Alibaba Open Code Review užitečný?
Otevřete každý komentář, najděte příslušný řádek a ověřte, zda lze problém reprodukovat. Opravu potvrďte testem a falešně pozitivní výsledky zaznamenávejte zvlášť. Absence komentářů nenahrazuje funkční testy ani kontroly řízení přístupu.
Ve svém srovnání vývojáři v souboru README uvádějí, že OCR odhalí menší podíl problémů než univerzální agenti. Jde o tvrzení vývojářů za podmínek jejich studie, nikoli o měření kvality vašeho projektu. Přesnost OCR zde nebyla nezávisle měřena.
## V čem se liší delegování
V běžném režimu se používá model nakonfigurovaný v OCR. V režimu delegování OCR vybírá soubory a určuje pravidla, zatímco kód kontroluje váš AI agent pomocí vlastního modelu. V tomto režimu není nutné samostatné nastavení modelu ani API klíč pro OCR.
Příkazy pro přípravu ze souboru README:
```bash
ocr delegate preview
ocr delegate rule src/main.go src/handler.go
```
Nahraďte cesty vlastními. Po těchto příkazech předejte analýzu připojenému agentovi: příprava souborů ještě není kontrola kódu. Stále platí jeho podmínky a limity účtování, takže „není potřeba samostatný klíč“ neznamená „kontrola je zdarma“.
Repozitář popisuje integrace s Claude Code, Codexem a dalšími agenty. Pokud používáte Codex, nejprve se seznamte s tím, [jak fungují dovednosti Codexu](https://ailoot.ai/blog/cs/codex-skills/); pro další podporovaný nástroj je tu [úvod do Kimi Code](https://ailoot.ai/blog/cs/kimi-code-install/). Integraci připojte, až porozumíte běžnému reportu, nikoli místo toho, abyste si jej přečetli.
## Pokud běh nepřinese žádný výsledek
Zkontrolujte, že máte nainstalovanou požadovanou verzi Gitu, jste ve správném adresáři projektu a připojení k modelu funguje. Pokud nejsou žádné změny ke kontrole, nevydávejte prázdný výsledek za kontrolu celé kódové základny: pro celé soubory slouží příkaz scan. Nezavádějte automatické blokování commitů na základě jediného neznámého reportu.
Příkazy byly ověřeny podle oficiálního souboru README na připnuté revizi repozitáře. Neběžel žádný placený běh na projektu uživatele. Kritériem úspěšného prvního pokusu jsou srozumitelné komentáře, které jste dokázali potvrdit nebo odmítnout s odůvodněním.
### Zdroje
- [Oficiální dokumentace](https://raw.githubusercontent.com/alibaba/open-code-review/486022daaf14f7142275eddb9b3cacc3cc5dadfa/README.md)
Pokud potřebujete přístup k modelům AI prostřednictvím Ailoot, podívejte se na [Ailoot](https://ailoot.ai/).
## Časté otázky
### Dokazuje OCR zpráva bez připomínek správnost kódu?
Ne. Ověřte, že se skutečně kontrolovaly zamýšlené změny v Gitu, a zachovejte funkční testy i testy řízení přístupu. U každého nálezu prohlédněte uvedený řádek a chybu reprodukujte; falešné poplachy evidujte zvlášť.
### Je kontrola v režimu delegování zdarma?
Ne. Režim předá analýzu připojenému agentovi a odpadá samostatná konfigurace modelu OCR, stále ale platí ceny a limity daného agenta. Příkazy náhledu a pravidel připravují předání; nejde o dokončenou kontrolu.
## Ailoot · Společnost a její portfolio projektů
Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.
Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.
Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.