Open Code Review d’Alibaba : installation et première revue

Documentation Ailoot : API, clés et intégration.

À quoi sert Open Code Review ?#

Le projet est publié dans le dépôt officiel d’Alibaba sous licence Apache-2.0. Dans le README, les développeurs décrivent la combinaison de la sélection programmatique des fichiers et de règles avec un agent qui analyse le code. Il existe aussi ocr scan pour examiner des fichiers entiers lorsqu’il n’y a pas de diff pertinent, c’est-à-dire un ensemble de modifications Git.

Commencez par votre première revue et évaluez les commentaires sur votre propre code. Les économies de tokens pour votre projet n’ont pas été mesurées ici. L’article sur les fausses affirmations de « terminé » explique pourquoi il est utile de vérifier séparément les résultats d’un agent.

Préparer le dépôt et installer OCR#

Cette méthode d’installation nécessite Git 2.41 ou une version ultérieure et npm. Commencez par un dépôt de test qui ne contient aucun secret. L’agent peut lire des fichiers entiers et rechercher dans la base de code ; le mode répertoire de travail inclut également les fichiers non suivis. Vérifiez l’ensemble du dépôt, y compris les nouveaux fichiers : il ne doit contenir aucune clé ni donnée qui ne puisse être envoyée au modèle que vous avez choisi.

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

Après l’installation, la commande ocr est disponible. Vérifiez les options d’installation et le paquet à partir du README officiel, et non d’un paquet quelconque portant un nom similaire.

Configurer le modèle et lancer une revue#

Dans le terminal, exécutez :

ocr config provider
ocr config model

L’interface interactive vous demande de choisir un fournisseur, de saisir une clé API et de configurer le modèle, puis vérifie la connexion. Saisissez la clé dans l’interface prévue à cet effet, pas dans les fichiers du projet ni dans les messages de commit. Avant de lancer une revue, renseignez-vous sur la facturation de votre fournisseur : la licence gratuite d’OCR ne signifie pas que les appels au modèle sont gratuits.

Accédez au répertoire de votre projet et lancez une revue. Remplacez your-project par le chemin de votre projet :

cd your-project
ocr review

Dans ce mode, ocr review examine les modifications indexées, non indexées et les nouveaux fichiers non suivis. Pour enregistrer les commentaires au format JSON, vous pouvez utiliser :

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

N’ajoutez pas automatiquement le rapport à un commit : vérifiez d’abord qu’il ne contient aucun code ni donnée sensible. Une commande distincte permet d’examiner tous les fichiers d’un répertoire, quelles que soient les modifications :

ocr scan --path internal/agent

internal/agent est un exemple tiré du README ; remplacez-le par un chemin existant dans votre projet. Commencez par un petit répertoire afin d’évaluer l’utilité des commentaires et le coût réel avant d’analyser l’ensemble du projet.

Comment déterminer si une revue est utile#

Ouvrez chaque commentaire, repérez la ligne et vérifiez si le problème peut être reproduit. Confirmez la correction à l’aide d’un test et consignez séparément les faux positifs. L’absence de commentaires ne remplace pas les tests fonctionnels ni les vérifications des contrôles d’accès.

Dans leur comparaison, les développeurs indiquent dans le README qu’OCR détecte une proportion plus faible de problèmes que les agents généralistes. Il s’agit de leur affirmation dans les conditions de leur étude, et non d’une mesure de la qualité de votre projet. Aucune mesure indépendante de la précision d’OCR n’a été réalisée ici.

En quoi le mode délégation est différent#

En mode normal, OCR utilise le modèle configuré. En mode délégation, OCR sélectionne les fichiers et définit les règles, tandis que votre agent d’IA examine le code avec son propre modèle. Dans ce mode, il n’est pas nécessaire de configurer un modèle séparément ni de fournir une clé API pour OCR.

Commandes de préparation tirées du README :

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

Remplacez les chemins par les vôtres. Après ces commandes, transmettez l’analyse à l’agent connecté : préparer les fichiers ne constitue pas encore une revue de code. Les conditions de paiement et les limites de cet agent continuent de s’appliquer ; « aucune clé distincte requise » ne signifie donc pas « revue gratuite ».

Le dépôt décrit des intégrations avec Claude Code, Codex et d’autres agents. Si vous utilisez Codex, commencez par vous familiariser avec le fonctionnement des skills Codex ; pour un autre outil pris en charge, voici une introduction à Kimi Code. Connectez l’intégration une fois que vous comprenez le rapport standard, et non à la place de sa lecture.

Si l’exécution ne produit aucun résultat#

Vérifiez que la version requise de Git est installée, que vous vous trouvez dans le bon répertoire de projet et que la connexion au modèle fonctionne. S’il n’y a aucune modification à examiner, ne qualifiez pas un résultat vide de revue de l’ensemble de la base de code : utilisez scan pour examiner des fichiers entiers. Ne mettez pas en place un blocage automatique des commits à partir d’un seul rapport inhabituel.

Les commandes ont été vérifiées à partir du README officiel, à la révision indiquée du dépôt. Aucune exécution payante sur le projet d’un utilisateur n’a été effectuée. Pour considérer une première tentative comme réussie, il faut obtenir des commentaires clairs que vous avez pu confirmer ou réfuter avec justification.

Si vous avez besoin d’accéder à des modèles d’IA via Ailoot, découvrez Ailoot.