api-report-generator

name api-report-generator description 接口自动化测试智能报告生成专家。将执行结果、诊断结论和历史数据转化为多维度、可视化、可驱动决策的专业HTML测试报告，集成Allure报告跳转入口实现双报告联动。支持手动调用和上下游技能联动调用（api-test-executor、api-failure-diagnoser、api-testdata-cleaner）。当用户提到生成测试报告、生成报告、测试报告、HTML报告、报告汇总、测试总结、查看报告、report时触发。 agent_created true api-report-generator — 接口自动化测试智能报告生成专家 概述 将接口测试执行结果、诊断结论和历史数据转化为多维度、可视化、可驱动决策的专业HTML测试报告。集成Allure报告跳转入口，实现双报告联动。 核心能力： 多源数据聚合：对接 api-test-executor 执行结果、api-failure-diagnoser 诊断结论、api-testdata-cleaner 清理记录 可视化报告：专业HTML报告，含数据图表（饼图/柱状图/折线图）、模块统计、趋势分析 智能分析：风险分级、高频失败接口识别、优化建议生成 Allure联动：自动检索本地Allure报告，嵌入跳转入口 明确不做： 测试执行、脚本修复、数据清理、环境部署。 触发条件 当用户表述包含以下意图时触发： "生成测试报告" / "生成报告" / "出个报告" "测试报告" / "HTML报告" / "报告汇总" "测试总结" / "查看报告" / "report" "帮我生成接口测试报告" / "分析一下执行结果" 上游技能（api-test-executor、api-failure-diagnoser、api-testdata-cleaner）联动调用 输入参数 参数 类型 必填 说明 exec_data_path string 是 测试执行结果文件路径（如 execution_results.json） allure_report_path string 否 Allure报告目录路径，为空则自动检索 report_save_path string 否 HTML报告输出目录，默认 ./reports/custom_report report_title string 否 报告标题，默认「接口自动化测试报告」 show_chart bool 否 是否展示数据图表，默认 true auto_link_allure bool 否 是否添加Allure跳转链接，默认 true auto_trigger bool 否 是否为上游技能自动联动调用，默认 false 前置条件 exec_data_path 指向的执行结果文件必须存在 可选关联数据：诊断报告（failure_diagnoser输出）、清理记录（cleaner输出）、历史趋势数据 若需Allure联动，需确认Allure服务已启动或报告目录存在 工作流 Step 1: 数据加载与校验 读取 exec_data_path 指向的执行结果文件 校验数据完整性（必须包含：total_cases、passed、failed、时间信息） 若数据缺失，标记异常，继续生成基础报告框架 加载可选关联数据： 诊断报告： reports/diagnose_report_*.md 或 reports/diagnose_*.json 清理记录： reports/clean_report_*.md 历史趋势： reports/execution_results.json （多次执行记录） Step 2: Allure 报告自动生成与启动 若 allure_report_path 已提供，直接使用 否则自动执行以下流程： a. 清理旧数据 ：清空 allure-results/ 和 allure-report/ 目录 b. 执行测试生成 allure 数据 ：运行 python3 -m pytest {测试命令} --alluredir=reports/allure-results --clean-alluredir ，从执行结果的 scope/filters 参数推断 pytest 命令（如 -m p0 ） c. 生成 Allure 报告 ：运行 allure generate reports/allure-results -o reports/allure-report --clean d. 启动 Allure 服务 ：在未被占用的端口（优先 8088）运行 allure open reports/allure-report -p {port} ，后台启动 检测 Allure 服务是否启动成功（ curl -s -o /dev/null -w "%{http_code}" http://localhost:{port} ） 将 Allure 报告 URL（如 http://localhost:8088 ）嵌入 HTML 报告的跳转按钮 若 Allure CLI 未安装或生成失败，标记按钮为灰色 disabled，页面提示安装方式 Step 3: 数据分析与计算 基础统计 ：通过率、失败率、平均耗时、执行时长 模块统计 ：按 module 标签分组统计各模块通过率、失败数、平均耗时 优先级统计 ：按 P0/P1/P2/P3 分级统计 趋势数据 ：对比历史执行结果（最近10次），计算通过率趋势 风险分析 ： 高风险模块：通过率低于 70% 的模块 高频失败接口：多次执行持续失败的用例 Flaky测试：时而通过时而失败的用例 覆盖率缺口：模块无测试覆盖的情况 优化建议 ：基于失败模式生成脚本重构、断言调整、场景补充、环境优化建议 Step 4: HTML 报告生成 按照 references/report_template_spec.md 规范生成HTML报告。 页面分区（固定模块） 报告头部 ：标题、执行环境、执行时间、报告生成时间 总览大盘 ：总用例数、成功/失败/跳过数、通过率、平均响应耗时 趋势图表 ：多次执行通过率折线图、接口耗时趋势 模块统计 ：按业务模块展示饼图/柱状图，统计通过率、失败率、平均耗时 用例明细 ：列表展示所有用例（名称、接口路径、状态、响应时间、标签），支持筛选和分页 故障详情 ：失败用例分区展示（报错信息、AI诊断根因、修复建议），按P0优先 数据清理记录 ：本次测试后清理执行结果（清理数量、异常信息） 风险分级 ：高/中/低风险模块标识，高频失败接口，flaky测试 优化建议 ：脚本重构/断言调整/场景补充/环境优化，按优先级排序 Allure跳转 ：固定位置「打开Allure原生报告」按钮，新标签页跳转 底部备注 ：版本、技能标识、运维备注 UI/UX 规范 详见 references/report_template_spec.md Step 5: 文件输出 输出路径： report_save_path/接口测试报告_{时间戳}.html 配套资源（CSS/JS/图表）内联到HTML中，生成单文件可独立打开 图表使用 CDN 加载 Chart.js（需联网），同时提供离线降级方案 Step 6: 结果输出 { "status" : "success" , "custom_report_path" : "/path/to/接口测试报告_20260611_153000.html" , "allure_report_url" : "http://localhost:8080" , "report_create_time" : "2026-06-11 15:30:00" , "total_statistics" : { "total" : 83 , "passed" : 77 , "failed" : 0 , "skipped" : 1 , "pass_rate" : "97.5%" } , "error_info" : "" } 联动调用规范 被上游技能调用 请调用 api-report-generator，参数如下： - exec_data_path: /path/to/execution_results.json - auto_trigger: true 典型联动场景 api-test-executor 执行完毕 → 自动调用生成报告 api-failure-diagnoser 修复完毕 → 调用生成含诊断结论的报告 api-testdata-cleaner 清理完毕 → 调用生成含清理记录的报告 约束规则 单文件输出 ：HTML报告内联所有CSS/JS/图表数据，可独立打开 浏览器兼容 ：兼容 Chrome、Edge、Firefox 主流浏览器 数据安全 ：报告内不泄露敏感账号、密钥、生产数据 容错性 ：原始数据缺失时保留页面框架，对应模块标注「暂无数据」 联动一致 ：自动触发与手动调用的报告格式、路径规则保持一致 文件命名 ：报告文件名含项目名、时间戳，避免覆盖 图表降级 ：网络不可用时图表区域显示数据表格替代