核心用法
AEO（AI-Engine Optimization）是一款面向生成式搜索时代的站点审计工具，通过 npx @ainyc/aeo-audit@1 运行。核心工作流分为 audit（诊断）、fix（修复）、schema（结构化数据校验）、llms（AI 可读文件生成）、monitor（持续监控） 五大模式，默认执行 audit。
Audit 模式支持单页或整站（--sitemap）扫描，输出 JSON、Markdown 或精简的 agent 格式。关键能力包括：
- 关键缺陷检测：独立于评分体系的硬性错误（如 h1 数量不为 1、缺失 title/description），即使整体分数合格也会强制暴露
- 变更页审计：
--changed --base main仅扫描 PR 中改动的静态路由，配合--rewrite-sitemap-origin可在本地/预览环境审计生产域名硬编码的 sitemap - 静态构建门禁：直接审计
./out等构建产物目录，--require-meta可在 CI 中拦截缺失 meta description 的部署 - 回归对比：
compare子命令对比两次 audit 报告，以 exit code 1/2 实现 CI 门禁
Schema 模式专用于 JSON-LD 校验，自动识别重复单例类型（如每页只能有一个 FAQPage）、属性缺失及实体不一致问题。
llms 模式生成或优化 llms.txt 与 llms-full.txt，并检测内容协商陷阱（部分框架对 Accept: text/markdown 返回 307 导致 AI 工具无法抓取）。
显著优点
1. 生成式搜索优先：除传统 SEO 因素外，专门评分 AI 可读文件（llms.txt）、代理技能暴露（agent skills）、地理信号等新兴因子
2. CI/CD 原生设计：--format json + compare + --require-meta 提供可编程的回归门禁，exit code 语义清晰（0=通过，1=回归，2=配置错误）
3. 预览工作流友好：--rewrite-sitemap-origin、--allow-local、--changed 三联组合解决本地/分支预览审计的域名映射与范围控制难题
4. 安全默认：默认阻断 SSRF 风险（私有/回环地址），需显式 --allow-local 放行
5. 稳定标识体系：所有发现项（critical defects、fixes、factors）均携带机器可读 ID，便于集成系统长期追踪
潜在局限
- Lighthouse 限制：
--lighthouse依赖 Google PageSpeed Insights，单 URL 耗时 15-30s，无法与--sitemap联用 - 动态路由盲区：
--changed基于静态文件差异，无法自动推断动态路由参数，需手动通过--critical-paths补充 - 静态模式信号缺失：离线审计无法检测服务器端信号（redirect、X-Robots-Tag、Last-Modified 等）
- Node 依赖：需 Node.js 环境运行 npx，非纯容器/无网络场景受限
适合人群
- 技术 SEO 工程师：需将 AEO/GEO（Generative Engine Optimization）纳入 CI 流水线
- 前端开发者：在 Next.js/Nuxt 等框架的预览部署阶段拦截可索引性缺陷
- 内容运营：生成并维护 llms.txt 以提升 AI 搜索引用率
- 竞品分析师：
--detect-platform批量识别技术栈，monitor模式追踪对手评分变化
常规风险
- SSRF 误配置：
--allow-local放行后若目标存在开放重定向至内网 metadata 服务（如 169.254.169.254），可能导致凭证泄露；工具虽按 hop 评估但仍需用户确认审计意图 - 生产流量冲击：
--sitemap默认并发 5，大规模站点仍需--limit管控，避免对源站造成压力 - 误报修复：
fix模式会修改源码，虽要求用户确认，但自动化的 schema 注入可能与既有结构冲突，建议在分支环境验证