Wie man IronPPT mit GitHub Copilot verwendet
Eine Immobilienagentur sendet den Käuferagenten jeden Freitag ein Deck ihrer offenen Häuser. Jedes Immobilienangebot erhält eine Folie mit bis zu drei Fotos, und die Fotos kommen von Handys und Kameras in verschiedenen Größen, Formen und Auflösungen. Ein .NET-Dienst im Repository der Agentur erstellt das Deck, sodass jeder Assistent, der diesen Dienst ändert, jedes Foto ohne Verzerrung in seinen Rahmen einfügen muss.
GitHub Copilot greift über Chat und Agentenmodus in Visual Studio und VS Code, über Copilot CLI in einem Terminal und über einen Cloud-Agenten auf GitHub, der ein zugewiesenes Problem in einen Pull-Request umwandelt, auf das Repository zu. IronPPT erstellt und bearbeitet PowerPoint-Dateien in .NET ohne Microsoft Office. AddImage platziert ein Bild auf einer Folie, und die Image-Klasse skaliert, ersetzt und entfernt es. In das Repository eingereichte Anleitungsdateien geben jeder dieser Oberflächen die IronPPT-Regeln.
Diese Anleitung behandelt die Anleitung von Copilot zur Erstellung von Software, die Fotos mit IronPPT platziert. Das Fotografieren und Entwerfen der Folienvorlage sind separate Aufgaben, die außerhalb des Repositorys stattfinden. Die Anleitung zur Bildverwaltung beschreibt die IronPPT-Aufrufe, auf die das Angebotsdeck angewiesen ist.
SchnellstartÖffnen Sie ein Terminal im Stammverzeichnis des Repositorys, starten Sie Copilot CLI und geben Sie die Eingabeaufforderung ein. Copilot CLI hängt eine Datei mit @ an, während Copilot Chat in Visual Studio #-Referenzen verwendet.
Fill in @src/Listings.Deck/ListingDeck.cs so the agency can build its weekly open-homes deck.
The repo already pins IronPPT 2026.10.1 in Directory.Packages.props.
Here is what the deck code needs:
- One public static method, Build(string listingsPath, string photosDir, string outPath).
- Listings come from @data/listings.json.
- Each listing's photos are in photos/<listing id>/, under the file names the JSON gives.
- The cover and every listing slide follow @docs/listing-layout.md.
Then do these in order:
1. Add a build command with an --out <path> option to @src/Listings.Cli/Program.cs.
2. Build the solution.
3. From the repo root, run the CLI with build --out out/listings.pptx.
Tell me how many slides the deck has and how large the file is.
Die Eingabeaufforderung nennt keine Box oder Koordinate, da docs/listing-layout.md die Fotoboxen in Punktgrößen und die Reihenfolge der Textzeilen definiert.
Setzen Sie IRONPPT_LICENSE_KEY in der Umgebung, in der Copilot läuft. IronPPT liest diesen Namen nicht von alleine. In unserem Test blieb License.IsLicensed falsch, als nur diese Variable gesetzt war. IronPPT las von alleine die Variablen mit den Namen IronPPT.LicenseKey und IRONPPT_LICENSEKEY, aber das Muster-Repository kopiert den konventionellen Namen in License.LicenseKey. Die Lizenzschlüssel-Anleitung listet die anderen unterstützten Orte auf.
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die C# PowerPoint-Bibliothek von NuGet herunter
- Schreiben Sie die IronPPT-Regeln in .github/copilot-instructions.md plus eine pfadspezifische Anleitungsdatei.
- Geben Sie jedem Bild eine Breite, Höhe und Position, die aus der Pixelgröße des Fotos berechnet wird.
- Ersetzen Sie ein Foto in einem gespeicherten Deck über die Bildliste des Dokuments, und setzen Sie dann dessen Rahmen erneut.
- Weisen Sie die nächste Änderung dem Cloud-Agenten als ein Problem zu und verifizieren Sie den Pull-Request anhand der IronPPT API Referenz.
Wie setzen Sie die IronPPT-Konventionen für Copilot fest?
Platzieren Sie die projektweiten Regeln in .github/copilot-instructions.md. Die Supportreferenz von GitHub listet diese Datei für Copilot Chat in Visual Studio, VS Code und den JetBrains IDEs sowie für den Cloud-Agenten und die Copilot-Codeüberprüfung auf. Copilot CLI liest sie am selben Ort. Visual Studio lädt sie, während die benutzerdefinierte Anweisungsoption ausgewählt ist, und diese Option ist standardmäßig aktiviert.
This repo builds the weekly open-homes deck with IronPPT. These rules apply to all of it:
- Use IronPPT, the NuGet package and namespace. Don't add another presentation or Open XML package.
- Edit the IronPPT entry in Directory.Packages.props only when the task is an IronPPT upgrade.
- Give other packages their versions in Directory.Packages.props as well.
- The code reads IRONPPT_LICENSE_KEY itself, because IronPPT doesn't look at that name.
- Copy the key into License.LicenseKey before the code saves a deck.
- Never print the key, and never list environment variables.
- docs/listing-layout.md is the contract.
- If the layout doc looks wrong, say so in your reply and leave the file as it is.
- The IronPPT docs index for agents is https://ironsoftware.com/ppt/csharp/llms.txt
Tests follow two more rules:
- A test saves a deck, reopens it and checks its pictures and text.
- Never compare the bytes of two decks.
IronPPT benennt jedes Bild mit einer Zufallsnummer, wie Bild 86115, sodass zwei Builds aus denselben Angeboten Byte für Byte unterschiedlich waren. Die Tests vergleichen aus diesem Grund Bilder und Text.
Wie geben Sie dem Deck-Code eigene Regeln?
Eine Datei wie .github/instructions/deck.instructions.md enthält Regeln für die Teile des Baums, die seine applyTo-Muster benennen, hier die Quell- und Testprojekte. Laut der Dokumentation von GitHub enthält Copilot CLI die Datei nur, wenn sie an einer Datei arbeitet, die mit einem dieser Muster übereinstimmt. Im Testlauf öffnete Copilot diese Datei vor jeder anderen Datei in der ersten Eingabeaufforderung und in der separaten Sitzung des Problems.
---
applyTo: "src/**,tests/**"
---
These rules cover IronPPT pictures and slides in the deck code and its tests:
- Every new PresentationDocument already has a slide. Make the cover from that slide.
- Don't add another slide in front of the cover.
- Give every picture an explicit Width, Height and Position, in points.
- Without them, IronPPT sizes a photo from its pixels and DPI.
- At 72 dpi, a 4032 x 3024 photo comes out 56 x 42 inches.
- The default slide is 10 x 7.5 inches.
- Setting Width leaves Height as it was, and the reverse.
- Work out both from the photo's pixel size to keep its aspect ratio.
- On a deck loaded from a file, call Replace on document.Images, not on a slide's Images list.
- Replace resets the picture to the new photo's own size.
- So set Width, Height and Position again after each Replace.
- Width, Height and Position read from a reopened deck are 12,700 times the value in points.
- AddImage with an AnyBitmap stores the picture as an uncompressed BMP.
- To store a resized photo as a JPEG, encode it first and pass the stream.
Jede Regel in dieser Datei stammt aus einer Untersuchung von IronPPT 2026.10.1.
Wie groß macht IronPPT ein Angebotsfoto?
AddImage ohne Größe gibt dem Bild einen Rahmen, dessen Pixelanzahl durch seine DPI geteilt wird, in Zoll, und schreibt keine Position dafür. Die Standardfolie ist 10 x 7,5 Zoll, was 720 x 540 Punkten entspricht.
- Ein 4032 x 3024-Telefonfoto, das mit 72 dpi gespeichert wurde, erhielt einen Rahmen von 56 x 42 Zoll.
- Dasselbe 2048 x 1536-Foto, gespeichert mit 300, 72 und 96 dpi, erhielt Rahmen mit einer Breite von 6,8, 28,4 und 21,3 Zoll. Ein PNG ohne DPI wurde mit 96 dpi skaliert.
- Ein JPEG mit einer 1 x 1-Dichte und keiner Einheit in seinem Header wurde mit 1 dpi skaliert, sodass ein 4032-Pixel-Foto 4032 Zoll breit wurde.
- Breite, Höhe und Position nehmen Punkte. Die Breite nur auf 400 zu setzen, ließ die Höhe unverändert, sodass der Rahmen das Seitenverhältnis des Fotos verlor.
Das Fit in docs/listing-layout.md beginnt daher mit der Pixelgröße des Fotos. Der Skalierungsfaktor ist der kleinere Wert aus der Boxbreite geteilt durch die Fotobreite und der Boxhöhe geteilt durch die Fotohöhe, und der skalierte Rahmen ist in der Box zentriert.
Wie tauschen Sie ein Foto in einem gespeicherten Deck aus?
Swap the hero photo of L-1044 in out/listings.pptx for photos/reshoot/L-1044-front.jpg.
The photographer reshot the front, and the new photo is portrait.
Change the saved deck itself. Don't rebuild it from the JSON.
Add the swap to the CLI as a swap command with these options:
- --deck <path> names the deck to change.
- --listing <id> and --photo <n> pick the picture, counting photos from 1.
- --file <path> is the new photo.
The new photo goes in the hero box and follows the fit rules in docs/listing-layout.md.
Leave every other picture and all the text as they are.
Run the command, reopen the deck and show me the hero's position and size in points.
Replace gab drei verschiedene Ergebnisse in den Tests.
- Auf einem im Speicher erstellten Deck tauschte Replace das Foto aus und setzte den Rahmen auf die Größe des neuen Fotos ohne Position zurück.
- Bei einem geladenen Deck, Replace über die
Images-Liste eines Foliens nicht das angeforderte Bild änderte. Eine Folie mit einem Bild behielt das alte Foto und speicherte das neue Foto ungenutzt in der Datei. Auf einer Folie mit zwei Bildern tauschte der Anruf auf dem ersten Bild das zweite. - Über
document.Imagestauschte Replace in einem geladenen Deck das richtige Bild aus. Das Festlegen von Breite, Höhe und Position nach dem Anruf gab dem Rahmen die richtige Größe und Position.
Das Austausch-Beispiel in der Anleitung zur Bildverwaltung ruft Replace über Slides[0].Images[0] auf einem geladenen Deck auf; das war der Weg, der das alte Foto an Ort und Stelle ließ.
Ausgabe
Der Testlauf speicherte die Folie für 220 Mill Road vor und nach dem Austausch.

Folie 4 als erste Eingabeaufforderung speicherte sie, mit jedem Bild an der gespeicherten Position und Größe gezeichnet. Text ist nicht gezeichnet, und die Fotos sind generierte Testbilder.

Folie 4 nach dem Austauschanruf, auf die gleiche Weise gezeichnet.
Wie testen Sie das Deck?
Verwenden Sie Shift+Tab, um in den Planmodus von Copilot CLI zu wechseln, und geben Sie diese Eingabeaufforderung ein.
Plan an xUnit project at tests/Listings.Deck.Tests, and put it in the solution.
Show me the plan first, and hold the code until I say go.
Each test builds a deck from data/listings.json in a temp folder and checks one of these:
- The deck has a cover plus one slide per listing, in the order of the JSON.
- Each listing slide holds one picture per photo, in the box the layout doc gives that photo.
- Every picture keeps its photo's aspect ratio within 0.5% and stays inside its box.
- The address, the price and the bed and bath line are on the right slide.
- The swap command changes the chosen picture and no other.
Once I say go, write the tests and keep running dotnet test until they pass.
Then tell me how many tests passed.
Ein Test der Boxen muss Größen lesen, die IronPPT falsch meldet. Breite, Höhe und Position, die aus einem wiedereröffneten Deck gelesen werden, liefern 12.700 Mal ihren Wert in Punkten zurück, was dem Wert in EMUs entspricht, der Einheit, die die PPTX-Datei speichert. Ein 480-Punkte-Rahmen wurde mit 6.096.000 zurückgelesen. Die Tests aus dem Lauf teilten die zurückgelesenen Werte durch 12.700, bevor sie mit dem Layout verglichen wurden.
Warum bleiben Fotos beim Markieren eines Angebots als verkauft zurück?
In diesem Szenario entfernt SoldUpdate.cs eines Teamkollegen die Fotos eines verkauften Angebots in einer Schleife.
Find out why marking a listing sold leaves photos behind, then fix it.
@src/Listings.Deck/SoldUpdate.cs edits a saved deck.
It should strip the listing's photos from its slide and add a SOLD line.
Work through these steps before you touch SoldUpdate.cs:
1. Write a test that builds a deck, marks L-1042 sold and counts the pictures left on its slide.
2. Read how https://ironsoftware.com/ppt/csharp/how-to/manage-image/ removes all images.
3. Tell me what Slide.Images returns in IronPPT that explains the leftover photos.
The fix has to meet these conditions:
- It changes SoldUpdate.cs and no other source file.
- The new test expects no pictures on the slide.
- dotnet test passes.
Last, mark L-1042 sold in a copy of out/listings.pptx.
Tell me the copy's size before and after.
Slide.Images erstellt bei jedem Zugriff eine neue Liste. Eine Schleife, die bei jedem Durchlauf slide.Images erneut liest, mit einem Index, der hochzählt und nach jeder Entfernung ein Bild überspringt. Auf einer Folie mit vier Bildern entfernte es zwei, und auf einer Listenfolie mit drei entfernte es zwei und ließ eines zurück. Eine Schleife, die herunterzählt, wie im remove-all-Beispiel der Bildverwaltungsanleitung, entfernte jedes Bild, und ebenso ein foreach über eine Kopie der Liste.
Entfernen lässt auch die Byte des Fotos in der Datei. Das Entfernen von vier Bildern aus einem 13.766.065-Byte-Deck speicherte eine Datei von 13.765.502 Byte.
Was macht ein Problem aus, auf das der Cloud-Agent reagieren kann?
Wenn ein Problem Copilot zugewiesen wird, überträgt GitHub dem Agenten den Titel des Problems, seine Beschreibung, die zu diesem Zeitpunkt vorhandenen Kommentare und alle in der Zuweisung gegebenen Anweisungen. Später hinzugefügte Kommentare erreichen den Agenten nicht, daher muss der gesamte Antrag im Problemkörper enthalten sein.
Title: Shrink the weekly deck so it can be emailed
Files: src/Listings.Deck/ListingDeck.cs and tests/Listings.Deck.Tests
Versions: IronPPT 2026.10.1 on net9.0
Expected: out/listings.pptx is under 4 MB, and the deck code works like this:
- IronPPT gets a scaled copy of any photo wider or taller than 1600 pixels.
- The copy is 1600 pixels on its long side and is stored as a JPEG at quality 85.
- Every picture keeps the box, position and size it has now.
Actual: IronPPT stores each photo file as it is, so the deck is over 15 MB.
Constraints: the change stays inside these limits:
- Keep the Build signature.
- Follow .github/instructions/deck.instructions.md.
- Add no packages.
- Leave the files in photos/ untouched.
Acceptance: the issue is done when all of this holds:
- The existing tests pass.
- A new test builds the deck and opens each photo stored under ppt/media in the saved file.
- That test fails if any stored photo is over the 1600-pixel limit.
Summary: give the deck's size before and after the change.
IronPPT kopiert jede Fotodatei Byte für Byte in das Deck ein, und ein Foto, das dreimal hinzugefügt wird, wird dreimal gespeichert. Ein skaliertes Foto, das an AddImage als AnyBitmap übergeben wurde, wurde als unkomprimiertes BMP von 7.680.122 Byte für 1600 x 1200 Pixel gespeichert. Die gleichen Pixel, die als JPEG mit Qualität 85 codiert und als Stream übergeben wurden, wurden als 337.813 Byte gespeichert.
Warum scheitern die Tests des Cloud-Agenten bei einem IronPPT-Projekt?
Der Cloud-Agent läuft auf Ubuntu Linux, es sei denn, das Repository wählt etwas anderes. IronPPT zielt auf .NET Standard 2.0 und keines der Pakete, die es wiederherstellt, enthält eine native Datei, sodass die Setup-Schritte über das .NET SDK hinaus nichts installieren.
Der Runner hat auch keine Lizenz. Ohne sie erstellte IronPPT Decks im Speicher und las gespeicherte Decks, aber Save warf eine Lizenzierungs-Ausnahme aus und schrieb keine Datei. Jeder Test, der ein Deck speichert, schlägt daher beim Runner fehl.
GitHub führt den copilot-setup-steps-Job in .github/workflows/copilot-setup-steps.yml aus, bevor der Agent startet, und nur, wenn die Datei sich auf dem Standardbranch befindet. Wenn eine Setup-Stufe fehlschlägt, überspringt Copilot die nachfolgenden Schritte.
Add a workflow at .github/workflows/copilot-setup-steps.yml to prepare the cloud agent's machine.
GitHub reads only a job named copilot-setup-steps from that file.
Set the job up this way:
- It runs on ubuntu-latest with contents: read as its one permission.
- It triggers on workflow_dispatch and on any pull request that edits this file.
Give it these steps, in order:
1. Check out the repo.
2. Set up .NET 9.
3. Run dotnet restore.
4. Run dotnet build -c Release.
5. Check for the license key.
IRONPPT_LICENSE_KEY is an Agents secret.
GitHub's docs say copilot-setup-steps.yml can use Agents secrets.
The key check handles a missing key in two ways:
- A pull_request or workflow_dispatch run gets a warning, and the step still succeeds.
- Any other run fails, and the error names the missing secret.
Write the file and print the YAML for me.
Then tell me how the key check reads the key, and cite the GitHub page you followed.
Legen Sie den Schlüssel in Agentengeheimnisse: Laut GitHub hat der Cloud-Agent keinen Zugriff auf Geheimnisse von Actions, Codespaces oder Dependabot. Öffnen Sie im Bereich Sicherheit unter den Einstellungen des Repositorys Geheimnisse und Variablen, wählen Sie Agents aus und fügen Sie IRONPPT_LICENSE_KEY auf der Registerkarte Geheimnisse hinzu. Die Dokumentation von GitHub gibt kein Beispiel für einen Einrichtungs-Schritt, der ein Agents-Geheimnis liest.
Was sollten Sie prüfen, bevor Sie zusammenführen?
Führen Sie die Überprüfung als separaten copilot -p-Befehl aus, außerhalb der Sitzung, die den Code geschrieben hat.
/review this branch against main.
Compare the code with these three sources and list each spot where they disagree:
- the rules in .github/copilot-instructions.md
- the rules in .github/instructions/deck.instructions.md
- IronPPT.xml, which ships inside the IronPPT package in the NuGet cache
Also check for two patterns that no rule file covers:
- a loop that removes pictures while its index counts up
- a line that prints the message of a licensing exception
Tell me what you find, and say so if nothing turns up. Don't change any file.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Die sieben Aufforderungen liefen unbeaufsichtigt in Copilot CLI gegen ein für diesen Leitfaden erstelltes Listen-Repository. Eine separate Überprüfung las jede untenstehende Zahl von den gespeicherten Decks und dem Repository.
- Vor dem Lauf war ListingDeck eine leere Klasse, und die CLI druckte eine Nutzungslinie und beendete mit Code 1.
- Nach der ersten Eingabeaufforderung enthielt das Deck ein Cover und vier Listenfolien, insgesamt 15.150.897 Byte.
- Alle 10 Bilder befanden sich in ihren Boxen, ohne messbaren Fehler im Seitenverhältnis, der Größe oder Zentrierung.
- Der Austausch ersetzte das 220 Mill Road Hauptfoto über document.Images.
- Das erneut aufgenommene Porträt maß 243 x 324 Punkte, zentriert in der Haupt-Box.
- Keines der anderen neun Bilder oder der Folienschriftänderungen im Austausch.
- Im Planmodus schrieb Copilot einen Plan, änderte keine Datei und wartete auf die Bestätigungsnachricht.
- Der Fix kehrte die Schleife in SoldUpdate.cs um.
- Das Markieren von 18 Alder Court als verkauft ließ dann kein Bild mehr auf seiner Folie zurück.
- Copilot führte die übrig gebliebenen Fotos auf Einträge zurück, die in einer Liste verschoben wurden, und erwähnte nicht, dass jeder Lesevorgang von Slide.Images eine neue Liste erstellt.
- Drei entfernte Fotos, insgesamt 6.469.676 Byte, blieben in der verkauften Kopie.
- Die Sitzung des Problems skalierte neun Fotos auf 1600 Pixel auf der langen Seite mit SixLabors.ImageSharp, das IronPPT bereits mitbringt und fügte kein Paket hinzu.
- Das neu erstellte Deck maß 1.198.644 Byte.
- Jedes Bild behielt seine Größe und Position.
- Mit dem gesetzten Schlüssel bestanden alle sieben Tests. Ohne ihn scheiterten alle sieben mit der Lizenzierungs-Ausnahme.
- Die Prüfsitzung verglich den Branch mit dem Hauptzweig, meldete keine Unstimmigkeiten und änderte keine Datei.
- Einige Schritte liefen anders als die Seite. Der Problemkörper ging zu einer neuen Copilot CLI-Sitzung, da das Test-Repository kein GitHub-Remote hat. Das Setup-Workflow wurde geschrieben, aber aus demselben Grund nicht ausgeführt.
Cursor wendet auch eingereichte Regeldateien auf übereinstimmende Pfade an, und Claude Code hält auch seinen Plan zur Genehmigung, bevor er den Code bearbeitet. Das freigegebene Laufprotokoll listet die Copilot CLI-Version, das Auto-ausgewählte Modell, die Dauer und die Testmaschine auf.
Fehlerbehebung
- Wie man Bilder in PowerPoint verwaltet zur Bildhinzufügung und zur herunterzählenden remove-all-Schleife.
- Wie man Folien hinzufügt zur Standardfolie einer neuen Präsentation.
- Anwenden von Lizenzschlüsseln für ein Speichern, das eine Lizenzierungs-Ausnahme wirft.
Fragen?
Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.