Perplexity Wrapped Search

核心用法

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 控制，适合复杂研究任务。

关键特性：

• 所有输出默认包裹在 <<<EXTERNAL_UNTRUSTED_CONTENT>>> 安全边界内，防止提示注入
• 成本敏感操作（如 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 弃用 | 关注版本更新，使用默认推荐模型 |

核心用法

perplexity_wrapped 是一款集成 Perplexity AI 搜索能力的命令行工具，支持三种互补的搜索模式：

| 模式 | 特点 | 成本 | 适用场景 |

|------|------|------|----------|

| **Sonar API**（默认）| AI 生成回答 + 引用来源 | ~$0.01/query | 自然语言问答、快速信息获取 |

| **Search API** | 排名搜索结果列表 | ~$0.005/query | 查找具体来源、批量查询 |

| **Agentic Research** | 第三方大模型 + 工具调用 | ~$0.006-0.02/query | 复杂分析、多步骤推理 |

快速开始

# 默认模式：AI 回答 + 引用
node {baseDir}/scripts/search.mjs "AI 领域最新动态"

# 搜索模式：获取排名结果
node {baseDir}/scripts/search.mjs "latest news" --mode search

# 深度研究（需确认，高成本 ~$0.40-1.30）
node {baseDir}/scripts/search.mjs "量子计算对比" --deep --yes

显著优点

1. 安全防护完善：首创 <<<EXTERNAL_UNTRUSTED_CONTENT>>> 边界包装机制，配合全角字符折叠防御，有效防止提示词注入攻击，特别适合 Agent 自动化场景。

2. 成本控制精细：提供清晰的成本估算表，Deep Research 等高价模式强制要求 --yes 确认，防止意外消费。

3. 多模型支持：Agentic 模式支持 OpenAI、Anthropic、Google、xAI 等 11 种第三方模型，可按需选择性价比最优方案。

4. 无外部依赖：仅使用 Node.js 内置模块，无第三方依赖风险。

潜在局限

• 单查询限制：Sonar 和 Agentic 模式不支持批量查询，每次调用仅处理单个问题
• 网络依赖：完全依赖 Perplexity API 可用性，无离线能力
• 数据外泄：搜索内容需传输至 Perplexity 服务器，不适合处理机密信息
• T3 来源等级：由个人开发者维护，非知名机构背书

适合人群

• 需要安全、可溯源 AI 搜索的自动化工作流开发者
• 研究人员、分析师、内容创作者等需要快速获取高质量信息来源的用户
• 注重成本控制的团队（相比直接使用 Claude/ChatGPT 网页版更经济）

常规风险

• 搜索内容被传输至第三方 API，存在数据外泄风险
• 高成本模式（Deep Research）单次查询可达 $1.30，需审慎使用
• 环境变量配置不当导致 API Key 缺失或泄露