Como usar IronXL com ChatGPT Codex
Uma pasta de entrada compartilhada coleta tudo o que as filiais enviam. Exportações modernas em XLSX vão ao lado de arquivos XLS de sistemas aposentados há anos, arquivos CSV separados por vírgula e ponto e vírgula, despejos de armazém separados por tabulação, uma planilha de salários criptografada, uma exportação de portal web que se revela ser em HTML, e um arquivo de zero bytes ocasional deixado por um upload falho. O armazém quer cada um deles como CSV, JSON e XML, e quer saber quais arquivos não foram incluídos.
ChatGPT Codex é a agente de codificação da OpenAI. Ele é distribuído como um programa de terminal, como extensões de IDE, dentro do aplicativo de área de trabalho ChatGPT e como um serviço em nuvem, e cada um deles pode entrar com a mesma conta do ChatGPT. IronXL é a biblioteca de planilhas da Iron Software para .NET.
Cada solicitação de conversão neste guia faz com que o Codex escreva um arquivo de resultados com uma linha por arquivo de entrada antes de relatar qualquer coisa, e cada figura de conversão aqui foi contada de um arquivo desse tipo.
Início RápidoAbra o Codex em um projeto de console .NET com algumas planilhas de exemplo, e descreva a conversão.
$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.
A menção $ironxl carrega a habilidade do IronXL antes que o Codex escreva o código.
Fluxo de trabalho mínimo (5 etapas)
- Adicione o pacote NuGet IronXL.Excel ao projeto
- Salve a habilidade do IronXL como
.agents/skills/ironxl/SKILL.mdpara que a menção$ironxlseja resolvida - Confirme um
AGENTS.mdque faz do IronXL a única biblioteca de planilhas e mantém chaves e senhas fora de cada saída - Verifique os bytes iniciais de cada arquivo, separador e senha antes do IronXL abri-lo, e registre um status para cada entrada
- Mescle os modos em um trabalho testado e procure cada membro que chama na referência de API do IronXL
O que é ChatGPT Codex, e como ele se encaixa no trabalho com planilhas .NET?
Codex realiza o trabalho que lhe é dado, dentro das permissões que você concede. Para um pipeline de conversão, ele escreve o conversor, executa-o sobre a caixa de entrada, abre os arquivos que produziu, e edita o código quando estão errados. Instale o CLI com npm install -g @openai/codex do repositório Codex, e veja as páginas CLI do Codex da OpenAI para o terminal.
A orientação de segurança da OpenAI pede as mesmas verificações direcionadas e revisão de diferenças na saída do Codex que uma solicitação de pull humano receberia. Neste pipeline, um membro inventado quebra a compilação, e uma má conversão aparece como uma linha de resultados que não coincide com o manifesto.
Codex pode dispor o conversor de maneira diferente a cada vez, mas o IronXL tem que retornar as mesmas planilhas e valores para um determinado arquivo. WorkBook.Load abre arquivos XLS, XLSX, XLSM e XLTX, bem como CSV e TSV, conforme a guia de carregamento lista.
Como você escreve uma solicitação do IronXL e configura o Codex para isso?
Uma solicitação de conversão afirma qual pasta ler, como cada tipo de arquivo é aberto, onde cada saída vai, o que uma linha do arquivo de resultados contém, e o que é considerado prova. Qualquer uma das deixadas de fora torna-se uma decisão que o agente toma por você.
| Componente | Prompt fraco | Prompt forte |
|---|---|---|
| Entrada | Converter as planilhas | Todo arquivo em Inbox/, XLS, XLSX, CSV e TSV |
| Carregamento | Não declarado | WorkBook.LoadCSV com o separador de out/inventory.csv |
| Saída | Salve-os como CSV | CSV, JSON e XML por planilha, em uma pasta por arquivo de entrada sob out/converted/ |
| Erros | Não declarado | Qualquer arquivo que lançar cria uma linha de resultados com seu tipo de exceção |
| Prova | Verifique se funcionou | Cada linha de out/convert-results.csv concorda com Expected/manifest.csv |
| Restrições | None | Deixe Inbox/ intocado. Nenhuma senha em qualquer saída. |
As pesquisas da OpenAI sobre alucinação descobrem que treinamento e avaliação recompensam palpites, e em um trabalho de conversão um palpite pode surgir como um total no resumo final.
Codex procura por habilidades em pastas .agents/skills do diretório de trabalho até a raiz do repositório. Uma habilidade é uma pasta cujo SKILL.md começa com um nome e uma descrição. IronXL publica seu skill.md com o nome ironxl, então salvá-lo como .agents/skills/ironxl/SKILL.md faz $ironxl resolver. Sem a menção, Codex ainda pode escolher a habilidade por conta própria se a tarefa se adequar à descrição da habilidade, e a descrição do IronXL lista conversões entre XLSX, XLS, CSV, TSV, JSON e XML.
AGENTS.md contém as regras permanentes. Codex coleta esses arquivos começando na raiz do repositório e descendo até a pasta onde a sessão começou, e onde dois arquivos entram em conflito, o mais próximo dessa pasta tem precedência.
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.
Espere uma nova seção em AGENTS.md e uma resposta sem números, já que esta rodada não converte nada.
Como você pede ao Codex para adicionar o IronXL e converter uma primeira pasta?
Verifique o pacote antes de qualquer outra coisa.
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 depende diretamente de IronSoftware.Common 2026.4.2 e IronSoftware.System.Drawing 2026.8.2. No .NET 9, a lista transitiva continha 30 pacotes além de IronXL.Excel em si, nenhum deles Office ou Interop, e cada DLL na saída da compilação, incluindo as pastas da plataforma sob runtimes, era um assembly gerenciado. Mantenha a versão que o Codex relata para uso em solicitações futuras, e veja o registro de alterações do IronXL ao escolher uma versão.
Sem uma chave, toda carga do IronXL lança. Em uma caixa de entrada com 28 arquivos, isso significaria 28 cópias da mesma falha, então o guardião abaixo sai antes que qualquer arquivo seja tocado.
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.
A página de chaves de licença cobre chaves de teste e os arquivos de configuração que o IronXL também lê.
Antes que o conversor exista, descubra o que a pasta contém. A OpenAI documenta o explorador integrado do Codex como um agente com ênfase em leitura para exploração da base de código, o que se adequa a uma pesquisa sem edições.
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.
Um XLSX é um arquivo zip que começa com PK, e um XLS é um arquivo composto OLE2 que começa com D0 CF 11 E0. A pesquisa sinaliza um arquivo de texto separado por vírgulas chamado .xlsx e uma exportação de portal cujo .xls contém uma tabela HTML, e não pode identificar o arquivo de Newcastle de zero bytes ou um arquivo de bytes aleatórios por seus bytes iniciais. Ele também sinaliza os dois livros de trabalho criptografados, porque um XLSX criptografado é um contêiner OLE2 com a mesma assinatura de um XLS legado.
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.
Quatro de suas linhas estão com o status errado neste estágio. O arquivo de zero bytes e o arquivo de texto chamado .xlsx são considerados convertidos, e os dois livros de trabalho criptografados são considerados falhas, o arquivo de folha de pagamento cuja senha é conhecida e um arquivo de pool de bônus que pertence a Protegido. Os comandos posteriores corrigem todos os quatro.
Onde o IronXL grava cada planilha?
Um salvamento de livro de trabalho não grava no caminho passado. Chamado em um livro de trabalho cuja única planilha é Orders, SaveAsCsv com o caminho out/x/orders.csv grava orders.Orders.csv, o nome do arquivo seguido pelo nome da planilha, e nunca cria orders.csv. O guia de conversão documenta um arquivo por planilha para CSV, TSV, JSON e XML, e medimos os detalhes dos quais um pipeline depende com 2026.10.1.
- Uma única planilha ainda recebe um sufixo: Um livro de trabalho carregado de CSV ou TSV tem uma planilha chamada
Sheet0, portanto, customers-uk.csv se torna customers-uk.Sheet0.csv. - Os nomes das planilhas passam sem alterações: A planilha Resumo Q3 da caixa de entrada dá um nome de arquivo com espaço, e um nome de planilha francês mantém suas letras acentuadas, então scripts a jusante devem citar caminhos.
- Os escritores de planilhas se comportam de maneira diferente: Um salvamento simples de livro de trabalho com um nome de CSV, TSV, JSON ou XML também se divide por planilha, enquanto
WorkSheet.SaveAsCsve os outros escritores de planilhas produzem exatamente o caminho que lhes é dado. - Cada formato tem sua própria forma: O CSV começa com uma marca de ordem de bytes UTF-8, JSON é um array de linhas com cada valor como uma string, e XML dá a cada célula um elemento ColumnN com um
xsi:type, comoxs:double. Os nomes das planilhas que não são nomes XML válidos são escapados, para que o Resumo Q3 se torne o elementoQ3_x0020_Summary.
Como o CSV pode conter quebras de linha citadas e termina com uma linha vazia, contar suas linhas resulta em uma contagem de linhas errada. Conte as linhas de dados da própria planilha, como o arquivo de resultados faz, e liste os caminhos de saída que o IronXL escreveu.
Por que um CSV convertido perde seus zeros à esquerda?
A equipe que importa os dados convertidos pode relatar um problema como uma imagem. Codex aceita imagens quando uma sessão começa com codex --image, e o CLI também permite que você cole uma no compositor.
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
A captura de tela mostra três contas que a importação não conseguiu encontrar, 123, 4567 e 9. O arquivo original as tem como 000123, 004567 e 000009. LoadCSV tem um argumento convertFieldValues que por padrão é verdade, e transforma qualquer campo que parece um número em um número, o que elimina zeros à esquerda. Passar convertFieldValues: false mantém cada campo como o texto que o ramo escreveu.
Por que um arquivo CSV carrega de forma diferente em outra máquina?
LoadCSV divide colunas em seu argumento listDelimiter, e quando este é nulo, o IronXL recorre ao separador de lista da cultura atual. Na nossa máquina en-CA, esse separador é uma vírgula, então um arquivo de ponto e vírgula de Lyon carregou como duas colunas cortadas em cada vírgula decimal. Sob de-DE, a mesma chamada dividiu-o corretamente. WorkBook.Load em um arquivo CSV se comporta da mesma forma. O guia de leitura CSV mostra a forma explícita.
O separador é metade do problema. Com a conversão de campos ativada, o IronXL também analisa números usando a cultura atual. Em en-CA, LoadCSV com um delimitador de ponto e vírgula leu o preço de Lyon 4,20 como 420, sem erro, porque uma vírgula ali é um separador de milhares. Sob de-DE, leu 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
Qual valor o IronXL grava para uma célula formatada?
Os escritores de CSV e JSON do livro de trabalho gravam o texto que cada célula exibe, a mesma string que seu FormattedCellValue, então o formato do número decide o que chega ao armazém. O escritor XML grava o valor armazenado com seu tipo. Medimos isso em um XLSX escrito por openpyxl e no XLS de Derby da caixa de entrada.
| Valor armazenado | Formato | 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 de março de 2018 | m/d/yy h:mm | 3-1-18 0:00 | 3.1.18 0:00 | 2018-03-01T00:00:00 |
Arrendondamento elimina dígitos e nada relata isso. Um peso de 0.004 sob o formato 0.00 saiu como 0.00. A cultura também chega à saída. A documentação XML fornecida diz para deixar o delimitador do escritor CSV nulo para o padrão do sistema, e sob de-DE, esse padrão escreveu pontos e vírgulas. Passar uma vírgula como delimitador mudou apenas o separador. Um preço de Derby no formato Geral ainda saiu como "33,84".
Sob en-CA, a caixa de entrada esconde a maioria disso, porque seus outros livros de trabalho mantêm números no formato Geral e datas como yyyy-mm-dd. O arquivo de Derby, escrito por IronXL, é a exceção. No próprio CSV do Codex, todos os 70 datas saíram como na última linha da tabela, um ano de dois dígitos com o separador de data en-CA, onde en-US dá 3/1/18 0:00. Quando o armazém precisa de valores armazenados, construa o CSV a partir de cada Value formatado com CultureInfo.InvariantCulture. Isso deu 1234.5, 2.345678 e 2026-09-20 sob en-CA, de-DE e fr-FR igualmente.
Por que um arquivo corrompido pode ser convertido sem erro?
Quando WorkBook.Load não consegue ler um arquivo como um livro de trabalho, ele tenta novamente como CSV. Esse recurso explica vários resultados na caixa de entrada.
| Arquivo de entrada | Resultado do carregamento | Registre como |
|---|---|---|
| .xlsx de zero bytes | Uma planilha vazia, sem exceção | Ilegível, vazio |
| Texto separado por vírgulas salvo como .xlsx | Carregado como CSV, nove linhas de dados em duas colunas | Ilegível, incompatibilidade de conteúdo |
| Tabela HTML salva como .xls | Lançou FileLoadException. Uma cópia sem caracteres de citação foi carregada como uma célula | Ilegível, incompatibilidade de conteúdo |
| Bytes aleatórios salvos como .xls | Lançou FileLoadException, exceção interna AggregateException "Falha no carregamento do Excel, então fallback CSV também falhou" | Ilegível, formato desconhecido |
| Primeiros 40 por cento de um verdadeiro .xlsx | Lançou FileLoadException citando memória insuficiente, exceção interna SharpZipBaseException "EOF inesperado" | Ilegível, truncado |
As duas primeiras linhas são as perigosas, porque um conversor que apenas captura exceções as relata como sucessos e envia uma planilha vazia ou um arquivo de texto renomeado para o armazém.
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.
O que o IronXL faz com um livro de trabalho protegido por senha?
Dois tipos de proteção surgem em uma caixa de entrada, e o IronXL os trata de maneira diferente.
Um livro de trabalho criptografado lança ArgumentNullException quando carregado sem senha e SecurityException com uma senha errada, enquanto ProtectSheet apenas bloqueia a edição. Os alvos protegidos por planilha da caixa de entrada carregaram e foram convertidos sem senha alguma. O guia de assistentes de codificação de IA compara os dois tipos na íntegra, e o guia de senhas observa que o formato do arquivo não oferece uma maneira de testar a proteção sem tentar abrir o arquivo.
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.
Uma viagem de ida e volta de DataSet devolve a mesma planilha?
Uma viagem de ida e volta não devolve a mesma planilha por padrão. Um pipeline que entrega planilhas a SQL ou Entity Framework através de ToDataSet e reconstrói livros de trabalho com LoadWorkSheetsFromDataSet deve testar a viagem. A OpenAI documenta o trabalhador integrado do Codex como um agente focado em execução para implementação e correções, e o comando /subagents muda para a sua thread enquanto ele executa.
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.
Três coisas mudaram os dados em nossa calibração nas 28 planilhas convertidas.
- A linha de cabeçalho desaparece:
ToDataSetcom um argumento de cabeçalho verdadeiro transforma a primeira linha em nomes de colunas, e a reconstrução não escreve de volta uma linha de cabeçalho. Cada planilha perdeu sua linha de cabeçalho, e 5.267 células diferiram.ToDataSetsem argumento, por padrão, é falso, mantém o cabeçalho como dados e evita a perda. - Texto que parece uma data se torna uma data: A reconstrução analisa valores de string da mesma maneira que atribuir
Cell.Valuefaz. O texto 2026-09-01 voltou como um DateTime, e a data de Hamburgo 10.09.2026 (10 de setembro) voltou como 9 de outubro sob en-CA. Com o problema do cabeçalho corrigido, 364 células em seis planilhas ainda diferiram por esse motivo. - Os tipos de colunas são todos objeto: Cada coluna no DataSet exportado tinha o tipo System.Object, e números inteiros chegaram como Double. O código que lê a tabela precisa converter os valores por si mesmo.
Atribuir cada valor de texto novamente através de Cell.StringValue, que armazena o texto como escrito, impede a conversão de data. O guia DataSet mostra as duas direções da conversão.
Como você relata cada arquivo que falhou na conversão?
O arquivo de resultados mostra quais arquivos falharam, mas as pessoas que corrigem a caixa de entrada também precisam de cada razão em palavras, agrupadas por 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
Como você depura a saída de conversão incorreta de ponta a ponta?
Entregue apenas com um sintoma, o Codex pode seguir um defeito entre arquivos fonte, logs e notas de outras equipes.
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.
Leia o diagnóstico e concorde com ele antes de qualquer coisa ser corrigida. Uma resposta forte cita a chamada LoadCSV que depende da conversão de campo padrão, conecta o salto à mudança de um host Windows com formato alemão para um contêiner cujo LANG é en_US.UTF-8, e propõe manter o texto do campo e analisar preços com a cultura em que os arquivos do ramo são escritos. Na nossa calibração essa mudança produziu os totais do ERP em ambas as culturas.
Como transformar código único em componentes reutilizáveis e testados?
Quando o arquivo de resultados e o manifesto concordam em cada linha, colapse os modos em um único trabalho que outros serviços possam invocar.
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.
Um refator pode eliminar a verificação de bytes, a pesquisa de senha ou a configuração de convertFieldValues e ainda compilar.
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.
Bytes de saída fazem um alvo de teste ruim, porque um XLSX salvo pode mudar byte por byte entre lançamentos enquanto cada valor permanece o mesmo.
Mantenha as perguntas recorrentes do IronXL na habilidade do repositório em vez de em ~/.codex/prompts/, que a página de solicitações personalizadas da OpenAI marca como obsoleta.
$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.
Como você reutiliza essas solicitações em outra pasta de planilhas?
Mude os caminhos e as solicitações se aplicam a qualquer outra pasta de planilhas. Para um teste de aceitação de ponta a ponta que começa a partir de uma pasta vazia, veja o guia de assistentes de codificação de IA.
O que os prompts produziram em uma execução real?
Enviamos uma formulação anterior de cada solicitação acima para o Codex em ordem, em uma sessão, contra um aplicativo de console de amostra .NET 9. Sua caixa de entrada contém 28 arquivos (XLSX de uma única planilha e multi-planilha, três arquivos XLS legado de dois escritores diferentes, texto separado por vírgula, ponto e vírgula e tabulação, um livro de trabalho protegido por planilha, dois livros de trabalho criptografados, e cinco arquivos corrompidos ou mal rotulados). Um manifesto fornece o status esperado, planilhas e linhas de dados de cada um, e um arquivo de senhas lista um dos dois livros de trabalho criptografados. Após a execução, verificamos os resultados abaixo com nossa própria compilação de Release, uma execução da suíte de testes e uma conversão separada de cada arquivo da caixa de entrada.
- O primeiro conversor marcou 23 arquivos convertidos e 5 falhados. O trabalho final correspondeu ao manifesto em todas as 28 linhas, com 22 Convertidos, 1 Protegido e 5 Ilegíveis.
- Após a verificação de bytes, e antes de qualquer tratamento de senha, 21 arquivos convertidos e 7 foram Ilegíveis, e as únicas 2 linhas que discordaram do manifesto foram o par criptografado.
- A fidelidade do texto foi de 147 campos diferentes entre cinco dos nove arquivos de texto para 0 em todos os 9. A investigação da cultura leu o UnitPrice de Lyon como 420 sob en-US e 4.2 sob de-DE.
- Após a correção da captura de tela, os 9 números de conta que tinham perdido os zeros à esquerda voltaram, e 60 de 60 corresponderam à origem.
- No quickstart, 7 dos 8 arquivos de amostra relataram sucesso e o arquivo de bytes aleatórios lançou FileLoadException. O arquivo de Newcastle de zero bytes foi considerado um sucesso, e Lyon tinha duas colunas.
- Os códigos de saída do guardião de chave foram 0 com a chave definida e 2 sem ela. A chave chegou ao Codex apenas através do ambiente e nunca apareceu em um arquivo ou resposta.
- A saída da pesquisa continha 28 linhas, sinalizou 4 incompatibilidades e deixou 2 arquivos não identificados.
- A folha de pagamento foi convertida com suas 25 linhas de dados, o pool de bônus foi a única linha Protegida, a senha errada levantou SecurityException, e nenhum dos 124 arquivos sob out/continha uma senha.
- A viagem de ida e volta do agente trabalhador, que também copiou formatos de número para células tipadas, comparou 5.714 células em 28 planilhas com 0 diferenças. Nossa própria viagem de ida e volta também encontrou 0.
- O relatório de falhas listou 5 arquivos Ilegíveis e 1 arquivo Protegido, o mesmo que o arquivo de resultados.
- Codex nomeou a linha 27 do trabalho noturno e o contêiner en-US. Sob de-DE, os arquivos do ramo deram os totais do ERP 25632.85, 11926.93 e 14387.26, e sob en-US, 100 vezes esses valores. Adicionamos o trabalho, seus logs, as notas do host e a nota financeira pouco antes dessa solicitação. Um segundo explorador não pôde iniciar com o mesmo nome, então o Codex executou a investigação só de leitura em sua thread principal.
- O trabalhador da viagem de ida e volta escreveu uma ConversionJob de 125 linhas com injeção de dependência, e os testes passaram 2 de 2, também em um clone limpo.
- A solicitação 16 deixou 40 arquivos em out/api-probe/, e o SheetConvert ainda foi compilado.
- A sandbox do Codex não conseguiu acessar o nuget.org, então a restauração usou o cache do pacote local. Todas as 16 compilações de Release sucederam. Uma primeira execução completa falhou. Sua viagem de ida e volta copiou células de origem sobre a planilha reconstruída, sua verificação de bytes também adicionou a etapa da senha, seu refactoring deixou arquivos obsoletos em out/converted/, e sua sonda de API colocou um segundo programa dentro do projeto, o que quebrou a compilação. As solicitações 9, 11, 14 e 16 foram apertadas antes da execução relatada aqui.
A versão do Codex, modelo, tempo e máquina de teste para esta execução estão no registro de execução compartilhado.
Solução de problemas
- C# Ler Arquivos CSV quando um arquivo de ponto e vírgula cai em uma ou duas colunas
- Converter Tipos de Arquivo de Planilha quando um arquivo convertido está faltando no caminho que você passou
- Definir uma Senha para o Livro de Trabalho quando um livro de trabalho criptografado lança ao carregar
- Aplicar uma Chave de Licença no IronXL se cada linha no arquivo de resultados mostrar a mesma falha de licenciamento
Questões?
Se você tiver dúvidas, entre em contato com support@ironsoftware.com
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.