Open Code Review: alcance, filtros y llamadas al modelo
Primera revisión controlada con Open Code Review
Elige un alcance Git, inspecciona la vista previa y guarda resultados sin confundir selección de archivos con una revisión terminada.
Qué aprenderás
- Instala e inspecciona antes de añadir credenciales
- Escoge las referencias con intención
- Guarda un resultado que puedas comprobar
Antes de empezar
- Cambios Git y comparación desde merge-base
- Uso básico de CLI y credenciales de modelos
Elegir el alcance, explicar exclusiones y preparar una prueba controlada distinguiendo inspección y ejecución.
Conclusiones clave
- El modo de trabajo incluye archivos no rastreados.
- La revisión de rango parte de una base común.
- Configurar el proveedor puede realizar una solicitud de conectividad.
Instala e inspecciona antes de añadir credenciales
El README documenta la instalación mediante npm y exige Git 2.41 o posterior. Registra la versión instalada de OCR y la de Git. Para repetir un despliegue, selecciona y fija una versión auditada; una instalación npm sin versión sigue la publicación actual del paquete.
Empieza en un repositorio de ejemplos sintéticos. La vista previa muestra la selección antes de una revisión normal con modelo. Inspecciona los archivos excluidos, especialmente cuando las pruebas o las extensiones poco habituales contienen comportamiento importante.
Escoge las referencias con intención
Utiliza el modo de trabajo al preparar cambios locales. Para una rama, indica la base y el destino adecuados; la comparación documentada utiliza su base común. Revisar un commit responde a una pregunta más estrecha y conviene cuando ese es el objetivo.
Los archivos no rastreados se representan como incorporaciones en el modo de trabajo. Una nota local o un artefacto generado pueden afectar a la selección. Comprueba el estado del repositorio, las referencias y la vista previa antes de conectar un modelo externo.
Guarda un resultado que puedas comprobar
En una revisión normal, la configuración interactiva del proveedor y del modelo establece el acceso de OCR. La documentación indica que también prueba la conectividad. Utiliza un destino autorizado e introduce las credenciales en privado, sin copiarlas a transcripciones compartidas.
Guarda la salida JSON en un archivo nuevo y contrasta cada comentario con el código. Conserva la vista previa y el resultado de ejecución. Este recorrido explica comandos documentados; para el artículo no se instaló OCR ni se realizó una llamada API o una revisión real del repositorio.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Comprueba git --version e instala una versión auditada del paquete npm documentado.
- 2
Ejecuta ocr review --preview sobre ejemplos sintéticos e inspecciona la lista.
- 3
Tras configurar un proveedor autorizado, guarda JSON y comprueba los comentarios.
Ejemplo para copiar
git --version
git status --short
ocr review --preview
# Después de configurar un proveedor autorizado:
ocr review --format json --output review-demo.jsonPreguntas frecuentes
¿Puedo previsualizar sin pagar una revisión?
La arquitectura describe la vista previa como selección sin llamada al modelo. No ejecuta la revisión posterior.
¿Por qué falta un archivo de pruebas?
Las exclusiones predeterminadas pueden omitir pruebas. Consulta el motivo y las reglas de inclusión antes de decidir si el alcance es adecuado.
Fuentes
- Open Code Review / README.mdFuente verificada 2026-09-18
- Open Code Review / pages/src/content/docs/en/architecture.mdFuente verificada 2026-09-18
- Open Code Review / pages/src/content/docs/en/configuration.mdFuente verificada 2026-09-18
- Open Code Review / internal/agent/selection.goFuente verificada 2026-09-18