Open Code Review di Alibaba: installazione e prima revisione

Documentazione di Ailoot: API, chiavi e integrazione.

Cosa fa Open Code Review#

Il progetto è pubblicato nel repository ufficiale di Alibaba con licenza Apache-2.0. Nel README, gli sviluppatori descrivono la combinazione di selezione programmatica dei file e regole con un agente che analizza il codice. È disponibile anche ocr scan per file interi quando non c'è un diff significativo, cioè un insieme di modifiche Git.

Inizia con la tua prima revisione e valuta i commenti sul tuo codice. Qui non è stato misurato il risparmio di token sul tuo progetto. Il motivo per cui è utile controllare separatamente i risultati di un agente è spiegato nell'articolo sulle false affermazioni di «fatto».

Prepara il repository e installa OCR#

Per questo metodo di installazione servono Git 2.41 o versioni successive e npm. Inizia con un repository di prova che non contenga segreti. L'agente può leggere file interi e cercare nel codice; inoltre, la modalità della directory di lavoro include anche i file non tracciati. Controlla l'intero repository, compresi i nuovi file: non deve contenere chiavi o dati che non possono essere inviati al modello scelto.

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

Dopo l'installazione, il comando ocr è disponibile. Verifica le opzioni di installazione e il pacchetto consultando il README ufficiale, non un pacchetto qualsiasi con un nome simile.

Configura il modello ed esegui una revisione#

Nel terminale, esegui:

ocr config provider
ocr config model

L'interfaccia interattiva chiede di scegliere un provider, inserire una chiave API e configurare il modello, quindi verifica la connessione. Inserisci la chiave nell'interfaccia apposita, non nei file del progetto o nei messaggi di commit. Prima di eseguire una revisione, verifica i costi applicati dal provider scelto: la licenza gratuita di OCR non significa che le chiamate al modello siano gratuite.

Vai nella directory del progetto ed esegui una revisione. Sostituisci your-project con il percorso del tuo progetto:

cd your-project
ocr review

In questa modalità, ocr review controlla le modifiche in stage, quelle non in stage e i nuovi file non tracciati. Per salvare i commenti in formato JSON, puoi usare:

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

Non aggiungere automaticamente il rapporto a un commit: prima verifica che non contenga codice o dati sensibili. Esiste un comando separato per rivedere tutti i file di una directory, indipendentemente dalle modifiche:

ocr scan --path internal/agent

internal/agent è un esempio tratto dal README; sostituiscilo con un percorso esistente nel tuo progetto. Inizia con una directory piccola per valutare l'utilità dei commenti e il costo effettivo prima di eseguire la scansione di tutto.

Come capire se una revisione è utile#

Apri ogni commento, trova la riga e verifica se il problema può essere riprodotto. Conferma la correzione con un test e registra separatamente i falsi positivi. L'assenza di commenti non sostituisce i test funzionali e i controlli degli accessi.

Nel confronto riportato nel README, gli sviluppatori affermano che OCR rileva una percentuale di problemi inferiore rispetto agli agenti generalisti. Questa è una loro affermazione, riferita alle condizioni dello studio, non una misurazione della qualità del tuo progetto. Qui non è stata effettuata alcuna misurazione indipendente dell'accuratezza di OCR.

In cosa differisce la delega#

La modalità normale usa il modello configurato in OCR. In modalità di delega, OCR seleziona i file e determina le regole, mentre il tuo agente IA esamina il codice usando il proprio modello. In questa modalità non servono una configurazione separata del modello né una chiave API per OCR.

Comandi di preparazione dal README:

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

Sostituisci i percorsi con i tuoi. Dopo questi comandi, affida l'analisi all'agente collegato: preparare i file non equivale ancora a una revisione del codice. Si applicano comunque i relativi costi e limiti; quindi, «non serve una chiave separata» non significa «revisione gratuita».

Il repository descrive integrazioni con Claude Code, Codex e altri agenti. Se usi Codex, prima familiarizza con il funzionamento delle skill di Codex; per un altro strumento supportato, consulta un'introduzione a Kimi Code. Collega l'integrazione dopo aver capito il rapporto normale, non al posto di leggerlo.

Se l'esecuzione non produce risultati#

Verifica che sia installata la versione richiesta di Git, che ti trovi nella directory corretta del progetto e che la connessione al modello funzioni. Se non ci sono modifiche da rivedere, non chiamare un risultato vuoto una revisione dell'intero codice: per esaminare i file interi si usa scan. Non attivare il blocco automatico dei commit basandoti su un unico rapporto che non conosci.

I comandi sono stati verificati rispetto al README ufficiale alla revisione fissata del repository. Non è stata eseguita alcuna chiamata a pagamento sul progetto di un utente. Il criterio per considerare riuscito il primo tentativo è ricevere commenti chiari che sei riuscito a confermare o respingere con una motivazione.

Se ti serve accedere ai modelli IA tramite Ailoot, dai un'occhiata ad Ailoot.