用途：指导把传统搜索 API（Google Custom Search、Bing、SerpAPI）或旧版 LLM 迁移到 Perplexity Sonar。核心优势是 Sonar 在一次 API 调用中同时完成搜索与 LLM 摘要，替代原先“搜索取原始结果 + 另调 LLM 总结 + 手动提取引用”的多步管线。
主要能力：提供迁移对比（返回内容、答案生成、引用处理、计费结构、时效过滤 search_recency_filter、域名过滤 search_domain_filter）；用 grep 命令评估现有集成点；构建统一 SearchAdapter 接口，分别实现 GoogleSearchAdapter 与 PerplexitySearchAdapter；用 PERPLEXITY_TRAFFIC_PERCENT 环境变量做特性开关流量切分（10%→50%→100%）；对比新旧结果的引用域名重合度；迁移后简化为单次调用。
使用方式：先运行 grep 定位旧搜索 API 调用并统计集成点数量；再实现适配器层，Perplexity 侧用 OpenAI 客户端指向 https://api.perplexity.ai，模型为 sonar，密钥读 PERPLEXITY_API_KEY；随后按周逐步提高流量百分比，最后移除旧适配器。回滚可将流量设为 0%。
适用场景：需要从多步搜索+摘要管线收敛为单 API 架构、并希望灰度切换与质量验证的项目。
限制与注意：引用格式差异需在适配器内归一化；Perplexity 返回合成答案，原始结果需依赖 search_results 字段；因同时做搜索与合成，延迟可能更高，建议缓存；token 消耗可能带来成本上升，可将简单查询路由到 sonar 并限制 max_tokens。资料未提供具体价格、平台支持范围与完整错误码说明。