IronPPT'i Google Antigravity ile Nasıl Kullanılır
Bir proje yönetim ofisi, her proje için her Pazartesi bir durum sunumu yayınlar. StatusDesk'te, ofisin web uygulamasında, bir proje yöneticisi bir projenin satırındaki Durum sunumunu indir'e tıklayarak sunucu tarafından kısa süre önce oluşturulan bir PowerPoint dosyası alır. Bir sunum hatasız indirilebilir ve yine de boş bir ilk slayt, üst üste yığılmış metin kutuları veya başka bir projenin slaytları ile açılabilir. Bu hataların hiçbiri oluşturma günlüğünde görünmez.
Google Antigravity, bir proje yöneticisinin kullandığı şekilde sayfayı kontrol edebilir. /browser komutu, her İndir butonuna tıklayan ve bir ekran görüntüsü yakalayan bir korumalı tarayıcı alt ajanını başlatır. IronPPT, sunucu üzerinde metin, şekil ve görüntülere dayalı olarak sunumu oluşturur, IronPPT'nin slayt öğesi eğitici rehberinde ele alınan unsurlar. Bu rehber, sayfayı her iki araçla da oluşturur ve bu sunumları önceden bilinen altı projeye karşı kontrol eder.
Bu rehber, PowerPoint dosyaları oluşturan .NET kodunu yazmak için AI ajanlarını kullanan geliştiriciler içindir. Slayt tasarımı veya kurumsal şablonlarla ilgilenmez.
Hızlı BaşlangıçAntigravity'de StatusDesk projesi açıkken, durum sayfasını açıklayın.
/plan Give StatusDesk, the PMO's .NET 9 MVC site, a /Status page.
Each project row gets a Download status deck button.
The nav bar gets a Status link.
Install IronPPT 2026.10.1. Its namespace is IronPPT.
App_Data/projects.json holds the projects and the report week.
Each deck has these slides, in order:
1. Title: project name, "Status report, week of" plus the week, owner.
2. Status: status word, status-colored rectangle, summary, logo.
3. Milestones: name, due date and state, at most five per slide.
4. Risks: every risk, only if there are any.
Follow these rules too:
- Status colors: Green 00B050, Amber FFC000, Red C00000.
- Logo: App_Data/logos/<Id>.png, skipped if missing or unreadable.
- Text boxes don't overlap, and nothing runs off the slide IronPPT creates.
- Download name: status-<Id>.pptx, with the PowerPoint content type.
- If a deck fails, the page shows one plain sentence, never exception text.
Startup code reads IRONPPT_LICENSE_KEY itself and sets IronPPT.License.LicenseKey once.
Never print, log or store the key, or list environment variables.
Answer these in the Implementation Plan:
- What does a new PresentationDocument hold, and how big is its slide?
- Where does AddText put a text box, and what unit do Position, Width and Height use?
- How do the deck's bytes get into the HTTP response?
Show me the plan, then build until dotnet build shows zero errors.
Başarılı bir oluşturma, üç cevaptan hiçbirini kanıtlamaz, bu yüzden onaylamadan önce planı okuyun.
IronPPT kendi başına IRONPPT_LICENSE_KEY'i okumaz. Bizim testimizde, License.IsLicensed yalnızca o değişken ayarlandığında yanlış kaldı, oysa IronPPT.LicenseKey adlı bir ortam değişkeni herhangi bir kod olmadan işleme lisans verdi. Başlangıçta License.LicenseKey atamak, değişken adını uygulamanın kontrolünde tutar. Lisans anahtarı rehberi anahtarı uygulamanın diğer yollarını açıklar.
Asgari İş Akışı (5 adım)
- C# PowerPoint kütüphanesini NuGet'ten İndirin
- Zaten sayfa oluşturup servis eden bir ASP.NET Core projesiyle başlayın
- Her metin kutusu, şekil ve görüntüye kendi konumunu nokta cinsinden verin
- /browser her sunumu indirip her dosyayı bilinen bir listeyle karşılaştırmalıdır
- Eş zamanlı indirmeler yapın, ardından API referansındaki her üye doğrulansın
Google Antigravity nedir ve bir sohbet asistanından nasıl farklıdır?
Google'ın genel bakışına göre, Antigravity App, AI ajanlarının ekiplerini başlatmak, orkestre etmek ve incelemek için bağımsız bir masaüstü uygulamasıdır. Ajanları, bir sohbet asistanının metni döndürdüğü yerlerde bir Uygulama Planı, bir Kılavuz ve ekran görüntüleri gibi Eserler döndürür.
Bir paket adını kontrol etmeden seçen bir ajan, malware'i yükleyebilir, çünkü saldırganlar dil modellerinin hayal ettiği adlar altında paketler yayınlar. Bu saldırıya slopsquatting denir. Her görevin paket eklediği paket adını ve sürümünü IronPPT olarak adlandırın. AI kodlama asistanları rehberi, ajanlar için IronPPT'nin dokümantasyon dosyalarını listelemekte ve kabul testi tek bir isteme sığmaktadır.
Planda, kod değişikliklerinde ve Kılavuzda neyi kontrol etmelisiniz?
Planda, her cevabı aşağıda ölçülen sunum içeriğiyle karşılaştırın. Kod değişikliklerinde, her metin kutusunun konum aldığı yeri bulun ve API referansındaki her IronPPT üyesini doğrulayın.
Kılavuz, her indirme işlemine ait bir ekran görüntüsünü tutmalıdır. Masaüstü uygulamasında, Antigravity her screenshot'ı yorumları kabul eden bir görsel eser olarak saklar, bu yüzden yanlış satır üzerindeki bir yorum yeni bir isteme gerek kalmadan projeyi tanımlar.
Gerçek bir tarayıcıda indirme butonunu nasıl test edersiniz?
/browser'a her sunumu indirip dosyayı açarak tamamlayabileceği bir tablo sağlayın.
/browser Launch StatusDesk with dotnet run as a background process.
Then open http://localhost:5326/Status.
Do this for every project, top to bottom:
1. Click Download status deck.
2. Save the file as artifacts/decks/status-<Id>.pptx.
3. Take a screenshot of the page.
Next, write a console tool in tools/DeckCheck that opens a deck with IronPPT.
It prints the slide count and each slide's text, shape count and image count.
Leave tools/DeckCheck out of the web project's compile items.
Run DeckCheck on each deck in artifacts/decks and compare it with TestData/expected-decks.csv.
Put the results in a Walkthrough table and in artifacts/deckcheck.md.
The table has these columns:
- project
- slides expected and slides found
- first text on slide 1
- images found
- pass or fail
If a row fails, trace the cause in the deck code before you edit.
Then fix it, restart the site and download every deck again.
At the end, kill the dotnet process by its PID and show me the table.
Altı proje, bir durum sunumunun ele alması gereken durumları kapsar. Atlas ve Borealis bir logoya ve açık risklere sahipken; Cobalt'ın logo dosyası yok ve Delta'nın riski yok, böylece sunumu dönüm noktalarından sonra sona erer. Ember logosu, başarısız bir dışa aktarımın bir HTML hata sayfasını bir görüntü yerine tutar, ve Fjord'un yedi dönüm noktası vardır, bu da ikinci bir dönüm noktası slaydını gerektirir.
P-102 için indirme sonrasında /Status sayfası, son tarayıcı geçişinin tespit ettiği şekilde stiller olmadan.
Çıktı
Aşağıdaki Borealis sunumu, son tarayıcı geçişinin indirdiği değiştirilmemiş dosyadır.
Borealis Mobil Uygulama durumu sunumu, ikinci slaytında logo olan dört slayt.
Yeni bir IronPPT sunumu, herhangi bir şey eklemeden önce ne içerir?
Her yeni PresentationDocument bir slaytla başlar. O slayt, Başlık Slaytı düzenini kullanır ve iki boş yer tutucu, Başlık 1 ve Altyazı 2 tutar ve AddSlide ardından eklenir. Slayt ekleme rehberi mevcut slaydı belirtir.
Slayt oranı 4:3, 720 x 540 noktadır. Position, Width ve Height değerleri nokta cinsinden alır, böylece 100 genişliği 1.270.000 EMU yazar. IronPPT 2026.10.1 için birim piksellerini çağıran slayt öğesi eğitimi rehberindeki yorumlar yanlıştır.
Slide.AddText konum içermeyen bir metin kutusu oluşturur, IronPPT merkez makalesinde ölçüldüğü gibi. Position, Width ve Height'ı Slide.TextBoxes son öğesi için ayarlamak, çağrının eklediği kutunun yerleşimini sağlar. Font.FontFamily, dosyaya yazı fontu yazmaz, ama Font.LatinFont yazar.
Her slayt için AddSlide'yi ve konumlar olmadan AddText'i çağıran bir kalibrasyon oluşturması, tüm altı sunumu boş bir slaytla açtı ve her sunumda 6 ila 15 metin kutusu aynı konumu paylaştı. Mevcut slaydı yeniden kullanarak ve her metin kutusunun konumunu belirleyen ikinci bir oluşturma, tüm altı projeyi geçti.
Antigravity'nin çalışabileceği bir proje nasıl kurulur?
Ajanı sayfa oluşturan ve bir sayfa servis eden bir depoda başlatın. Bu rehber projesi, dotnet new mvc -f net9.0 ile oluşturuldu ve ilk istemden önce bir kez oluşturulmuştur. Properties/launchSettings.json'daki http profili port 5326'yı servis eder.
Which IronPPT version is in StatusDesk.csproj? Quote that PackageReference line.
Next, find and quote the code that sets the key.
Answer from the code without running the app.
Check the key handling against these rules:
- The key comes in through IRONPPT_LICENSE_KEY at startup and nowhere else.
- No appsettings file has an IronPPT.LicenseKey entry.
- The key isn't set in Properties/launchSettings.json either.
- If the variable is missing, startup logs a single warning with its name and no value.
- IronPPT licensing errors get logged by type name only, because their message can contain the key.
If that warning is missing, add it to Program.cs and change nothing else.
For each other rule that fails, give me the file and line.
Önceliği olmayan bir lisans anahtarıyla, IronPPT 2026.10.1 bellekte bir sunum oluşturdu ve mevcut bir PPTX dosyasını açtı. Save "Üretim Lisansı Gerekiyor" başlıklı bir LicensingException attı ve hiçbir çıktı dosyası görünmedi. Kalibrasyon sayfasında ilk lisanssız indirme işleminden sonra 871 ms sonra ve daha sonraki olanlar 33 ila 48 ms içinde başarısız oldu. Bir işleyici, tipi kamuya açık olmadığı için LicensingException'ı tip adıyla eşleştirmek zorundadır.
Geçersiz bir anahtarla, LicensingException mesajı kendisine verilen anahtar metnini tekrarladı. İstisna mesajını görüntüleyen bir kalibrasyon indirmesi, yanıt olarak bu anahtar metnini döndürdü. Mesajı kaydeden bir günlük girişi aynı metni taşır, bu yüzden yukarıdaki kural tip adını yalnızca günlüğe kaydeder.
Sunum kurallarını sonraki görevlere nasıl uygularsınız?
Her satır geçtiğinde, oturumun kararlarını kurallar olarak kaydedin. Antigravity'nin kurallar dokümantasyonuna göre, CLI, AGENTS.md, GEMINI.md ve .agents/rules dosyalarını depolama kökünden ve alt dizinlerden okur. /learn komutu, oturumdan gelen düzeltmeleri kalıcı kurallar haline sıkıştırır.
/learn Save what this session decided in a new AGENTS.md at the repo root.
Put it under the heading "Status decks" and cover these points:
- what a new PresentationDocument holds before any slide is added
- the unit of Position, Width and Height, and the slide size
- how each text box gets a position of its own
- how the deck's bytes reach the HTTP response
- that the key comes only from IRONPPT_LICENSE_KEY and is never printed, logged or stored
- that no command lists the environment variables
- that a change is done once every row of TestData/expected-decks.csv passes in /browser
Show me the file when you're done.
Pek çok kişi aynı anda indirme yaparken ne olur?
Her istek kendi PresentationDocument'ını oluşturup kendi dosyasına kaydetse bile, IronPPT iki istekte aynı anda kullanmak için güvenli değildir. Bellekte 16 işlemci üzerinde sunumlar oluşturmak hata üretmedi. Paralel dizinlerde kaydetme veya yükleme işlemi, InvalidOperationException ve IOException gibi hatalarla başarısız oldu ve istisnasız kaydedilen bazı dosyalar başka bir sunumun slaytlarını tuttu. Save etrafında bir kilitleme ve yalnızca yükleme de kilitlenmemiş olarak bırakıldığında, 32 sundan 1 ile 10'u hala başarısız oldu.
Kalibrasyon uygulamasında, iki kez indirmek için patronunun her projesi seçildi. Kilitleme olmadan, 36 yanıtın 30'u HTTP 500 döndürdü ve sunulan 6 sunumdan 4'ü yanlıştı. Her IronPPT çağrısı etrafında bir kilit ile, 36 yanıtın tümü doğru sunumu içeriyordu ve en yavaş olanı 1.066 ms sürdü.
/plan On Monday mornings a dozen project managers download their decks within seconds of each other.
Write an Implementation Plan Artifact first, and wait for my approval before any edit.
Once I approve, measure the effect on the site before you touch the code:
1. Run the site in a separate process.
2. Send 12 download requests at once, two per project.
3. Save each response and check its slide count and title against TestData/expected-decks.csv.
4. Search each file for text from another project.
5. Count the failed responses and the files that don't match.
Then fix the root cause. Every download has to stay under two seconds.
After the fix, send the 12-request burst three more times.
Give me these results:
- the counts before the fix and for each later burst
- the first error from the log
End by stopping the site's dotnet process through its PID.
Beklenen hizmet, IronPPT 2026.10.1 ile derlenen bu örneğe benzer. Onlardan oluşturulan sunumlar, ilk slayt üzerindeki boş Başlık 1 ve Altyazı 2 yer tutucuları korurlar. Onları silmek için, ilk AddText çağrısından önce title.TextBoxes.ToList()'nin her öğesi için Remove çağrısı yapın.
using IronPPT;
using IronPPT.Enums;
using IronPPT.Models;
namespace StatusDesk.Services;
public sealed class DeckBuilder(IWebHostEnvironment env)
{
// IronPPT is not safe to run on two requests at once, so every IronPPT call goes through this lock.
private static readonly object IronPptLock = new();
private static readonly Dictionary<string, string> StatusColors = new()
{
["Green"] = "#00B050",
["Amber"] = "#FFC000",
["Red"] = "#C00000",
};
public byte[] Build(Project project, string reportWeek)
{
lock (IronPptLock)
{
var deck = new PresentationDocument();
Slide title = deck.Slides[0];
AddText(title, project.Name, x: 40, y: 180, width: 640, height: 70, points: 40, bold: true);
AddText(title, $"Status report, week of {reportWeek}", x: 40, y: 260, width: 640, height: 40, points: 24);
AddText(title, $"Owner: {project.Owner}", x: 40, y: 310, width: 640, height: 40, points: 20);
Slide status = deck.AddSlide(new Slide());
AddText(status, "Status", x: 40, y: 30, width: 500, height: 60, points: 32, bold: true);
status.AddShape(new Shape
{
Type = ShapeType.Rectangle,
FillColor = new Color(StatusColors[project.Status]),
Position = (40, 110),
Width = 160,
Height = 60,
});
AddText(status, project.Status, x: 220, y: 120, width: 300, height: 40, points: 28, bold: true);
AddText(status, project.Summary, x: 40, y: 200, width: 640, height: 120, points: 20);
string logo = Path.Combine(env.ContentRootPath, "App_Data", "logos", project.Id + ".png");
if (File.Exists(logo))
{
try
{
var image = status.AddImage(logo);
image.Position = (560, 30);
image.Width = 120;
image.Height = 60;
}
catch (IronPPT.Models.Exceptions.ImageLoadException)
{
}
}
// Milestone and risk slides follow the same AddText pattern.
string path = Path.Combine(Path.GetTempPath(), $"status-{Guid.NewGuid():N}.pptx");
try
{
deck.Save(path);
return File.ReadAllBytes(path);
}
finally
{
File.Delete(path);
}
}
}
private static void AddText(Slide slide, string text, double x, double y, int width, int height, double points, bool bold = false)
{
slide.AddText(new Text(text)
{
TextStyle = new TextStyle { IsBold = bold, TextFont = new Font { LatinFont = "Calibri", FontSize = points } },
});
var box = (TextBox)slide.TextBoxes[^1];
box.Position = (x, y);
box.Width = width;
box.Height = height;
}
}
Save'nun yalnızca bir dosya yolu kabul ettiği için, örnek geçici bir dosya yazar ve onun baytlarını döndürür.
Ne zaman birden fazla ajan gönderilmeli?
Bir tarayıcıya ihtiyaç duyulmadığında kontrolün bir bölümünü gerektiren duruma ikinci bir ajan başlatın.
Split this work between two agents.
Agent A writes an xUnit project, StatusDesk.Tests, with these tests:
- For each row of TestData/expected-decks.csv, check the slide count and title text.
- Check the status rectangle's fill color in the saved file's slide XML.
- Build and save all six decks on parallel threads, then check each file holds only its project.
The tests follow AGENTS.md and these rules:
- They copy IRONPPT_LICENSE_KEY into IronPPT.License.LicenseKey before any save.
- They build decks through the site's own deck code and never start the site.
- The web project is the repo root, so its compile items skip StatusDesk.Tests.
Agent A runs them with dotnet test StatusDesk.Tests.
Agent B starts once that suite passes:
1. Use /browser to download every deck.
2. Send the 12-request burst again.
3. Put a screenshot of each download in the Walkthrough, and note there that the tests passed first.
Tell me what each agent found.
IronPPT ile geriye kaydedilen bir sunumu okuyan bir test, metni bozulmamış olarak alır. Pozisyonlar ve boyutlar, ayarlanan değerlerden 12.700 kat daha büyük döndü ve dolgu ve metin renkleri #00000000 olarak geri döndü, bu nedenle bir renk kontrolü slayt XML'ini okumalıdır.
Gerçek bir çalıştırmada istemler ne üretti?
Altı istem de onay istemleri atlanarak tek bir Antigravity CLI oturumunda çalıştı. Uygulama, lisans anahtarını yalnızca IRONPPT_LICENSE_KEY aracılığıyla aldı. Her sunum da bağımsız olarak indirildi ve kontrol edildi, ilk istemden sonra bir kez ve son uygulamada tekrar.
- Herhangi bir düzenlemeden önce, plan yeni belgedeki ilk slayttaki iki boş yer tutucuyu buldu ve yapılandırma onları kaldırdı.
- İlk istemden sonra, tüm altı sunum beklenen slayt sayısı ve başlıkla donatılmıştı.
- Her iki kontrolde de, hiçbir metin kutusu bir diğeriyle üst üste gelmedi veya slayt kenarını aşmadı.
- O ilk yapılandırmada, 12 eşzamanlı indirmenin üç patlaması 3, 1 ve 3 doğru sunum döndürdü.
- O patlamalarda, 36 isteğin 27'si bir güldüren sayfayı HTTP 200 ile aldı, bir sunum yerine.
- İki sunum teslimi yanlış idi ve bir Borealis Mobil Uygulama sunumu, Delta Ofis Taşınması projesinin adını içeriyordu.
- Ajanın düzeltmesi, her sunumu yapılandırırken ve kaydederken bir kilidi koymuştur.
- Düzeltme, durum sayfasına ilk istekte tüm altı sunumu oluşturdu ve baytlarını bellekte tuttu, proje verileri veya bir logo değişene kadar.
- Düzeltmeden sonra, üç bağımsız patlama 36'dan 36 doğru sunum döndürdü ve en yavaş indirme 14 ms sürdü. Her yanıt bellekte tutulan sunumlardan gelmişti, bu yüzden bu patlamalar kilidi kullanmadı. Eşzamanlılık bölümündeki kalibrasyon testi, kilidin çalıştığını gösteren ölçümdür.
- 400 x 200 piksel logoları, 152 x 110 noktada çizildi, bu da onları bozdu.
- Anahtarsız, sayfa "Bu proje için durum sunumu oluşturulamadı." mesajını gösterdi.
- Geçersiz bir anahtar yanıt veya günlükte görünmedi.
- /learn depo kökünde yedi noktaya sahip AGENTS.md yazdı.
- Tüm 13 xUnit testleri anahtarla geçti ve anahtarsız başarısız oldu.
- İki ajanlı istem her ajanı kendi çocuk konuşmasında çalıştırdı ve Ajan B testler geçtikten sonra başladı.
- Bazı adımlar sayfadan farklı çalıştı. /browser alt ajanı başlangıçta Chrome'a erişmede başarısız oldu, böylece ajan Chrome'u uzaktan hata ayıklama ile kendi başlattı. O adım, ayrıca kullanıcının Chrome profilinde DevToolsActivePort dosyasını yeniden yazdı. Tarayıcı ekran görüntüleri sayfayı stilleri olmadan gösterdi, bağımsız kontrolde normal şekilde yüklendiler. Her iki plan-öncelikli istem, yürütme onay gönderene kadar plan sonrasında durdu. Kurulum kontrolü, bir şey kaydetmeyen bir yakalama bloğunu raporladı ve eşzamanlılık istemi daha sonra onu değiştirdi.
ChatGPT Codex görevlerin adlandırılmış kısımlarını araştırmacı ve çalışan ajanlara atar ve GitHub Copilot AGENTS.md ile bu rehberde olduğu gibi sürekli kurallarını taahhüt edilen talimat dosyalarında tutar. kayıt paylaşımı merkez sayfasında Antigravity'nin versiyonunu, modeli, çalışmanın süresini ve test makinesini listeler.
Hata Ayıklama
- Slayt Öğesi için slayt üzerindeki metin, stil, görüntüler ve şekiller
- Ekstra boş bir slayt açıldığında Slayt Ekle
- Metin stilleri ve paragraflar için Metin Ekle
- Görüntü boyutu ve konumu için Görüntü Yönet
Savesunucuda atıldığında Lisans Anahtarlarını Uygulama
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.