Communitygithub.com

slidepatch

Gestaltet bearbeitbare PowerPoint-Inhalte mithilfe einer Referenzfolie oder PPTX-Vorlage neu, wobei Text, Zahlen, eingebettete Bilder und native Diagrammdaten erhalten bleiben. Unterstützt automatische Vorlagenauswahl, Layout, Paginierung sowie Schrift- und Farbanpassung bei Diagrammen, inklusive Deck-, Inhalts- und Abschnittsseiten. Wandelt eigenständige Formeln nach geprüften Plänen in native PowerPoint-Gleichungen um. Enthält Umgebungsprüfungen und native Bearbeitungsverifizierung. Erfordert Windows und Microsoft PowerPoint (Desktop); für die Diagrammprüfung ist auch Excel erforderlich.

Was ist slidepatch?

SlidePatch ist ein leistungsstarkes Tool zur Neugestaltung von PowerPoint-Präsentationen, das es AI-Agenten ermöglicht, bearbeitbare Folieninhalte unter Beibehaltung von Text, Zahlen, eingebetteten Bildern und nativen Diagrammdaten zu restylen. Es unterstützt sowohl die automatische Vorlagenauswahl als auch individuelle Layouts und Paginierung, einschließlich Deck-, Inhalts- und Abschnittsseiten. Zudem können eigenständige Formeln nach einem geprüften Plan in native PowerPoint-Gleichungen umgewandelt werden. Das Tool ist für Entwickler und Power-User konzipiert, die mit Inhalten aus LLM-generierten Präsentationen oder Vorlagen arbeiten. Es erfordert Windows und Microsoft PowerPoint (Desktop); für die Diagrammprüfung ist auch Excel notwendig. SlidePatch enthält umfassende Umgebungschecks und eine native Bearbeitungsverifizierung, die sicherstellt, dass jede generierte Folie korrekt gerendert und bearbeitbar ist.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ChenYueqi2024/SlidePatch/tree/HEAD/skills/slidepatch

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht slidepatch?

Verwenden Sie die mit dieser Fertigkeit gebündelten Skripte. Lösen Sie ihre Pfade relativ zu dieser Datei auf, unabhängig vom Arbeitsverzeichnis des Host-Agenten. Der Host benötigt lokale Befehlsausführung und Bildanzeige; diese Fertigkeit hat keine DSH-spezifischen APIs oder Modell-API-Schlüssel.

Für eine Neuinstallation führen Sie python <skill>/scripts/slidepatch.py doctor aus (fügen Sie --charts für Diagrammmigration oder --equations für Gleichungskonvertierung hinzu). Dies überprüft Abhängigkeiten und die Office-Registrierung, ohne Anwendungen zu öffnen. Ein Bereitergebnis ist kein Ersatz für eine native Überprüfung.

Native Gleichungskonvertierung

Bei Anfragen zur Konvertierung von eigenständigem Formeltext, Bildern oder MathType/OLE-Gleichungen in native PowerPoint-Gleichungen verwenden Sie inspect-equations und convert-equations. Lesen Sie references/equations.md für den Plan, die Transkription und den Verifikationsvertrag. Dieser Modus benötigt zusätzlich zu Windows/PowerPoint Pandoc; andere Modi benötigen Pandoc nicht. Er erhält das Layout, die Seitenanzahl und nicht näher bezeichnete Objekte des Decks, verwendet keine Vorlage und konvertiert vorhandene native Gleichungen nicht erneut. Explizite ganzobjektive LaTeX erzeugt Kandidaten; der Agent überprüft und transkribiert Bilder und zwischengespeicherte OLE-Vorschauen, ohne OLE zu aktivieren oder MathType-Binärdateien zu parsen. Lassen Sie unklare Objekte intakt und melden Sie sie. Die Vorlagenmigration lehnt derzeit native Gleichungen ab, um einen Verlust mathematischer Strukturen zu verhindern; behandeln Sie die Konvertierung nicht als automatische Unterstützung für die Migration der resultierenden Gleichungen.

Gesamtdeck-Migration und Paginierung

Bei einer Anfrage zur Migration der gesamten Präsentation oder zur Ermöglichung von Paginierung bevorzugen Sie migrate. Lesen Sie references/batch.md für den Abdeckungsvertrag und das Beweisformat.

python <skill>/scripts/slidepatch.py migrate <source.pptx> --template <template.pptx> --output <new-output.pptx> --evidence <fresh-evidence-directory>

Die Engine besucht jede Quellfolie der Reihe nach. Sie identifiziert Deckblätter, Inhaltsseiten, nummerierte Abschnitte und normale Inhaltsseiten; bevorzugt den passenden Vorlagen-Seitentyp; und verwendet native Vorlagenhintergründe, Grafiken und Layouts wieder. Eine Inhaltsseite kann einen Inhaltsseitenstil verwenden, wenn es keine dedizierte Inhaltsvorlage gibt. Überprüfen Sie die Klassifizierung und den Fallback in plan.json; dies ist geometrische/typografische Inferenz, kein uneingeschränktes Bildverständnis.

Behalten Sie Schriftfamilie, -größe, -stärke und -farbe der Vorlage bei. Native Textmessungen bestimmen die Kapazität. Halten Sie vollständige Gruppen nach Möglichkeit zusammen; balancieren Sie die Textmenge auf gleich kurzen ganzseitigen Gruppenpartitionen aus. Wenn eine einzelne Gruppe zu groß ist, teilen Sie sie an Körperobjekt-, Absatz- oder Satzgrenzen auf, wobei genaue Zeichenschnitte erhalten bleiben. Fortsetzungsseiten für überdimensionierte Gruppen richten den Inhalt oben aus. Titel, Gruppenüberschriften und Fußzeilen werden als expliziter Kontext wiederholt; Körperausschnitte müssen die Quelle genau einmal und in der richtigen Reihenfolge rekonstruieren. Schreiben Sie niemals Quellnummern um oder nummerieren Sie ein Inhaltsverzeichnis stillschweigend neu. Ein Satz, der ohne Änderung der Vorlagentypografie nicht passt, führt zum Fehlschlag des gesamten Vorgangs.

Dieser Modus unterstützt gewöhnlichen bearbeitbaren Text, unterstützte Quelltextplatzhalter und eingebettete Bilder/native Diagramme mit klarer Struktur. Die Quellplatzhalterbeschränkungen sind in references/plan.md. Für Medienseiten lesen Sie references/media.md: Bilder und ihre Zuschnitte bleiben nativ, Diagramme behalten eingebettete Arbeitsmappen, und zugehörige Bildunterschriften bleiben bei ihren Assets während Layout und Paginierung. Medienseiten verwenden Inhaltsvorlagen. Nicht-Text-Dekorationen, nicht unterstützte Platzhalter, Gruppen, Animationen, externe Links und mehrdeutige Strukturen bleiben nicht unterstützt. Ein Fehler auf einer Seite verhindert die Veröffentlichung des gesamten Outputs; liefern Sie niemals ein unvollständiges Deck. Jede generierte Seite wird erneut geöffnet, gerendert, gegen ihre Vorlagenschrift/Hintergrund geprüft und in einer separaten Korrekturkopie tatsächlich bearbeitet und gespeichert. Der Output wird erst veröffentlicht, nachdem alle Seiten-, Text- und Medienprüfungen bestanden sind.

Überprüfen Sie jedes after-N.png, insbesondere Deck-/Abschnittstitel, Inhaltsseiten-Fallback und Paginierungsgrenzen. Lesen Sie die seitenweisen Prüfungen und die Liste der bearbeitbaren Seiten in report.json. Liefern Sie die verifizierte PPTX, Vorschau und eine kurze Zusammenfassung der Quelle-zu-Ausgabe-Seiten. Geben Sie an, dass wiederholter Kontext beabsichtigt ist, wenn Seiten aufgeteilt wurden. Originale bleiben unverändert.

Gleicher-Datei-Modus (Plan v1)

  • Die Eingabe ist eine vorhandene .pptx; Quelle und Referenz sind verschiedene Folien in derselben Datei mit demselben Design und Layout und ausgeblendeten Mastergrafiken.
  • Quelle: gewöhnliche Formen, Linien und horizontale Textfelder. Referenz: diese plus dekorative Bilder. Keine Gruppen, Platzhalter, Diagramme, SmartArt, Animationen, Übergänge, Hyperlinks oder gedrehte Objekte auf einer der ausgewählten Folien.
  • Jedes Quelltextobjekt ist genau einem Referenztextobjekt zugeordnet und umgekehrt. Die Nicht-Text-Formen der Quelle müssen explizit als Dekorationen zum Ersetzen identifiziert werden. Stoppen Sie zur Klärung, wenn ein Objekt aussagekräftiges visuelles Beweismaterial enthalten könnte.
  • Der Vorgang ersetzt die lokalen Objekte der Quellfolie durch native Kopien der Referenzobjekte und füllt sie mit exakten Quellzeichenfolgen. Er übernimmt die Referenztypografie, einschließlich Änderungen an der Hervorhebung; er verspricht nicht die Erhaltung der Zeichenformatierung der Quelle.
  • Keine Inhaltszusammenfassung, Seitenaufteilung, automatische Schriftverkleinerung oder Bild-zu-bearbeitbar-Rekonstruktion. Wenn die ausgewählten Folien nicht in diese Grenzen passen, erklären Sie die spezifische Einschränkung, anstatt das Deck durch ein nicht verwandtes Tool neu aufzubauen.

Separater-Vorlagen-Modus (Plan v2)

Verwenden Sie apply-template für eine Quellfolie und eine Vorlage in separaten PPTX-Dateien. Dieser Modus erzeugt eine neue Folie in den Abmessungen der Vorlage; er überschreibt nicht das Quell-Deck oder enthält die anderen Vorlagenfolien. Wählen Sie v1, wenn der Benutzer die anderen Folien des Quell-Decks erhalten muss.

Überprüfen Sie beide Dateien, einschließlich der geerbten Layout-/Mastergrafiken, die jetzt unter inheritance aufgeführt sind. Zeigen Sie die tatsächlichen Vorschauen an und wählen Sie eine Inhaltsseite, anstatt davon auszugehen, dass Folie 2 eine geeignete Vorlage ist. Bewahren Sie Branding und Dekorationen. Klassifizieren Sie jedes lokale Vorlagenobjekt explizit als behaltene Dekoration oder entfernten Beispielinhalt; behalten Sie keine nicht verwandten Vorlagenfotos als Beweis für den Quellinhalt.

Erstellen Sie eine Platzierung pro Quelltextobjekt. Eine Platzierung benennt ein gewöhnliches texttragendes Vorlagenobjekt als Stilspender und gibt Grenzen in Punkten an. Derselbe Spender kann mehreren Platzierungen dienen, sodass die Anzahl der Quell- und Vorlagentexte abweichen kann. Die Engine dupliziert native Objekte innerhalb der Vorlage und bewahrt ihr Layout/Master und Design. Text stammt direkt von der Quelle; Pläne enthalten keine Ersetzungszeichenfolgen. Schriftverkleinerung und Inhaltsumschreibung werden nicht unterstützt.

Quelleinschränkungen von v1 gelten, außer dass v2 auch die unterstützten Quelltextplatzhalter akzeptiert. Leere sichere Textplätze werden explizit als verworfen aufgezeichnet; aktiver geerbter Quelltext führt zur Ablehnung, anstatt stillschweigend weggelassen zu werden. Stilspender müssen gewöhnliche ungedrehte horizontale Textobjekte sein, keine Platzhalter/Gruppen. Vorlagen-Layout-/Master-Dekorationen bleiben nativ, einschließlich geerbter Bilder und ungenutzter Layout-Platzhalter. Behaltene lokale Dekorationen dürfen keinen Text haben. Pläne zeichnen auf, welche Objekte entfernt werden; die automatische Planung kann diese Entscheidungen vorschlagen, während der Agent ihre Bedeutung überprüft.

Automatisches Layout (bevorzugt für separate Vorlagen)

Für eine reine Textquelle mit einem klaren Titel und Fließtext, einschließlich unterstützter Quelltextplatzhalter, führen Sie zuerst Folgendes aus:

python <skill>/scripts/slidepatch.py plan-template <source.pptx> --template <template.pptx> --source-slide 1 --out <fresh-planning-directory>

Dies erzeugt einen normalen v2 plan.json ohne manuell bereitgestellte Zielseite, Form-IDs oder Koordinaten. selection.json zeichnet abgeleitete Quellrollen, Kandidatenvorlagenseiten, geometriebasierte Dekorationsentscheidungen, Kandidatenlayouts, Passungsmessungen und Ablehnungsgründe auf. Status planned bedeutet, dass ein Plan existiert, nicht, dass eine PPTX die endgültige Überprüfung bestanden hat.

Der Planer verwendet Schrifthierarchie und räumliche Nähe, um Überschriften und Fließtexte zuzuordnen; er verwendet keine Formnamen oder Vorlagenseitennummern. Er erfordert einen eindeutigen oberen Titel, erkennt kurzschriftliche untere Fußzeilen und unterstützt gruppierte Zeilen/Spalten oder unüberschriebene Absätze. Er durchsucht Reihen-, gestapelte, zwei- und dreispaltige Layouts unter Verwendung der nativen Textbegrenzungen von PowerPoint mit den ursprünglichen Vorlagenschriftgrößen. Text umbricht; keine Zeichenfolgenumschreibung oder Schriftverkleinerung tritt auf. Kandidatenboxen dürfen sich nicht gegenseitig oder mit beibehaltenen Dekorationen überlappen. Ganzseitige Hintergründe und ungenutzte Layout-Platzhalter sind von Hindernisprüfungen ausgeschlossen.

Lesen Sie selection.json, zeigen Sie source.png und das ausgewählte template-N.png an, und prüfen Sie, ob die Rollenzuordnungen und die Entfernung von Beispielbildern sinnvoll sind. Die automatische Bildklassifizierung verwendet Geometrie und nahegelegene Bildunterschriften, kein Bildverständnis. Beanspruchen Sie kein universelles semantisches Matching. Für ein eindeutiges Ergebnis fahren Sie direkt mit apply-template unter Verwendung des generierten Plans fort und überprüfen Sie dann die gerenderte Ausgabe. Der Benutzer muss keine Koordinaten angeben oder Routineentscheidungen genehmigen, die bereits durch seine Anfrage abgedeckt sind.

Wenn die Einzelseitenplanung mehrdeutige Rollen, unsichere Dekorationen, nicht unterstützte Objekte oder überkapazitäre Inhalte ablehnt, lesen Sie den aufgezeichneten Grund. Wenn Paginierung autorisiert ist, verwenden Sie migrate. Andernfalls überprüfen Sie die tatsächlichen Objekte, bevor Sie einen überprüften expliziten v2-Plan verwenden. Überspringen Sie niemals stillschweigend Inhalte, verkleinern Sie Schriften oder ändern Sie den autorisierten Seitenumfang. Quellen mit Bildern, Nicht-Text-Dekorationen, gemischter/unklarer Hierarchie, Diagrammen oder Gruppen benötigen weiterhin einen expliziten oder nicht unterstützten Arbeitsablauf.

Ausführung

Installieren Sie requirements.txt in einer virtuellen Python-Umgebung (3.10+). Verwenden Sie diesen Interpreter für jeden Befehl. Desktop-PowerPoint muss in der angemeldeten Windows-Sitzung verwendbar sein. Überprüfen Sie zuerst:

python <skill>/scripts/slidepatch.py inspect <source.pptx> --out <fresh-inspection-directory>

Lesen Sie inventory.json und zeigen Sie beide relevanten slide-N.png-Vorschauen an. Ordnen Sie Inhaltsrollen mithilfe der tatsächlichen Objekte und des Aussehens zu. Leiten Sie Form-IDs niemals aus ihrer Reihenfolge ab oder rekonstruieren Sie den geschützten Text aus dem Gedächtnis.

Für den gleicher-Datei-Modus erstellen Sie einen JSON-Plan unter Verwendung des Schemas in references/plan.md. Für separate Vorlagen bevorzugen Sie plan-template; verwenden Sie einen manuell überprüften v2-Plan, wenn eine automatische Inferenz ungeeignet ist. Kopieren Sie Hashes und IDs aus aktuellen Bestandsverzeichnissen. Bewahren Sie den beabsichtigten Umfang des Benutzers. Eine klare autorisierte Anfrage mit einer eindeutigen Zuordnung kann fortfahren; fragen Sie nur, wenn eine inhaltliche Mehrdeutigkeit nicht aus den Dateien aufgelöst werden kann.

python <skill>/scripts/slidepatch.py apply <source.pptx> --plan <plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>

Für eine separate Vorlage überprüfen Sie diese ebenfalls, verwenden Sie dann einen v2-Plan:

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>

Die Engine erstellt das bearbeitete Deck, öffnet es in PowerPoint erneut und rendert es, vergleicht exakte Textobjekte und Zahlen, überprüft nicht betroffene Folien und testet eine echte Textbearbeitung und Formverschiebung in einer separaten Korrekturkopie. Sie veröffentlicht die Ausgabe erst, nachdem diese Prüfungen bestanden sind. Sie ruft niemals PowerPoint Quit auf oder schließt nicht verwandte Präsentationen. Nativer Kopieren/Einfügen verwendet die Systemablage.

Der Vorlagenmodus überprüft stattdessen das einseitige Ergebnis, beide ursprünglichen Hashes, alle lokalen Quellzeichenfolgen, gespeicherte native Objekte und identische gerenderte Dekorationsschichten vor/nach. Vorhandenes dekoratives Überlaufen ist erlaubt; neuer Inhalt muss passen. Er verwendet natives Duplizieren ohne Ablage. Die PPTX kann weiterhin nicht verwendete Vorlagenlayouts, Master oder Medien enthalten; dieser Prototyp bereinigt keine versteckten Paket-Assets.

Überprüfung und Lieferung

Lesen Sie report.json; Exit-Status und Bericht müssen beide Erfolg anzeigen. Zeigen Sie before-<source>.png, before-<reference>.png und after-<source>.png an. Überprüfen Sie, ob das Styling übereinstimmt und es kein Abschneiden, unbeabsichtigte Überlappungen oder falsche Lesereihenfolge gibt. Geometrieprüfungen ersetzen keine visuelle Überprüfung.

Für den Vorlagenmodus zeigen Sie source-before.png, template-before.png, after-1.png, plus template-shell.png und output-shell.png an. Überprüfen Sie die neue Komposition anhand der visuellen Sprache der Vorlage; allein übereinstimmende Textzeichenfolgen sind nicht ausreichend.

Liefern Sie die neue PPTX mit einer Vorschau und einer prägnanten Zusammenfassung der Prüfungen und des Umfangs. editability-proof.pptx enthält absichtlich eine Bearbeitungsmarkierung und ist Beweismaterial, nicht die endgültige Lieferung. Wenn eine Prüfung fehlschlägt, melden Sie das Problem; präsentieren Sie niemals eine bereitgestellte oder Korrekturdatei als endgültiges Deck. Wählen Sie bei Wiederholungsversuchen neue Pfade, wobei Fehlerbeweise verfügbar bleiben.

Verwandte Skills