用途：这是一个最小可运行的 Perplexity Sonar 搜索示例，用于演示 Perplexity 的核心能力——每次查询都会联网检索并返回带引用的答案，区别于普通大模型。适合在新建 Perplexity 集成、测试环境或学习基础用法时使用。
前提条件：需先完成 perplexity-install-auth 配置，安装 openai 包，并设置环境变量 PERPLEXITY_API_KEY。
主要能力：示例覆盖四步。第一步用 TypeScript 发起基础搜索，通过 OpenAI 客户端把 baseURL 指向 https://api.perplexity.ai，模型使用 sonar，从 response.choices[0].message.content 取答案，引用以响应顶层 citations 数组返回，并打印 token 用量。第二步给出等价的 Python 写法，用 response.model_dump() 读取 citations。第三步演示域名过滤，通过 search_domain_filter 限定搜索域名，并用 search_recency_filter 控制时效。第四步演示流式搜索，stream 设为 true，引用在最后一个 chunk 中到达。
输出与错误处理：正常输出包括联网回答、解析出的引用 URL 和 token 用量。常见错误有 401（API 密钥无效）、citations 为空（问题过于抽象，应提具体事实性问题）、429（超出速率限制，需退避重试）、超时（复杂查询可改用 sonar 而非 sonar-pro）。
限制与注意：示例建议使用开发范围密钥和固定公开事实性问题，设置较小 token 上限，只打印答案摘要、引用 URL 和汇总用量；确认引用可解析后再信任答案。不要使用客户数据或生产密钥，学习结束后应吊销临时密钥并清理本地配置。资料未提供价格、平台支持范围等更多信息。