Slidecraft

Slidecraft verwandelt Quellmaterial in polierte, bearbeitbare PowerPoint-Präsentationen in der Agent-App, die Sie bereits verwenden. Der Agent plant und leitet die Arbeit, während Slidecraft Projektdateien, visuelle Ressourcen, Bildgenerierung, Slide-Verständnis und PowerPoint-Konstruktion organisiert.

Die aktuelle Alpha ist für lokale Projekte über Codex, Claude Code, GitHub Copilot und andere MCP-kompatible Agent-Apps bereit. Der Release-Fortschritt wird in Release-Bereitschaft verfolgt.

Installation

Installieren Sie Python 3.10 oder neuer und die aktuelle Node.js-LTS-Version und führen Sie dann den geführten Installer aus.

macOS und 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 -

Der Installer erstellt eine isolierte Laufzeitumgebung, installiert alltägliche Präsentationsfunktionen, bereitet den bearbeitbaren PowerPoint-Konstruktor vor, verifiziert die Installation und verbindet erkannte Agent-Apps. Er kann bei einem Update von Slidecraft sicher erneut ausgeführt werden.

Siehe Installation für eine Option zum Prüfen vor der Ausführung, ausgewählte Agent-Einrichtung, GitHub-Copilot-Workspace-Einrichtung, Installationsorte und Fehlerbehebung.

Mitwirkende können aus einem geklonten Checkout mit demselben geführten Ablauf installieren.

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

Der Installer gibt den genauen Dashboard-Befehl aus, wenn er fertig ist. Er folgt dieser Form.

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

Das Dashboard zeigt Projekte, Stileinstellungen, gemeinsame Ressourcensammlungen, Provider-Konfiguration und Laufzeitstatus. Projekt- und Bibliotheksordner können direkt im Dateibrowser des Betriebssystems geöffnet werden.

Related MCP server: PPTX MCP Server

Agent-Integration

Slidecraft stellt dieselben Fähigkeiten im Prozess, über seine CLI und über MCP bereit.

slidecraft agent-capabilities
slidecraft-mcp

Ihre Agent-App verwaltet das Gespräch. Slidecraft zeichnet Projektentscheidungen, Quellen, Fortschritt und Ergebnisse auf, sodass jede neue Sitzung vom selben Projekt fortgesetzt werden kann. Das Dashboard präsentiert diese Dateien und Einstellungen an einem Ort.

Die gebündelte Agent-Skill ist unter integrations/skills/slidecraft/SKILL.md verfügbar. Der vollständige Host-Vertrag ist in Agent-Integration dokumentiert.

Der MCP-Server ist selbstbeschreibend und funktioniert als lokaler STDIO-Toolserver in Codex, Claude Code, GitHub Copilot Chat und anderen MCP-fähigen Hosts. Hostspezifische Einrichtungsbeispiele finden Sie in Agent-Schnellstart.

In einer neuen Sitzung benennen Sie das Projekt und beschreiben, was Sie möchten. Der Agent findet seinen gespeicherten Fortschritt, setzt die Arbeit fort oder gibt das angeforderte Präsentationsartefakt zurück. Siehe Agent-Schnellstart.

Shell-basierte Agent-Hosts können denselben namensbasierten Einstiegspunkt direkt verwenden.

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

Projekte und Ressourcen

Ein Projekt kann in einem vom Benutzer gewählten Verzeichnis oder im verwalteten Datenverzeichnis von Slidecraft liegen.

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

Visuelle Inspiration, kanonische Icons und wiederverwendbare bearbeitbare Komponenten befinden sich in gemeinsamen lokalen Sammlungen. Auswahlen, die im Chat oder im Dashboard getroffen werden, bleiben am Projekt haften und sind bereit, wenn das Projekt erneut geöffnet wird.

Die Konfiguration folgt gepackten Standardwerten, Benutzerkonfiguration, einem optionalen Projekt-Overlay, Umgebungsvariablen und expliziten Laufzeitargumenten. Verwenden Sie diese Befehle, um jeden aufgelösten Wert und seine Quelle zu überprüfen.

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

Siehe Konfiguration, Leitfadenprofile und die Dokumentationsübersicht.

Pipeline

Der Agent denkt den Präsentationsworkflow durch und setzt diese wiederverwendbaren Fähigkeiten zusammen.

1. Multimodales Quellmaterial und harte Einschränkungen normalisieren.

2. Die Storyline des Decks und die slide-spezifische semantische Absicht planen.

3. Visuelle Inspiration, kanonische Icons und wiederverwendbare Komponenten suchen und dann die nützlichen Ressourcen im Kontext auswählen.

4. Bildgenerierungs-Briefings für informationshaltige Slides zusammenstellen und ausführen.

5. Agent-visuelles Denken verwenden, um bedeutungsvolle gerenderte Entitäten und Beziehungen auf maßgebliche Quellinhalte abzubilden.

6. Text, Formen und Layout mit OpenCV messen, wobei SAM 2 für unregelmäßige gefüllte Bereiche verwendet wird, wenn es nützliche Grenzdetails hinzufügt.

7. Rekonstruktionsrouten und Verfeinerungsabsicht verfassen und dann bearbeitbare PowerPoint-Szenen kompilieren.

8. Deterministische begrenzte Normalisierung auf vom Agenten identifizierte Typografiegruppen, Ausrichtungen, Icon-Slots und Connector-Topologie anwenden.

9. Das bearbeitbare Deck rendern und einen Rekonstruktionsbericht aufbewahren.

Der Systemvertrag ist in Framework-Pipeline dokumentiert. Connector-Argumentation ist in Connector-Vertrag dokumentiert. Verfeinerungseinschränkungen sind in Normalisierungsvertrag dokumentiert.

Repository-Layout

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

Die oberste AGENTS.md gibt repository-bewussten Agenten einen prägnanten Einstiegsvertrag. Gemeinsamer Framework-Code hängt nie von einem Projekt unter workspace/ oder von Test-Fixtures ab.

Live-Präsentationsprojekte und generierte Ausgaben bleiben während der Repository-Entwicklung unter workspace/ und sind von Git ausgeschlossen. Gepackte Starter-Ressourcen befinden sich unter src/slidecraft/starter_resources/.

Jedes neue Projekt erhält eine gepackte Deck-Design-Baseline unter seinem versteckten .slidecraft/-Verzeichnis. Cover, Agenden, Abschnittstrenner, Aussagen, Abschlüsse und Anhangstrenner verwenden gemeinsame deterministische Layouts. Informationshaltige Slides verwenden den Bildgenerierungsweg. Die endgültige Zusammenstellung erfordert alle geplanten Slides in Deck-Reihenfolge und prüft das eingefrorene Design, wiederholte Typografierollen, Connector-Richtlinie, kanonische Assets, Canvas und Deck-Chrome vor dem Export.

Entwicklung

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

OpenCV übernimmt die Messung von gewöhnlichem Text, Connectors und Strichzeichnungen. Installieren Sie das segmentation-Extra, um SAM-2-Grenzerkennung für unregelmäßige gefüllte Objekte hinzuzufügen.

Lizenz

Slidecraft wird unter der MIT-Lizenz veröffentlicht. Gebündelte Ressourcen von Drittanbietern behalten ihre eigenen Hinweise.