SuperAPI AI 工具集

seo-performance

通用与其它

查看项目

更新于 10-15 16:43

技能介绍

用途:用于完整审计中的性能子轨道,聚焦页面性能测量与报告输出。

主要能力:优先采用 PageSpeed Insights / CrUX 的真实用户 CWV 数据;若不可用则回退到 Lighthouse 实验室数据并明确标注。检查项包括 Lighthouse 性能分(尽可能含移动端与桌面端)、LCP、CLS;INP 仅在数据源确实提供时报告,禁止由 TBT 推断或编造 INP,INP 不可用时可将 TBT 作为实验室代理指标。优先级:性能分 < 70 或 LCP > 2500ms 或 INP > 200ms 或 CLS > 0.1 为 High;70-79 为 Medium;数据源限制为 Low。

使用方式:输入为 URL、超时、可选的 PageSpeed API key(PAGESPEED_API_KEY)。在 API/无头环境中优先运行 scripts/analyze_performance.py 进行确定性分析;有 PageSpeed 数据时使用该数据,否则回退到已标注的启发式方法,使流程无需人工介入即可完成。运行前可检查 .seo-cache/ 中的共享缓存;本专项不要求上游缓存输入;用户说 refresh 或 re-run 时忽略缓存。完成后写入共享数据缓存:mkdir -p .seo-cache/pages/{url-slug},按 ../seo/references/shared-data-cache.md 的 schema 写入 .seo-cache/pages/{url-slug}/performance.json,至少匹配 core_web_vitals 与 issues 键;并将 .seo-cache/ 加入 .gitignore:grep -qxF '.seo-cache/' .gitignore 2>/dev/null || echo '.seo-cache/' >> .gitignore。

输出:PERFORMANCE-AUDIT-REPORT.md、SUMMARY.json;若用户要求 client report 或 premium deliverable,读取 ../seo-audit/assets/report-template.html 与 ../seo/references/premium-report-standard.md,先生成 HTML 作为内部中间产物,再产出 PDF 作为公开交付物,最终回复只提 PDF(除非用户明确要求 HTML)。

限制:API 数据不可用、配额受限或未认证时需按回退指引处理;不编造 INP;具体模板内容与缓存 schema 细节需参考对应引用文件。