Crea un .tryslides sin MCP
Referencia del paquete portátil y ejemplo probado para agentes y programadores.
Leer en MarkdownEmpieza con un ejemplo válido
Descarga el paquete editable mínimo, su documento y el empaquetador Python. Solo usa la biblioteca estándar de Python: no llama a MCP ni necesita el repositorio privado.
Ejecuta el script con Python 3 junto a document.json para generar presentation.tryslides. Impórtalo desde el espacio de presentaciones. El ejemplo contiene una diapositiva con un rectángulo, sin dependencias de imágenes ni texto.
Estructura del paquete
Es un contenedor ZIP con extensión .tryslides, no un JSON renombrado. Contiene manifest.json, document.json y los archivos de imágenes/fuentes referenciados.
| Campo del manifiesto | Significado |
|---|---|
format | Exactamente tryslides |
formatVersion | Versión de paquete 1 |
metadata.title, metadata.createdAt | Título y fecha ISO |
document.path | Exactamente document.json |
document.size, document.sha256 | Longitud UTF-8 y SHA-256 en minúsculas de los bytes exactos |
assets | Registros de imágenes |
fonts | Registros de fuentes con avisos de licencia |
Una imagen declara id, path seguro, MIME contentType, size y sha256. Las fuentes usan fontId y licencia con nombre, URL de origen y aviso. Rutas e identidades deben coincidir con el documento. Una URL externa no sustituye los bytes de imagen.
Contrato del documento
El ejemplo usa schema version 16, distinta de la versión 1 del paquete. Incluye identidad, título, fechas, tema, lienzo, diapositivas, elementos y estructuras de historial validadas. Conserva toda la estructura, no solo slides.
Empieza cambiando el título y la geometría/apariencia del rectángulo sin alterar los tipos. El lienzo es 1920 × 1080. Usa identidades únicas y referencias válidas; no copies campos arbitrarios de PPTX u otro editor.
Para archivos más ricos, exporta una presentación pequeña con el elemento deseado como referencia. El texto usa estado enriquecido estructurado, no una cadena simple. Los Steps conservan identidad y diferencias de estado. No inventes esas estructuras. El esquema de comandos MCP no es el esquema serializado del paquete.
Recursos y comprobación
El script incluido solo empaqueta documentos de formas sin recursos. Para imágenes o texto incorpora binarios y licencias desde una exportación válida y actualiza tamaños y hashes. Máximo: 100 MiB, 100 recursos de imagen/fuente combinados y 25 MiB por recurso.
Cualquier cambio de bytes, incluso espacios, exige recalcular tamaño y hash. Se rechazan rutas inseguras, referencias ausentes, checksums incorrectos y estados inválidos. Un ZIP válido no garantiza una presentación válida.
Importa siempre el resultado y revisa cada diapositiva y Step antes de entregarlo. El formato está en prelanzamiento y puede evolucionar; usa el ejemplo actual.