如何使用IronXL与Google Antigravity

Curtis Chau
Curtis Chau
更新: 2026年10月15日

一个工作簿上传页面可以编译,通账户集成测试,并且在首个供应商发送大价格清单、密码保护的工作簿或重命名的CSV文件时仍然失败。

Google Antigravity的/browser命令将页面交给Chrome子代理,子代理选择上传表单中的每个测试工作簿,提交并保留响应的截图。 IronXL直接从请求流中打开服务器上的上传,使用WorkBook.Load,无需办公室安装。 本指南通过这两者构建一个供应商价格清单页面。 该页面显示一个预览表格,验证每一行是否符合书面规则,返回清理后的XLSX文件,每个步骤都通过截图和结果表格得以验证。

快速入门
NuGet使用NuGet安装

PM > Install-Package IronXL.Excel

通过在 NuGet 包管理器控制台中运行上述命令安装 IronXL,或在 NuGet 包管理器中搜索该包。

在Antigravity中打开MVC项目,请求上传页面。

/plan Build a supplier price list upload at /PriceList in this ASP.NET Core MVC app on .NET 9.

- A supplier picks an .xlsx or .xls file in a multipart form.
- The server opens it with WorkBook.Load straight from IFormFile.OpenReadStream.
- Use IronXL from the IronXL.Excel 2026.10.1 package. The namespace is IronXL.
- The page shows a preview table, a validation summary and a link to a cleaned XLSX download.
- docs/price-list-rules.md defines every rule and message.

Set IronXL.License.LicenseKey once in Program.cs from IRONXL_LICENSE_KEY.
The app reads that variable on its own, so don't print its value or list environment variables.
Keep the key out of every file.

In the Implementation Plan, tell me:

- which request body limit applies before the action runs
- how the page tells a password-protected workbook from a damaged file
- how text cells get written into the cleaned workbook

Then get dotnet build passing with no errors.
Text

在批准之前阅读到此计划的两个部分。 Kestrel在MVC绑定表单之前拒绝任何超过30,000,000字节的请求体,因此在动作内部的大小检查不会对更大的文件运行。一个合理的计划使用[RequestSizeLimit]和[RequestFormLimits]为此一个动作设置限制,如微软的文件上传指南所述,并在其后保持自身的10 MB检查。 这些属性覆盖了Kestrel的服务器范围限制,所以计划不需要在Program.cs中使用更大的MaxRequestBodySize,这将提高每个终端的天花板。 计划还应将需要密码的工作簿与根本不是工作簿的文件区分开来,因为IronXL对每种情况都会引发不同的异常。 在非交互模式下,agy -p会自动通过计划审查,如Antigravity变更日志所述,因此您可以在之后与代码更改一起审查计划文物。

只给代理变量名称以及没有其他内容,因为粘贴密钥可能最终会出现在源代码中,或提交中,或命令日志中。 即使是变量的值也可能泄露。 在早期的运行中,代理利用一个PowerShell命令检查IRONXL_LICENSE_KEY是否设置并打印其值。 密钥去了模型并进入Antigravity的自己的记录文件中,位于~/.gemini/antigravity-cli/之下,虽然存储库中没有文件包含它。

许可证密钥指南详细说明了IronXL检查密钥的所有位置。



什么是Google Antigravity,它与聊天助手有何不同?

给定一个目标,Antigravity代理生成计划,在编辑器、终端和浏览器中执行它,并通过您可以审查的文物而不是聊天记录报告其所做的内容。

没有指导,构建上传页面的代理可能选择它找到的第一个Excel库或猜测一个包名称。 一个猜测的名称可能解析为攻击者提前以该名称发布的伪造品,通常称为slopsquatting。 使用IronXL.Excel作为包和IronXL作为命名空间。

AI码写助手指南列出了需要给代理的IronXL文档链接,并包括一个单提示接受测试,可以在Antigravity中运行。

代理返还了什么,您如何审核?

代码实现计划前

计划定义了文件。 审核计划以确认范围。

运行中,代码差异

代码差异显示计划如何实现。 检查POST操作中的属性,每个catch子句中的异常类型,以及清理后的工作簿中写入每个单元格的每一行。 在接受更改前,在API参考中查找每个使用的IronXL成员。

运行后,演练

演练总结了更改并保留结果的证据。 每个截图作为一个图像文物保存,接受评论。 如果某个显示有错误的值,例如打印为数字的日期,请在该截图上评论,而不是在新提示中描述问题。

我们的CLI对话从第一个提示到最后一个提示保留了一个walkthrough.md,并在每个任务中替换其内容,因此早期提示中的七个文件表格仅在代理的回复中幸存。 在每个提示完成后立即保留每个表格的副本。

如何在真实浏览器中测试IronXL上传页面?

请求一个只有真实上传能填充的结果表。

/browser Start PriceListImport with dotnet run as a background task and open /PriceList.
Its http profile serves http://localhost:5289.

For each file listed in TestData/uploads/expected.csv:

1. Choose it in the upload form and submit.
2. Wait for the page to settle, then take a screenshot.
3. If the outcome column says password, type that row's password, pick the file again and resubmit.

In the Walkthrough, give me one row per file with:

- its size in bytes
- the expected outcome
- what the page showed, either its accepted and rejected counts or the message text
- the EffectiveDate in the first preview row, when there is a preview
- pass or fail against its expected.csv row

If a row doesn't match, quote the server log line or error page behind it before you touch the code.
After every fix, start the app fresh and redo the whole seven-file pass.
Stop the app when you're done.
Text

更高的请求限制改变一个文件的结果,但新日期解析器触碰所有预览,因此只有在每次修复后完整地对所有七个文件进行全面运行可以显示没有其他问题。 首先请求日志行也意味着在查看编辑之前查看原因。

请注意: 首先打开price-list-oversized.xlsx的截图。提高请求限制后,它显示页面自己的10 MB消息。

是什么导致了错误或缺失的Excel值?

每个下面的失败都可追溯到一个原因,并在后续任务中命名它可以节省代理一番试错。

我们从IronXL的ASP.NET MVC指南中适配了控制器,以读取上传的表单文件,而不是固定路径,添加了10 MB长度检查,并通过无头Chrome上传了七个测试工作簿。 下面的每个失败都编译得很干净。

截图原因修复请求
32.7 MB文件"此站点无法访问"Kestrel的默认主体限制[RequestSizeLimit] 和 [RequestFormLimits] 高于应用程序的上限,加上它自己的大小消息
"工作簿已受密码保护,但没有提供密码。 (参数'password')"该页面显示ArgumentNullException ex.Message一个密码字段和您自己的信息
两列中有8行用分号连接的文本重命名的CSV加载没有异常首先检查标题行
小文件的内存不足消息截断的工作簿抛出FileLoadException"不是可读的工作簿"
"2026-11-01 12:00:00 AM",或用XLS日期格式显示为"46327"读取原始值或DataTable,以及IronXL未检测到的XLS日期格式FormattedCellValue,以及用于序列号的DateTime.FromOADate

在我们的探测中,空文件、PNG图像和纯文本文件也加载没有异常,所以标题检查拒绝了比任何catch块更多的不良上传。

您如何设置Antigravity可以工作的项目?

从已经编译并服务其首页的应用程序开始。 dotnet new mvc --framework net9.0 创建了一个。 启动它一次并从 Properties/launchSettings.json 复制 http 地址,因为每个新项目都会得到自己的端口号,/browser 提示必须使用它。 保持该地址在 http://localhost:<port> 格式,因为浏览器的白名单开始时仅包含 localhost,其他地址需要有人点击始终允许。

将测试工作簿提交到 TestData/uploads,附带记录每一个结果的 expected.csv,并将规则写入 docs/price-list-rules.md。 我们的集合包括一个需要清理的价格清单、一个遗留的XLS导出、有受保护工作表的工作簿、加密的工作簿、截断的下载、重命名的CSV和一个32.7 MB的工作簿。 然后让代理检查包和密钥。

Tell me which IronXL.Excel version PriceListImport.csproj references.
Quote its PackageReference line, then list every file that mentions a license key.

The key rules are:

- The key comes from IRONXL_LICENSE_KEY at startup and from nowhere else.
- Neither appsettings file has an IronXL.LicenseKey entry.
- A missing variable produces one startup warning that names it and prints no value.

Add that warning if the app doesn't have it yet. Leave everything else as it is.
Text

在以后添加或更新包的任何提示中命名该版本,以免任务安静地升级或降级IronXL。

没有密钥,每次上传在加载调用时都会因LicensingException失败,显示"需要生产许可证"。 一个捕获每个异常并称文件不可读的页面将把每个问题归咎于服务器,这又是仅捕获预期异常的一个原因。

Antigravity 从项目中的 AGENTS.md, GEMINI.md 和 .agents/rules/*.md 加载规则,根据其规则文档。 在 .agents/rules/ 中的文件需要带有有效 trigger 的 YAML 前言,Google 警告说缺少前言或未识别的触发器的规则将被静默丢弃。 一个全局触发器仅在代理处理匹配文件时加载规则,这适合仅涉及一个控制器和一个服务的规则。

/learn 将一个会话的修正转换为规则或技能。 斜杠命令页面说它写入 .antigravity/rules.md,而规则页面并未列出该路径为规加载位置之一,因此请在提示中命名文件。

/learn Save what this session settled about the upload page as a glob rule.
Write it to .agents/rules/price-list-upload.md.
Give it YAML frontmatter with trigger: glob.
Its globs cover Controllers/**, Services/** and Views/PriceList/**.

The rule should cover:

- the request limits, with the reason for each value
- the exceptions IronXL throws for a missing password, a wrong password and an unreadable file
- how text that starts with = gets written
- how legacy XLS dates are read
- that no upload change is finished until the seven-file /browser check passes for TestData/uploads
Text

打开新文件并检查其首行是否有前言和蛇形命名触发器值,如 always_on,永远不要使用驼峰命名 alwaysOn。 也要读取 globs 值。 规则页面将其类型化为以逗号分隔的字符串,并不描述YAML列表。

如何用IronXL加载上传的工作簿?

在ASP.NET Core 源代码中,IFormFile.OpenReadStream 将表单部分包裹在 ReferenceReadStream 中,因为表单读取器为每个文件缓冲数据,可以寻址,最高 64 KB 在内存中,剩下的在临时文件中。IronXL 需要一个可以寻址的流。 我们通过仅转发流传递每个测试工作簿给 WorkBook.Load,所有七个抛出 NotSupportedException异常,提示 "指定的方法不受支持。" 上传流报告说它可以寻址,IronXL 从中读取每一个上传,没有复制。

10 MB上限更保护内存而非带宽。 加载32.7 MB的测试文件,在六栏中含有260,001行,包括标题,花费6.6秒,并在控制台探测中最顶达到732 MB工作集。 IronXL 的文件大小限制页面指出 IronXL 自身没有文件大小或行数限制,因此上限属于应用程序。将其设置为供应商发送的最大价目表,并保持来自规则的 5,000 行限制作为第二检查。

Plan the refactor below in an Implementation Plan Artifact, then wait for my review before editing.

Move all the IronXL work out of the controller into Services/PriceListImporter.cs.
Register the service as a singleton.

The controller:

- keeps the request limits and the 10 MB check
- passes the upload stream to the service, with the password or null when the field is empty
- keeps the cleaned bytes for the download link

The service owns the header row check. It catches three IronXL failures and nothing else:

- a missing password, which throws an ArgumentNullException whose ParamName is password
- a wrong password, which throws a System.Security.SecurityException
- a file that can't be read, which throws a System.IO.FileLoadException

An IronSoftware.Exceptions.LicensingException has to reach the error page and the log.
So does any other failure.
Once the build passes, repeat the browser upload check on all seven workbooks.
Text

当更改到达时,与下面的版本比较加载步骤。 对IronXL 2026.10.1进行编译,并带有相同三个抓取子句,我们的校准页面在七个测试文件中的每一个中均达到了预期结果。

using IronXL;

public sealed class PriceListImporter
{
    public ImportResult Import(Stream upload, string? password)
    {
        WorkBook workBook;
        try
        {
            workBook = string.IsNullOrEmpty(password)
                ? WorkBook.Load(upload)
                : WorkBook.Load(upload, password);
        }
        catch (ArgumentNullException ex) when (ex.ParamName == "password")
        {
            return ImportResult.AskForPassword("This workbook is password-protected. Enter its password to open it.");
        }
        catch (System.Security.SecurityException)
        {
            return ImportResult.AskForPassword("That password did not open the workbook. Try again.");
        }
        catch (FileLoadException)
        {
            return ImportResult.Failed("This file is not a readable Excel workbook. Upload an .xlsx or .xls file.");
        }

        WorkSheet sheet = workBook.WorkSheets.First();
        return Validate(sheet);
    }
}
C#

ImportResult 和 Validate 代表应用程序自己的结果类型和规则检查。

如何构建预览表?

请求预览的代理可能会将已加载的工作簿传递给 WorkBook.ExportToHtmlString 并将结果放入视图中。 IronXL的Excel到HTML示例,通过HTML导出方法及其选项类写入文件,页面仅描述了五个显示选项。 我们的探针调用了四个测试工作簿的字符串导出,页面呈现了预览。 良好的价格清单、锁定的工作表文件和带有密码的加密文件每次抛出InvalidOperationException,表示"可空对象必须有一个值。"遗留的XLS文件导出其13行中的12行,PL-3012缺失。

这些文件来自 openpyxl,它的默认单元格填充没有 patternType 属性,IronXL 内部的 HTML 转换器对此填充失败。 我们添加了 patternType="none" 之后,好的价目表导出时不包括其最后一行 PL-2007。每个导出的工作簿都丢失了最终行,包括由 IronXL 创建的三行工作簿,而遗留日期仍然显示为诸如 46337 的序列号。

导出确实对单元格文本进行了编码,因此使用img标签的描述带有src=x和onerror警报以转义角括号显示。 在Razor视图中从工作表的每个单元格构建预览,因此验证计数的每一行都到达屏幕,并且Razor对每个值进行编码。 如果代码更改调用字符串导出,请要求代理替换它。

如何将文本单元格写入清理后的工作簿?

我们的测试价目表中的一行有一个描述,其纯文本以 =HYPERLINK( 开头。 IronXL将其读取为文本,正如供应商存储的那样。 通过 Value 或 StringValue 将该字符串写入已清理的工作簿,IronXL 改而存储为活动的 HYPERLINK 公式。 两者写入时重新加载为公式,保存的表格 XML 为单元格保存了 <f> 元素。 写入指南建议使用 StringValue 来强制精确值,在 IronXL 2026.10.1 中适用于诸如 +SUM(1,2) 或 @SUM(1,2) 的文本,但不适用于以 = 开头的文本。

开头的撇号可以解决它。 StringValue = "'" + text 将其余字符串存储为无公式的共享字符串,Excel 将其视为输入含引号的单元格,并读取回原文本。 在分配值之前将单元格的 FormatString 设置为 "@"(文本格式)也能在我们的探测中保留字符串为文本。 在普通分配后移除公式没有修复它,因为它会使单元格为空。

/goal 让代理一直工作在这样的检查上,直到通过,没有暂停确认。

/goal Every cleaned workbook the page produces follows docs/price-list-rules.md.
First start the app in the background on http://localhost:5289. Stop it when you finish.

Work through each file in TestData/uploads that expected.csv marks preview or password:

1. Submit it to the /PriceList form, with the password from its expected.csv row if it has one.
2. Take the download link from the response.
3. Save that download as artifacts/cleaned/<file name>.xlsx.
4. Reload it with WorkBook.Load in a small console project under tools/CleanedCheck.

The web project must not compile tools/CleanedCheck.
The console project sets IronXL.License.LicenseKey from IRONXL_LICENSE_KEY.

For every reloaded file, check:

- the two sheet names
- the accepted and rejected counts against expected.csv
- that no cell in either sheet is a formula
- that the PL-2007 description reads back exactly as the supplier typed it

Keep fixing and rechecking until all four files pass. Then put the results in the Walkthrough.
Text

我们的两个校准清洁器在页面上报告了35接受并拒绝了6行,因此仅凭计数无法区分它们。 未经更改复制描述的那个保存了一个下载,用在价格表中的一个HYPERLINK公式。

如何处理受密码保护的工作簿?

一个只含有受保护表的工作簿可以在没有密码的情况下打开,如 工作表密码指南所述,而我们的锁定表测试文件像其他任何文件一样加载和验证。 就地清理工作簿而不是生成一个新工作簿有一个陷阱。 在我们更改已加载文件中的某个单元格并保存后,<sheetProtection> 元素仍在表格 XML 中,因此那样制作的清洁副本在供应商用 Excel 打开时保持受保护。

有开放密码的工作簿是加密的。 没有密码加载它会引发ArgumentNullException,参数名称为密码,错误或空密码引发System.Security.SecurityException,显示"无效密码",因此上面的导入器仅在字段持有文本时传递密码。 使用正确的密码,WorkBook.Load(stream, password) 打开了文件,采用与工作簿密码指南中在文件路径后传递的第二个参数相同。

加载的工作簿仍然自我报告为加密,但从 ToByteArray 的字节却无需密码即可打开。 本页面的规则说清理后的文件不带密码,因此通过 WorkBook.Create 构建一个新工作簿使该规则在代码中可看到,而不是将其留给副作用。

何时应指派多个代理?

一个代理可以拥有自动测试,而另一个拥有浏览器证据。

Agent A: add a PriceListImport.Tests xUnit project that the web project doesn't compile.
Add public partial class Program { } to the web project so the tests can reach it.
Use WebApplicationFactory<Program>, and for each workbook in TestData/uploads:

1. Post it to /PriceList as multipart form data.
2. Assert the outcome expected.csv gives for it, sending that row's password where it has one.
3. Download the cleaned workbook, if there is one.
4. Reload that workbook with WorkBook.Load and assert the counts.
5. Assert that no cell holds a formula.

Compare cell values, never file bytes.

Agent B: once Agent A's tests pass, run the app on http://localhost:5289 and open /PriceList.
Use /browser to upload price-list-oversized.xlsx and price-list-encrypted.xlsx.
Record each browser session.
Attach both recordings and a screenshot of each final page to the Walkthrough.
Text

代理B存在是因为内存中测试服务器不适用Kestrel的限制。 我们通过 WebApplicationFactory 将 32.7 MB 的工作簿发布到该页面的操作版本,它没有请求限制属性,测试接收到状态 200,并附上页面自己的“大于 10 MB”消息。 如果稍后更改下调操作的请求限制,测试会继续通过,而供应商则会收到连接错误,只有浏览器会话显示它。

请注意: 桌面应用协同调度代理同步或异步,因此代理 A 和代理 B 可以作为独立任务运行。 CLI一次接收整个提示。 仅在代理A的测试在同一提交上通过后接受代理B的录音。

在实际运行中这些提示生成了什么?

这七个提示在新的 ASP.NET Core MVC 应用程序中运行在一次 Antigravity CLI 对话中。 /learn 提示在重构和 /goal 检查之后第六次运行。

  • 我们对最终APP的无头Chrome通过匹配了7个工作簿预期结果。 上传版本应用预览了7个中的4个,其中一个是重命名的CSV,没有验证。
  • 每个清理后的下载重新加载后,价格和拒绝表及其计数分别为35/6、12/0、15/0和10/0,任何单元格中无公式且PL-2007描述与供应商键入时完全一样。
  • 应用的发布构建,重新加载检查和测试项目每个完成时无警告,并且xUnit套件7/7通过。
  • 32.7 MB 的上传到达动作并获得了应用程序的大小消息,因为 Quickstart 提示已将两个限制属性设置为 64 MB,并在 Program.cs 中将每个表单的多部分体限制也提高到了 64 MB。
  • 在代理自己的首次 /browser 通过中,所有 7 行在不改变代码的情况下通过。 代理通过它写的Puppeteer脚本进行这些上传和截图,而启动的Chrome子代理没有上传任何内容。 截图保留在Antigravity的文物文件夹中,而不是存储库。
  • 重构后,导入器按参数名称捕获ArgumentNullException,SecurityException和FileLoadException,并将LicensingException留给错误页。
  • 我们扫描未在任何存储库文件、git对象或Antigravity记录中找到许可密钥。
  • 有些步骤与页面中的运行不一样。 Quickstart 提示已经用文本格式写入描述单元格,所以没有校准失败显示,/goal 重新加载在第一次检查中通过。 目标在无头 agy -p 上完成,回复末尾有一个目标完成标记。 Quickstart计划和代码在同一轮中到达,而重构提示在我们批准其计划后停止。
  • /learn 没有写入规则文件。它产生了一个学习建议 Artifact,带有 trigger: glob 和 globs 值,写为三种模式的 YAML 列表,然后等待批准。
  • 一个代理做了双代理提示的两部分,并且其录音在7对7测试通过后于同一提交上。 每个测试方法都将其文件的预期值硬编码而不是读取 expected.csv。

Antigravity 的版本、模型和时序,加上测试机器,列在中心的运行记录中。


故障排除


有问题吗?

如果您有任何问题,请联系support@ironsoftware.com

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

阅读更多

准备开始了吗?

NuGet 下载量 2,393,101版本:2026.11刚刚发布