| 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。
- 如果用户问题可能包含敏感信息:
- 先提示"将发生外部检索/可能外发内容"
- 提供脱敏版本的 query(用占位符替换敏感字段)
- 取得用户确认后再检索
标准流程
Step 1:默认使用脚本调用
首次检索一律使用脚本获取结果:
~/.config/opencode/scripts/perplexity-search.sh "问题"
Step 2:仅在必要时升级到深度搜索
只有在满足任意条件时才使用 sonar-pro 或 sonar-reasoning:
- 用户明确要求"深度报告/全面调研/带引用的长综述"
- 普通搜索结果过碎,无法回答核心问题
升级前必须"缩小问题规模"(降低超时概率):
- 把问题拆成 1–3 个子问题分别搜索(不要一把梭)
- 限制输出:要求要点式(例如 ≤ 6 条)
- 限定范围:时间窗口/产品版本/地区/特定站点
Step 3:超时/失败自动降级
如果深度搜索超时或报错:
- 立即退回普通搜索
- 基于 3 个最相关来源给出结论
- 明确告知用户"深度搜索超时,已降级到普通搜索"
输出规范(强制)
- 结论:1–3 句
- 证据与来源:每条关键结论给出 URL;时效性信息注明日期/时间窗口
- 不确定性:当来源冲突或证据不足时必须说明