Slidecraft

Slidecraft convierte material de origen en presentaciones de PowerPoint pulidas y editables dentro de la aplicación de agente que ya usas. El agente planifica y guía el trabajo mientras Slidecraft organiza los archivos del proyecto, los recursos visuales, la generación de imágenes, la comprensión de diapositivas y la construcción de PowerPoint.

La versión alfa actual está lista para proyectos locales a través de Codex, Claude Code, GitHub Copilot y otras aplicaciones de agente compatibles con MCP. El progreso de la versión se sigue en Preparación para la versión.

Instalación

Instala Python 3.10 o superior y la versión LTS actual de Node.js, y luego ejecuta el instalador guiado.

macOS y Linux

curl -fsSL https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | python3 -

Windows PowerShell

irm https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | py -3 -

El instalador crea un entorno de ejecución aislado, instala las funciones habituales de presentación, prepara el constructor de PowerPoint editable, verifica la instalación y conecta las aplicaciones de agente detectadas. Se puede volver a ejecutar de forma segura cuando Slidecraft se actualice.

Consulta Instalación para conocer la opción de inspección antes de ejecutar, la configuración de agentes seleccionados, la configuración del espacio de trabajo de GitHub Copilot, las ubicaciones de instalación y la resolución de problemas.

Los colaboradores pueden instalar desde un clon del repositorio con el mismo flujo guiado.

git clone https://github.com/henryhyw/slidecraft.git
cd slidecraft
python3 install.py --source .

El instalador imprime el comando exacto del panel cuando termina. Sigue esta forma.

/path/to/Slidecraft/app/bin/slidecraft console

El panel muestra proyectos, ajustes de estilo, colecciones de recursos compartidos, configuración del proveedor y estado del entorno de ejecución. Las carpetas de proyectos y bibliotecas se pueden abrir directamente en el explorador de archivos del sistema operativo.

Related MCP server: PPTX MCP Server

Integración con el agente

Slidecraft expone las mismas capacidades en proceso, a través de su CLI y mediante MCP.

slidecraft agent-capabilities
slidecraft-mcp

Tu aplicación de agente gestiona la conversación. Slidecraft registra las decisiones del proyecto, las fuentes, el progreso y los entregables para que cualquier nueva sesión pueda continuar desde el mismo proyecto. El panel presenta esos archivos y ajustes en un solo lugar.

La habilidad de agente incluida está disponible en integrations/skills/slidecraft/SKILL.md. El contrato completo del host está documentado en Integración con el agente.

El servidor MCP es autodescriptivo y funciona como un servidor de herramientas STDIO local en Codex, Claude Code, GitHub Copilot Chat y otros hosts compatibles con MCP. Hay ejemplos de configuración específicos para cada host en Inicio rápido del agente.

En una sesión nueva, nombra el proyecto y describe lo que quieres. El agente encuentra su progreso guardado, continúa el trabajo o devuelve el artefacto de presentación solicitado. Consulta Inicio rápido del agente.

Los hosts de agente basados en shell pueden usar el mismo punto de entrada de nombre primero directamente.

slidecraft project resolve "Market Growth"
slidecraft project show "Market Growth"

Proyectos y recursos

Un proyecto puede vivir en un directorio elegido por el usuario o en el directorio de datos gestionado por Slidecraft.

project/
  slidecraft.project.json
  sources/           user material and direct-use visual assets
  deliverables/      editable presentations, previews, and reports
  .slidecraft/       durable Agent evidence and resource assignments

La inspiración visual, los iconos canónicos y los componentes editables reutilizables viven en colecciones locales compartidas. Las selecciones realizadas en el chat o en el panel permanecen vinculadas al proyecto y están listas cuando se vuelve a abrir el proyecto.

La configuración sigue los valores predeterminados del paquete, la configuración del usuario, una superposición opcional del proyecto, las variables de entorno y los argumentos explícitos de ejecución. Usa estos comandos para inspeccionar cada valor resuelto y su origen.

slidecraft config path
slidecraft config show
slidecraft config validate
slidecraft config explain

Consulta Configuración, Perfiles de guía y el mapa de documentación.

Canal de trabajo

El agente razona a través del flujo de trabajo de presentación y compone estas capacidades reutilizables.

1. Normalizar el material de origen multimodal y las restricciones estrictas.

2. Planificar la narrativa de la presentación y la intención semántica específica de cada diapositiva.

3. Buscar inspiración visual, iconos canónicos y componentes reutilizables, y luego seleccionar los recursos útiles en contexto.

4. Montar y ejecutar resúmenes de generación de imágenes para diapositivas con información.

5. Usar el razonamiento visual del agente para mapear entidades y relaciones renderizadas significativas con el contenido de la fuente autoritativa.

6. Medir texto, formas y diseño con OpenCV, usando SAM 2 para regiones rellenas irregulares cuando añade detalles de contorno útiles.

7. Redactar rutas de reconstrucción e intención de refinamiento, y luego compilar escenas de PowerPoint editables.

8. Aplicar normalización determinista acotada a grupos de tipografía, alineaciones, ranuras de iconos y topología de conectores identificados por el agente.

9. Renderizar la presentación editable y conservar un informe de reconstrucción.

El contrato del sistema está documentado en Canal de trabajo del framework. El razonamiento de conectores está documentado en Contrato de conectores. Las restricciones de refinamiento están documentadas en Contrato de normalización.

Estructura del repositorio

src/slidecraft/       installable Python package and dashboard
js/                   portable PowerPoint constructor
scripts/              installed worker and platform integration scripts
config/               versioned framework and design-policy examples
src/slidecraft/guidance_profiles/ reusable communication profiles
schemas/              interchange contracts
integrations/         Agent integration packages
tests/                automated tests
tools/historical_regression/  architecture-slide regression utilities excluded from the runtime
vendor/               upstream development sources for bundled resources
workspace/            ignored local projects, caches, and generated evidence

El AGENTS.md de nivel superior ofrece a los agentes conscientes del repositorio un contrato de entrada conciso. El código compartido del framework nunca depende de un proyecto bajo workspace/ ni de accesorios de prueba.

Los proyectos de presentación en vivo y la salida generada permanecen bajo workspace/ durante el desarrollo del repositorio y se excluyen de Git. Los recursos iniciales empaquetados viven bajo src/slidecraft/starter_resources/.

Cada proyecto nuevo recibe una línea base de diseño de presentación empaquetada bajo su directorio oculto .slidecraft/. Portadas, agendas, divisores de sección, declaraciones, cierres y divisores de apéndice usan diseños deterministas compartidos. Las diapositivas con información usan la ruta de generación de imágenes. El ensamblaje final requiere todas las diapositivas planificadas en orden de presentación y verifica el diseño congelado, los roles de tipografía repetidos, la política de conectores, los activos canónicos, el lienzo y el marco de la presentación antes de exportar.

Desarrollo

.venv/bin/python -m pytest -q
.venv/bin/python -m ruff check src tests tools
.venv/bin/python -m build

OpenCV maneja la medición de texto ordinario, conectores y arte lineal. Instala el extra segmentation para añadir la detección de contornos SAM 2 para objetos rellenos irregulares.

Licencia

Slidecraft se publica bajo la Licencia MIT. Los recursos de terceros incluidos conservan sus propios avisos.