So verwenden Sie IronXL mit ChatGPT Codex
Ein gemeinsamer Posteingang sammelt, was auch immer die Zweigstellen senden. Moderne XLSX-Exporte landen neben XLS-Dateien von vor Jahren außer Betrieb genommenen Systemen, Komma und Semikolon getrennte CSV-Dateien, tabulatorgetrennte Lagerauszüge, eine verschlüsselte Gehaltsarbeitsmappe, ein Webportal-Export, der sich als HTML herausstellt, und die gelegentliche Null-Byte-Datei, die nach einem fehlgeschlagenen Upload übrig bleibt. Das Warenlager möchte alle als CSV, JSON und XML haben und wissen, welche Dateien nicht angekommen sind.
ChatGPT Codex ist der Codierungsagent von OpenAI. Es wird als Terminalprogramm, als IDE-Erweiterungen, innerhalb der ChatGPT-Desktop-App und als Cloud-Service bereitgestellt, und jede kann mit demselben ChatGPT-Konto angemeldet werden. IronXL ist die Tabellenkalkulationsbibliothek von Iron Software für .NET.
Jeder Umwandlungsbefehl in diesem Leitfaden lässt Codex eine Ergebnisdatei mit einer Zeile pro Eingabedatei schreiben, bevor es etwas meldet, und jedes hier aufgeführte Umwandlungsergebnis wurde aus einer Datei dieser Art gezählt.
SchnellstartÖffnen Sie Codex in einem .NET-Konsolenprojekt mit einigen Beispiel-Tabellen und beschreiben Sie die Umwandlung.
$ironxl Add IronXL to this console project and have Program.cs convert every file in Samples/.
- Save each worksheet as CSV, JSON and XML under out/quickstart/<file name>/.
- Log each input file as one line in out/quickstart-results.csv.
- Give each line the sheet names, data rows per sheet and output files.
- For a file that fails, add the exception type to its line.
- Read that CSV back and print how many files succeeded and how many failed.
The license key is in IRONXL_LICENSE_KEY.
Build and run it, and fix whatever breaks.
Das $ironxl-Erwähnung lädt IronXLs Fähigkeit, bevor Codex Code schreibt.
Minimaler Arbeitsablauf (5 Schritte)
- Fügen Sie das IronXL.Excel NuGet-Paket zum Projekt hinzu
- Speichern Sie IronXLs Fähigkeit als
.agents/skills/ironxl/SKILL.md, damit die Erwähnung$ironxlaufgelöst werden kann. - Übergeben Sie ein
AGENTS.md, das IronXL zur einzigen Tabellenkalkulationsbibliothek macht und Schlüssel und Passwörter aus jedem Ergebnis heraushält. - Überprüfen Sie die führenden Bytes, den Trennzeichner und das Passwort jeder Datei, bevor IronXL sie öffnet, und zeichnen Sie einen Status für jede Eingabe auf.
- Verschmelzen Sie die Modi in einen getesteten Auftrag und suchen Sie jedes Mitglied, das er aufruft, in IronXLs API-Referenz.
Was ist ChatGPT Codex und wie fügt es sich in .NET-Tabellenkalkulationsarbeiten ein?
Codex führt die ihm zugewiesene Arbeit innerhalb der Ihnen gewährten Berechtigungen aus. Für eine Umwandlungspipeline schreibt es den Umwandler, führt ihn über den Posteingang aus, öffnet die erzeugten Dateien und bearbeitet den Code, wenn diese falsch sind. Installieren Sie das CLI mit npm install -g @openai/codex aus dem Codex-Repository, und sehen Sie sich die Codex CLI-Seiten für das Terminal an.
OpenAIs Sicherheitshinweise fordern dieselben zielgerichteten Überprüfungen und Diff-Prüfungen für die Codex-Ausgabe, die ein menschlicher Pull-Request erhalten würde. In dieser Pipeline bricht ein erfundener Mitglied den Build, und eine schlechte Umwandlung erscheint als Ergebniszeile, die nicht mit dem Manifest übereinstimmt.
Codex kann den Umwandler jedes Mal anders anordnen, aber IronXL muss für eine gegebene Datei dieselben Tabellen und Werte zurückgeben. WorkBook.Load öffnet XLS, XLSX, XLSM und XLTX-Dateien sowie CSV und TSV, wie es im Ladeleitfaden aufgeführt ist.
Wie schreibt man eine IronXL-Eingabeaufforderung und richtet Codex dafür ein?
Eine Umwandlungseingabeaufforderung gibt an, welchen Ordner gelesen werden soll, wie jeder Dateityp geöffnet wird, wohin jedes Ergebnis geht, was eine Zeile der Ergebnisdatei enthält und was als Nachweis gilt. Alles, was weggelassen wird, wird zu einer Entscheidung, die der Agent für Sie trifft.
| Komponente | Schwacher Prompt | Starker Prompt |
|---|---|---|
| Eingabe | Wandeln Sie die Tabellenkalkulationen um | Jede Datei in Inbox/, XLS, XLSX, CSV und TSV |
| Laden | Nicht angegeben | WorkBook.LoadCSV mit dem Trennzeichen aus out/inventory.csv |
| Ausgabe | Speichern Sie sie als CSV | CSV, JSON und XML pro Tabelle, in einem Ordner pro Eingabedatei unter out/converted/ |
| Fehler | Nicht angegeben | Jede Datei, die fehlschlägt, erhält eine Ergebniszeile mit ihrem Ausnahme-Typ |
| Nachweis | Überprüfen Sie, ob es funktioniert hat | Jede Zeile von out/convert-results.csv stimmt mit Expected/manifest.csv überein |
| Einschränkungen | None | Lassen Sie Inbox/ unberührt. Kein Passwort in irgendeinem Ergebnis. |
OpenAIs Forschung zu Halluzinationen zeigt, dass Training und Bewertung raten belohnen, und in einem Umwandlungsjob kann eine Vermutung als Gesamtmenge in der Abschlusszusammenfassung auftreten.
Codex sucht nach Fähigkeiten in .agents/skills-Ordnern vom Arbeitsverzeichnis bis zum Repository-Stamm. Eine Fähigkeit ist ein Ordner, dessen SKILL.md mit einem Namen und einer Beschreibung beginnt. IronXL veröffentlicht seine skill.md unter dem Namen ironxl, sodass das Speichern unter .agents/skills/ironxl/SKILL.md dazu führt, dass $ironxl aufgelöst wird. Ohne die Erwähnung kann Codex die Fähigkeit dennoch selbst auswählen, wenn die Aufgabe zur Beschreibung der Fähigkeit passt, und IronXLs Beschreibung listet Umwandlungen zwischen XLSX, XLS, CSV, TSV, JSON und XML auf.
AGENTS.md hält die ständigen Regeln. Codex sammelt diese Dateien vom Repository-Stamm ausgehend und geht nach unten zum Ordner, in dem die Sitzung begann, und wenn zwei Dateien in Konflikt stehen, hat die, die näher an diesem Ordner ist, Vorrang.
Write a root-level AGENTS.md with a section called Spreadsheet conversion.
It should hold these rules:
- IronXL (NuGet IronXL.Excel, namespace IronXL) is the only spreadsheet library allowed.
- API names come from the ironxl skill in .agents/skills/ironxl/.
- The index at ironsoftware.com/excel/csharp/llms.txt is also a source for them.
- IRONXL_LICENSE_KEY holds the license key, which is never echoed or saved.
- Inbox/, Expected/ and config/ are read-only.
- Passwords from config/known-passwords.csv never reach source code, an output or a log.
- Only a per-file results file written in that turn can back a count, total or timing in a reply.
- A reply that gives such a number names that file.
Erwarten Sie einen neuen Abschnitt in AGENTS.md und eine Antwort ohne Zahlen, da dieser Zug nichts umwandelt.
Wie fragen Sie Codex, IronXL hinzuzufügen und einen ersten Ordner umzuwandeln?
Überprüfen Sie das Paket vor allem anderen.
Tell me about the IronXL package, and don't change any package reference.
1. Print the IronXL.Excel PackageReference from SheetConvert.csproj and the version restore resolved.
2. Run dotnet list package --include-transitive and copy out every line that isn't IronXL.Excel itself.
3. Say whether anything in that graph needs Microsoft Office, Office Interop or a native library on Linux.
IronXL.Excel 2026.10.1 hängt direkt von IronSoftware.Common 2026.4.2 und IronSoftware.System.Drawing 2026.8.2 ab. Auf .NET 9 hielt die transitive Liste 30 Pakete außer IronXL.Excel selbst, keines davon Office oder Interop, und jede DLL im Build-Ergebnis, einschließlich der Plattform-Ordner unter Runtime, war eine verwaltete Assembly. Behalten Sie die von Codex gemeldete Version für spätere Eingabeaufforderungen und sehen Sie sich das IronXL Änderungsprotokoll an, wenn Sie eine Version auswählen.
Ohne Schlüssel schlägt jeder IronXL-Ladevorgang fehl. Über einen 28-Dateien-Eingang würde das 28 Kopien desselben Fehlers bedeuten, so dass der folgende Schutz austritt, bevor eine Datei berührt wird.
Put the license setup in Startup.ApplyIronXlKey and call it before any other line of Program.cs runs.
If IRONXL_LICENSE_KEY is missing or License.IsLicensed is false, write one line to stderr.
Then exit with code 2 before opening any inbox file.
Run the program twice, once as it is and once with the variable unset for that run only.
Give me both exit codes.
Die Lizenzschlüsselseite behandelt Testschlüssel und die Konfigurationsdateien, die IronXL ebenfalls liest.
Bevor der Umwandler existiert, finden Sie heraus, was der Ordner enthält. OpenAI dokumentiert Codex' eingebauten Explorer als agentenlastigen Agenten für die Codebase-Erkundung, was zu einer Umfrage ohne Änderungen passt.
Ask the explorer agent to survey Inbox/ without changing anything.
For each file it should report:
- the extension and the size in bytes
- the first eight bytes in hex
- what those bytes say the file really is (OOXML zip, OLE2 compound file, plain text, HTML, or unknown)
- for a text file, the separator in its header line
When the explorer reports back, save its findings as out/inventory.csv with one row per inbox file.
Then list every file whose bytes disagree with its extension.
Ein XLSX ist ein Zip-Archiv, das mit PK beginnt, und ein XLS ist eine OLE2-Kompositdatei, die mit D0 CF 11 E0 beginnt. Die Umfrage markiert eine durch Komma getrennte Textdatei mit dem Namen .xlsx und einen Portal-Export, dessen .xls eine HTML-Tabelle enthält, und sie kann die Null-Byte-Newcastle-Datei oder eine Datei mit zufälligen Bytes nicht anhand ihrer führenden Bytes identifizieren. Sie markiert auch die zwei verschlüsselten Arbeitsmappen, da ein verschlüsseltes XLSX ein OLE2-Container mit der gleichen Signatur wie ein altes XLS ist.
Create Services/InboxConverter.cs with a Convert(string path) method.
Convert returns a FileResult record.
The record holds the file, status, reason, sheet names and data rows per sheet.
It also holds the output paths, and the exception type and message.
Convert follows these rules:
- Open .xls and .xlsx files with WorkBook.Load.
- Open .csv and .tsv files with WorkBook.LoadCSV, using the separator recorded in out/inventory.csv.
- Save every sheet with SaveAsCsv, SaveAsJson and SaveAsXml into out/converted/<file name without extension>/.
- Keep going when a file throws.
Add a --convert mode that writes out/convert-results.csv.
Run it, and give me the status counts from that file.
Vier ihrer Zeilen haben in diesem Stadium den falschen Status. Die Null-Byte-Datei und die als .xlsx benannte Textdatei werden als umgewandelt gezählt, und die zwei verschlüsselten Arbeitsmappen werden als Fehlschläge gezählt, die Gehaltsabrechnungsdatei, deren Passwort bekannt ist, und eine Bonus-Pool-Datei, die unter geschützt gehört. Spätere Aufforderungen korrigieren alle vier.
Wo schreibt IronXL jedes Arbeitsblatt?
Ein Arbeitsmappenspeichern schreibt nicht an den übergebenen Pfad. Aufgerufen auf eine Arbeitsmappe, deren einziges Blatt Bestellungen ist, schreibt SaveAsCsv mit dem Pfad out/x/orders.csv orders.Orders.csv, den Dateinamen gefolgt vom Blattnamen und erstellt niemals orders.csv. Der Umwandlungsleitfaden dokumentiert eine Datei pro Arbeitsblatt für CSV, TSV, JSON und XML, und wir haben die Details gemessen, auf die sich eine Pipeline mit 2026.10.1 stützt.
- Ein einziges Blatt erhält immer noch ein Suffix: Eine aus CSV oder TSV geladene Arbeitsmappe hat ein Blatt namens
Sheet0, sodass customers-uk.csv zu customers-uk.Sheet0.csv wird. - Blattnamen werden unverändert übernommen: Das Q3-Zusammenfassungsblatt des Posteingangs gibt einen Dateinamen mit einem Leerzeichen darin an, und ein französischer Blattname behält seine Akzentbuchstaben, sodass nachgeschaltete Skripte Pfade angeben müssen.
- Die Arbeitsblattwriter verhalten sich unterschiedlich: Ein einfaches Arbeitsmappenspeichern mit einem CSV-, TSV-, JSON- oder XML-Namen teilt auch nach Blatt, während
WorkSheet.SaveAsCsvund die anderen Arbeitsblattwriter genau den ihnen gegebenen Pfad erzeugen. - Jedes Format hat seine eigene Form: Das CSV beginnt mit einem UTF-8-Byte-Order-Mark, JSON ist ein Array von Zeilen mit jedem Wert als String, und XML gibt jeder Zelle ein ColumnN-Element mit einem
xsi:type, wie etwaxs:double. Blattnamen, die keine gültigen XML-Namen sind, werden maskiert, sodass Q3-Zusammenfassung zu dem ElementQ3_x0020_Summarywird.
Weil das CSV enthaltene Zitatumbruchzeichen enthalten kann und mit einer leeren Zeile endet, gibt das Zählen seiner Zeilen die falsche Zeilenanzahl an. Zählen Sie die Datenzeilen direkt aus dem Arbeitsblatt, wie es die Ergebnisdatei tut, und listen Sie die von IronXL geschriebenen Ausgabepfade auf.
Warum verliert ein umgewandeltes CSV seine führenden Nullen?
Das Team, das die umgewandelten Daten importiert, kann ein Problem als Bild melden. Codex akzeptiert Bilder, wenn eine Sitzung mit codex --image anfängt, und das CLI ermöglicht es auch, ein Bild in den Komponisten einzufügen.
I've attached a screenshot with codex --image.
The customer accounts team took it from their import preview of the converted customers-uk file.
1. Read the picture and compare it with Inbox/customers-uk.csv.
2. Tell me which values changed between source and output, and which IronXL setting changed them.
3. Fix the conversion and rerun it for that file.
4. Write out/accountno-check.csv with one row per customer.
Give each row of that file these columns:
- source AccountNo
- converted AccountNo
- whether they match
Der Screenshot zeigt drei Konten, die der Import nicht finden konnte: 123, 4567 und 9. Die Quelldatei hat sie als 000123, 004567 und 000009. LoadCSV hat ein convertFieldValues-Argument, das standardmäßig auf true gesetzt ist, und es verwandelt jedes Feld, das wie eine Zahl aussieht, in eine Zahl, wodurch führende Nullen verschwinden. Das Übergeben von convertFieldValues: false behält jedes Feld als den Text, den der Zweig geschrieben hat.
Warum wird ein CSV auf einem anderen Rechner anders geladen?
LoadCSV teilt Spalten über sein listDelimiter-Argument, und wenn dies null ist, fällt IronXL auf den Listen-Trennzeichen der aktuellen Kultur zurück. Auf unserem en-CA-Rechner ist dieses Trennzeichen ein Komma, daher wurde eine Semikolon-Datei aus Lyon als zwei Spalten mit jedem Dezimalkomma getrennt geladen. Unter de-DE teilte der gleiche Aufruf sie korrekt. WorkBook.Load bei einer CSV-Datei verhält sich genauso. Der CSV Leseguide zeigt die explizite Form.
Der Trennzeichen ist das halbe Problem. Mit eingeschalteter Feldumwandlung analysiert IronXL auch Zahlen unter Verwendung der aktuellen Kultur. Auf en-CA las LoadCSV mit einem Semikolon-Argument den Lyon-Preis 4,20 als 420 ohne Fehler, da ein Komma dort ein Tausender-Trennzeichen ist. Unter de-DE las es 4.2.
Prove the text survived conversion for every .csv and .tsv in Inbox/.
1. Rerun --convert so every file goes through the fixed conversion.
2. Compare each source field with the same field in the converted CSV.
3. Write out/text-fidelity.csv with one row per file.
4. Load orders-lyon-2026-09.csv again, first under de-DE and then under en-US.
5. Use a semicolon separator for both loads, and leave convertFieldValues at its default.
6. Add two rows to out/text-fidelity.csv giving the UnitPrice of the first data row under each culture.
Give each per-file row these columns:
- separator
- source columns
- output columns
- fields compared
- fields that differ
- first difference
Welchen Wert schreibt IronXL für eine formatierte Zelle?
Die CSV- und JSON-Writer der Arbeitsmappe schreiben den Text, den jede Zelle anzeigt, derselbe String wie sein FormattedCellValue, sodass das Zahlenformat bestimmt, was das Lager erreicht. Der XML-Writer schreibt den gespeicherten Wert mit seinem Typ. Wir haben dies bei einer von openpyxl geschriebenen XLSX und der Derbys-XLS des Posteingangs gemessen.
| Gespeicherter Wert | Format | CSV, en-CA | CSV, de-DE | XML |
|---|---|---|---|---|
| 1234.5 | #,##0.00 | "1,234.50" | 1.234,50 | 1234.5 |
| 2.345678 | 0.00 | 2.35 | 2,35 | 2.345678 |
| 0.256 | 0% | 26% | 26% | 0.256 |
| 123 | 000000 | 000123 | 000123 | 123 |
| 1 März 2018 | m/d/yy h:mm | 3-1-18 0:00 | 3.1.18 0:00 | 2018-03-01T00:00:00 |
Runden senkt Ziffern und nichts meldet es. Ein Gewicht von 0,004 unter dem 0.00-Format kam als 0,00 heraus. Die Kultur erreicht auch das Ergebnis. Die mitgelieferte XML-Dokumentation besagt, dass der Trennzeichen des CSV-Writers für das Systemstandard auf null gelassen werden sollte, und unter de-DE schrieb dieser Standard Semikolons. Ein Komma als Trennzeichen änderte nur das Trennzeichen. Ein Derby-Preis im allgemeinen Format kam immer noch als "33,84" heraus.
Unter en-CA versteckt der Posteingang das meiste davon, da seine anderen Arbeitsmappen Zahlen im allgemeinen Format und Daten als yyyy-mm-dd behalten. Die Derbys-Datei, die von IronXL geschrieben wurde, ist die Ausnahme. In Codex' eigenem CSV dafür kamen alle 70 Daten wie in der letzten Tabellenzeile heraus, ein zweistelliges Jahr mit dem en-CA-Datums-Trennzeichen, wo en-US "3/1/18 0:00" gibt. Wenn das Lager gespeicherte Werte benötigt, erstellen Sie das CSV aus dem Value jeder Zelle, formatiert mit CultureInfo.InvariantCulture. Das gab 1234.5, 2.345678 und 2026-09-20 unter en-CA, de-DE und fr-FR gleichermaßen.
Warum kann eine defekte Datei ohne Fehler umgewandelt werden?
Wenn WorkBook.Load eine Datei nicht als Arbeitsmappe lesen kann, versucht es erneut als CSV. Diese Rückfallebene erklärt mehrere Ergebnisse im Eingang.
| Eingabedatei | Ladeergebnis | Protokolliere als |
|---|---|---|
| Null-Byte .xlsx | Ein leeren Blatt, keine Ausnahme | Unlesbar, leer |
| Durch Komma getrennter Text, gespeichert als .xlsx | Als CSV geladen, neun Datenzeilen in zwei Spalten | Unlesbar, Inhaltsmismatch |
| HTML-Tabelle, gespeichert als .xls | Warf FileLoadException. Eine Kopie ohne Anführungszeichen wurde als eine Zelle geladen | Unlesbar, Inhaltsmismatch |
| Zufällige Bytes, gespeichert als .xls | Warf FileLoadException, innere AggregateException "Excel-Start fehlgeschlagen, dann schlug der CSV-Fallback ebenfalls fehl" | Unlesbar, unbekanntes Format |
| Erste 40 Prozent eines echten .xlsx | Warf FileLoadException, zitiert unzureichend Speicher, innere SharpZipBaseException "Unerwartetes Ende der Datei" | Unlesbar, abgeschnitten |
Die beiden ersten Reihen sind die gefährlichen, weil ein Umwandler, der nur Ausnahmen handhabt, sie als Erfolge meldet und ein leeres Blatt oder eine umbenannte Textdatei an das Lager sendet.
Add a byte check to InboxConverter.
Expected/README.md defines when a file counts as Unreadable and which reason to record.
- Before IronXL opens a file, compare its leading bytes with its extension.
- On a mismatch, set the status to Unreadable.
- Give it the reason empty, content-mismatch or unknown-format, as the README defines them.
- A file that starts like a valid zip but still fails to load is truncated.
- Keep the exception type for every file that throws.
Leave the encrypted workbooks for the next turn, and add no password handling yet.
Rerun --convert, then compare out/convert-results.csv with Expected/manifest.csv.
List every row whose status or reason disagrees.
Was macht IronXL mit einer passwortgeschützten Arbeitsmappe?
Zwei Arten von Schutz tauchen in einem Eingang auf, und IronXL behandelt sie unterschiedlich.
Eine verschlüsselte Arbeitsmappe wirft ArgumentNullException, wenn sie ohne Passwort geladen wird, und SecurityException bei einem falschen, während ProtectSheet nur die Bearbeitung sperrt. Die im Posteingang geschützten Ziel-Arbeitsmappen laden und werden ohne jegliches Passwort umgewandelt. Der Leitfaden für KI-Coding-Assistenten vergleicht die beiden Arten vollständig, und der Passwortleitfaden weist darauf hin, dass das Dateiformat keine Möglichkeit bietet, auf Schutz zu prüfen, ohne zu versuchen, die Datei zu öffnen.
Handle the two encrypted inbox workbooks.
1. Load each OLE2 .xlsx with its password from config/known-passwords.csv.
2. Give a file with no listed password the status Protected and the reason no-password.
3. Try one wrong password against the payroll file and record the exception type it raises.
4. Rerun --convert and confirm out/convert-results.csv agrees with Expected/manifest.csv on every row.
5. Write out/password-scan.csv with one row per file under out/.
6. Say in each row whether that file contains any known password.
Tell me how many rows of out/password-scan.csv found a password.
Gibt ein DataSet-Rundtrip dasselbe Blatt zurück?
Eine Rundreise gibt nicht standardmäßig dasselbe Blatt zurück. Ein Pipeline, der Blätter von SQL oder Entity Framework über ToDataSet verarbeitet und Arbeitsmappen mit LoadWorkSheetsFromDataSet rekonstruiert, sollte den Weg testen. OpenAI Dokumentiert Codex' eingebauten Worker als auf die Ausführung fokussierten Agenten für Implementierung und Fixes, und der /subagents-Befehl wechselt zu seinem Thread, während er läuft.
Have the worker agent add a --roundtrip mode.
For each Converted file it should:
1. Call ToDataSet.
2. Rebuild a workbook with WorkBook.LoadWorkSheetsFromDataSet.
3. Take the values only from that DataSet and never from the source sheet.
4. Save the rebuilt workbook to out/roundtrip/<name>.xlsx and reload it.
5. Compare every cell's text with the source sheet.
6. Write out/roundtrip-results.csv with one row per sheet.
Give each row these columns:
- rows before
- rows after
- cells compared
- cells that differ
- first difference
Fix the round trip until every sheet reports zero differences, and tell me what each fix was for.
"Drei Dinge änderten die Daten in unserer Kalibrierung über die 28 umgewandelten Blätter.
- Die Kopfzeile verschwindet:
ToDataSetmit einem true-Kopfzeilenargument verwandelt die erste Zeile in Spaltennamen, und der Rekonstruktor schreibt keine Kopfzeile zurück. Jedes Blatt verlor seine Kopfzeile, und 5,267 Zellen unterschieden sich.ToDataSetohne Argument, standardmäßig auf false gesetzt, behält die Kopfzeile als Daten bei und vermeidet den Verlust. - Text, der wie ein Datum aussieht, wird ein Datum: Der Rekonstruktor analysiert String-Werte auf die gleiche Weise wie das Zuweisen von
Cell.Value. Der Text 2026-09-01 kam als DateTime zurück, und das Hamburger-Datum 10.09.2026 (10. September) kam unter en-CA als 9. Oktober zurück. Mit dem gelösten Kopfzeilenproblem unterschieden sich immer noch 364 Zellen in sechs Blättern aus diesem Grund. - Spaltentypen sind alle Objekt: Jede Spalte im exportierten DataSet hatte den Typ System.Object, und ganze Zahlen kamen als Double an. Code, der die Tabelle liest, muss Werte selbst umwandeln.
Die erneute Zuweisung jedes Textwerts über Cell.StringValue, der den Text so speichert wie geschrieben, stoppt die Datumsumwandlung. Der DataSet-Leitfaden zeigt beide Richtungen der Umwandlung.
Wie werden alle Dateien gemeldet, die nicht umgewandelt werden konnten?
Die Ergebnisdatei zeigt, welche Dateien fehlgeschlagen sind, aber die Personen, die den Posteingang reparieren, benötigen auch jedes Grundwort, gruppiert nach Status.
I need a written reason for every file that didn't convert.
1. Have each --convert run rewrite out/convert-log.jsonl with one JSON object per inbox file.
2. Build out/failures.md from that JSONL alone.
3. Give each status other than Converted a heading, its count, and each file with its reason.
4. Check the counts in failures.md against out/convert-results.csv and report any mismatch.
Give each JSON object these fields:
- file
- status
- reason
- exception type
- message
- milliseconds
Wie debuggt man ein unkorrektes Umwandlungsergebnis von Anfang bis Ende?
Nur mit einem Symptom ausgestattet, kann Codex einem Fehler über Quelldateien, Protokolle und Notizen anderer Teams folgen.
Finance says every European total has been about a hundred times too high since 2026-10-01.
The job and its inputs didn't change.
Send the explorer agent to find the cause.
Have the explorer read Jobs/NightlyConvert.cs, Logs/, Ops/hosts.md and Feedback/finance-2026-10-07.md.
In out/nightly-diagnosis.md, do the following:
- show the line of the job that produces the inflated totals
- explain why conv-01 gave the right totals
- propose the smallest fix, with a command that proves it on all three branch files
Don't edit any code in this turn.
Lesen Sie die Diagnose und stimmen Sie dem Kommentar zu, bevor etwas behoben wird. Eine starke Antwort zitiert den LoadCSV-Aufruf, der sich auf die Standard-Feldumwandlung verlässt, verbindet den Sprung mit dem Wechsel von einem Windows-Host im deutschen Format zu einem Container, dessen LANG ist en_US.UTF-8, und schlägt vor, den Feldtext beizubehalten und Preise mit der Kultur zu analysieren, in der die Zweigdateien geschrieben werden. In unserer Kalibrierung produzierte diese Änderung die ERP-Summen unter beiden Kulturen.
Wie wandeln Sie einmalige Codes in wiederverwendbare, getestete Komponenten um?
Wenn die Ergebnisdatei und das Manifest bei jeder Zeile übereinstimmen, komprimieren Sie die Modi in einen einzigen Job, den andere Dienste aufrufen können.
Have the worker agent merge the conversion modes into one ConversionJob.
- Wire it up through Microsoft.Extensions.DependencyInjection.
- Pass it a ConversionOptions record that holds the inbox folder and the output folder.
- The record also holds the passwords file and the formats to write.
- Keep the byte check, the password handling and convertFieldValues: false.
- Clear out/converted/ at the start of each run.
- Stay under 180 lines and add XML doc comments.
Then run it over Inbox/ into out/final-results.csv.
Confirm every row matches Expected/manifest.csv on status, reason, sheet count and data rows.
Eine Umstrukturierung kann die Byte-Prüfung, die Passwortsuche oder die convertFieldValues-Einstellung weglassen und dennoch kompilieren.
Add an xUnit project, SheetConvert.Tests, whose tests run ConversionJob on real inbox files.
They should check that:
- branch-summary-q3.xlsx yields nine output files named after its sheets
- customers-uk.csv keeps 000123
- orders-lyon-2026-09.csv keeps 4,20 and six columns
- the zero-byte and HTML files are Unreadable with the README reasons
- bonus-pool-2026.xlsx is Protected
- a DataSet round trip of pricing-2026.xlsx leaves no differing cell
Finish with dotnet test and save its results as a TRX file under out/.
Quote the pass and fail counts from that file.
Ausgabe-Bytes sind ein schlechtes Testziel, da ein gespeichertes XLSX zwischen Versionen Byte für Byte ändern kann, während alle Werte gleich bleiben.
Behalten Sie zurückkehrende IronXL-Fragen im Repository-Skill, anstatt in ~/.codex/prompts/, das auf OpenAIs benutzerdefinierten Prompten-Seite als veraltet gekennzeichnet ist.
$ironxl Look through the IronXL API reference for methods that write CSV, TSV, JSON or XML.
List every such method on WorkBook and WorkSheet.
For each one, say whether it writes one file per sheet or a single file.
1. Check each answer in a scratch project outside this repository.
2. Call each method on a two-sheet workbook, or on one of its sheets.
3. Copy only the files the calls produced into out/api-probe/ and list them.
4. Name the line in ConversionJob that decides each output file's name.
5. Confirm SheetConvert still builds.
Wie verwenden Sie diese Eingabeaufforderungen in einem anderen Tabellenkalkulationsordner wieder?
Ändern Sie die Pfade, und die Eingabeaufforderungen gelten für jeden anderen Ordner mit Tabellenkalkulationen. Für einen End-to-End-Akzeptanztest, der mit einem leeren Ordner beginnt, siehe den KI-Coding-Assistenten-Leitfaden.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Wir haben eine frühere Formulierung jeder oben genannten Eingabeaufforderung in einer Sitzung an Codex gesendet, in einer Beispiel .NET 9 Konsolen-App. Sein Posteingang enthält 28 Dateien (ein- und mehrblättrige XLSX, drei veraltete XLS-Dateien von zwei verschiedenen Schreibern, Komma-, Semikolon- und Tabulator-getrennte Texte, eine geschützte Arbeitsmappe, zwei verschlüsselte Arbeitsmappen und fünf defekte oder falsch bezeichnete Dateien). Ein Manifest gibt den erwarteten Status, die Blätter und die Datenzeilen jeder einzelnen Datei an, und eine Passwortdatei listet eine der beiden verschlüsselten Arbeitsmappen auf. Nach dem Lauf überprüften wir die unten stehenden Ergebnisse mit unserem eigenen Release-Build, einem Lauf der Test-Suite und einer separaten Umwandlung jeder Eingabedatei.
- Der erste Umwandler markierte 23 Dateien als umgewandelt und 5 als fehlgeschlagen. Der endgültige Job stimmte im Manifest auf allen 28 Zeilen überein, mit 22 Umgewandelt, 1 Geschützt und 5 Unlesbar.
- Nach der Byte-Prüfung und vor jeglicher Passwortbehandlung wurden 21 Dateien umgewandelt und 7 waren unlesbar, und die einzigen 2 Zeilen, die nicht mit dem Manifest übereinstimmten, waren das verschlüsselte Paar.
- Die Texttreue ging von 147 unterschiedlichen Feldern in fünf der neun Textdateien auf 0 in allen 9. Die Kulturuntersuchung las den Lyon-Einheitspreis als 420 unter en-US und 4.2 unter de-DE.
- Nach der Screenshoterlösung kehrten die 9 Kontonummern, die führende Nullen verloren hatten, zurück und 60 von 60 stimmten mit der Quelle überein.
- Im Schnellstart meldeten es 7 von 8 Beispieldateien mit Erfolg und die Zufallsbytes-Datei warf FileLoadException. Die Null-Byte-Newcastle-Datei wurde als Erfolg gezählt, und Lyon hatte zwei Spalten.
- Exitcodes vom Schlüsselwächter waren 0 mit dem gesetzten Schlüssel und 2 ohne. Der Schlüssel erreichte Codex nur durch die Umgebung und erschien nie in einer Datei oder einer Antwort.
- Die Umfrageausgabe hielt 28 Zeilen, markierte 4 Mismatches und ließ 2 Dateien unidentifiziert.
- Die Gehaltsabrechnung wurde mit ihren 25 Datenzeilen umgewandelt, der Bonuspool war die einzige Geschützte Zeile, das verkehrte Passwort erhob SecurityException, und keine der 124 Dateien unter out/hatte ein Passwort.
- Die Rundreise des Worker-Agents, die auch Zahlenformate für typisierte Zellen kopierte, verglich 5.714 Zellen in 28 Blättern mit 0 Unterschieden. Unsere eigene Rundreise fand ebenfalls 0.
- Der Fehlerbericht listete 5 unlesbare Dateien und 1 Geschützte Datei, gleich der Ergebnisdatei.
- Codex benannte Zeile 27 des nächtlichen Jobs und den en-US-Container. Unter de-DE gaben die Zweigdateien die ERP-Summen 25632,85, 11926,93 und 14387,26, und unter en-US 100-mal diese. Wir fügten den Job, seine Protokolle, die Host-Notizen und die Finanz-Notiz direkt vor dieser Aufforderung hinzu. Ein zweiter Explorer konnte nicht unter demselben Namen gestartet werden, also führte Codex die schreibgeschützte Untersuchung in seinem Haupt-Thread aus.
- Der Arbeits-Job der Rundreise schrieb ein 125-Zeilen ConversionJob mit Dependency Injection, und die Tests bestanden 2 von 2, auch auf einem sauberen Klon.
- Prompt 16 hinterließ 40 Dateien in out/api-probe/, und SheetConvert baute immer noch.
- Codex' Sandbox konnte nuget.org nicht erreichen, also wurde für die Wiederherstellung der lokale Paketcache verwendet. Alle 16 Release-Builds waren erfolgreich. Ein erster Volldurchlauf scheiterte. Seine Rundreise kopierte Quelldateien über das rekonstruierte Blatt, seine Byte-Prüfung fügte auch den Passwort-Schritt hinzu, seine Umstrukturierung ließ alte Dateien in out/converted/zurück, und seine API-Untersuchung fügte ein zweites Programm innerhalb des Projekts hinzu, was den Build zerstörte. Aufforderungen 9, 11, 14 und 16 wurden vor dem hier gemeldeten Lauf gestrafft.
Codex' Version, Modell, Timing und Testmaschine für diesen Lauf befinden sich im geteilten Laufprotokoll.
Fehlerbehebung
- C# Lesen von CSV-Dateien, wenn eine Semikolon-Datei in einer oder zwei Spalten landet
- Umwandlung von Tabellenkalkulationsdateiformaten, wenn eine umgewandelte Datei am übergebenen Pfad fehlt
- Setzen eines Passworts für Arbeitsmappen, wenn eine verschlüsselte Arbeitsmappe beim Laden fehlschlägt
- Anwenden eines Lizenzschlüssels in IronXL, wenn jede Zeile in der Ergebnisdatei denselben Lizenzfehler zeigt
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.