IronXL과 ChatGPT Codex 사용 방법
공유된 받은 편지함 폴더는 각 분기가 보내는 모든 것을 수집합니다. 현대의 XLSX 내보내기는 몇 년 전에 폐기된 시스템에서 XLS 파일 옆에 있으며, 콤마와 세미콜론으로 구분된 CSV 파일, 탭으로 구분된 창고 덤프, 암호화된 급여 작업표, HTML로 판명된 웹 포털 내보내기, 그리고 실패한 업로드로 인한 0바이트 파일이 가끔 있습니다. 창고에서는 모든 파일을 CSV, JSON 및 XML로 원하며, 어떤 파일이 실패했는지도 알고 싶어합니다.
ChatGPT Codex는 OpenAI의 코딩 에이전트입니다. 터미널 프로그램, IDE 확장, ChatGPT 데스크톱 앱 내부, 그리고 클라우드 서비스로 제공되며, 각각은 동일한 ChatGPT 계정으로 로그인할 수 있습니다. IronXL은 Iron Software의 .NET용 스프레드시트 라이브러리입니다.
이 가이드의 각 변환 프롬프트는 Codex가 코드를 작성하기 전에 입력 파일당 한 행으로 구성된 결과 파일을 작성하게 하여 모든 것을 보고하며, 여기의 모든 변환 수치는 그러한 유형의 파일에서 계산되었습니다.
빠른 시작.NET 콘솔 프로젝트에서 샘플 스프레드시트를 사용하여 Codex를 열고 변환을 설명하십시오.
$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.
$ironxl 언급은 Codex가 코드를 작성하기 전에 IronXL의 기술을 로드합니다.
최소 워크플로우(5단계)
- IronXL.Excel NuGet 패키지를 프로젝트에 추가하십시오
- IronXL의 기술을
.agents/skills/ironxl/SKILL.md로 저장하여$ironxl언급을 해결하십시오. - IronXL을 유일한 스프레드시트 라이브러리로 만들고 모든 출력에서 키와 암호를 제외하도록
AGENTS.md를 커밋하십시오. - IronXL이 파일을 열기 전에 각 파일의 리딩 바이트, 구분 기호 및 암호를 확인하고 모든 입력에 대한 상태를 기록하십시오.
- 모드를 하나의 테스트된 작업으로 병합하고 IronXL의 API 레퍼런스에서 호출하는 모든 멤버를 검색하십시오.
ChatGPT Codex란 무엇이며 .NET 스프레드시트 작업에 어떻게 적합합니까?
Codex는 부여된 권한 내에서 주어진 작업을 수행합니다. 변환 파이프라인에서는 변환기를 작성하고, 받은 편지함을 통해 실행하고, 생성된 파일을 열며, 잘못된 경우 코드를 수정합니다. 클라우드 서비스와 함께 npm install -g @openai/codex으로 Codex 저장소에서 CLI를 설치하고 터미널용 OpenAI의 Codex CLI 페이지를 참조하십시오.
OpenAI의 보안 지침에서는 사람이 요청한 풀하는 것과 동일한 타겟 체크와 차이 검토를 요청합니다. 이 파이프라인에서는 중요한 멤버가 빌드를 깨뜨리고 잘못된 변환이 매니페스트와 일치하지 않는 결과 행으로 나타납니다.
Codex는 변환기를 매번 다르게 설계할 수 있지만, 주어진 파일에 대해 IronXL은 동일한 시트와 값을 반환해야 합니다. WorkBook.Load은 XLS, XLSX, XLSM 및 XLTX 파일뿐만 아니라 CSV 및 TSV도 열 수 있습니다. 로드 가이드를 참조하세요.
IronXL 프롬프트를 작성하고 Codex를 어떻게 설정합니까?
변환 프롬프트는 읽을 폴더, 각 파일 유형을 열 방법, 각 출력이 갈 위치, 결과 파일의 한 행이 포함해야 할 내용, 증거로 무엇을 간주해야 할지를 설정합니다. 이 중 하나라도 누락되면 에이전트는 스스로 결정하게 됩니다.
| 컴포넌트 | 약한 프롬프트 | 강한 프롬프트 |
|---|---|---|
| 입력 | 스프레드시트를 변환하십시오 | Inbox/, XLS, XLSX, CSV 및 TSV의 모든 파일 |
| 로드 중 | 미기재 | 구분기가 out/inventory.csv인 경우 WorkBook.LoadCSV |
| 출력 | CSV로 저장하십시오 | out/converted/ 아래의 입력 파일당 하나의 폴더 안에 시트당 CSV, JSON, XML |
| 오류 | 미기재 | 예외 유형으로 결과 행을 받는 모든 파일 |
| 증거 | 작동 여부 확인 | out/convert-results.csv의 각 행이 Expected/manifest.csv와 일치합니다 |
| 제약 조건 | None | Inbox/은 손대지 마세요. 어떤 출력에도 암호가 없습니다. |
OpenAI의 헬루시네이션에 대한 연구는 훈련 및 평가가 추측을 보상하며, 변환 작업에서 추측은 요약을 닫는 계산으로 표면화될 수 있음을 발견합니다.
Codex는 작업 디렉토리에서 저장소 루트까지 .agents/skills 폴더에서 기술을 찾습니다. 기술은 SKILL.md가 이름과 설명으로 시작하는 폴더입니다. IronXL은 ironxl라는 이름으로 skill.md를 게시하며, 이를 .agents/skills/ironxl/SKILL.md로 저장하면 $ironxl가 해결됩니다. 언급이 없더라도 Codex는 작업이 기술의 설명에 맞는 경우 스스로 기술을 선택할 수 있으며, IronXL의 설명은 XLSX, XLS, CSV, TSV, JSON 및 XML 간의 변환을 나열합니다.
AGENTS.md는 현재 규칙을 보유합니다. Codex는 세션이 시작된 폴더까지 저장소 루트에서 시작하여 파일을 수집하며, 두 파일이 충돌할 경우 해당 폴더에 더 가까운 파일이 우선권을 가집니다.
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.
AGENTS.md 내의 새로운 섹션 하나와 전환이 없는 답변을 기대하십시오. 이 턴은 아무것도 변환하지 않습니다.
Codex에게 IronXL을 추가하고 첫 번째 폴더를 변환하도록 요청하려면 어떻게 해야 하나요?
다른 것보다 패키지를 먼저 확인하십시오.
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은 IronSoftware.Common 2026.4.2와 IronSoftware.System.Drawing 2026.8.2를 직접적으로 의존합니다. .NET 9에서 전이 목록에는 IronXL.Excel 자체 외에도 30개의 패키지가 포함되어 있으며, 그중 어느 것도 Office 또는 Interop이 아니었으며, 빌드 출력에 있는 모든 DLL은 런타임 아래의 플랫폼 폴더를 포함하여 관리 어셈블리였습니다. Codex가 나중에 프롬프트를 보고할 버전을 유지하고, 릴리스를 선택할 때 IronXL 변경 로그를 참조하십시오.
키가 없으면 모든 IronXL 로드가 예외를 발생시킵니다. 28개의 파일이 있는 받은 편지함에서 그것은 동일한 실패의 28가지 복사본을 의미하므로 아래의 보호 장치가 어떤 파일도 이용하기 전에 종료할 것입니다.
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.
라이선스 키 페이지에서는 체험판 키와 IronXL이 또한 읽는 구성 파일을 다룹니다.
변환기가 존재하기 전에 폴더가 무엇을 수용하고 있는지 확인하십시오. OpenAI는 Codex의 내장된 탐색기를 코드베이스 탐색을 위한 읽기 중심 에이전트로 문서화하며, 이는 수정 없이 조사할 때 적합합니다.
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.
XLSX는 PK로 시작하는 zip 아카이브이고, XLS는 D0 CF 11 E0으로 시작하는 OLE2 복합 파일입니다. 조사는 .xlsx라는 이름의 콤마로 구분된 텍스트 파일 및 .xls에 HTML 테이블을 포함하는 포털 내보내기의 플래그를 지정하며, 선행 바이트에서 0바이트 Newcastle 파일 또는 무작위 바이트 파일을 식별하지 못합니다. 또한 두 개의 암호화된 워크북을 플래그 지정합니다. 왜냐하면 암호화된 XLSX는 레거시 XLS와 동일한 서명을 가진 OLE2 컨테이너이기 때문입니다.
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.
이 단계에서 네 줄 중 네 개의 상태가 잘못되었습니다. 0바이트 파일과 .xlsx라는 이름의 텍스트 파일은 변환된 것으로 간주되며, 두 개의 암호화된 워크북은 실패로 간주됩니다. 암호가 알려진 급여 파일과 Protected 아래에 속하는 보너스 풀 파일입니다. 나중에 프롬프트가 네 가지 모두를 수정합니다.
IronXL은 각 워크시트를 어디에 저장합니까?
작업표 저장은 전달한 경로에 쓰이지 않습니다. Orders라는 하나의 시트만 있는 작업표에서 호출된 SaveAsCsv는 경로 out/x/orders.csv에 대해 orders.Orders.csv를 씁니다. 파일 이름에 시트 이름이 뒤따라오며 orders.csv는 생성되지 않습니다. 변환 가이드에서는 CSV, TSV, JSON 및 XML의 각 워크시트당 하나의 파일에 대해 문서화하며 2026.10.1을 사용하여 파이프라인이 종속되는 세부 사항을 측정했습니다.
- 단일 시트도 접미사를 받습니다: CSV 또는 TSV에서 로드된 작업표는
Sheet0라는 하나의 시트를 가지며, so customers-uk.csv는 customers-uk.Sheet0.csv가 됩니다. - 시트 이름은 그대로 전달됩니다: 받은 편지함의 Q3 요약 시트는 공백이 있는 파일 이름을 제공하며, 프랑스어 시트 이름은 악센트가 있는 문자를 유지하므로 하류 스크립트는 경로를 인용해야 합니다.
- 워크시트 작성자는 다르게 동작합니다: CSV, TSV, JSON 또는 XML 이름으로 일반적인 작업표 저장도 시트로 분할되는 반면,
WorkSheet.SaveAsCsv및 다른 워크시트 작성자는 지정된 경로를 그대로 생성합니다. - 각 형식은 고유한 모양을 가집니다: CSV는 UTF-8 바이트 순서 표시로 시작하며, JSON은 모든 값을 문자열로 가지는 행들의 배열이고, XML은 각 셀에
xsi:type요소와 같은xs:double를 제공합니다. 유효하지 않은 XML 이름인 시트 이름은 이스케이프됩니다. 그래서 Q3 요약은Q3_x0020_Summary요소가 됩니다.
CSV는 인용된 줄 바꿈을 포함할 수 있고 빈 줄로 끝나기 때문에, 모든 줄을 세면 잘못된 행 수를 제공합니다. 워크시트 자체에서 데이터 행을 세고, 결과 파일에서 한 것처럼 IronXL이 작성한 출력 경로를 목록화하십시오.
변환된 CSV가 선행 0을 잃는 이유는 무엇입니까?
변환된 데이터를 가져오는 팀은 문제를 그림으로 보고할 수 있습니다. Codex는 codex --image로 세션을 시작할 때 이미지를 수락하며, CLI도 작곡가에 하나를 붙여넣을 수 있도록 허용합니다.
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
스크린샷은 123, 4567 및 9를 찾을 수 없는 3개의 계정을 표시합니다. 소스 파일에 그들은 000123, 004567 및 000009로 있습니다. LoadCSV는 기본적으로 true인 convertFieldValues 인수를 가지고 있으며, 숫자처럼 보이는 모든 필드를 숫자로 변경하여 선행 0을 제거합니다. convertFieldValues: false 전달을 통해 모든 필드를 브랜치가 작성한 텍스트 그대로 유지합니다.
다른 기기에서 CSV가 다르게 로드되는 이유는 무엇입니까?
LoadCSV는 listDelimiter 인수를 기반으로 열을 나누며, 그 값이 null일 때 IronXL은 현재 문화의 목록 구분자로 돌아갑니다. 우리의 en-CA 기기에서 그 구분자는 콤마이므로, Lyon에서 온 세미콜론 파일은 각 소수점 콤마에서 잘려 두 열로 로드되었습니다. de-DE 하에서는 동일한 호출이 이를 올바르게 나눴습니다. CSV 파일에서 WorkBook.Load은 동일한 방식으로 동작합니다. CSV 읽기 가이드는 명시적 형식을 보여줍니다.
구분자만 문제가 아닙니다. 필드 변환을 그대로 두면 IronXL은 현재 문화로 숫자를 해석합니다. en-CA에서는 Lyon 가격 4,20을 세미콜론 구분자로 읽을 때 LoadCSV이 이를 오류 없이 420으로 읽었는데, 이는 거기에 있는 콤마가 천 단위 구분자이기 때문입니다. de-DE 하에서는 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
IronXL이 서식화된 셀에 대해 기록하는 값은 무엇입니까?
작업표의 CSV 및 JSON 작성자는 각 셀이 표시하는 텍스트를 기록하며, 이는 FormattedCellValue와 같은 문자열로, 숫자 형식이 창고로 전달될 내용을 결정합니다. XML 작성자는 저장된 값을 해당 유형으로 기록합니다. openpyxl이 작성한 XLSX 및 받은 편지함의 Derby XLS에서 이를 측정했습니다.
| 저장된 값 | 형식 | 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 |
| 2018년 3월 1일 | m/d/yy h:mm | 3-1-18 0:00 | 3.1.18 0:00 | 2018-03-01T00:00:00 |
반올림은 자릿수를 줄이고 아무 것도 보고하지 않습니다. 0.00 형식 하에서 0.004의 무게는 0.00으로 나왔습니다. 문화는 출력에도 도달합니다. 출시된 XML 문서는 CSV 작성자의 구분자를 시스템 기본값으로 남겨 두라고 하고 있으며, de-DE 하에서는 기본값이 세미콜론으로 작성되었습니다. 구분자로 콤마를 전달하면 구분자만 변경되었습니다. 일반 형식의 Derby 가격은 여전히 "33,84"로 나왔습니다.
en-CA 하에서는 받은 편지함이 이 대부분을 숨깁니다. 왜냐하면 다른 워크북은 일반 형식으로 숫자를 유지하고 날짜는 yyyy-mm-dd로 표시되기 때문입니다. IronXL이 작성한 Derby 파일은 예외입니다. Codex의 자체 CSV 내에서는, 모든 70개의 날짜가 마지막 테이블 행처럼 나왔습니다. 두 자리 연도는 en-CA 날짜 구분자로 나타나는 반면, en-US는 3/1/18 0:00으로 나옵니다. 창고가 저장된 값을 필요로 할 때, CSV는 각 셀의 Value을 CultureInfo.InvariantCulture으로 형식화하여 작성하십시오. 이는 en-CA, de-DE 및 fr-FR에서 각각 1234.5, 2.345678, 2026-09-20을 제공합니다.
잘못된 파일이 오류 없이 변환될 수 있는 이유는 무엇입니까?
WorkBook.Load이 파일을 작업표로서 읽을 수 없을 때, CSV로 다시 시도합니다. 그 대체는 받은 편지함에 있는 몇몇 결과를 설명합니다.
| 받은 편지함 파일 | 로드 결과 | 다음으로 기록 |
|---|---|---|
| 0바이트 .xlsx | 빈 시트 하나, 예외 없음 | 읽을 수 없음, 빈 파일 |
| 콤마로 구분된 텍스트가 .xlsx로 저장됨 | CSV로 로드되었고, 두 열에 아홉 개의 데이터 행 | 읽을 수 없음, 콘텐츠 불일치 |
| HTML 테이블이 .xls로 저장됨 | FileLoadException 던짐. 인용 부호 문자 없이 한 셀로 로드된 복사본 | 읽을 수 없음, 콘텐츠 불일치 |
| .xls로 저장된 무작위 바이트 | FileLoadException 던짐, 내부 AggregateException "Excel 로드 실패, 이후 CSV 대체가 실패" | 읽을 수 없음, 알 수 없는 형식 |
| 실제 .xlsx의 첫 40퍼센트 | 불충분한 메모리를 인용하여 FileLoadException을 던졌고, 내부 SharpZipBaseException "예상치 못한 EOF" | 읽을 수 없음, 잘림 |
첫 두 행이 위험한 행입니다. 왜냐하면 예외만 잡는 변환기는 이를 성공으로 보고하고 빈 시트 또는 이름 변경된 텍스트 파일을 창고에 전달할 것이기 때문입니다.
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.
IronXL은 암호로 보호된 작업표로 무엇을 합니까?
받은 편지함에는 두 종류의 보호가 있으며, IronXL은 이들을 다르게 처리합니다.
암호화된 작업표는 암호 없이 로드된 경우 ArgumentNullException을 발생시키고, 잘못된 암호를 사용하면 SecurityException을 발생시킵니다. ProtectSheet은 편집만 잠급니다. 받은 편지함에는 보호된 대상 작업표 로드 및 변환은 아무런 암호 없이 이루어졌습니다. AI 코딩 어시스턴트 가이드는 두 종류를 완전히 비교하며, 암호 가이드는 파일 형식이 파일을 열려고 시도하지 않고는 보호 여부를 테스트할 방법이 없음을 언급합니다.
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.
DataSet 라운드 트립에서 동일한 시트를 반환합니까?
라운드 트립은 기본적으로 동일한 시트를 반환하지 않습니다. SQL 또는 Entity Framework를 통해 시트를 ToDataSet에 핸드오프하고 LoadWorkSheetsFromDataSet으로 작업표를 재구축하는 파이프라인은 트립을 테스트해야 합니다. OpenAI는 Codex의 내장된 작업자를 구현 및 수정을 위한 실행 중심 에이전트로 문서화하며, 실행 중에 쓰레드를 전환하는 /subagents 명령을 제공합니다.
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.
28개의 변환된 시트에서 교정 동안 세 가지가 데이터를 변경했습니다.
- 헤더 행이 사라집니다:
ToDataSet와 true 헤더 인수는 첫 행을 열 이름으로 변환하며, 재구축은 아무런 헤더 행을 다시 쓰지 않습니다. 모든 시트는 헤더 행을 잃고, 5,267개의 셀이 다릅니다. 인수가 없는ToDataSet는 기본값이 false이며, 데이터를 헤더로 유지하고 손실을 피합니다. - 날짜처럼 보이는 텍스트가 날짜로 변환됩니다: 재구축은
Cell.Value을 할당하는 것과 동일한 방식으로 문자열 값을 파싱합니다. 텍스트 2026-09-01은 DateTime으로 돌아왔으며, Hamburg 날짜 10.09.2026 (9월 10일)은 en-CA에서 10월 9일로 돌아왔습니다. 헤더 문제를 수정한 후에도 여섯 개의 시트에 364개의 셀이 이 이유로 달랐습니다. - 열 유형은 모두 개체입니다: 내보낸 DataSet의 모든 열은 유형 System.Object를 가졌으며, 전체 숫자는 Double로 도착했습니다. 테이블을 읽는 코드는 스스로 값을 변환해야 합니다.
텍스트 값을 다시 Cell.StringValue을 통해 할당하여, 텍스트를 작성한 그대로 저장하면 날짜 변환이 멈춥니다. DataSet 가이드는 변환의 두 방향을 보여줍니다.
변환에 실패한 모든 파일을 어떻게 보고합니까?
결과 파일은 어떤 파일이 실패했는지 보여주지만, 받은 편지함을 수정하는 사람들은 상태별로 그룹화된 각 이유를 구체적으로 설명한 내용을 원합니다.
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
끝에서 끝까지 잘못된 변환 출력을 어떻게 디버그합니까?
증상 외에 아무 것도 핸드오프 받지 못한 채, Codex는 소스 파일, 로그 및 다른 팀의 노트를 통해 문제를 팔로우할 수 있습니다.
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.
진단을 읽고 동의한 후에만 수정을 시작하십시오. 강력한 답변은 기본 필드 변환에 의존하는 LoadCSV 호출을 인용하고, 독일 형식의 Windows 호스트에서 LANG가 en_US.UTF-8인 컨테이너로의 이동을 연결하며, 브랜치 파일이 작성된 문화를 사용하여 필드 텍스트를 유지하고 가격을 해석할 것을 제안합니다. 교정 동안 그 변경은 ERP 총계를 두 문화 모두에서 산출했습니다.
1회성 코드를 재사용 가능한, 테스트된 구성요소로 어떻게 변환하나요?
결과 파일과 매니페스트가 모든 행에서 동의할 때, 모드를 다른 서비스가 호출할 수 있는 단일 작업으로 통합하세요.
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.
리팩터는 바이트 검사, 암호 조회 또는 convertFieldValues 설정을 제외하고 컴파일할 수 있습니다.
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.
바이트 출력은 잘못된 테스트 대상이 됩니다. 왜냐하면 저장된 XLSX는 릴리스 간에 바이트 단위로 변경될 수 있지만 모든 값은 그대로 유지되기 때문입니다.
반복되는 IronXL 질문은 OpenAI의 커스텀 프롬프트 페이지에서 더 이상 사용되지 않음으로 표시된 ~/.codex/prompts/ 대신 저장소 기술로 유지하십시오.
$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.
다른 스프레드시트 폴더에서 이러한 프롬프트를 어떻게 재사용합니까?
경로를 변경하면 프롬프트는 다른 스프레드시트 폴더에 적용됩니다. 빈 폴더에서 시작하는 단일 종료-끝 수용성 테스트는 AI 코딩 어시스턴트 가이드를 참조하십시오.
실제 실행에서 프롬프트가 무엇을 생성했습니까?
우리는 위의 모든 프롬프트의 이전 워딩을 Codex에 순서대로 하나의 세션으로 보냈고, 샘플 .NET 9 콘솔 앱에서 확인했습니다. 받은 편지함에는 28개의 파일 (단일 시트 및 다중 시트 XLSX, 두 개의 다른 작성자에서 온 세 개의 레거시 XLS 파일, 콤마, 세미콜론 및 탭 구분 텍스트, 시트 보호 워크북, 두 개의 암호화된 워크북, 그리고 5개의 잘못된 또는 잘못된 파일)이 있습니다. 매니페스트는 각 파일의 예상 상태, 시트 및 데이터 행을 제공하며, 암호 파일은 두 개의 암호화된 워크북 중 하나를 나열합니다. 런이 실행된 후 우리는 test suite의 릴리스 빌드 및 받은 편지함의 모든 파일의 별도 변환과 함께 아래의 결과를 확인했습니다.
- 첫 번째 변환기는 23개 파일이 변환되었고 5개가 실패했음을 표시했습니다. 최종 작업은 모든 28행에서 매니페스트와 일치했으며, 22 Converted, 1 Protected 및 5 Unreadable로 나타났습니다.
- 바이트 검사 후 및 암호 처리를 시작하기 전에, 21개 파일이 변환되고 7개는 읽을 수 없었으며, 매니페스트와 의견이 다른 것은 암호화된 쌍 뿐이었습니다.
- 텍스트 충실성은 아홉 개의 텍스트 파일 중 다섯 개에서의 147가지 다른 필드에서 모든 9개에서의 0으로 도달했습니다. 문화 프로브는 Lyon UnitPrice를 en-US에서는 420으로, de-DE에서는 4.2로 읽었습니다.
- 스크린샷 수정 후, 선행 0을 잃은 9개의 계정 번호가 돌아왔으며, 60 중 60개가 소스와 일치했습니다.
- 빠른 시작에서는 8개의 샘플 파일 중 7개가 성공을 보고하고 무작위 바이트 파일이 FileLoadException을 던졌습니다. 0바이트 Newcastle 파일은 성공으로 간주되었으며, Lyon은 두 개의 열이 있었습니다.
- 키 보호 장치에서의 종료 코드는 키가 설정된 경우 0이고 설정되지 않은 경우 2였습니다. 키는 환경을 통해서만 Codex에 도달했으며, 파일이나 응답에서 나타나지 않았습니다.
- 조사 결과는 28개 행을 담고, 4개의 불일치를 플래그했으며, 2개의 파일은 식별되지 않았습니다.
- 급여는 25개의 데이터 행으로 변환되었고, 보너스 풀은 하나의 Protected 행이었으며, 잘못된 암호는 SecurityException을 발생시켰습니다. 124개 파일 중 out/에 암호가 포함된 파일은 없었습니다.
- 내부의 형식을 가져오는 것을 포함한 라운드 트립 작업자는 5,714개의 셀을 28개의 시트에서 비교했으며, 0개의 차이가 있었습니다. 우리의 자체 라운드 트립에서도 0이 발견되었습니다.
- 실패 보고서는 5개의 읽을 수 없는 파일과 1개의 Protected 파일을 열거했으며, 이는 결과 파일과 동일했습니다.
- Codex는 야간 작업의 27번째 줄과 en-US 컨테이너를 명명했습니다. de-DE 하에서 브랜치 파일은 ERP 총계 25632.85, 11926.93 및 14387.26을 제공했으며, en-US 하에서는 그것의 100배였습니다. 해당 프롬프트 바로 전 작업, 로그, 호스트 노트 및 금융 노트를 추가했습니다. 동일한 이름 하에서는 두 번째 탐색기가 시작할 수 없었기 때문에, Codex는 메인 스레드에서 읽기 전용 조사를 수행했습니다.
- 라운드 트립의 작업자는 종속성 주입을 통해 125줄의 ConversionJob을 작성했으며, 테스트는 2개 중 2개가 통과했으며, 깨끗한 복제에서도 역시 성공했습니다.
- 프롬프트 16은 out/api-probe/에 40개의 파일을 남겼으며, SheetConvert는 여전히 빌드되었습니다.
- Codex의 샌드박스는 nuget.org에 도달할 수 없어서, 로컬 패키지 캐시를 사용해 복구했습니다. 모든 16개의 릴리스 빌드는 성공했습니다. 첫 번째 전체 실행은 실패했습니다. 그것의 라운드 트립은 소스 셀을 재구축된 시트로 복사했고, 바이트 검사는 또한 암호 단계를 추가했으며, 리팩터는 out/converted/에 오래된 파일을 남겼고, API 탐사가 프로젝트 내에 두 번째 프로그램을 두어 빌드를 깨뜨렸습니다. 여기 보고된 실행 전 프롬프트 9, 11, 14 및 16은 강화되었습니다.
Codex의 버전, 모델, 타이밍 및 이 실행을 위한 테스트 기계는 공유 실행 기록에 있습니다.
문제 해결
- 세미콜론 파일이 한두 열로 도착할 때 C# Read CSV Files
- 변환된 파일이 전달된 경로에 없을 때 Convert Spreadsheet File Types
- 암호화된 작업표가 로드 중에 던질 때 Set a Password to Workbook
- 결과 파일의 각 행이 동일한 라이선스 실패를 나타낼 때 Apply a License Key in IronXL
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.