Cómo usar IronPPT con Cursor

Curtis Chau
Curtis Chau
Actualizado: 19 de octubre de 2026

Cuando un agente de IA mueve un generador de informes en C# del Open XML SDK a IronPPT al traducir directamente cada llamada a la diapositiva, el nuevo conjunto de diapositivas difiere del anterior. El Open XML SDK comienza desde un paquete vacío. Un nuevo PresentationDocument de IronPPT ya contiene una diapositiva, por lo que un puerto directo que agrega una diapositiva de título y una diapositiva por estudiante guarda un conjunto de diapositivas cuya primera diapositiva está en blanco. En nuestras pruebas, el mismo puerto también produjo diapositivas 4:3 donde el generador antiguo escribía 16:9.

Cursor es un editor de código de IA construido sobre la base de código de VS Code, con un agente que edita archivos y ejecuta comandos. La migración a continuación utiliza dos de sus características, los enlaces de documentación que el agente lee y las reglas del proyecto comprometidas en .cursor/rules. Mueve un generador de informes escolares a IronPPT. El generador construye un informe por clase desde un archivo de lista, con una diapositiva de título, una diapositiva por estudiante y una diapositiva de cierre, y el conjunto de diapositivas migradas debe mantener cada línea de texto aprobada por la escuela.

Para las llamadas involucradas, consulte la guía de agregar diapositiva y la guía de agregar texto.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronPPT

Instale IronPPT ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Con el repositorio de ReportDecks abierto, pegue esta solicitud en un nuevo chat del Agente.

@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.
Text

No pegue la clave de licencia en un chat, donde el agente puede copiarla en un archivo fuente, un commit o un registro de compilación. IronPPT 2026.10.1 no lee IRONPPT_LICENSE_KEY por sí mismo. Busca una configuración llamada IronPPT.LicenseKey en el entorno o en la configuración de la aplicación, por lo que la solicitud establece License.LicenseKey en el código. Sin una clave, construir diapositivas en memoria y leer un conjunto funcionó, y Save lanzó una LicensingException antes de escribir el archivo. La guía de claves de licencia describe dónde almacenar la clave en su lugar.



¿Qué modelo de Cursor debería usar para trabajar con IronPPT?

Composer es el modelo agente propio de Cursor. El selector de modelos también ofrece los modelos Grok de SpaceXAI, que Cursor co-desarrolló, y modelos de OpenAI, Anthropic, Google y otros laboratorios. La prueba ejecutada a continuación utilizó Composer 2.5.

¿Cómo le das a Cursor la documentación de IronPPT?

Incluya el enlace de documentación de IronPPT en la solicitud o almacénelo en una regla que todo el equipo comparta. El llms.txt de IronPPT enumera cada guía y la referencia de la API, y llms-full.txt condensa 16 páginas de documentación en un solo archivo. A partir de octubre de 2026, el menú @ de Cursor adjunta archivos, carpetas, terminales, chats, diferencias de Git y el navegador, por lo que la solicitud le da al agente la documentación de IronPPT como un enlace.

La guía de agregar diapositiva señala que una nueva presentación ya contiene una diapositiva en blanco. El skill.md de IronPPT llama al mismo objeto una presentación nueva y vacía, y ninguna página enlazada por llms.txt indica el tamaño de la diapositiva de un nuevo conjunto.

@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.
Text

¿Cómo escribir reglas de proyecto que codifiquen tus convenciones de IronPPT?

Una regla de proyecto es un archivo .mdc almacenado en .cursor/rules y versionado con el repositorio. Cursor ignora un archivo .md simple en esa carpeta porque un archivo sin frontmatter no le proporciona una forma de decidir cuándo cargar la regla.

La regla a continuación enumera sus patrones de archivo en globs, separados por comas como especifica la página de reglas de Cursor, y establece alwaysApply en falso. Cursor luego lo carga para solicitudes que involucran el código del conjunto de diapositivas o las pruebas. Guárdelo como .cursor/rules/ironppt-decks.mdc.

---
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.
Markdown
Por favor, tenga en cuenta: Cursor también lee AGENTS.md en la raíz o en cualquier subcarpeta. Ese archivo no tiene frontmatter ni patrones de archivo, por lo que una regla que depende de globs pertenece en .cursor/rules.

Las reglas se aplican a las solicitudes de Agent. La página de reglas de Cursor indica que las reglas no afectan a Tab y que las reglas de usuario no se aplican a las ediciones en línea, por lo que revise esas sugerencias manualmente contra la regla.

¿Cómo mapear las llamadas del Open XML SDK a IronPPT?

El Open XML SDK escribe una parte del paquete por vez, por lo que el generador antiguo también crea el maestro de diapositivas, el diseño, el tema y el maestro de notas. IronPPT crea esas partes por sí mismo.

Open XML SDKIronPPT
PresentationDocument.Create con una parte de presentación, maestro, diseño y temanew PresentationDocument(), o el constructor con una ruta de plantilla
Un SlidePart añadido a la parte de presentación y enumerado en SlideIdListAddSlide(new Slide()), que anexa la diapositiva
Marcadores de posición de título y cuerpo llenados con A.Paragraph y A.RunSlide.AddChild con un TextBox, uno Paragraph por línea
Texto en un marcador de posición existenteTexts[i].Text en una diapositiva de la plantilla cargada
SlideSize ajustado a 12192000 por 6858000No hay equivalente, por lo que el tamaño proviene de la plantilla
Un NotesSlidePart por diapositivaNo existe equivalente
Save a un archivo o cualquier StreamSave(string), solo una ruta de archivo

IronPPT.dll incorpora su propia copia de los tipos de Open XML SDK, todos internos, por lo que el proyecto construido con ambos paquetes referenciados durante la migración.

¿Por qué un nuevo conjunto de diapositivas de IronPPT comienza con una diapositiva extra?

La diapositiva integrada de un nuevo PresentationDocument usa un diseño de título cuyos marcadores de título y subtítulo están vacíos. AddSlide se añade después de ella y devuelve la diapositiva que se le dio, por lo que cada diapositiva de un puerto directo aparece una posición más tarde de lo que estaba en el esquema aprobado.

Eliminar esa diapositiva demasiado pronto falla. Llamar a Remove sobre ella mientras es la única diapositiva lanzó una InvalidOperationException indicando que una presentación debe contener al menos una diapositiva. Una vez que existió una segunda diapositiva, la misma llamada tuvo éxito.

El tamaño de la diapositiva es la segunda diferencia. Un nuevo conjunto midió 9144000 por 6858000 EMU, una diapositiva 4:3. La referencia API documenta Slide.Width y Slide.Height con un ejemplo que establece el ancho en 960 puntos, pero ninguna propiedad cambia el tamaño de la diapositiva del conjunto. Establecerlos a 960 por 540 puntos escribió 12192000 por 6858000 EMU en las extensiones de las formas de la diapositiva y dejó el tamaño de la diapositiva en ppt/presentation.xml en 9144000 por 6858000 EMU. Un conjunto cargado desde un archivo 16:9 mantuvo 12192000 por 6858000 EMU a través del guardado, junto con sus marcadores y notas. Por lo tanto, el repositorio mantiene la diapositiva de título de la escuela en TestData/templates/hollybrook-16x9.pptx.

¿Cómo planificar y ejecutar una migración a IronPPT?

Presione Shift+Tab en la entrada del chat hasta que se seleccione el Modo Plan, luego envíe la solicitud a continuación. Cursor escribe el plan como un archivo Markdown editable.

@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.
Text

Corrija cualquier error en el plan. Luego construya el plan en Modo Plan, o cambie de nuevo a Agente y envíe esta solicitud.

@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.
Text

La mención @ironppt-decks adjunta la regla por nombre.

¿Qué característica de Cursor encaja con cada cambio?

Seleccione una característica basada en el alcance del cambio. Tab completa una edición que el desarrollador ha comenzado. Para una selección que una oración puede describir, use la edición en línea (Ctrl+K). El Agente maneja cambios en varios archivos y trabajo que requiere una compilación, y el Modo Plan agrega un plan para revisar antes de que el Agente cambie cualquier código.

Envíe esta solicitud en el Agente. Nombra el método que cambia, por lo que no necesita selección en el editor.

@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.
Text

¿Cómo coloca IronPPT el texto que agrega una diapositiva?

Cinco llamadas Slide.AddText en una diapositiva produjeron cinco formas de 1905000 por 1270000 EMU en el mismo marcador de posición del cuerpo. El centro de agentes de IA explica por qué tales formas comparten una posición. Un TextBox que contiene un Paragraph por línea da una forma con las líneas en orden. Una verificación del esquema no detecta una caja dejada en el tamaño predeterminado, porque solo lee el texto.

PresentationDocument.AddText se comporta de manera diferente al método de diapositiva. Agregó su texto como una nueva ejecución al final del párrafo final de la última diapositiva, sin espacio ni salto de línea. Al leer a través de Slide.Texts, las dos ejecuciones aparecen como elementos separados. Slide.Paragraphs devuelve la línea que ve un espectador, por lo que el comando de inspección lee los párrafos.

¿Cómo depurar el conjunto de diapositivas que IronPPT ya escribe?

El conjunto de diapositivas de la reunión con los padres ya utilizaba IronPPT antes de la migración.

@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.
Text

Resultado

Los dibujos a continuación muestran una diapositiva de citas del conjunto antes de la corrección y una del conjunto después de ella.

Diapositiva 3 del conjunto de reunión con los padres antes de la corrección, una diapositiva 4:3 con dos formas de texto superpuestas

Diapositiva 3 del conjunto de reunión con los padres antes de la corrección, dibujada desde el XML del archivo guardado. La diapositiva 4:3 contiene dos formas de texto en la misma posición. El dibujo muestra la geometría almacenada, no una representación de PowerPoint.

Diapositiva 2 del conjunto de reunión con los padres después de la corrección, una diapositiva 16:9 con una pequeña caja de texto

Diapositiva 2 del conjunto de reunión con los padres después de la corrección, dibujada desde el XML del archivo guardado. La diapositiva 16:9 contiene una caja de texto de 1905000 por 1270000 EMU. El dibujo muestra la geometría almacenada, no una representación de PowerPoint.

¿Cómo escribir pruebas de regresión para los conjuntos de diapositivas?

@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.
Text

Slide.Width y Slide.Height devolvieron valores vacíos en un nuevo conjunto y en uno abierto de 16:9, por lo que la prueba de tamaño lee ppt/presentation.xml.

¿Qué produjeron los prompts en una ejecución real?

Cada construcción e inspección a continuación se repitió en una compilación de Release fresca de cada commit que cambió el código, y un script separado leyó cada conjunto guardado.

  • Antes del traslado, el conjunto de Open XML SDK coincidía con las 8 líneas del esquema aprobado.
  • Después del traslado a IronPPT, el conjunto de informes del término también coincidió con las 8 líneas.
  • El conjunto migrado mantuvo diapositivas 16:9 de 12192000 por 6858000 EMU al abrir la plantilla de la escuela.
  • Cursor llenó la diapositiva de título de la plantilla, por lo que el conjunto de 7B contenía 8 diapositivas y ninguna diapositiva en blanco.
  • Cada diapositiva de alumno contenía su texto en una sola caja de texto de 1905000 por 1270000 EMU sin posición propia.
  • El conjunto de Open XML SDK contenía 6 diapositivas de notas, y el conjunto de IronPPT ninguna.
  • Los seis comentarios del tutor fueron a 7B-term-report.comments.txt, una línea por estudiante en orden de lista.
  • Cursor respondió las cinco preguntas de documentación de las páginas citadas y no cambió ningún archivo.
  • Cursor no encontró ninguna página que indique dónde PresentationDocument.AddText coloca su texto.
  • Para el tamaño de la diapositiva, Cursor citó Slide.Width y Slide.Height. Esa respuesta fue incorrecta.
  • La verificación de salida rechazó una lista con una entrada de alumno vacía, imprimió "la diapositiva 2 no tiene texto" y salió con el código 3.
  • Antes de su corrección, el conjunto de la noche coincidía con 0 de las 7 líneas y usaba diapositivas 4:3.
  • Después de la corrección, el conjunto de la noche coincidió con 7 de las 7 líneas en diapositivas 16:9.
  • Las cuentas de coincidencias reportadas por Cursor coincidieron con las verificaciones independientes en ambos conjuntos.
  • La suite xUnit pasó 9 de 9 pruebas, que cubrían los siete casos solicitados.
  • Cada compilación de Release tuvo 0 errores, y el proyecto de prueba añadió 1 advertencia de analizador xUnit.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. Las siete solicitudes pasaron por el CLI de Cursor en una sola sesión sin pantalla. El CLI omitió preguntas de Cursor sobre notas del orador en la solicitud 03 y sobre la salida de errores en la solicitud 05. Las solicitudes 05 a 07 se ejecutaron en Modo Plan cuando se reanudó la sesión, por lo que un mensaje de seguimiento, "Construya el plan.", llevó a cabo cada plan. Para la diferencia en la solicitud 04, Cursor comparó los esquemas con el archivo esperado en lugar de mostrar el cambio de código.

La guía de GitHub Copilot limita parte de sus convenciones de IronPPT al proyecto fuente y de prueba con un archivo de instrucciones específico de ruta, como lo hacen los globs aquí. La guía de Claude Code también aprueba un plan antes de que se escriba su generador de conjuntos de diapositivas. El registro de ejecución enumera la versión de Cursor, el modelo y la duración de esta ejecución, y la máquina de prueba.


Solución de problemas


¿Preguntas?

Si tienes alguna pregunta, contacta a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 7,110Versión:2026.11recién lanzado