# Perplexity Research

> 当需要外部检索/最新信息/事实核查/对比资料时，强制使用 Perplexity MCP（perplexity_search 优先，必要时 perplexity_research，超时降级，必须引用与脱敏）。

- Skill: `wangmengguo/perplexity-research` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wangmengguo/perplexity-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wangmengguo/perplexity-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wangmengguo (https://skillmd.com/u/wangmengguo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wangmengguo/perplexity-research

---


# Perplexity Research（全局 SOP）

## 目标
在需要外部信息时，调用 Perplexity 完成检索，并以"稳定、可追溯、可控外发"为优先级。

## 实现方式（按优先级）

### 方式 1：直接 API 调用（推荐，无进程泄漏）
使用 Bash 工具调用脚本：
```bash
~/.config/opencode/scripts/perplexity-search.sh "你的问题"
```

**优点**：
- 无常驻进程，用完即退出
- 无 MCP 进程泄漏问题
- 更快的响应时间

**模型选择**（通过环境变量）：
- `sonar`：快速搜索（默认）
- `sonar-pro`：更强大的搜索
- `sonar-reasoning`：深度推理

示例：
```bash
PERPLEXITY_MODEL=sonar-pro ~/.config/opencode/scripts/perplexity-search.sh "最新的AI发展"
```

### 方式 2：MCP 工具（备用，需启用 MCP）
若 MCP 已启用，可使用以下工具：
- `perplexity_search`：快速搜索（推荐默认入口）
- `perplexity_ask`：轻量问答（适合快速总结）
- `perplexity_research`：深度研究（更慢、更容易超时）
- `perplexity_reason`：偏推理/分析

**注意**：MCP 方式存在进程泄漏风险，建议优先使用方式 1。

## 触发条件（必须启用本 Skill）
出现以下任意意图时，必须走本流程：
- "帮我搜/检索/查一下/找资料/找来源/给链接/核实事实"
- "最新/近期/截至今天/最近更新/新闻/发布公告"
- "对比评测/竞品分析/多来源综合"

## 禁止外发与脱敏（硬性约束）
- 绝不将以下内容直接发给 Perplexity：API Key、token、密码、私有代码片段、客户数据、内部域名/内网 URL。
- 如果用户问题可能包含敏感信息：
  1) 先提示"将发生外部检索/可能外发内容"
  2) 提供脱敏版本的 query（用占位符替换敏感字段）
  3) 取得用户确认后再检索

## 标准流程

### Step 1：默认使用脚本调用
首次检索一律使用脚本获取结果：
```bash
~/.config/opencode/scripts/perplexity-search.sh "问题"
```

### Step 2：仅在必要时升级到深度搜索
只有在满足任意条件时才使用 `sonar-pro` 或 `sonar-reasoning`：
- 用户明确要求"深度报告/全面调研/带引用的长综述"
- 普通搜索结果过碎，无法回答核心问题

升级前必须"缩小问题规模"（降低超时概率）：
- 把问题拆成 1–3 个子问题分别搜索（不要一把梭）
- 限制输出：要求要点式（例如 ≤ 6 条）
- 限定范围：时间窗口/产品版本/地区/特定站点

### Step 3：超时/失败自动降级
如果深度搜索超时或报错：
- 立即退回普通搜索
- 基于 3 个最相关来源给出结论
- 明确告知用户"深度搜索超时，已降级到普通搜索"

## 输出规范（强制）
- 结论：1–3 句
- 证据与来源：每条关键结论给出 URL；时效性信息注明日期/时间窗口
- 不确定性：当来源冲突或证据不足时必须说明