perplexity-research

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

Perplexity Research（全局 SOP）

目标

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

实现方式（按优先级）

方式 1：直接 API 调用（推荐，无进程泄漏）

使用 Bash 工具调用脚本：

~/.config/opencode/scripts/perplexity-search.sh "你的问题"

优点：

• 无常驻进程，用完即退出
• 无 MCP 进程泄漏问题
• 更快的响应时间

模型选择（通过环境变量）：

• sonar：快速搜索（默认）
• sonar-pro：更强大的搜索
• sonar-reasoning：深度推理

示例：

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：默认使用脚本调用

首次检索一律使用脚本获取结果：

~/.config/opencode/scripts/perplexity-search.sh "问题"

Step 2：仅在必要时升级到深度搜索

只有在满足任意条件时才使用 sonar-pro 或 sonar-reasoning：

• 用户明确要求"深度报告/全面调研/带引用的长综述"
• 普通搜索结果过碎，无法回答核心问题

升级前必须"缩小问题规模"（降低超时概率）：

• 把问题拆成 1–3 个子问题分别搜索（不要一把梭）
• 限制输出：要求要点式（例如 ≤ 6 条）
• 限定范围：时间窗口/产品版本/地区/特定站点

Step 3：超时/失败自动降级

如果深度搜索超时或报错：

• 立即退回普通搜索
• 基于 3 个最相关来源给出结论
• 明确告知用户"深度搜索超时，已降级到普通搜索"

输出规范（强制）

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