IronPPT ve Cursor ile Nasıl Çalışılır
Bir AI ajanı C# rapor destesi oluşturucusunu Open XML SDK'dan IronPPT'ye taşıdığında, her slayt çağrısını doğrudan çevirerek, yeni deste eskisinden farklı olur. Open XML SDK boş bir paketle başlar. Yeni bir IronPPT PresentationDocument zaten bir slayta sahiptir, bu yüzden bir başlık slaytı ve her öğrenci için bir slayt ekleyen doğrudan port, ilk slaytı boş olan bir deste kaydeder. Testlerimizde, aynı port ayrıca eski oluşturucunun 16:9 olarak yazdığı yerlerde 4:3 slaytlar üretti.
Cursor, VS Code kod tabanı üzerine inşa edilmiş, dosyaları düzenleyen ve komutları çalıştıran bir ajanı olan bir AI kod editörüdür. Aşağıdaki geçiş, belgelere bağlantılar ve .cursor/rules'ye taahhüt edilen proje kuralları gibi iki özelliğini kullanır. Bir okulun rapor destesi oluşturucusunu IronPPT'ye taşır. Oluşturucu, her sınıf için bir başlık slaytı, her öğrenci için bir slayt ve kapanış slaytı ile bir dönem rapor destesi oluşturur ve taşınan deste okul tarafından onaylanmış her metin satırını korumalıdır.
İlgili çağrılar için, slayt ekleme kılavuzu ve metin ekleme kılavuzu bölümüne bakın.
Hızlı BaşlangıçReportDecks deposu açıkken, bu isteği yeni bir Ajan sohbetine yapıştırın.
@src/ReportDecks/ @TestData/expected/
Add an inspect command to Program.cs that prints the outline of a deck.
It runs as `dotnet run --project src/ReportDecks -- inspect <deck.pptx>`.
Before you write it, check https://ironsoftware.com/ppt/csharp/llms.txt.
From there, open the guides on adding slides and on license keys.
The command opens the deck with IronPPT and prints one line per slide, in this form:
- The slide number, a colon and a space.
- The text of each non-empty paragraph on the slide, in order, joined with " | ".
The outlines in TestData/expected use the same form.
The program reads IRONPPT_LICENSE_KEY from the environment itself.
It sets License.LicenseKey from that value before it opens or saves a deck.
Never show the license key in output, and don't dump the environment variables.
Keep IronPPT on version 2026.10.1 and leave OpenXmlDeckWriter alone for now.
Then build the term report for TestData/classes/7B.json, inspect it and show me what it prints.
Lisans anahtarını bir sohbete yapıştırmayın, çünkü ajan bunu bir kaynak dosyaya, bir taahhüde veya bir derleme günlüğüne kopyalayabilir. IronPPT 2026.10.1, IRONPPT_LICENSE_KEY kendisi tarafından okumaz. Ortamda veya uygulama yapılandırmasında IronPPT.LicenseKey adlı bir ayarı arar, bu yüzden istem kodda License.LicenseKey ayarlar. Bir anahtar olmadan, bellekte slaytlar oluşturmak ve bir desteyi okumak işe yaradı ve Save dosyayı yazmadan önce LicensingException fırlattı. lisans anahtarı kılavuzu, anahtarın nereye saklanacağını açıklar.
Asgari İş Akışı (5 adım)
- C# PowerPoint kütüphanesini NuGet'ten İndirin
- IronPPT'nin belge bağlantısını içeren .cursor/rules altında bir proje kuralı ekleyin
- Kurala, yeni bir destenin zaten bir slayta sahip olduğunu ve 4:3 kullandığını kaydedin
- Her istekte deste koduna ve onaylanmış taslağa referans verin
- Kaydedilen her desteyi o taslak ile karşılaştırın, ardından API referansı içindeki her üye adını doğrulayın API referansı
IronPPT çalışmaları için hangi Cursor modelini kullanmalısınız?
Composer, Cursor'un kendi agentik modelidir. Model seçici ayrıca Cursor tarafından ortak geliştirilen SpaceXAI'nın Grok modellerini ve OpenAI, Anthropic, Google ile diğer laboratuvarların modellerini sunar. Aşağıdaki test çalıştırması Composer 2.5 kullanıldı.
IronPPT belgelerini Cursor'a nasıl vermelisiniz?
İstek içine IronPPT'nin belge bağlantısını dahil edin veya tüm ekibin paylaştığı bir kurala kaydedin. IronPPT'nin llms.txt dosyası, her kılavuzu ve API referansını listeler ve llms-full.txt, 16 belge sayfasını tek bir dosyada yoğunlaştırır. Ekim 2026 itibarıyla, Cursor'un @ menüsü dosya, klasör, terminal, sohbet, Git farkları ve tarayıcı ekler, bu yüzden istek, ajanı IronPPT'nin belgelerini bir bağlantı olarak verir.
Slayt ekleme kılavuzu, yeni bir sunumun zaten boş bir slayt içerdiğini belirtir. IronPPT'nin skill.md dosyası aynı nesneyi yeni, boş bir sunum olarak adlandırır ve llms.txt'nin bağlantı verdiği hiçbir sayfa yeni bir destenin slayt boyutunu belirtmez.
@src/ReportDecks/ParentEveningDeck.cs
Answer five questions about IronPPT, and don't change any files:
1. How many slides does a new PresentationDocument hold before AddSlide is called?
2. Where does AddSlide put the new slide, and what does it return?
3. Where does text passed to PresentationDocument.AddText end up?
4. Can IronPPT set the slide size, and what size does a new deck use?
5. Can IronPPT write speaker notes?
Base every answer on https://ironsoftware.com/ppt/csharp/llms.txt or a page it links to.
Name the page each answer comes from.
If no page answers a question, tell me so rather than guess.
IronPPT konvansiyonlarınızı kodlayan proje kuralları nasıl yazılır?
Bir proje kuralı, .cursor/rules içinde depolanan ve depo ile sürümlenen bir .mdc dosyasıdır. Cursor, bu klasördeki sıradan bir .md dosyasını görmezden gelir, çünkü frontmatter olmayan bir dosya, kuralların ne zaman yükleneceğine karar vermesine olanak tanımaz.
Aşağıdaki kural, dosya desenlerini globs içinde, virgüllerle ayırarak listeler ve alwaysApply'yi false olarak ayarlar. Cursor daha sonra, destek kodu veya testlerle ilgili istekler için yükler. Bunu .cursor/rules/ironppt-decks.mdc olarak kaydedin.
---
description: IronPPT conventions for the report deck code
globs: src/ReportDecks/**/*.cs, tests/**/*.cs
alwaysApply: false
---
Follow these rules in the report deck code:
- Build decks with IronPPT 2026.10.1 from NuGet, namespace IronPPT.
- Don't add another presentation package.
- Look up IronPPT members in https://ironsoftware.com/ppt/csharp/llms.txt and its linked pages.
- The program reads the key from IRONPPT_LICENSE_KEY.
- Never write the key to output or files.
- A new PresentationDocument starts with one slide already, and AddSlide appends after it.
- Fill that first slide, or remove it once the deck has another slide.
- A new PresentationDocument is 4:3.
- For a 16:9 deck with the school's title slide, open TestData/templates/hollybrook-16x9.pptx.
- On slides you add, put the lines in one TextBox as Paragraphs.
- Each AddText call on a slide creates another text box of the same size, with no position.
- PresentationDocument.AddText joins its text to the last paragraph of the last slide.
- Don't use PresentationDocument.AddText.
- Check every deck you save with the inspect command against TestData/expected.
- If an IronPPT member isn't in the docs, say so and cite the page you searched.
Kurallar Aracı isteklerine uygulanır. Cursor'ın kurallar sayfası, kuralların Tab'ı etkilemediğini ve kullanıcı kurallarının satır içi düzenlemelere uygulanmadığını belirtir, bu nedenle bu önerileri kurallara karşı manuel olarak gözden geçirin.
Open XML SDK çağrılarını IronPPT'ye nasıl eşlersiniz?
Open XML SDK bir paketi parça parça yazar, bu yüzden eski oluşturucu da slayt ana şablonunu, düzeni, temayı ve notlar ana şablonunu oluşturur. IronPPT bu parçaları kendisi oluşturur.
| Open XML SDK | IronPPT |
|---|---|
Bir sunum parçası, ana şablon, düzen ve tema içeren PresentationDocument.Create | new PresentationDocument() veya şablon yolu ile oluşturucu |
Sunum parçasına eklenen ve SlideIdList listelenen bir SlidePart | AddSlide(new Slide()), slaytı ekler |
Başlık ve gövde yer tutucularına A.Paragraph ve A.Run ile doldurulmuş | Slide.AddChild ile bir TextBox, satır başına bir Paragraph |
| Mevcut bir yer tutucudaki metin | Yüklenen şablonun bir slaydındaki Texts[i].Text |
SlideSize 12192000'e 6858000 olarak ayarlanmış | Eşdeğer yok, bu yüzden boyut şablondan gelir |
Slayt başına bir NotesSlidePart | Eşdeğeri yok |
Bir dosyaya veya herhangi bir Stream ile bir Save | yalnızca bir dosya yolu Save(string) |
IronPPT.dll, Open XML SDK türlerinin kendi kopyasını, hepsi dahili, belirler, bu yüzden geçiş sırasında her iki paketle de referans verilen proje oluşturuldu.
Neden yeni bir IronPPT destesi ekstra bir slayt ile başlar?
Yeni bir PresentationDocument yerleşik slaytı, başlık ve alt başlık yer tutucularının boş olduğu bir başlık düzeni kullanır. AddSlide bunun ardından eklenir ve kendisine verilen slaytı döndürür, bu nedenle doğrudan bir portun her slaytı, onaylanmış taslaktaki yerinden bir pozisyon sonra görünür.
Bu slaytı çok erken kaldırmak başarısız olur. Üzerinde yalnızca bir slayt varken Remove'e çağrı yapmak, bir sunumun en az bir slayt içermesi gerektiğini belirten bir InvalidOperationException oluşturdu. İkinci bir slayt var olduğunda, aynı çağrı başarılı oldu.
İkinci fark, slayt boyutudur. Yeni bir deste, 4:3 bir slayt olan 9144000 ile 6858000 EMU ölçtü. API referansı Slide.Width ve Slide.Height numuneyi 960 noktaya ayarlama ile belgelendirir, ancak bu özelliklerin hiçbiri destenin slayt boyutunu değiştirmez. Bunları 960 ile 540 noktaya ayarlamak, slaydın şekillerinin kapsamlarına 12192000 ile 6858000 EMU yazdı ve ppt/presentation.xml'deki slayt boyutunu 9144000 ile 6858000 EMU olarak bıraktı. 16:9 bir dosyadan yüklenen bir deste, kaydetme boyunca 12192000 ile 6858000 EMU'nun korunduğu, yer tutucuları ve notları ile birlikte kaldı. Bu nedenle depo, okulun başlık slaydını TestData/templates/hollybrook-16x9.pptx içerisinde tutar.
IronPPT'ye bir geçişi nasıl planlar ve yürütürsünüz?
Plan Modu seçilene kadar sohbet girişinde Shift+Tab tuşlarına basın, ardından aşağıdaki isteği gönderin. Cursor, planı düzenlenebilir bir Markdown dosyası olarak yazar.
@src/ReportDecks/OpenXmlDeckWriter.cs @TestData/expected/7B-term-report.txt
Plan how to move the term report deck from the Open XML SDK to IronPPT.
Don't write any code until I approve the plan.
Leave ParentEveningDeck out of it, since it already uses IronPPT.
The plan needs to answer these questions:
- Which IronPPT call replaces each Open XML SDK step the writer takes?
- How does the deck keep 16:9 slides and avoid an extra blank slide?
- Where do the tutor comments go, given that they're speaker notes today?
- How does the build command keep its arguments and its output path?
Roster.cs and DeckText.cs stay as they are.
End with a list of the assumptions you made.
Plan üzerindeki hataları düzeltin. Sonra planı Plan Modunda oluşturun veya Ajan'a geri dönün ve bu isteği gönderin.
@ironppt-decks
Go ahead with the approved plan.
If IronPPT can't write speaker notes, the tutor comments go in a text file beside the deck:
- For out/7B-term-report.pptx, the file is out/7B-term-report.comments.txt.
- It holds one "Name: comment" line per pupil, in roster order.
Work through these steps in order:
1. Build and inspect the 7B term report.
2. Count the lines that match TestData/expected/7B-term-report.txt.
3. Replace OpenXmlDeckWriter with an IronPPT class named TermReportDeck.
4. Remove DocumentFormat.OpenXml from the project file.
5. Build the solution, then build, inspect and count again.
Tell me both match counts, before and after, and show me the diff.
@ironppt-decks belirtisi, kuralı adla ekler.
Değişimin her birine hangi Cursor özelliği uyar?
Değişikliğin kapsamına göre bir özellik seçin. Tab, geliştirici tarafından başlatılan bir düzenlemeyi tamamlar. Bir cümle ile tanımlanabilecek bir seçilim için satır içi düzenleme (Ctrl+K) kullanın. Ajan, birden fazla dosya üzerinde yapılan değişiklikleri ve bir derleme gerektiren çalışmayı ele alır ve Plan Modu, Ajan'ın herhangi bir kodu değiştirmeden önce gözden geçirilecek bir plan ekler.
Bu isteği Ajan'da gönderin. Değiştirdiği yöntemi adlandırır, bu yüzden editörde bir seçilim gerektirmez.
@src/ReportDecks/
Make TermReportDeck.Write check its own output once it saves the deck:
- Reopen the saved deck with IronPPT.
- Throw if the slide count isn't the pupil count plus 2.
- Throw if any slide has no text, with that slide's number in the message.
Have the build command print that message and exit with code 3.
Then build the decks for TestData/classes/7B.json and TestData/classes/8A.json.
Show me what each build prints.
IronPPT bir slaydın eklediği metni nasıl yerleştirir?
Bir slaytta yapılan beş Slide.AddText çağrısı, aynı gövde yer tutucusunda 1905000 ile 1270000 EMU boyutlarında beş şekil üretti. AI ajanlar merkezi, bu tür şekillerin neden aynı pozisyonu paylaştığını açıklar. Satır başına bir Paragraph tutan bir TextBox satırları sırasına göre bir şekilde verir. Bir kontur kontrolü, yalnızca metni okuduğu için varsayılan boyutta bırakılan bir kutuyu algılamaz.
PresentationDocument.AddText, slayt yönteminden farklı davranır. En son slaydın son paragrafının sonunda yeni bir çalıştırma olarak metnini ekledi, boşluk veya satır sonu olmadan. Slide.Texts üzerinden geri okunduğunda, iki çalıştırma ayrı öğeler olarak görünür. Slide.Paragraphs, bir izleyicinin gördüğü satırı döndürür, bu yüzden inceleme komutu paragrafları okur.
IronPPT'nin zaten yazdığı desteği nasıl hata ayıklarsınız?
Velilerin akşam destesi, geçişten önce zaten IronPPT'yi kullanıyordu.
@src/ReportDecks/ParentEveningDeck.cs @TestData/expected/7B-parents-evening.txt
Find out why none of the 7B evening deck's lines match 7B-parents-evening.txt.
The office also reports black bars at the sides when the hall screen shows it.
Diagnose it before you touch any code:
1. Build the evening deck, inspect it and compare it with the expected outline.
2. List each line that differs.
3. Explain what in ParentEveningDeck causes each difference.
After that, fix ParentEveningDeck and keep it on IronPPT.
Add the output check the term report has, with pupils plus 1 as the slide count.
Inspect the deck again and tell me how many lines match before and after the fix.
Çıktı
Aşağıdaki çizimler, bir randevu slaytının düzeltme öncesi ve düzeltme sonrası desteden olanını gösterir.

Kaydedilen dosyanın XML'inden çizilmiş, düzeltme öncesi velilerin akşam destesi slayt 3. 4:3 slayt, aynı pozisyonda iki metin şekli tutar. Çizim saklanan geometrileri gösterir, bir PowerPoint rendesi değil.

Kaydedilen dosyanın XML'inden çizilmiş, düzeltme sonrası velilerin akşam destesi slayt 2. 16:9 slayt, 1905000 ile 1270000 EMU büyüklüğünde bir metin kutusu tutar. Çizim saklanan geometrileri gösterir, bir PowerPoint rendesi değil.
Desteler için regresyon testleri nasıl yazılır?
@src/ReportDecks/ @TestData/
Write xUnit tests in tests/ReportDecks.Tests and add that project to the solution.
The tests cover these cases:
- The 7B term report matches every line of TestData/expected/7B-term-report.txt.
- The 7B evening deck matches every line of TestData/expected/7B-parents-evening.txt.
- Both decks are 16:9, which is 12192000 by 6858000 EMU in ppt/presentation.xml.
- Every slide after the first keeps its text in one text box.
- The 8A term report has 5 slides, with pupils in roster order.
- The comments file has one line per pupil, in roster order.
- The output check throws for a saved deck with an empty slide and names that slide.
If the output check has no method of its own that takes a saved deck, add one.
Write test decks to a temp folder, not to out/.
Run dotnet test, then give me the pass and fail totals.
Slide.Width ve Slide.Height, yeni bir destede ve açılan 16:9 bir destede boş değerler döndürdü, bu yüzden boyut testi ppt/presentation.xml okur.
Gerçek bir çalıştırmada istemler ne üretti?
Aşağıdaki her yapı ve inceleme, kodu değiştiren her taahhüdün taze bir Yayın sürümü üzerinde tekrarlandı ve ayrı bir betik her kaydedilen desteyi okudu.
- Geçiş öncesi, Open XML SDK destesi onaylanmış taslağın tüm 8 satırını eşleştirdi.
- IronPPT'ye geçiş sonrası, dönem rapor destesi de tüm 8 satırı eşleştirdi.
- Taşınan deste, okulun şablonunu açarak 12192000 ile 6858000 EMU arasında 16:9 slaytları korudu.
- Cursor, şablonun başlık slaydını doldurdu, böylece 7B destesi 8 slayt ve boş slayt içermiyordu.
- Her öğrenci slaytı, kendi pozisyonu olmayan tek bir 1905000 ile 1270000 EMU metin kutusu içinde metnini tuttu.
- Open XML SDK destesi 6 not slaydı tuttu ve IronPPT destesi hiçbiri tutmadı.
- Altı danışman yorumu, 7B-term-report.comments.txt'ye, kayıt sırasıyla her öğrenci için bir satır olarak gitti.
- Cursor, alıntılanmış sayfalardan beş dokümantasyon sorusunu yanıtladı ve dosyaları değiştirmedi.
- Cursor, PresentationDocument.AddText'in metni nereye yerleştirdiğini belirten bir sayfa bulamadı.
- Slayt boyutu için Cursor, Slide.Width ve Slide.Height'i alıntıladı. Bu yanıt yanlıştı.
- Çıkış kontrolü, boş bir öğrenci girişi olan bir listeyi reddetti, "Slayt 2 metin içermiyor" yazdırdı ve kod 3 ile çıktı.
- Düzeltilmeden önce, akşam destesi 7 satırdan 0'ını eşleştirdi ve 4:3 slaytları kullandı.
- Düzeltilmiş durumda, akşam destesi 7 satırdan 7'sini 16:9 slaytlarda eşleştirdi.
- Cursor'ın bildirdiği eşleşme sayıları, her iki destedeki bağımsız kontrollerle uyumlu oldu.
- xUnit dizisi, istenen yedi durumu kapsayan 9 testten 9'unu geçti.
- Her Yayın yapımı 0 hata içeriyordu ve test projesi 1 xUnit analizör uyarısı ekledi.
- Bazı adımlar sayfadan farklı çalıştı. Yedi istem de, tek bir başsız oturumda Cursor CLI'den geçti. CLI, 03'ün isteminde notlar hakkındaki soruları ve 05'in istemindeki hata çıktısını atladı. 05'ten 07'ye kadar olan istemler, oturum yeniden başladığında Plan Modunda çalıştı, bu yüzden bir takip mesajı, "Planı oluşturun.", her bir planı gerçekleştirdi. 04'ün isteminde farklılık için, Cursor kodun değişimini göstermek yerine beklenen dosya ile taslakları karşılaştırdı.
GitHub Copilot kılavuzu, bazı IronPPT konvansiyonlarını, buradaki globlar gibi, yol özgü bir talimat dosyası ile kaynak ve test projeleri ile sınırlıyor. Claude Kod kılavuzu, deste oluşturucu yazılmadan önce bir planı da onaylar. çalıştırma kaydı, Cursor sürümünü, modeli ve bu çalıştırmanın süresini listeler, ve test makinesini.
Hata Ayıklama
- Slaytları Nasıl Eklerim, oluşturulan bir deste boş bir slayt ile başladığında
- TextBox Sınıfı, bir slaydın satırları çakıştığında
- Slaytları Nasıl Yönetirim, bir slaytın kaldırılması veya gizlenmesi gerektiğinde
- Lisans Anahtarlarını Kullanma, oluşturulan kod kayıtta bir lisanslama hatası verdiğinde
Sorular?
Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın
Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.