مراجعة Open Code Review من Alibaba: التثبيت وإجراء مراجعتك الأولى

توثيق Ailoot: API والمفاتيح والتكامل.

ما وظيفة Open Code Review؟#

يُنشر المشروع في المستودع الرسمي لـ Alibaba بموجب ترخيص Apache-2.0. ويصف المطورون في ملف README الجمع بين الاختيار البرمجي للملفات والقواعد وبين وكيل يحلل الشيفرة. ويتوفر أيضًا الأمر ocr scan لفحص ملفات كاملة عندما لا يوجد فرق ذو معنى، أي مجموعة تغييرات Git.

ابدأ بمراجعتك الأولى، وقيّم التعليقات على شيفرتك بنفسك. لم تُقَس هنا وفورات الرموز في مشروعك. وتشرح المقالة حول الادعاءات الزائفة بإتمام العمل سبب فائدة التحقق من نتائج الوكيل بشكل منفصل.

تجهيز المستودع وتثبيت 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 الملفات ويحدد القواعد، بينما يراجع وكيل الذكاء الاصطناعي لديك الشيفرة باستخدام نموذجه الخاص. ولا يلزم في هذا الوضع إعداد نموذج منفصل أو مفتاح API لـ OCR.

أوامر التجهيز الواردة في ملف README:

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

استبدل المسارات بمساراتك. بعد هذه الأوامر، أحِل التحليل إلى الوكيل المتصل: تجهيز الملفات لا يُعد مراجعة للشيفرة بعد. تظل شروط الدفع والحدود الخاصة به سارية، لذا فإن «لا يلزم مفتاح منفصل» لا تعني «المراجعة مجانية».

يصف المستودع عمليات تكامل مع Claude Code وCodex ووكلاء آخرين. إذا كنت تستخدم Codex، فتعرّف أولًا على طريقة عمل مهارات Codex؛ ولأداة أخرى مدعومة، اطّلع على مقدمة إلى Kimi Code. أعدّ التكامل بعد أن تفهم التقرير العادي، لا بدلًا من قراءته.

إذا لم يُنتج التشغيل أي نتيجة#

تحقّق من تثبيت إصدار Git المطلوب، ومن وجودك في دليل المشروع الصحيح، ومن عمل الاتصال بالنموذج. إذا لم توجد تغييرات لمراجعتها، فلا تسمِّ نتيجة فارغة مراجعةً لقاعدة الشيفرة بأكملها: يُستخدم scan لفحص ملفات كاملة. لا تضف حظرًا تلقائيًا للإيداع بناءً على تقرير واحد غير مألوف.

تم التحقق من الأوامر بمقارنتها بملف README الرسمي عند مراجعة المستودع المثبّتة. لم تُجرَ أي عملية تشغيل مدفوعة على مشروع مستخدم. معيار نجاح المحاولة الأولى هو الحصول على تعليقات واضحة تمكنت من تأكيدها أو رفضها مع تبرير.

إذا كنت بحاجة إلى الوصول إلى نماذج الذكاء الاصطناعي عبر Ailoot، فألقِ نظرة على Ailoot.