Jak korzystać z IronXL z ChatGPT Codex

Curtis Chau
Curtis Chau
Zaktualizowano: 15 października 2026

Wspólny folder skrzynki odbiorczej zbiera wszystko, co przesyłają oddziały. Nowoczesne eksporty XLSX znajdują się obok plików XLS z systemów wycofanych lata temu, plików CSV z przecinkami i średnikami, zrzutów magazynowych oddzielanych tabulatorami, zaszyfrowanego skoroszytu płacowego, eksportu z portalu webowego, który okazuje się być HTML-em, oraz przypadkowych plików o wielkości zero bajtów pozostawionych przez nieudane przesyłanie. Magazyn chce, aby każdy z nich był w formacie CSV, JSON i XML, oraz chce wiedzieć, które pliki nie dotarły.

ChatGPT Codex to agent programowania od OpenAI. Jest dostępny jako program terminalowy, jako rozszerzenia do IDE, w aplikacji desktopowej ChatGPT i jako usługa w chmurze, a każdy z nich może używać tego samego konta ChatGPT. IronXL to biblioteka arkuszy kalkulacyjnych dla .NET od Iron Software.

Każda instrukcja konwersji w tym przewodniku sprawia, że Codex pisze plik wynikowy z jednym wierszem na plik wejściowy, zanim cokolwiek zgłosi, a każda figura konwersji tutaj została policzona z pliku tego rodzaju.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronXL.Excel

Zainstaluj IronXL, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Otworzyć Codex w projekcie konsoli .NET z kilkoma przykładowymi arkuszami kalkulacyjnymi i opisać konwersję.

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

Wzmianka $ironxl ładuje umiejętność IronXL przed tym, jak Codex napisze kod.



Czym jest ChatGPT Codex i jak wpasowuje się w pracę z arkuszami kalkulacyjnymi .NET?

Codex wykonuje zleconą pracę, w ramach nadanych uprawnień. Dla potoku konwersji pisze konwerter, uruchamia go na skrzynce odbiorczej, otwiera wyprodukowane pliki i edytuje kod, gdy są błędne. Zainstalować CLI z npm install -g @openai/codex z repozytorium Codex i zapoznać się ze stronami CLI Codex od OpenAI dla terminala.

Zalecenia bezpieczeństwa OpenAI proszą o takie same ukierunkowane kontrole i przegląd różnic w wynikach Codex, jak w przypadku ludzkiej prośby o ściągnięcie. W tym potoku wymyślony członek psuje kompilację, a zła konwersja pojawia się jako wiersz wyników, który nie odpowiada manifestowi.

Codex może układać konwerter inaczej za każdym razem, ale IronXL musi zwracać te same arkusze i wartości dla danego pliku. WorkBook.Load otwiera pliki XLS, XLSX, XLSM i XLTX, a także CSV i TSV, jak wskazuje przewodnik ładowania.

Jak napisać zapytanie IronXL i skonfigurować dla niego Codex?

Zapytanie o konwersję określa, który folder czytać, jak otwierać każdy typ pliku, gdzie każde wyjście idzie, co zawiera jeden wiersz pliku wyników i co uważać za dowód. Każdy z pozostawionych elementów staje się decyzją, którą agent podejmie za użytkownika.

KomponentSłaby promptSilny prompt
WejścieKonwertuj arkusze kalkulacyjneKażdy plik w Inbox/, XLS, XLSX, CSV i TSV
ŁadowanieNiewyswietloneWorkBook.LoadCSV z separatorem z out/inventory.csv
WynikZapisz je jako CSVCSV, JSON i XML dla każdego arkusza, w jednym folderze na plik wejściowy pod out/converted/
BłędyNiewyswietloneKażdy plik, który generuje błąd, dostaje wiersz wyników z typem wyjątku
DowódSprawdź, czy działałoKażdy wiersz out/convert-results.csv zgadza się z Expected/manifest.csv
OgraniczeniaNoneBrak zmian w Inbox/. Żadne hasło nie pojawiło się w żadnym wyjściu.

Badania OpenAI nad halucynacjami stwierdzają, że trening i ocena nagradzają zgadywanie, a w pracy konwersyjnej zgadywanie może się pojawić jako suma w zamykającym podsumowaniu.

Codex szuka umiejętności w folderach .agents/skills od katalogu roboczego do głównego katalogu repozytorium. Umiejętność to folder, którego SKILL.md zaczyna się od nazwy i opisu. IronXL publikuje swoje skill.md pod nazwą ironxl, więc zapisanie go jako .agents/skills/ironxl/SKILL.md sprawia, że $ironxl działa poprawnie. Bez wzmianki Codex nadal może wybrać umiejętność samodzielnie, jeśli zadanie pasuje do opisu umiejętności, a opis IronXL wymienia konwersje między XLSX, XLS, CSV, TSV, JSON i XML.

AGENTS.md zawiera obowiązujące zasady. Codex zbiera te pliki, zaczynając od głównego katalogu repozytorium i schodząc do folderu, w którym rozpoczęła się sesja, a gdy dwa pliki stanowią konflikt, priorytet ma ten bliżej tego folderu.

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

Oczekuj jednej nowej sekcji w AGENTS.md i odpowiedzi bez liczb, ponieważ ta rotacja niczego nie przekształca.

Jak poprosić Codex o dodanie IronXL i konwersję pierwszego folderu?

Sprawdzić pakiet przed wszystkim innym.

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

IronXL.Excel 2026.10.1 zależy bezpośrednio od IronSoftware.Common 2026.4.2 i IronSoftware.System.Drawing 2026.8.2. Na .NET 9 lista tranzytywna zawierała 30 pakietów oprócz samego IronXL.Excel, żaden z nich nie był związany z Office czy Interop, a każda DLL w wyjściu kompilacji, w tym katalogi platformowe w ramach runtimes, była zarządzanym zestawem. Zachowaj wersję, którą zgłasza Codex, dla późniejszych zapytań, i zapoznaj się z changelogiem IronXL przy wyborze wydania.

Bez klucza każde ładowanie IronXL generuje błąd. W skrzynce odbiorczej z 28 plikami oznaczałoby to 28 kopii tego samego błędu, więc poniższa kontrola wyjmuje przed dotknięciem jakiegokolwiek pliku.

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

Strona kluczy licencyjnych obejmuje klucze próbne i pliki konfiguracyjne, które IronXL również czyta.

Przed istnieniem konwertera dowiedz się, co zawiera folder. OpenAI dokumentuje wbudowanego eksploratora Codex jako agenta skoncentrowanego na odczycie do eksploracji bazy kodu, co pasuje do przeglądów bez edycji.

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

XLSX to archiwum zip, które zaczyna się od PK, a XLS to plik złożony OLE2, który zaczyna się od D0 CF 11 E0. Przegląd oznacza plik tekstowy oddzielony przecinkami o nazwie .xlsx i eksport portalu posiadający HTMLowy stolik w pliku .xls, a nie może zidentyfikować pliku zero-bajtowego z Newcastle ani pliku losowych bajtów na podstawie ich początkowych bajtów. Zaznacza także dwa zaszyfrowane skoroszyty, ponieważ zaszyfrowany XLSX to kontener OLE2 z tą samą sygnaturą jak dziedziczny XLS.

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

Cztery jego wiersze mają na tym etapie niewłaściwy status. Plik zero-bajtowy i plik tekstowy o nazwie .xlsx uznawane są za skonwertowane, a dwa zaszyfrowane skoroszyty jako niepowodzenia, plik płacowy z znanym hasłem i plik puli premii, który należy do Ochrony. Późniejsze zapytania naprawiają wszystkie cztery.

Gdzie IronXL zapisuje każdy arkusz?

Zapis skoroszytu nie zapisuje do podanej ścieżki. Wywołane na skoroszycie, którego jedynym arkuszem jest Orders, SaveAsCsv z ścieżką out/x/orders.csv zapisuje orders.Orders.csv, nazwę pliku z nazwą arkusza, i nigdy nie tworzy orders.csv. Przewodnik konwersji dokumentuje jeden plik na arkusz dla CSV, TSV, JSON i XML, a szczegóły, od których zależy potok, zmierzono w wersji 2026.10.1.

  • Pojedynczy arkusz wciąż dostaje końcówkę: Skoroszyt załadowany z CSV lub TSV ma jeden arkusz nazywany Sheet0, więc customers-uk.csv staje się customers-uk.Sheet0.csv.
  • Nazwy arkuszy przechodzą bez zmian: Arkusz podsumowania skrzynki odbiorczej daje nazwę pliku z miejscem, a nazwa arkusza francuskiego zachowuje swoje akcentowane litery, więc skrypty poniżej muszą dołączać cudzysłowia do ścieżek.
  • Wskaźniki arkuszy zachowują się inaczej: Zwykły zapis skoroszytu z nazwą CSV, TSV, JSON lub XML również dzieli się na arkusze, podczas gdy WorkSheet.SaveAsCsv i inne wskaźniki arkuszy produkują dokładnie daną ścieżkę.
  • Każdy format ma swoją własną formę: CSV zaczyna się od znacznika porządku bajtów UTF-8, JSON to tablica wierszy z każdą wartością jako ciągiem, a XML daje każdej komórce element ColumnN z xsi:type taką jak xs:double. Nazwy arkuszy, które nie są ważnymi nazwami XML-owymi, są kodowane, więc Podsumowanie Q3 staje się elementem Q3_x0020_Summary.

Ponieważ CSV może zawierać ujęte w odniesienie końce linii i kończy się pustą linią, zliczanie jego linii daje błędną liczbę wierszy. Zliczać wiersze danych z samego arkusza tak, jak to robi plik wyników, i wylistować ścieżki wyjściowe, które zapisał IronXL.

Dlaczego skonwertowany CSV traci swoje wiodące zera?

Zespół, który importuje skonwertowane dane może zgłaszać problem w formie zdjęcia. Codex akceptuje obrazy, gdy sesja zaczyna się od codex --image, a CLI także pozwala na wklejanie obrazu do kompozytora.

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
Text

Zrzut ekranu pokazuje trzy konta, których import nie mógł odnaleźć, 123, 4567 i 9. Plik źródłowy ma je jako 000123, 004567 i 000009. LoadCSV ma argument convertFieldValues, który domyślnie jest równy true i zamienia każde pole, które wygląda jak liczba, w liczbę, co usuwa wiodące zera. Przekazanie convertFieldValues: false zachowuje każde pole jako tekst napisany przez gałąź.

Dlaczego ładowanie CSV różni się na innym komputerze?

LoadCSV dzieli kolumny na jego listDelimiter argument i gdy jest to null, IronXL wraca do separatora listy aktualnej kultury. Na naszym komputerze en-CA tym separatorem jest przecinek, więc plik średnikowy z Lyonu został załadowany jako dwie kolumny wycięte na każdym przecinku dziesiętnym. Pod de-DE to samo wywołanie podzieliło go poprawnie. WorkBook.Load na pliku CSV zachowuje się w ten sam sposób. Przewodnik czytania CSV pokazuje explicytną formę.

Separator to połowa problemu. Przy konwersji pól włączonej, IronXL analizuje liczby również wykorzystując aktualną kulturę. Na en-CA, LoadCSV z separatorem średnikowym odczytał cenę 4,20 z Lyonu jako 420, bez błędu, ponieważ przecinek tam to separator tysięcy. Pod de-DE odczytał ją jako 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
Text

Jaką wartość zapisuje IronXL dla sformatowanej komórki?

Pisarki CSV i JSON skoroszytu zapisują tekst, jaki wyświetla każda komórka, ten sam ciąg co jego FormattedCellValue, więc format liczby decyduje, co dociera do magazynu. Pisarz XML zapisuje przechowywaną wartość z jej typem. Zmierzaliśmy to na pliku XLSX napisanym przez openpyxl i na pliku Derby XLS ze skrzynki odbiorczej.

Przechowywana wartośćFormatCSV, en-CACSV, de-DEXML
1234.5#,##0.00"1,234.50"1.234,501234.5
2.3456780.002.352,352.345678
0.2560%26%26%0.256
123000000000123000123123
1 marca 2018m/d/yy h:mm3-1-18 0:003.1.18 0:002018-03-01T00:00:00

Zaokrąglenie usuwa cyfry i nic tego nie raportuje. Waga 0,004 w formacie 0.00 pojawiła się jako 0,00. Kultura także sięga do wyjścia. Wysłana dokumentacja XML mówi, aby pozostawić separator pisarki CSV jako null dla systemowego domyślnego, a pod de-DE to domyślne pisało średnikami. Podanie przecinka jako separatora zmieniło tylko separator. Cena Derby w formacie ogólnym nadal pojawiła się jako "33,84".

Pod en-CA skrzynka odbiorcza ukrywa większość z tego, ponieważ jej inne skoroszyty utrzymują liczby w formacie ogólnym i daty jako yyyy-mm-dd. Plik Derby napisany przez IronXL jest wyjątkiem. W własnym CSV Codex dla niego wszystkie 70 dat pojawiło się jak ostatni wiersz tabeli, dwucyfrowy rok z separatorem daty en-CA, gdzie en-US daje 3/1/18 0:00. Gdy magazyn potrzebuje przechowywanych wartości, należy zbudować CSV z każdego Value, sformatowanego z CultureInfo.InvariantCulture. To dało 1234,5, 2,345678 i 2026-09-20 pod en-CA, de-DE i fr-FR.

Dlaczego uszkodzony plik może się przekształcić bez błędu?

Gdy WorkBook.Load nie może odczytać pliku jako skoroszytu, próbuje ponownie jako CSV. To przełączenie tłumaczy kilka wyników w skrzynce wejściowej.

Plik skrzynki odbiorczejWynik ładowaniaZarejestruj jako
Plik zero-bajtowy .xlsxJeden pusty arkusz, brak wyjątkuNieczytelny, pusty
Tekst separatorem przecinkowym zapisano jako .xlsxZaładowano jako CSV, dziewięć wierszy danych w dwóch kolumnachNieczytelny, zła treść
Tabela HTML zapisana jako .xlsRzucił FileLoadException. Kopia bez znaków cytowania załadowana jako jedna komórkaNieczytelny, zła treść
Bajty losowe zapisane jako .xlsRzucił FileLoadException, wewnętrzne AggregateException "Załadowanie Excela nie powiodło się, a potem także wpadka CSV"Nieczytelny, nieznany format
Pierwsze 40 procent prawdziwego .xlsxRzucił FileLoadException, brak wystarczającej pamięci, wewnętrzne SharpZipBaseException "Nieoczekiwany koniec pliku"Nieczytelny, ucięty

Pierwsze dwa wiersze są niebezpieczne, ponieważ konwerter, który wyłapuje tylko wyjątki, raportuje je jako sukcesy i wysyła pusty arkusz lub przekształcony plik tekstowy do magazynu.

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

Co IronXL robi z chronionym hasłem skoroszytem?

Dwa rodzaje ochrony pojawiają się w skrzynce odbiorczej i IronXL traktuje je różnie.

Zaszyfrowany skoroszyt rzuca ArgumentNullException po załadowaniu bez hasła i SecurityException przy błędnym, podczas gdy ProtectSheet zamyka tylko edycję. Człowiek w ochronie skrzynka odbiorcza arkuszy załadowana i przekształcona bez żadnego hasła. Przewodnik dla asystentów kodowania AI porównuje dwa rodzaje w pełni, a przewodnik po hasłach zauważa, że format pliku nie oferuje.testowania ochrony bez próby otwarcia.

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

Czy DataSet round trip daje z powrotem ten sam arkusz?

Round trip nie daje z powrotem tego samego arkusza domyślnie. Potok, który przekazuje arkusze do SQL lub Entity Framework poprzez ToDataSet odbudowuje skoroszyty z LoadWorkSheetsFromDataSet powinien przetestować podróż. OpenAI dokumentuje wbudowanego pracownika Codex jako agenta skoncentrowanego na wykonaniu dla implementacji i poprawek, a /subagents przełącza na jego wątek, podczas gdy działa.

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

Trzy rzeczy zmieniły dane w naszej kalibracji na 28 przekształconych arkuszach.

  • Wiersz nagłówkowy znika: ToDataSet z prawdziwym argumentem nagłówka zamienia pierwszy wiersz w nazwy kolumn, a odbudowa nie zapisuje wiersza nagłówkowego z powrotem. Każdy arkusz stracił wiersz nagłówkowy, a 5 267 komórek różniło się. ToDataSet bez argumentu domyślnie jest fałszem, pozostawia nagłówek jako dane i unika straty.
  • Tekst, który wygląda jak data, staje się datą: Odbudowa analizuje wartości znakowe w ten sam sposób, jak przypisanie Cell.Value działa. Tekst 2026-09-01 wrócił jako DateTime, a data Hamburg 10.09.2026 (10 września) wróciła jako 9 października pod en-CA. Z naprawionym problemem nagłówka 364 komórki w sześciu arkuszach nadal różniły się z tego powodu.
  • Typy kolumn to wszystkie obiekty: Każda kolumna w wyeksportowanym DataSet miała typ System.Object, a liczby całkowite pojawiły się jako Double. Kod odczytujący tabelę musi przekształcić wartości samodzielnie.

Przypisanie każdej wartości tekstowej poprzez Cell.StringValue, który przechowuje tekst zgodnie z napisanym, zatrzymuje konwersję dat. Przewodnik DataSet pokazuje oba kierunki konwersji.

Jak zgłosić każdy plik, który nie powiódł się w konwersji?

Plik wyników pokazuje, które pliki nie powiodły się, ale ludzie, którzy naprawiają skrzynkę wejściową, również potrzebują przyczyny w słowach, pogrupowane według statusu.

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
Text

Jak debugować niepoprawne wyjście konwersji od końca do końca?

Przekazywany niczym innym niż symptomem Codex może prześledzić błąd przez pliki źródłowe, logi i notatki z innych zespołów.

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

Przeczytaj diagnozę i zgodnie z nią zanim cokolwiek zostanie naprawione. Silna odpowiedź cytuje wywołanie LoadCSV, które polega na domyślnej konwersji pól, łączy skok z przeniesieniem z hosta Windows o niemieckim formacie do kontenera, którego LANG to en_US.UTF-8, i proponuje zachowanie tekstu pola i interpretację cen wg kultury, w której oddziały są napisane. W naszej kalibracji ta zmiana wyprodukowała ERP suma pod obiema kulturami.

Jak zmienić jedno-znaczne kody na komponenty do wielokrotnego wykorzystania i testowania?

Gdy plik wyników i manifest zgadzają się na każdym wierszu, zewrzyj tryby w pojedyncze zadanie, które inne usługi mogą wywołać.

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

Refaktoryzacja może usunąć sprawdzenie bajtów, wyszukiwanie haseł lub convertFieldValues, a mimo to kompilować się.

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

Wyjściowe bajty są nieszczególnie testowalnym celem, ponieważ zapisany XLSX może zmieniać się bajtem przy bajcie między wydaniami, podczas gdy każda wartość pozostaje taka sama.

Przechowuj powtarzające się pytania IronXL w umiejętności repozytorium, zamiast w ~/.codex/prompts/, który OpenAI'owska strona custom prompts oznacza jako przestarzałe.

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

Jak ponownie wykorzystać te zapytania w innym folderze z arkuszami kalkulacyjnymi?

Zmienić ścieżki, a zapytania zastosują się do innego folderu z arkuszami kalkulacyjnymi. Dla jednego testu akceptacyjnego od początku do końca, zaczynając od pustego folderu, zobaczyć przewodnik asystentów kodowania AI.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Ty mnie wziął wcześniejsze sformułowanie każdego z powyższych zapytań do Codex po kolei, w jednej sesji, przeciwko przykładowej aplikacji konsoli .NET 9. Jego skrzynka odbiorcza zawiera 28 plików (pojedynczych i wieloarkuszowych XLSX, trzy pliki XLS z dwóch różnych autorów, tekst oddzielany przecinkami, średnikami i tabulatorami, chroniony hasłem skoroszyt, dwa zaszyfrowane skoroszyty i pięć uszkodzonych lub źle oznakowanych plików). Manifest daje oczekiwany status, arkusze i wiersze danych każdego z nich, a plik haseł zawiera jedno z dwóch zaszyfrowanych skörbin. Po uruchomieniu sprawdziliśmy poniższe wyniki z naszym własnym budowaniem wersji Release, uruchomieniem zestawu testowego i oddzielną konwersją każdego pliku w skrzynce wejściowej.

  • Pierwszy konwerter oznaczył 23 pliki jako skonwertowane i 5 jako niepowodzenia. Ostateczne zadanie pasowało do manifestu na wszystkich 28 wierszach, z 22 Skonwertowanymi, 1 Zabezpieczonym i 5 Nieczytelnymi.
  • Po sprawdzeniu bajtów, a przed jakimkolwiek handlem haseł, 21 plików zostało skonwertowanych i 7 było Nieczytelnych, a jedyne 2 wiersze, które nie zgadzały się z manifestem to zaszyfrowana para.
  • Wierność tekstowa poszła od 147 różniących pól w pięciu z dziewięciu plików tekstowych do 0 we wszystkich 9. Sonda kulturowa odczytała Lyon'owy UnitPrice jako 420 pod en-US i 4.2 pod de-DE.
  • Po poprawce zrzutu ekranu, 9 numerów kont, które straciły wiodące zera powróciło, a 60 z 60 pasowało do źródła.
  • W szybkim rozpoczęciu, 7 z 8 przykładów plików zgłosiło sukces, a plik zmiennych bajtów rzucił FileLoadException. Plik zero-bajtowy Newcastle był liczony jako sukces, a Lyon miał dwie kolumny.
  • Kody wyjścia z ochrony klucza były 0 przy ustawionym kluczu i 2 przy niezestawionym. Klucz dotarł do Codex tylko przez środowisko i nigdy nie pojawił się w pliku lub odpowiedzi.
  • Wyjście ankiety miało 28 wierszy, oznaczyło 4 niezgodności i pozostawiło 2 pliki niezidentyfikowane.
  • Przemiany płacowej z 25 wierszami danymi, jedynym Zabezpieczonym wierszem była pula premii, złe hasło podniosło SecurityException, a żadni z 124 plików w ramach out/nie miały hasła.
  • Wyciąg z podróży roboczego agenta, który także kopiował formaty liczb dla komórek typowanych, porównał 5 714 komórek w 28 arkuszach z 0 różnic. Nasz własny round trip także znalazł 0.
  • Raport porażki wymienił 5 Nieczytelnych plików i 1 Zabezpieczony plik, tyle samo co plik wyników.
  • Codex nazwał linię 27 wstawionej pracy nocnej i kontener en-US. Pod de-DE pliki oddziału dały ERP suma 25632,85, 11926,93 i 14387,26, a pod en-US 100 razy te. Dodano zadanie, jego logi, notatki z hosta i notatkę finansową tuż przed tym zapytaniem. Drugi eksplorator nie mógł wystartować pod tą samą nazwą, więc Codex przeprowadził czytelną inspekcję na głównym wątku.
  • Pracownik z rundy napisał 125-liniowy ConversionJob z wstrzykiwaniem zależności, a testy przeszły 2 na 2, także na czystej klonie.
  • Zapytanie 16 pozostawiło 40 plików w out/api-probe/, a SheetConvert nadal się budowało.
  • Piaskownica Codex nie mogła osiągnąć nuget.org, więc odtworzenie użyło pamięci podręcznej lokalnego pakietu. Wszystkie 16 wersji Release zakończyły się powodzeniem. Pierwsze pełne uruchomienie nie powiodło się. Jego round trip kopiował komórki źródłowe nad odbudowanym arkuszem, jego kontrola bajtów również dodawała krok hasła, jego refaktoryzacja pozostawiła nieświeże pliki w out/converted/, a jego sonda API umieściła drugi program wewnątrz projektu, co zepsuło budowę. Zapytania 9, 11, 14 i 16 były zacieśnione przed raportowanym uruchomieniem.

Wersja Codex, model, timing i maszyna testowa dla tego uruchomienia są w wspólnym zapisie uruchomienia.


Rozwiązywanie problemów


Pytania?

Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 2,393,101Wersja:2026.11właśnie wydane