Perplexity AI 搜索（安全版）

概述

本技能提供对 Perplexity API 的访问能力，支持基于网页内容的 AI 搜索。它将大语言模型与实时网络搜索相结合，可返回准确、最新且附带来源引用的答案。

这是经过安全加固的版本，修复了原始 perplexity-bash 技能中存在的命令注入漏洞。

何时使用 Perplexity vs. 内置搜索

建议使用 Perplexity 的场景：

• 需要获取最新信息（如新闻、价格、事件、近期进展）
• 用户明确要求提供来源引用或参考文献
• 用户特别提及 Perplexity，或期望获得研究风格的回答

建议使用内置网络搜索的场景：

• 简单事实类查询
• 快速信息检索
• 基础 URL 或内容获取

模型选择指南

快速入门

基础搜索

# 简单查询（默认使用 sonar 模型）
scripts/perplexity_search.sh "德国的首都是什么？"

# 指定其他模型
scripts/perplexity_search.sh -m sonar-pro "最新的 AI 发展动态"

# 以 Markdown 格式输出并包含引用
scripts/perplexity_search.sh -f markdown "特斯拉股票分析"

高级用法

# 高上下文模式，获取更全面的结果
scripts/perplexity_search.sh -m sonar-reasoning -c high -f markdown 
  "对比各类 AI 模型的性能基准测试"

# 自定义系统提示词
scripts/perplexity_search.sh -s "你是一位科技分析师。" 
  "分析当前科技趋势"

选项说明

搜索上下文大小说明

• low — 响应更快，引用来源更少，适合简单查询。
• medium（默认）— 平衡性最佳，适用于大多数场景。
• high — 最全面的搜索结果，适用于深度研究任务。

配置要求

API 密钥配置

方式一：配置文件（推荐）
在技能目录下创建 config.json 文件：

{
  "apiKey": "pplx-your-key-here"
}

方式二：环境变量

export PERPLEXITY_API_KEY="your-key-here"

优先级：配置文件 > 环境变量。

依赖项

• bash（4.0+）
• curl
• python3（仅用于 JSON 构建 — 不会对用户输入执行 eval）

安全说明

本版本已修复原始版本中发现的以下安全漏洞：

1. 杜绝命令注入 — 用户输入通过环境变量传入 Python，绝不会被拼接到代码字符串中进行插值
2. 输入校验 — 所有参数均经过严格校验（包括数值范围、允许的模型名称、允许的上下文值等）
3. API 密钥保护 — Authorization 请求头通过临时配置文件（curl -K，权限设为 600）传递给 curl；请求体则通过标准输入（--data @-）传入。因此，API 密钥和请求体均不会出现在进程列表（ps aux）中
4. 查询长度限制 — 查询文本上限设为 8000 字符，防止“拒绝钱包”（denial-of-wallet）攻击
5. 严格模型白名单 — 仅接受已知有效的模型名称

费用意识提醒

Perplexity API 并非免费服务，请合理控制调用量：

• 简单查询：每次约 $0.005–$0.015
• 深度研究查询：每次约 $0.015–$0.03+（甚至更高）
• 绝大多数查询请默认使用 sonar 模型，以控制成本。

故障排查

• 错误：未找到 API 密钥 — 请按上述说明完成 API 密钥配置
• 错误：未找到 curl — 请为您的系统安装 curl
• 错误：模型无效 — 使用 --list-models 查看当前支持的模型列表