Compatibilidad y formatos de datos

Este es el contrato de compatibilidad de SaveTether 1.0.0.

Entorno admitido

SaveTether admite Unreal Engine 5.8 Editor en Windows de 64 bits. El paquete exacto se compiló e instaló con UE 5.8.2 (CL 56702186). Es una herramienta exclusiva del Editor; nunca abre ni migra datos de partidas guardadas. Las herramientas de IA opcionales usan Toolset Registry/Python de Unreal solo si el usuario activa esos plugins del motor; no se incluyen ni son necesarios para el panel principal.

Integración pública

SaveTether 1.0.0 no declara una API externa compatible de C++/Blueprint. USaveTetherAISubsystem es un puente interno reflejado del Editor. La interfaz documentada opcional para automatización es el toolset de Toolset Registry: review_with_baseline, review_initial_declarations, get_review_status, get_review_page, export_report y capture_release.

En la línea 1.0.x se mantienen estables los nombres de herramientas, el significado de sus argumentos y las salvaguardas. Las versiones compatibles pueden añadir campos de resultado o herramientas, pero no cambiarán ni retirarán en silencio campos u operaciones existentes. Ignora los campos de resultado que no uses. No se promete compatibilidad binaria entre versiones o builds de Unreal: recompila para la instalación UE 5.8 Editor de destino.

Datos persistidos

• Las declaraciones escritas por el usuario usan schemaVersion: 1 y documentType: "SaveTetherDeclarations", con releaseId, identifiers tipados y propuestas de mapeo opcionales.
• Las baselines capturadas usan schemaVersion: 1 y documentType: "SaveTetherRelease", con releaseId, contentFingerprint e identifiers (kind, identifier, assetPath anulable). Es historial de identidades, no una migración ni certificado de compatibilidad de partidas.
• Los informes exportados usan schemaVersion: 1 y documentType: "SaveTetherChangeReport", con versiones del plugin/motor, estado/cobertura, fingerprints, cambios, mapeos y hallazgos. Pueden incluir identificadores y rutas del proyecto.
• Los perfiles y archivos de selección local usan schemaVersion: 1 y documentType: "SaveTetherProfile" o "SaveTetherPreferences". Las preferencias incluyen rutas de entrada/salida seleccionadas y son locales a la máquina.

Los lectores aceptan el esquema 1 y rechazan versiones futuras desconocidas en vez de adivinarlas o reescribirlas en silencio. Las releases capturadas son inmutables; los guardados de configuración conservan archivos existentes cuando debe elegirse un nombre nuevo. No hay migración automática de esquemas. Cualquier formato incompatible futuro debe usar una nueva versión de esquema e incluir instrucciones explícitas de actualización. La línea 1.0.x mantiene la lectura de documentos de esquema 1.

Alcance de la garantía

La versión 1.0.0 es la base inicial de compatibilidad. Los cambios incompatibles del contrato Toolset Registry o de formatos persistidos requieren una nueva versión mayor y una ruta explícita de migración; los añadidos compatibles siguen siendo opcionales. Una revisión completada solo describe cobertura de evaluación: no demuestra que las partidas existentes sigan siendo compatibles ni que carguen correctamente.