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

> أعِدّ نموذجًا لمراجعة Open Code، وتحقّق من تغييرات Git، وراجع النتائج. يستخدم وضع التفويض نموذج وكيلك.

Source: https://ailoot.ai/blog/ar/alibaba-open-code-review/
Canonical: https://ailoot.ai/blog/ar/alibaba-open-code-review/
Language: ar
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-187
Revision: sha256-42069cbec264650c48c0c9bd43aa4cc28ccb2debdd0eb917a4ad8b23aa1f7f9b


[توثيق Ailoot: API والمفاتيح والتكامل](https://ailoot.ai/docs/).

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway for this section">

الخلاصة الأساسية

Open Code Review، أو OCR، أداة تعمل عبر سطر الأوامر لمراجعة الشيفرة البرمجية. تقرأ تغييرات Git، وترسل الملفات إلى نموذج اللغة المُعدّ، ثم تعرض تعليقات مرتبطة بأسطر محددة. وهي مراجعة إضافية، وليست دليلًا على خلو الشيفرة من الأخطاء.

</div>

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

ابدأ بمراجعتك الأولى، وقيّم التعليقات على شيفرتك بنفسك. لم تُقَس هنا وفورات الرموز في مشروعك. وتشرح [المقالة حول الادعاءات الزائفة بإتمام العمل](https://ailoot.ai/blog/ar/ai-agent-says-done/) سبب فائدة التحقق من نتائج الوكيل بشكل منفصل.

## تجهيز المستودع وتثبيت OCR

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

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

بعد التثبيت، يصبح الأمر `ocr` متاحًا. تحقّق من خيارات التثبيت والحزمة نفسها بمقارنتها بملف README الرسمي، لا بحزمة عشوائية تحمل اسمًا مشابهًا.

## إعداد النموذج وإجراء مراجعة

في الطرفية، شغّل:

```bash
ocr config provider
ocr config model
```

تطلب منك الواجهة التفاعلية اختيار مزوّد، وإدخال مفتاح API، وإعداد النموذج، ثم تتحقق من الاتصال. أدخل المفتاح في الواجهة المخصصة، لا في ملفات المشروع أو رسائل الإيداع. قبل إجراء مراجعة، اعرف طريقة احتساب الرسوم لدى المزوّد الذي اخترته: ترخيص OCR المجاني لا يعني أن استدعاءات النموذج مجانية.

انتقل إلى دليل مشروعك وأجرِ مراجعة. استبدل `your-project` بمسار مشروعك:

```bash
cd your-project
ocr review
```

في هذا الوضع، يتحقق `ocr review` من التغييرات المُدرجة في التجهيز، وغير المُدرجة فيه، والجديدة غير المتعقبة. لحفظ التعليقات بصيغة JSON، يمكنك استخدام:

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

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

```bash
ocr scan --path internal/agent
```

`internal/agent` مثال من ملف README؛ استبدله بمسار موجود في مشروعك. ابدأ بدليل صغير لتقييم مدى فائدة التعليقات والتكلفة الفعلية قبل فحص كل شيء.

## كيف تعرف إن كانت المراجعة مفيدة؟

افتح كل تعليق، واعثر على السطر، وتحقق مما إذا كان بالإمكان إعادة إنتاج المشكلة. أكّد الإصلاح باختبار، وسجّل النتائج الإيجابية الكاذبة بشكل منفصل. عدم وجود تعليقات لا يغني عن الاختبارات الوظيفية وفحوصات التحكم في الوصول.

يذكر المطورون في مقارنة أجروها ضمن ملف README أن OCR يكتشف نسبة أقل من المشكلات مقارنة بالوكلاء متعددي الأغراض. هذا ادعاء المطورين في ظل ظروف دراستهم، وليس قياسًا لجودة مشروعك. لم يُجرَ هنا أي قياس مستقل لدقة OCR.

## كيف يختلف التفويض؟

يستخدم الوضع العادي النموذج المُعدّ في OCR. أما في وضع التفويض، فيختار OCR الملفات ويحدد القواعد، بينما يراجع وكيل الذكاء الاصطناعي لديك الشيفرة باستخدام نموذجه الخاص. ولا يلزم في هذا الوضع إعداد نموذج منفصل أو مفتاح API لـ OCR.

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

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

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

يصف المستودع عمليات تكامل مع Claude Code وCodex ووكلاء آخرين. إذا كنت تستخدم Codex، فتعرّف أولًا على [طريقة عمل مهارات Codex](https://ailoot.ai/blog/ar/codex-skills/)؛ ولأداة أخرى مدعومة، اطّلع على [مقدمة إلى Kimi Code](https://ailoot.ai/blog/ar/kimi-code-install/). أعدّ التكامل بعد أن تفهم التقرير العادي، لا بدلًا من قراءته.

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

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

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

<div class="section" role="doc-bibliography" aria-label="Sources">

### المصادر

- [التوثيق الرسمي](https://raw.githubusercontent.com/alibaba/open-code-review/486022daaf14f7142275eddb9b3cacc3cc5dadfa/README.md)

</div>



إذا كنت بحاجة إلى الوصول إلى نماذج الذكاء الاصطناعي عبر Ailoot، فألقِ نظرة على [Ailoot](https://ailoot.ai/).

## أسئلة شائعة

### هل يثبت تقرير OCR بلا ملاحظات صحة الشيفرة؟

لا. تحقق من مراجعة تغييرات Git المقصودة فعلًا، واحتفظ باختبارات الوظائف والتحكم في الوصول. لكل مشكلة مبلغ عنها، افحص السطر المشار إليه وأعد إنتاج المشكلة؛ وسجّل الإنذارات الكاذبة منفصلة.

### هل يجعل وضع التفويض المراجعة مجانية؟

لا. يغني عن إعداد نموذج مستقل لـ OCR بتسليم التحليل إلى وكيلك المتصل، لكن شروط دفع ذلك الوكيل وحدوده تظل سارية. تُعدّ أوامر المعاينة والقواعد عملية التسليم؛ ولا تمثل مراجعة مكتملة.


## Ailoot · الشركة ومحفظة مشاريعها

تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.