用途：为 SaaS 平台加入 AI 分析能力，包括自然语言查询（NL2SQL）、基于嵌入的语义搜索、AI 生成洞察（周期摘要、异常告警、趋势对比）。适用于需要可复用判断、领域约束或成熟工作流的任务；不适用于与 AI 分析无关或只需简单回答的场景。
主要能力：NL2SQL 将自然语言问题转为 SQL 并执行；语义搜索按含义而非精确关键词查找记录；AI 洞察生成周期摘要与异常检测（如超过均值 2 个标准差的日子）。架构含输入守卫、意图路由、Schema 上下文、LLM/嵌入 API、输出守卫、结果格式化。
使用方式：先读 SKILL.md，再按需加载引用文件。NL2SQL 需注入与租户相关的 Schema，要求仅输出 SELECT、必须包含 franchise_id 过滤，并用只读数据库用户执行。嵌入存储于 tbl_embeddings，按 franchise_id 隔离；大规模数据建议使用 pgvector、Pinecone 或 Weaviate。洞察缓存到 tbl_ai_insights_cache 并设置过期时间。
限制与安全：AI 分析为付费附加模块，需通过 requireModuleAccess('AI_ANALYTICS') 门控，默认关闭；所有令牌通过 ai-saas-billing 模式记录。禁止向 LLM 发送 PII，仅发送聚合指标；用户输入需用分隔符包裹以防提示注入；NL2SQL 输出视为不可信 SQL，必须校验；端点需限流（如每用户每小时 20 次）。
必要命令：CREATE USER 'ai_readonly'@'localhost' IDENTIFIED BY 'strong_password'; GRANT SELECT ON saas_db.* TO 'ai_readonly'@'localhost';