Orca: coordine agentes sin perder la identidad del trabajo
Lea el comprobador nativo de Orca para diagnosticar terminales
Siga selección de runtime, reconstrucción condicional y verificación en procesos nuevos sin llamar al script una comprobación de solo lectura.
Qué aprenderás
- Runtime correcto
- Comprobar puede modificar
- Un proceso nuevo importa
Antes de empezar
- Lectura básica de comandos y configuración
- Entorno de ensayo desechable y autorizado
Identifique host, worktree y evidencia de aceptación sin automatizar merges ni borrar trabajo pendiente.
Conclusiones clave
- Ensure puede cambiar dependencias.
- Node y Electron tienen rutas diferentes.
- La verificación posterior usa otro proceso.
Runtime correcto
readRuntimeArg admite --runtime=node o --runtime=electron, juntos o separados del valor. Una selección no válida sale con código 2. El script test del paquete verifica Node antes de ejecutar Vitest.
La lista incluye node-pty y módulos específicos en Windows. Importar JavaScript correctamente en otro contexto no demuestra compatibilidad de esas dependencias binarias con runtime y plataforma.
Comprobar puede modificar
ensureNodeRuntime comprueba carga y una condición de reconstrucción de node-pty parcheado. Solo retorna si ambas son satisfactorias; si no, reconstruye módulos y verifica. Electron llama a su propio script de dependencias nativas.
La ruta normal de ensure no es de solo lectura. --check-only es una rama hija que recoge fallos y termina, pero aquí no auditamos íntegramente cada auxiliar que invoca. Revise los efectos antes de ejecutar.
Un proceso nuevo importa
runNodeCheck crea un proceso Node nuevo porque un fallo de carga nativa puede contaminar el actual. runElectronCheck usa Electron con ELECTRON_RUN_AS_NODE=1. La reconstrucción va seguida de una comprobación posterior.
El código compara versiones de paquete y binario Electron y revisa su ruta. Use esos diagnósticos antes de atribuir un terminal fallido al modelo. No ejecutamos reconstrucciones ni pruebas upstream.
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
Identifique Node o Electron como runtime afectado.
- 2
Lea diagnósticos antes de reconstruir.
- 3
Verifique en el runtime correcto tras autorizar cambios.
Ejemplo para copiar
argumento → Node / Electron
carga inicial + condición de parche
si procede: reconstrucción
verificación nueva → éxito o exit 1Preguntas frecuentes
¿Es solo diagnóstico?
La ruta normal puede reconstruir dependencias.
¿Node correcto prueba compatibilidad de escritorio?
No. Electron tiene comprobaciones propias de ejecución y binario.
Fuentes
- Orca / config/scripts/ensure-native-runtime.mjsFuente verificada 2026-09-18
- Orca / package.jsonFuente verificada 2026-09-18