Tu proyecto sigue siendo tu proyecto.

Explora primero. Elija sus permisos.

El modo de planificación es de solo lectura para el proyecto y el estado externo. El modo de trabajo puede preparar cambios y ejecutar flujos de trabajo compatibles. De forma predeterminada, Revisar ediciones, con decisiones explícitas de Aplicar o Rechazar. Puede autorizar por separado la aplicación automática para secuencias de comandos de proyectos elegibles.

Si se solicita la implementación durante un turno del Plan, Orca puede solicitar una vez cambiar de modo. Espera a Permanecer en el plan o Cambiar a trabajar. Esa elección es independiente del permiso de edición; una preferencia de proyecto recordada explícitamente puede proporcionar un nuevo permiso de aplicación automática en sesiones de trabajo elegibles.

Una propuesta no es un escrito.

1. Orca captura el contexto del editor limitado y con ámbito de solicitud.
2. Inspecciona la información del proyecto necesaria para la tarea a través de herramientas limitadas.
3. En modo Trabajo, prepara una propuesta inmutable.
4. La propuesta se valida y se muestra en una tarjeta de revisión dedicada.
5. Elige Aplicar o Rechazar, o autoriza explícitamente la aplicación automática para las propuestas de script que cumplan los requisitos.
6. Antes del reemplazo, Orca vuelve a verificar el destino, los hashes, el estado del editor, la validación y la autorización. Las ediciones automáticas también requieren un punto de control persistente antes de escribir.

Las propuestas de archivos están vinculadas a hash y se verifican en busca de estados obsoletos o no guardados. Las ediciones automáticas mantienen la misma diferencia roja/verde en línea y la misma revisión ampliada. La reversión se verifica en caso de conflicto y requiere un punto de control válido y un objetivo sin cambios.

Permiso con un alcance definido.

La aplicación automática requiere una confirmación explícita de Permitir ediciones en el modo Trabajo. Cubre parches de proyectos independientes delimitados .gd fuera de addons/. Los parches más grandes, los cambios de escena/configuración, los scripts complementarios y la confianza en la ejecución de scripts conservan una revisión explícita. No proporciona aprobaciones de transacciones de múltiples archivos.

El permiso es solo para sesión a menos que confirmes Recordar para este proyecto. Esa preferencia exacta del proyecto se guarda localmente en EditorSettings y se puede administrar en Configuración → Sistema → Ediciones de script. Nueva sesión, restauración del historial, planificación y recarga de antiguas concesiones de tiempo de ejecución; Las sesiones de trabajo elegibles pueden obtener un nuevo permiso de la preferencia guardada. El historial de planes y de solo visualización sigue siendo de solo lectura.

Haz clic en el ícono de edición verde al lado de ORCA para revocar la aplicación automática inmediatamente, incluso durante un turno, y borrar el valor predeterminado recordado. La validación, los hashes nuevos, las comprobaciones de estado no guardado y las protecciones de ruta aún se aplican a cada escritura. Las fallas de almacenamiento de los puntos de control pausan la edición automática sin volver a adquirir el permiso silenciosamente.

Detener evita acciones adicionales y conserva las ediciones completadas. Revertir es una acción explícita e independiente. Configurar permisos de edición →

Recuperar explícitamente. Comprueba el estado actual.

Los puntos de control de script automático conservan la fuente anterior/propuesta exacta para las diferencias históricas y la reversión verificada por conflictos después del reinicio. Los registros interrumpidos ofrecen Comprobar recuperación y nunca reproducir ediciones ni permiso de restauración.

La recuperación está limitada a 64 puntos de control/4 MiB por conversación, con cada versión fuente como máximo 256 KiB/8000 líneas. Las aprobaciones pendientes y los puntos de control de reversión manual/estructurados permanecen solo en memoria. Más información sobre la recuperación de secuencias de comandos →

Limitado por el diseño.

• El acceso al proyecto permanece dentro de res://, rechaza el cruce de enlaces simbólicos y excluye el propio directorio de complementos de Orca de las herramientas del agente.
• Las propuestas no pueden sobrescribir los guiones y escenas conocidos no guardados.
• Los archivos existentes requieren el SHA-256 exacto devuelto por el lector de archivos de Orca.
• Las propuestas GDScript admitidas se validan antes de su revisión e inmediatamente antes de escribirse.
• Las rondas de herramientas, búsquedas, lecturas, respuestas, inactividad de la red y procesos de juego propios están limitados.
• Se toma una instantánea de la configuración del proveedor para un turno, de modo que un bucle de herramientas no pueda cambiar silenciosamente el punto final o el modelo.

Sepa lo que se envía y almacena.

Solicitudes y puntos finales

Las indicaciones, las imágenes adjuntas, el contexto relevante del editor y el contenido del proyecto devuelto por las herramientas pueden enviarse al proveedor que seleccione. Un punto final alojado localmente aún puede reenviar los datos recibidos a otro lugar. Orca no puede verificar qué hace un servidor después de recibir su solicitud.

Los puntos finales remotos y LAN editables requieren confirmación de su esquema exacto, host y puerto efectivo. Orca identifica HTTP sin bucle invertido y no cifrado y no sigue el chat del proveedor ni las redirecciones de descubrimiento de modelos. La confirmación es un consentimiento informado, no una prueba de confiabilidad.

Almacenamiento local

Las credenciales BYOK API se guardan a través de la configuración del editor Godot. Las credenciales de sesión/actualización de la cuenta Orca administrada utilizan la bóveda del sistema operativo, mientras que los tokens de acceso permanecen en la memoria. El historial de conversaciones del proyecto, incluidas las imágenes enviadas y las referencias de guiones, se almacena localmente como texto sin formato JSON en el almacenamiento user:// de Godot. El proveedor EditorSettings y la conversación JSON no son almacenamiento cifrado de bóveda de credenciales.

Los puntos de control de edición automática también almacenan el origen del script anterior/propuesto exacto y delimitado en la conversación local JSON. Se excluyen de los informes de soporte y continuación del proveedor y se eliminan con la conversación. Una preferencia de aplicación automática recordada reside en el EditorSettings local del proyecto exacto, fuera del historial y los archivos del proyecto; los registros de recuperación nunca otorgan permiso.

Los borradores de archivos adjuntos pendientes son solo de memoria. Las imágenes enviadas se deduplican dentro de las conversaciones dentro del alcance del proyecto y se eliminan mediante la eliminación o retención de la conversación. Cada conversación guardada conserva como máximo 32 imágenes únicas y 8 MiB de datos de imágenes decodificadas dentro de un límite de sesión JSON de 16 MiB. Las referencias de imágenes faltantes o corruptas hacen que la restauración sea de solo visualización.

Orientación y diagnóstico de proyectos.

Las instrucciones raíz limitada res://AGENTS.md y los metadatos del catálogo de habilidades del proyecto, cuando están presentes, se incluyen en un contexto privado con ámbito de solicitud. Un cuerpo de habilidades seleccionado se envía solo después de una llamada explícita a la herramienta de carga de habilidades. La guía temporal se elimina del historial reanudable después del turno.

La página Acerca de puede copiar un informe de diagnóstico incluido en la lista permitida que contiene versiones y el estado aproximado del proveedor/solicitud. Excluye credenciales, direcciones de puntos finales, ID de modelos, rutas y contenido de proyectos, conversaciones, resultados de modelos, registros, resultados de procesos, cambios y hashes.

Límites claros. Mejores expectativas.

• Orca 1.7.0 es compatible con Godot 4.7.2. Actualmente no se afirma una compatibilidad más amplia.
• Las descargas de imágenes de escritorio deben utilizar la ventana de archivos adjuntos independiente. Directo al editor Godot principal o al acoplador para invocar el controlador de importación de Godot. Se verificaron caídas de archivos adjuntos nativos en Linux/X11/Vulkan; otras plataformas, renderizadores y ventanas independientes aún necesitan pruebas de aceptación.
• Los metadatos de capacidad de imagen y las anulaciones explícitas no establecen la calidad de visión del modelo en vivo. No se incluyen archivos PDF, documentos, OCR ni capturas de pantalla automáticas.
• La verificación en tiempo de ejecución evalúa criterios estrictos de inicio o salida a partir de la salida del proceso limitada. No puede demostrar la corrección visual o del juego.
• Las aprobaciones pendientes y los puntos de control de reversión manual/estructurados no sobreviven al reinicio del editor o del complemento. Sólo los puntos de control de secuencias de comandos automáticas delimitados admiten una recuperación duradera.
• Las operaciones de escena estructuradas admiten un conjunto restringido de nodos, valores, dependencias y señales.
• La conexión y desconexión de scripts requieren una decisión de confianza y preparación separada porque Godot puede ejecutar código de proyecto mientras construye un candidato. Esto es un consentimiento informado, no una zona de pruebas.

Para obtener detalles completos, lea SECURITY.md y DEVELOPMENT.md.