Az Alibaba Open Code Review eszköze: telepítés és az első ellenőrzés

Ailoot dokumentáció: API, kulcsok és integráció.

Mire való az Open Code Review#

A projekt az Alibaba hivatalos adattárában jelent meg Apache-2.0 licenc alatt. A README-ben a fejlesztők azt írják, hogy a programozott fájlkiválasztást és szabályokat a kódot elemző ügynökkel kombinálják. Az ocr scan paranccsal teljes fájlok is ellenőrizhetők, ha nincs érdemi diff — vagyis Git-változáskészlet.

Kezdd az első ellenőrzéssel, és értékeld a saját kódodhoz fűzött megjegyzéseket. Itt nem mérték fel, mennyi tokent takaríthatsz meg a projekteden. Arról, hogy miért hasznos külön ellenőrizni az ügynök eredményeit, a „kész” állapotra vonatkozó hamis állításokról szóló cikkben olvashatsz.

Készítsd elő az adattárat, és telepítsd az OCR-t#

Ehhez a telepítési módhoz Git 2.41-es vagy újabb verzióra és npm-re lesz szükséged. Kezdj egy titkokat nem tartalmazó tesztadattárral. Az ügynök teljes fájlokat is beolvashat és kereshet a kódbázisban, a munkakönyvtár mód pedig a még nem követett fájlokat is figyelembe veszi. Ellenőrizd a teljes adattárat, az új fájlokat is beleértve: nem tartalmazhat olyan kulcsokat vagy adatokat, amelyeket nem szabad elküldeni a választott modellednek.

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

A telepítés után elérhetővé válik az ocr parancs. A telepítési lehetőségeket és magát a csomagot a hivatalos README alapján ellenőrizd, ne egy hasonló nevű véletlenszerű csomag alapján.

Állítsd be a modellt, és futtass ellenőrzést#

A terminálban futtasd:

ocr config provider
ocr config model

Az interaktív felület arra kér, hogy válassz egy szolgáltatót, add meg az API-kulcsot, és állítsd be a modellt, majd ellenőrzi a kapcsolatot. A kulcsot a kijelölt felületen add meg, ne projektfájlokban vagy commitüzenetekben. Az ellenőrzés futtatása előtt tájékozódj a választott szolgáltató díjszabásáról: az OCR ingyenes licence nem jelenti azt, hogy a modellhívások is ingyenesek.

Lépj be a projekt könyvtárába, és futtass ellenőrzést. A your-project helyére a projekted elérési útját írd:

cd your-project
ocr review

Ebben a módban az ocr review ellenőrzi a staging területre felvett, a staging területre fel nem vett, valamint az új, még nem követett változásokat. A megjegyzéseket JSON-fájlba mentheted ezzel:

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

Ne add automatikusan a jelentést a commithoz: előbb ellenőrizd, hogy nem tartalmaz-e érzékeny kódot vagy adatot. A változásoktól függetlenül egy könyvtár teljes fájlkészletének ellenőrzésére külön parancs szolgál:

ocr scan --path internal/agent

Az internal/agent a README-ben szereplő példa; cseréld le a projektedben létező elérési útra. Kezdetben csak egy kisebb könyvtárat vizsgálj át, így felmérheted a megjegyzések hasznosságát és a tényleges költséget, mielőtt mindent átvizsgálnál.

Honnan tudhatod, hogy hasznos-e az ellenőrzés#

Nyisd meg az egyes megjegyzéseket, keresd meg a hozzájuk tartozó sort, és ellenőrizd, hogy a probléma reprodukálható-e. Teszttel igazold a javítást, a téves pozitív találatokat pedig külön rögzítsd. A megjegyzések hiánya nem helyettesíti a funkcionális teszteket és a hozzáférés-vezérlés ellenőrzését.

A fejlesztők az összehasonlításukban azt írják a README-ben, hogy az OCR az általános célú ügynököknél kisebb arányban észleli a problémákat. Ez a fejlesztők állítása a vizsgálatuk körülményei között, nem a te projekted minőségének mérése. Itt nem végeztek független mérést az OCR pontosságáról.

Miben más a delegálási mód#

Normál módban az OCR-ben beállított modell működik. Delegálási módban az OCR választja ki a fájlokat és határozza meg a szabályokat, miközben a mesterséges intelligenciát használó ügynököd a saját modelljével ellenőrzi a kódot. Ebben a módban nincs szükség külön modellbeállításra és OCR API-kulcsra.

A README-ben szereplő előkészítő parancsok:

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

Cseréld le az elérési utakat a sajátjaidra. A parancsok futtatása után add át az elemzést a csatlakoztatott ügynöknek: a fájlok előkészítése önmagában még nem kódellenőrzés. A rá vonatkozó díjak és korlátozások továbbra is érvényesek, tehát a „nem kell külön kulcs” nem jelenti azt, hogy „az ellenőrzés ingyenes”.

Az adattárban Claude Code-, Codex- és más ügynökökkel való integrációkról is írnak. Ha Codexet használsz, előbb ismerkedj meg azzal, hogyan működnek a Codex-képességek; más támogatott eszköz esetén olvasd el a Kimi Code bemutatását. Csak akkor csatlakoztasd az integrációt, ha már érted a normál jelentést; az integráció ne helyettesítse annak elolvasását.

Ha a futtatás nem ad eredményt#

Ellenőrizd, hogy telepítve van-e a szükséges Git-verzió, a megfelelő projektkönyvtárban vagy-e, és működik-e a modellhez való kapcsolat. Ha nincsenek ellenőrizendő változások, ne nevezd a nulla eredményt a teljes kódbázis ellenőrzésének: a teljes fájlok vizsgálatára a scan szolgál. Ne akadályozd automatikusan a commitot egyetlen, számodra még ismeretlen jelentés alapján.

A parancsokat az adattár rögzített verziójához tartozó hivatalos README alapján ellenőrizték. Felhasználói projekten nem végeztek fizetős futtatást. Az első próbálkozás akkor tekinthető sikeresnek, ha világos megjegyzéseket kapsz, amelyeket indoklással meg tudsz erősíteni vagy cáfolni.

Ha az Ailooton keresztül szeretnél hozzáférni AI-modellekhez, nézd meg az Ailootot.