Alibaba компаниясының Open Code Review құралы: орнату және алғашқы шолу

Ailoot құжаттамасы: API, кілттер және интеграция.

Open Code Review не істейді#

Жоба Alibaba компаниясының ресми репозиторийінде Apache-2.0 лицензиясымен жарияланған. README файлында әзірлеушілер файлдарды бағдарламалық жолмен таңдауды және ережелерді кодты талдайтын агентпен біріктіретінін сипаттайды. Сондай-ақ мәнді айырмашылық — Git өзгерістер жиыны — болмаған кезде тұтас файлдарды тексеретін ocr scan пәрмені бар.

Алғашқы шолудан бастап, өз кодыңызға қатысты пікірлерді бағалаңыз. Жобаңыздағы токен үнемі мұнда өлшенген жоқ. Агент нәтижелерін бөлек тексерудің неліктен пайдалы екені «орындалды» деген жалған мәлімдемелер туралы мақалада түсіндіріледі.

Репозиторийді дайындап, OCR орнатыңыз#

Бұл орнату әдісі үшін Git 2.41 немесе одан кейінгі нұсқасы және npm қажет. Құпиялары жоқ сынақ репозиторийінен бастаңыз. Агент тұтас файлдарды оқып, код базасынан іздей алады, ал жұмыс каталогы режиміне бақыланбайтын файлдар да кіреді. Жаңа файлдарды қоса, бүкіл репозиторийді тексеріңіз: онда таңдалған модельге жіберуге болмайтын кілттер немесе деректер болмауы керек.

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

Орнатқаннан кейін ocr пәрмені қолжетімді болады. Орнату опциялары мен пакеттің өзін атауы ұқсас кездейсоқ пакеттен емес, ресми README файлынан тексеріңіз.

Модельді баптап, шолуды іске қосыңыз#

Терминалда мына пәрмендерді орындаңыз:

ocr config provider
ocr config model

Интерактивті интерфейс провайдерді таңдауды, API кілтін енгізуді және модельді баптауды сұрайды, содан кейін қосылымды тексереді. Кілтті жоба файлдарына немесе коммит хабарларына емес, арнайы интерфейске енгізіңіз. Шолуды іске қоспас бұрын таңдаған провайдеріңіздің ақы алу тәртібін біліңіз: OCR лицензиясының тегін болуы модельді шақыру тегін дегенді білдірмейді.

Жобаңыздың каталогына өтіп, шолуды іске қосыңыз. your-project сөзін жобаңыздың жолымен ауыстырыңыз:

cd your-project
ocr review

Бұл режимде ocr review сахналанған, сахналанбаған және жаңа, бақыланбайтын өзгерістерді тексереді. Пікірлерді JSON форматында сақтау үшін мына пәрменді қолдануға болады:

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

Есепті коммитке автоматты түрде қоспаңыз: алдымен онда құпия код немесе дерек жоқ екенін тексеріңіз. Өзгерістерге қарамастан каталогтағы тұтас файлдарды шолуға арналған бөлек пәрмен бар:

ocr scan --path internal/agent

internal/agent — README файлындағы мысал; оны жобаңыздағы бар жолмен ауыстырыңыз. Пікірлердің қаншалықты пайдалы екенін және нақты құнын бағалау үшін алдымен шағын каталогты сканерлеңіз, содан кейін ғана бәрін тексеріңіз.

Шолудың пайдалы екенін қалай анықтауға болады#

Әр пікірді ашып, көрсетілген жолды тауып, мәселені қайта шығара алатыныңызды тексеріңіз. Түзетуді тестпен растаңыз, ал жалған оң нәтижелерді бөлек тіркеңіз. Пікірлердің болмауы функционалдық тестілер мен қол жеткізуді басқару тексерулерін алмастырмайды.

Әзірлеушілер README файлындағы салыстыруында OCR жалпы мақсаттағы агенттерге қарағанда мәселелердің азырақ үлесін анықтайтынын атап өтеді. Бұл — олардың зерттеу жағдайларына қатысты мәлімдемесі, жобаңыздың сапасын өлшеу емес. Мұнда OCR дәлдігіне тәуелсіз өлшеу жүргізілген жоқ.

Делегация режимінің айырмашылығы#

Қалыпты режимде OCR ішінде бапталған модель қолданылады. Делегация режимінде OCR файлдарды таңдап, ережелерді анықтайды, ал AI агентіңіз кодты өзінің моделімен шолып шығады. Бұл режимде OCR үшін бөлек модель баптауы мен API кілті қажет емес.

README файлындағы дайындау пәрмендері:

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

Жолдарды өз жолдарыңызбен ауыстырыңыз. Осы пәрмендерден кейін талдауды қосылған агентке тапсырыңыз: файлдарды дайындау әлі кодты шолу болып саналмайды. Оның төлем шарттары мен шектеулері қолданылады, сондықтан «бөлек кілт қажет емес» деген сөз «шолу тегін» дегенді білдірмейді.

Репозиторийде Claude Code, Codex және басқа агенттермен интеграциялар сипатталған. Codex қолдансаңыз, алдымен Codex дағдыларының қалай жұмыс істейтінін біліп алыңыз; басқа қолдау көрсетілетін құрал үшін Kimi Code туралы кіріспе бар. Интеграцияны қалыпты есепті түсінгеннен кейін қосыңыз, оны оқудың орнына емес.

Іске қосқанда нәтиже шықпаса#

Қажетті Git нұсқасы орнатылғанын, дұрыс жоба каталогында екеніңізді және модельге қосылым жұмыс істейтінін тексеріңіз. Шолуға өзгерістер болмаса, бос нәтижені бүкіл код базасына жасалған шолу деп атамаңыз: тұтас файлдарды тексеру үшін scan қолданылады. Бейтаныс бір есепке сүйеніп коммитті автоматты түрде бұғаттамаңыз.

Пәрмендер репозиторийдің бекітілген нұсқасындағы ресми README файлымен салыстырылып тексерілді. Пайдаланушы жобасында ақылы іске қосу жүргізілген жоқ. Алғашқы әрекеттің сәтті өту өлшемі — негіздеп растай немесе жоққа шығара алған түсінікті пікірлер.

Ailoot арқылы AI модельдеріне қол жеткізу қажет болса, Ailoot сайтын қараңыз.