基于 Perplexity API 的三模式 AI 搜索工具，支持智能问答、精准检索与深度研究，输出经安全边界隔离处理，适合自动化工作流。
说明：
## 核心用法
`perplexity_wrapped` 是一个集成 Perplexity 三大 API 的搜索工具，通过 Node.js 脚本提供命令行调用能力。
**三大模式：**
1. **Sonar API（默认）**：AI 生成带引用的自然语言答案，适合快速获取解释、摘要或分析。包含从轻量 `sonar`（~$0.01）到 `sonar-deep-research`（~$0.40-1.30）的多档模型。
2. **Search API**：返回排序的网页结果（标题、URL、摘要），支持批量查询，成本固定 ~$0.005，适合精准溯源。
3. **Agentic Research API**：调用第三方模型（OpenAI、Anthropic、Google、xAI）并配备 `web_search`/`fetch_url` 工具，支持结构化输出与 reasoning 控制，适合复杂研究任务。
**关键特性：**
– 所有输出默认包裹在 `<<>>` 安全边界内，防止提示注入
– 成本敏感操作（如 Deep Research）需显式 `–yes` 确认
– 支持 1Password CLI 集成管理 API 密钥
## 显著优点
– **安全设计优先**：强制内容隔离边界、全角 Unicode 净化、明确来源标记，降低 agent 场景下的注入风险
– **成本分层清晰**：从 $0.005 的精准搜索到 $1+ 的深度研究，用户可按需选择
– **模型生态丰富**：Sonar 系列 + 10+ 第三方模型，覆盖速度、成本、质量全谱系
– **Agentic 模式灵活**：支持自定义 system instructions、reasoning effort 调节、工具调用追踪
## 潜在缺点与局限性
– **单次调用限制**：Sonar 与 Agentic API 不支持批量查询（仅 Search API 支持）
– **成本陷阱**：`sonar-deep-research` 单次可达 $1.30，需严格管控 `–yes` 使用
– **依赖 Node.js 环境**：相比纯 shell 方案增加部署复杂度
– **第三方模型成本波动**：Agentic 模式按 token + 工具调用计费，复杂查询成本不可预测
## 适合人群
– 需要**可信来源背书**的 AI 问答场景（Sonar 的引用机制）
– 自动化工作流中需**安全隔离外部内容**的开发者
– 研究人员进行**多源对比分析**（Agentic 的多工具调用）
– 对 API 成本敏感、需要**精细预算控制**的团队
## 常规风险
| 风险类型 | 说明 | 缓解措施 |
|———|——|———|
| 成本失控 | Deep Research 或高频 Agentic 调用产生意外账单 | 启用 `–yes` 门控，监控 dashboard |
| 提示注入 | 恶意网页内容通过搜索结果污染上下文 | 依赖默认的 untrusted-content 边界隔离 |
| API 密钥泄露 | 配置不当导致密钥暴露 | 使用 1Password CLI 或环境变量隔离 |
| 模型可用性 | 第三方模型（如 GPT-4o）可能被 Perplexity 弃用 | 关注版本更新，使用默认推荐模型 |
会员专属
