SuperAPI AI 工具集

update-test-snapshots

测试与质量

查看项目

更新于 10-16 02:39

技能介绍

用途:在有意修改 Markdown 输出后,重新生成所有测试快照(golden file)基线,更新快照测试所比对的预期输出。

使用方式:必须使用稳定包装脚本 scripts/update-test-snapshots.sh。该脚本会自动删除旧快照、运行测试、校验并统计生成结果。示例输出显示它会删除并在 src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/ 下重新生成 6 个快照文件,随后再次运行测试验证全部通过。

更新范围:src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/ 下的全面演示输出、汇总模板输出、含转义的边界用例、角色分配渲染、防火墙规则语义差异、多模块计划输出等快照文件。

适用场景:有意修改 Markdown 渲染逻辑(C# 渲染器)、更改格式化规则(值转义、表格格式等)、新增快照测试,或快照测试因预期变更而失败时。

限制与要求:禁止手动复制文件更新快照;不得在未理解变更原因的情况下更新;运行前需先确认新输出正确;提交前必须审查快照差异。脚本仅修改测试快照文件,不涉及生产代码。运行后建议用 scripts/git-diff.sh 审查差异,确认符合预期后再执行 git add 与 git commit。