סקירת הקוד של Alibaba באמצעות Open Code Review: התקנה והסקירה הראשונה

תיעוד Ailoot: API, מפתחות ואינטגרציה.

מה Open Code Review עושה#

הפרויקט פורסם במאגר הרשמי של Alibaba ברישיון Apache-2.0. בקובץ README המפתחים מתארים שילוב של בחירת קבצים וכללים באופן פרוגרמטי עם סוכן שמנתח את הקוד. יש גם את ocr scan לסריקת קבצים שלמים כשאין diff משמעותי—קבוצת שינויים ב-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 ולהגדיר את המודל, ואז בודק את החיבור. הזינו את המפתח בממשק המיועד לכך, ולא בקובצי הפרויקט או בהודעות commit. לפני הפעלת סקירה, בררו כיצד הספק שבחרתם גובה תשלום: הרישיון החינמי של OCR לא אומר שהקריאות למודל בחינם.

עברו לספריית הפרויקט שלכם והפעילו סקירה. החליפו את your-project בנתיב לפרויקט שלכם:

cd your-project
ocr review

במצב זה, ocr review בודק שינויים שנמצאים ב-staging, שינויים שעדיין לא נמצאים ב-staging ושינויים חדשים בקבצים שטרם נמצאים במעקב. כדי לשמור את ההערות כ-JSON, אפשר להשתמש בפקודה:

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

אל תוסיפו את הדוח אוטומטית ל-commit: בדקו תחילה שאינו מכיל קוד או נתונים רגישים. יש פקודה נפרדת לסקירת קבצים שלמים בספרייה, ללא קשר לשינויים:

ocr scan --path internal/agent

internal/agent הוא דוגמה מתוך ה-README; החליפו אותו בנתיב קיים בפרויקט שלכם. התחילו בספרייה קטנה כדי להעריך את התועלת של ההערות ואת העלות בפועל לפני סריקת הכול.

איך להעריך אם סקירה מועילה#

פתחו כל הערה, מצאו את השורה ובדקו אם אפשר לשחזר את הבעיה. אשרו את התיקון באמצעות בדיקה, ורשמו בנפרד תוצאות חיוביות שגויות. היעדר הערות אינו מחליף בדיקות פונקציונליות ובדיקות בקרת גישה.

בהשוואה שלהם, המפתחים מציינים ב-README ש-OCR מזהה שיעור קטן יותר של בעיות מסוכנים לשימוש כללי. זוהי טענת המפתחים בתנאי המחקר שלהם, ולא מדידה של איכות הפרויקט שלכם. לא נערכה כאן מדידה עצמאית של דיוק OCR.

במה מצב האצלה שונה#

במצב רגיל, נעשה שימוש במודל שהוגדר ב-OCR. במצב האצלה, OCR בוחר קבצים וקובע כללים, ואילו סוכן ה-AI שלכם סוקר את הקוד באמצעות המודל שלו. במצב זה אין צורך בהגדרת מודל נפרדת ובמפתח API עבור OCR.

פקודות הכנה מתוך ה-README:

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

החליפו את הנתיבים בנתיבים משלכם. לאחר הפקודות האלה, העבירו את הניתוח לסוכן המחובר: הכנת קבצים עדיין אינה סקירת קוד. תנאי התשלום והמגבלות שלו עדיין חלים, ולכן “אין צורך במפתח נפרד” לא אומר “הסקירה בחינם”.

המאגר מתאר אינטגרציות עם Claude Code, Codex וסוכנים אחרים. אם אתם משתמשים ב-Codex, הכירו תחילה את אופן הפעולה של מיומנויות Codex; לכלי נתמך אחר יש מבוא ל-Kimi Code. חברו את האינטגרציה לאחר שתבינו את הדוח הרגיל, ולא במקום לקרוא אותו.

אם ההרצה אינה מחזירה תוצאה#

בדקו שמותקנת גרסת Git הנדרשת, שאתם נמצאים בספריית הפרויקט הנכונה ושהחיבור למודל פועל. אם אין שינויים לסקירה, אל תכנו תוצאה ריקה סקירה של כל בסיס הקוד: לסריקת קבצים שלמים משתמשים ב-scan. אל תוסיפו חסימה אוטומטית של commit על סמך דוח יחיד שאינכם מכירים.

הפקודות נבדקו מול ה-README הרשמי בגרסת המאגר שנקבעה. לא בוצעה הרצה בתשלום על פרויקט של משתמש. הקריטריון להצלחה בניסיון הראשון הוא הערות ברורות שהצלחתם לאשר או לדחות בנימוק.

אם אתם זקוקים לגישה למודלי AI דרך Ailoot, עיינו ב-Ailoot.