Alibaba’ning Open Code Review vositasi: o‘rnatish va birinchi tekshiruv

Ailoot hujjatlari: API, kalitlar va integratsiya.

Open Code Review nima qiladi#

Loyiha Alibaba’ning rasmiy repozitoriysida Apache-2.0 litsenziyasi ostida e’lon qilingan. README faylida ishlab chiquvchilar dasturiy fayl tanlash va qoidalarni kodni tahlil qiladigan agent bilan birlashtirishni tasvirlaydi. Mazmunli diff — Git o‘zgarishlari to‘plami — bo‘lmaganida butun fayllarni tekshiradigan ocr scan buyrug‘i ham bor.

Birinchi tekshiruvni bajaring va o‘z kodingiz bo‘yicha izohlarni baholang. Loyihangizda qancha token tejalishi bu yerda o‘lchanmagan. Agent natijalarini alohida tekshirish nima uchun foydali ekani “bajarildi” degan yolg‘on da’volar haqidagi maqolada tushuntirilgan.

Repozitoriyni tayyorlash va OCR’ni o‘rnatish#

Bu o‘rnatish usuli uchun Git 2.41 yoki undan keyingi versiyasi va npm kerak bo‘ladi. Maxfiy ma’lumotlar bo‘lmagan sinov repozitoriysidan boshlang. Agent butun fayllarni o‘qishi va kod bazasidan qidirishi mumkin; ishchi katalog rejimi kuzatilmayotgan fayllarni ham qamrab oladi. Yangi fayllarni ham qo‘shib, butun repozitoriyni tekshiring: unda tanlagan modelingizga yuborib bo‘lmaydigan kalitlar yoki ma’lumotlar bo‘lmasligi kerak.

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

O‘rnatilgandan so‘ng ocr buyrug‘i mavjud bo‘ladi. O‘rnatish usullari va paketning o‘zini o‘xshash nomli tasodifiy paketdan emas, rasmiy README faylidan tekshiring.

Modelni sozlash va tekshiruvni bajarish#

Terminalda quyidagilarni bajaring:

ocr config provider
ocr config model

Interaktiv interfeys provayderni tanlashni, API kalitini kiritishni va modelni sozlashni so‘raydi, so‘ng ulanishni tekshiradi. Kalitni loyiha fayllari yoki commit xabarlariga emas, belgilangan interfeysga kiriting. Tekshiruvni boshlashdan oldin tanlagan provayderingiz qanday haq olishini bilib oling: OCR’ning bepul litsenziyasi model chaqiruvlari ham bepul degani emas.

Loyihangiz katalogiga o‘ting va tekshiruvni bajaring. your-project o‘rniga loyihangiz yo‘lini kiriting:

cd your-project
ocr review

Bu rejimda ocr review stage qilingan, stage qilinmagan va yangi kuzatilmayotgan o‘zgarishlarni tekshiradi. Izohlarni JSON formatida saqlash uchun quyidagini ishlatishingiz mumkin:

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

Hisobotni commit’ga avtomatik qo‘shmang: avval unda maxfiy kod yoki ma’lumotlar yo‘qligini tekshiring. O‘zgarishlardan qat’i nazar, katalogdagi butun fayllarni tekshirish uchun alohida buyruq mavjud:

ocr scan --path internal/agent

internal/agent — README faylidagi misol; uni loyihangizdagi mavjud yo‘l bilan almashtiring. Izohlar qanchalik foydali ekanini va haqiqiy xarajatni baholash uchun hammasini tekshirishdan oldin kichik katalogdan boshlang.

Tekshiruv foydali ekanini qanday aniqlash mumkin#

Har bir izohni oching, unda ko‘rsatilgan satrni toping va muammoni qayta yuzaga keltirish mumkinligini tekshiring. Tuzatishni test bilan tasdiqlang, noto‘g‘ri ijobiy natijalarni esa alohida qayd eting. Izohlar yo‘qligi funksional testlar va kirish nazorati tekshiruvlarining o‘rnini bosmaydi.

Ishlab chiquvchilar README faylidagi taqqoslashda OCR umumiy maqsadli agentlarga qaraganda kamroq ulushdagi muammolarni aniqlashini qayd etadi. Bu ularning o‘rganish sharoitlari doirasidagi da’vosi, loyihangiz sifatining o‘lchovi emas. Bu yerda OCR aniqligi mustaqil ravishda o‘lchanmagan.

Delegatsiya rejimining farqi#

Oddiy rejim OCR’da sozlangan modeldan foydalanadi. Delegatsiya rejimida OCR fayllarni tanlaydi va qoidalarni belgilaydi, AI agentingiz esa o‘z modelidan foydalanib kodni tekshiradi. Bu rejimda OCR uchun alohida model konfiguratsiyasi va API kaliti talab qilinmaydi.

README faylidagi tayyorlash buyruqlari:

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

Yo‘llarni o‘zingiznikiga almashtiring. Bu buyruqlardan keyin tahlilni ulangan agentga topshiring: fayllarni tayyorlash hali kod tekshiruvi degani emas. Uning to‘lov shartlari va cheklovlari amal qiladi, shuning uchun “alohida kalit kerak emas” degani “tekshiruv bepul” degani emas.

Repozitoriyda Claude Code, Codex va boshqa agentlar bilan integratsiyalar tasvirlangan. Codex’dan foydalansangiz, avval Codex ko‘nikmalari qanday ishlashi bilan tanishing; boshqa qo‘llab-quvvatlanadigan vosita uchun esa Kimi Code bilan tanishuv mavjud. Integratsiyani oddiy hisobotni tushunib olgandan keyin ulang, uni o‘qish o‘rniga ishlatmang.

Ishga tushirganda natija chiqmasa#

Kerakli Git versiyasi o‘rnatilganini, to‘g‘ri loyiha katalogida ekaningizni va modelga ulanish ishlayotganini tekshiring. Tekshiriladigan o‘zgarishlar bo‘lmasa, bo‘sh natijani butun kod bazasi tekshirilgan deb atamang: butun fayllar uchun scan buyrug‘idan foydalaniladi. Notanish bitta hisobot asosida commit’larni avtomatik bloklashni qo‘shmang.

Buyruqlar repozitoriyning belgilangan versiyasidagi rasmiy README bilan solishtirib tekshirildi. Foydalanuvchi loyihasida pulli ishga tushirish bajarilmadi. Birinchi urinishning muvaffaqiyat mezoni — asos bilan tasdiqlash yoki rad etish mumkin bo‘lgan aniq izohlar.

Ailoot orqali AI modellaridan foydalanish kerak bo‘lsa, Ailoot saytiga qarang.