¿Qué hace SlidePatch?
Usa los scripts incluidos con esta habilidad. Resuelve sus rutas de forma relativa a este archivo, independientemente del directorio de trabajo del agente anfitrión. El anfitrión necesita capacidad de ejecución local de comandos y visualización de imágenes; esta habilidad no tiene APIs específicas de DSH ni claves de API de modelos.
Para una instalación nueva, ejecuta python <skill>/scripts/slidepatch.py doctor (añade --charts para migración de gráficos o --equations para conversión de ecuaciones). Esto verifica dependencias y el registro de Office sin abrir aplicaciones. Un resultado listo no sustituye a la verificación nativa.
Conversión nativa de ecuaciones
Para solicitudes de conversión de texto de fórmula independiente, imágenes o ecuaciones MathType/OLE a ecuaciones nativas de PowerPoint, usa inspect-equations y convert-equations. Lee references/equations.md para el plan, la transcripción y el contrato de verificación. Este modo necesita Pandoc además de Windows/PowerPoint; otros modos no requieren Pandoc. Preserva el diseño de la presentación, el recuento de páginas y los objetos no especificados, no usa plantilla y no reconvierte ecuaciones nativas existentes. LaTeX explícito de objetos completos produce candidatos; el Agente revisa y transcribe imágenes y vistas previas OLE almacenadas en caché sin activar OLE ni analizar binarios MathType. Deja los objetos poco claros intactos e infórmalos. La migración de plantillas actualmente rechaza ecuaciones nativas para evitar la pérdida de estructura matemática; no trates la conversión como soporte automático para migrar las ecuaciones resultantes.
Migración y paginación de presentación completa
Para una solicitud de migrar la presentación completa o permitir la paginación, prefiere migrate. Lee references/batch.md para el contrato de cobertura y el formato de evidencia.
python <skill>/scripts/slidepatch.py migrate <source.pptx> --template <template.pptx> --output <new-output.pptx> --evidence <fresh-evidence-directory>
El motor visita cada diapositiva de origen en orden. Identifica páginas de portada, contenido, sección numerada y contenido ordinario; prefiere el tipo de página de plantilla coincidente; y reutiliza fondos, gráficos y diseños de plantilla nativos. Una página de contenido puede usar un estilo de página de contenido cuando no hay una plantilla de contenido dedicada. Revisa la clasificación y el respaldo en plan.json; esto es inferencia geométrica/tipográfica, no comprensión de imágenes sin restricciones.
Preserva la familia de fuente, tamaño, peso y color de la plantilla. Las mediciones de texto nativo determinan la capacidad. Mantén los grupos completos juntos cuando sea posible; equilibra el volumen de texto entre particiones de página de grupo completo igualmente cortas. Si un solo grupo es demasiado grande, divide en límites de objeto de cuerpo, párrafo u oración, preservando cortes de caracteres exactos. Las páginas de continuación de grupo sobredimensionado alinean el contenido en la parte superior. Los títulos, encabezados de grupo y pies de página se repiten como contexto explícito; los segmentos de cuerpo deben reconstruir el origen exactamente una vez y en orden. Nunca reescribas números de origen ni renumeres silenciosamente una tabla de contenido. Una oración que no pueda caber sin cambiar la tipografía de la plantilla hace fallar toda la operación.
Este modo admite texto editable ordinario, marcadores de posición de texto de origen admitidos e imágenes incrustadas/gráficos nativos con estructura clara. Los límites del marcador de posición de origen están en references/plan.md. Para páginas multimedia, lee references/media.md: las imágenes y sus recortes permanecen nativos, los gráficos conservan libros de trabajo incrustados y los subtítulos asociados se quedan con sus activos durante el diseño y la paginación. Las páginas multimedia usan plantillas de contenido. Las decoraciones que no son texto, los marcadores de posición no admitidos, los grupos, las animaciones, los enlaces externos y las estructuras ambiguas no son compatibles. El fallo en cualquier página impide la publicación de toda la salida; nunca entregues una presentación parcial. Cada página generada se vuelve a abrir, se renderiza, se verifica con respecto a la fuente/fondo de su plantilla, y se edita y guarda realmente en una copia de prueba separada. La salida se publica solo después de que todas las comprobaciones de página, texto y multimedia pasan.
Revisa cada after-N.png, especialmente los títulos de portada/sección, el respaldo de la página de contenido y los límites de paginación. Lee las comprobaciones por página y la lista de páginas editables en report.json. Entrega el PPTX verificado, la vista previa y un breve resumen de página de origen a salida. Indica que la repetición de contexto es intencional cuando se dividieron las páginas. Los originales permanecen sin cambios.
Modo de archivo único (plan v1)
- La entrada es un
.pptxexistente; el origen y la referencia son diapositivas diferentes en ese archivo con el mismo diseño y maquetación y gráficos maestros ocultos. - Origen: formas ordinarias, líneas y cuadros de texto horizontales. Referencia: estos más imágenes decorativas. Sin grupos, marcadores de posición, gráficos, SmartArt, animaciones, transiciones, hipervínculos ni objetos rotados en ninguna diapositiva seleccionada.
- Cada objeto de texto de origen se asigna exactamente a un objeto de texto de referencia, y viceversa. Las formas sin texto del origen deben identificarse explícitamente como decoraciones para reemplazar. Detente para aclaración si un objeto podría contener evidencia visual significativa.
- La operación reemplaza los objetos locales de la diapositiva de origen con copias nativas de los objetos de referencia y los llena con cadenas de origen exactas. Adopta la tipografía de la referencia, incluidos los cambios en el énfasis; no promete preservar el formato de caracteres del origen.
- Sin resumen de contenido, división de páginas, reducción automática de fuente ni reconstrucción de imagen a editable. Si las diapositivas seleccionadas no se ajustan a estos límites, explica la limitación específica en lugar de reconstruir la presentación a través de una herramienta no relacionada.
Modo de plantilla separada (plan v2)
Usa apply-template para una diapositiva de origen y una plantilla en archivos PPTX separados. Este modo produce una nueva diapositiva en las dimensiones de la plantilla; no reescribe la presentación de origen ni incluye las otras diapositivas de la plantilla. Elige v1 cuando el usuario requiera preservar las otras diapositivas de la presentación de origen.
Inspecciona ambos archivos, incluidos los gráficos de diseño/maestro heredados ahora listados bajo inheritance. Ve las vistas previas reales y elige una página de contenido en lugar de asumir que la diapositiva 2 es una plantilla adecuada. Preserva la marca y las decoraciones. Clasifica explícitamente cada objeto de plantilla local como decoración conservada o contenido de muestra eliminado; no retengas fotos de plantilla no relacionadas como evidencia para el contenido de origen.
Crea una ubicación por objeto de texto de origen. Una ubicación nombra una forma de texto ordinaria que porte estilo como donante de estilo y da límites en puntos. El mismo donante puede servir para múltiples ubicaciones, por lo que los recuentos de texto de origen y plantilla pueden diferir. El motor duplica objetos nativos dentro de la plantilla, preservando su diseño/maestro y tema. El texto proviene directamente del origen; los planes no contienen cadenas de reemplazo. La reducción de fuente y la reescritura de contenido no son compatibles.
Las restricciones de origen de v1 se aplican excepto que v2 también acepta los marcadores de posición de texto de origen admitidos. Los espacios de texto seguros vacíos se registran explícitamente como descartados; el texto de origen heredado activo causa rechazo en lugar de ser omitido silenciosamente. Los donantes de estilo deben ser formas de texto horizontales ordinarias sin rotar, no marcadores de posición/grupos. Las decoraciones de diseño/maestro de la plantilla permanecen nativas, incluidas imágenes heredadas y marcadores de posición de diseño no utilizados. Las decoraciones locales conservadas no deben tener texto. Los planes registran qué objetos se eliminan; la planificación automática puede proponer estas decisiones, mientras que el Agente revisa su significado.
Diseño automático (preferido para plantillas separadas)
Para un origen solo de texto con un título y texto de cuerpo claros, incluidos marcadores de posición de texto de origen admitidos, primero ejecuta:
python <skill>/scripts/slidepatch.py plan-template <source.pptx> --template <template.pptx> --source-slide 1 --out <fresh-planning-directory>
Esto genera un plan.json v2 normal sin proporcionar manualmente la página de destino, los ID de forma ni las coordenadas. selection.json registra roles de origen inferidos, páginas de plantilla candidatas, decisiones de decoración basadas en geometría, diseños candidatos, medidas de ajuste y razones de rechazo. El estado planned significa que existe un plan, no que un PPTX haya pasado la verificación final.
El planificador usa la jerarquía de fuentes y la proximidad espacial para asociar encabezados y cuerpos; no usa nombres de forma ni números de página de plantilla. Requiere un título superior distinto, reconoce pies de página inferiores de fuente corta y admite filas/columnas agrupadas o párrafos sin encabezado. Busca diseños de fila, apilados, dos columnas y tres columnas, usando los límites de texto nativos de PowerPoint con los tamaños de fuente originales de la plantilla. El texto se ajusta; no se produce reescritura de cadenas ni reducción de fuente. Los cuadros candidatos no deben superponerse entre sí ni con decoraciones conservadas. Los fondos de página completa y los marcadores de posición de diseño no utilizados se excluyen de las comprobaciones de obstáculos.
Lee selection.json, ve source.png y el template-N.png seleccionado, y verifica que las asociaciones de roles y la eliminación de imágenes de muestra tengan sentido. La clasificación automática de imágenes usa geometría y subtítulos cercanos, no comprensión de imágenes. No afirmes una coincidencia semántica universal. Para un resultado inequívoco, procede directamente a apply-template con el plan generado y luego revisa la salida renderizada. El usuario no necesita proporcionar coordenadas ni aprobar elecciones rutinarias ya cubiertas por su solicitud.
Si la planificación de una sola página rechaza roles ambiguos, decoraciones inciertas, objetos no admitidos o contenido de capacidad superior, lee la razón registrada. Cuando la paginación está autorizada, usa migrate. De lo contrario, inspecciona los objetos reales antes de usar un plan v2 explícito revisado. Nunca omitas contenido silenciosamente, reduzcas fuentes ni cambies el ámbito de página autorizado. Las fuentes con imágenes, decoraciones sin texto, jerarquía mixta/poco clara, gráficos o grupos aún necesitan un flujo de trabajo explícito o de contenido no admitido.
Ejecución
Instala requirements.txt en un entorno virtual Python 3.10+. Usa ese intérprete para cada comando. PowerPoint de escritorio debe ser utilizable en la sesión de Windows iniciada. Primero inspecciona:
python <skill>/scripts/slidepatch.py inspect <source.pptx> --out <fresh-inspection-directory>
Lee inventory.json y ve las vistas previas relevantes de slide-N.png. Empareja los roles de contenido usando los objetos reales y la apariencia. Nunca infieras ID de forma a partir de su orden ni reconstruyas el texto protegido de memoria.
Para modo de archivo único, crea un plan JSON usando el esquema en references/plan.md. Para plantillas separadas, prefiere plan-template; usa un plan v2 revisado manualmente cuando la inferencia automática no sea adecuada. Copia hashes e IDs de inventarios actuales. Preserva el ámbito previsto por el usuario. Una solicitud clara autorizada con un mapeo inequívoco puede proceder; pregunta solo cuando una ambigüedad de contenido material no pueda resolverse a partir de los archivos.
python <skill>/scripts/slidepatch.py apply <source.pptx> --plan <plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
Para una plantilla separada, inspecciónala también, luego usa un plan v2:
python <skill>/scripts/slidepatch.py inspect <template.pptx> --out <fresh-template-inspection>
python <skill>/scripts/slidepatch.py apply-template <source.pptx> --template <template.pptx> --plan <v2-plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
El motor prepara la presentación editada, la vuelve a abrir y renderiza en PowerPoint, compara objetos de texto exactos y números, verifica las diapositivas no objetivo, y prueba una edición de texto real y un movimiento de forma en una copia de prueba separada. Publica la salida solo después de que estas comprobaciones pasan. Nunca llama a PowerPoint Quit ni cierra presentaciones no relacionadas. La copia/pegar nativa usa el portapapeles del sistema.
El modo de plantilla en su lugar verifica el resultado de una diapositiva, ambos hashes originales, todas las cadenas de origen locales, los objetos nativos guardados y las capas de decoración renderizadas idénticas antes/después. Se permite el sangrado decorativo existente; el contenido nuevo debe caber. Usa Duplicar nativo sin el portapapeles. El PPTX aún puede contener diseños, maestros o multimedia de plantilla no utilizados; este prototipo no limpia los activos de paquete ocultos.
Revisión y entrega
Lee report.json; el estado de salida y el informe deben indicar éxito. Ve before-<source>.png, before-<reference>.png y after-<source>.png. Verifica que el estilo coincida y que no haya recortes, superposición no deseada ni orden de lectura incorrecto. Las comprobaciones geométricas no reemplazan la revisión visual.
Para modo de plantilla, ve source-before.png, template-before.png, after-1.png, más template-shell.png y output-shell.png. Verifica la nueva composición contra el lenguaje visual de la plantilla; la coincidencia de cadenas de texto por sí sola es insuficiente.
Entrega el nuevo PPTX con una vista previa y un resumen conciso de las comprobaciones y el alcance. editability-proof.pptx contiene deliberadamente un marcador de edición y es evidencia, no el entregable final. Si falla alguna comprobación, informa el problema; nunca presentes un archivo preparado o de prueba como la presentación final. Elige rutas nuevas en reintentos, manteniendo la evidencia de fallo disponible.