SuperAPI AI 工具集

testing-procedures

测试与质量

查看项目

更新于 10-15 17:24

技能介绍

用途:本技能为 Kalahari 项目提供测试流程指引,用于运行测试并分析结果。

构建命令:Windows 使用 scripts/build_windows.bat Debug,Linux 使用 scripts/build_linux.sh。明确禁止直接运行 cmake,禁止用 WSL 进行 Windows 构建。

测试执行:Windows 执行 ./build-windows/bin/kalahari-tests.exe;Linux 执行 ./build-linux/bin/kalahari-tests。测试框架为 Catch2 v3,采用 BDD 风格,测试文件位于 tests/。

结果解读:输出逐条标记 [PASS] TestName 或 [FAIL] TestName - expected X, got Y,并给出汇总,例如 All tests passed,或列出 test cases 与 assertions 的通过、失败数。

需要检查的要点:实现后确认现有测试是否仍通过、是否出现回归、是否为新增功能补充测试;覆盖率方面关注核心业务逻辑、边界情况与错误处理是否被测试。

手动测试:在需要时用于 UI 变更(视觉确认)、用户交互流程、主题切换、面板缩放与停靠。步骤为先运行应用 ./build-windows/bin/kalahari.exe,再测试特定功能、确认外观、检查响应性。

结果报告:通过时输出 decision 为 pass、tests 与 summary;失败时输出 decision 为 fail、tests、failures 列表与 summary。

常见问题排查:构建失败时检查 CMake 输出、vcpkg 依赖与缺失的 include;测试失败时仔细阅读失败信息、确认测试假设是否仍成立、核对测试数据与 fixture;不稳定测试检查时序依赖、测试间共享状态与测试隔离。