Open Code Review da Alibaba: instalação e primeira revisão

Documentação da Ailoot: API, chaves e integração.

O que faz o Open Code Review#

O projeto está publicado no repositório oficial da Alibaba sob a licença Apache-2.0. No README, os programadores descrevem a combinação da seleção programática de ficheiros e de regras com um agente que analisa o código. Também existe o comando ocr scan para ficheiros inteiros quando não há um diff significativo — um conjunto de alterações no Git.

Comece pela sua primeira revisão e avalie os comentários sobre o seu próprio código. A poupança de tokens no seu projeto não foi medida aqui. O artigo sobre falsas alegações de «concluído» explica por que motivo é útil verificar separadamente os resultados de um agente.

Prepare o repositório e instale o OCR#

Para este método de instalação, precisa do Git 2.41 ou posterior e do npm. Comece por um repositório de teste que não contenha segredos. O agente pode ler ficheiros inteiros e pesquisar a base de código; o modo de diretório de trabalho também inclui ficheiros não rastreados. Verifique todo o repositório, incluindo os ficheiros novos: não pode conter chaves nem dados que não possam ser enviados para o modelo escolhido.

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

Após a instalação, o comando ocr fica disponível. Verifique as opções de instalação e o próprio pacote com base no README oficial, e não num pacote aleatório com um nome semelhante.

Configure o modelo e execute uma revisão#

No terminal, execute:

ocr config provider
ocr config model

A interface interativa pede-lhe para escolher um fornecedor, introduzir uma chave API e configurar o modelo; em seguida, verifica a ligação. Introduza a chave na interface indicada, não nos ficheiros do projeto nem nas mensagens de commit. Antes de executar uma revisão, informe-se sobre os custos do fornecedor escolhido: a licença gratuita do OCR não significa que as chamadas ao modelo sejam gratuitas.

Aceda ao diretório do seu projeto e execute uma revisão. Substitua your-project pelo caminho para o seu projeto:

cd your-project
ocr review

Neste modo, ocr review verifica as alterações preparadas, não preparadas e novas alterações em ficheiros não rastreados. Para guardar os comentários em JSON, pode usar:

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

Não adicione automaticamente o relatório a um commit: primeiro, verifique se não contém código ou dados sensíveis. Existe um comando separado para rever ficheiros inteiros num diretório, independentemente das alterações:

ocr scan --path internal/agent

internal/agent é um exemplo do README; substitua-o por um caminho existente no seu projeto. Comece por um diretório pequeno para avaliar a utilidade dos comentários e o custo real antes de analisar tudo.

Como saber se uma revisão é útil#

Abra cada comentário, localize a linha e verifique se é possível reproduzir o problema. Confirme a correção com um teste e registe separadamente os falsos positivos. A ausência de comentários não substitui os testes funcionais nem as verificações de controlo de acesso.

Na comparação que apresentam, os programadores referem no README que o OCR deteta uma proporção menor de problemas do que os agentes de uso geral. Esta é uma afirmação dos programadores, nas condições do estudo que realizaram, e não uma medição da qualidade do seu projeto. A precisão do OCR não foi medida de forma independente neste artigo.

Em que difere o modo de delegação#

O modo normal utiliza o modelo configurado no OCR. No modo de delegação, o OCR seleciona os ficheiros e determina as regras, enquanto o seu agente de IA revê o código com o modelo próprio. Neste modo, não é necessária uma configuração de modelo separada nem uma chave API para o OCR.

Comandos de preparação do README:

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

Substitua os caminhos pelos seus. Após estes comandos, entregue a análise ao agente ligado: preparar os ficheiros ainda não é rever o código. As condições e os limites de pagamento do agente continuam a aplicar-se; por isso, «não é necessária uma chave separada» não significa «revisão gratuita».

O repositório descreve integrações com Claude Code, Codex e outros agentes. Se utiliza o Codex, comece por se familiarizar com o funcionamento das competências do Codex; para outra ferramenta compatível, consulte uma introdução ao Kimi Code. Ligue a integração depois de compreender o relatório normal, não em vez de o ler.

Se a execução não produzir resultados#

Verifique se tem instalada a versão necessária do Git, se está no diretório de projeto correto e se a ligação ao modelo funciona. Se não houver alterações para rever, não considere um resultado vazio como uma revisão de toda a base de código: o comando scan serve para analisar ficheiros inteiros. Não bloqueie automaticamente commits com base num único relatório desconhecido.

Os comandos foram verificados com base no README oficial na revisão fixada do repositório. Não foi realizada nenhuma execução paga num projeto de um utilizador. O critério para uma primeira tentativa bem-sucedida são comentários claros que conseguiu confirmar ou rejeitar com justificação.

Se precisar de acesso a modelos de IA através da Ailoot, visite a Ailoot.