用途：该技能提供一个小型 CLI（pplx_research.py，仅用 Python 标准库），直接向 Perplexity HTTP API 发送请求并设置较长的客户端超时，从而让深度研究任务跑完，而不是在 MCP 约 5 分钟上限处失败。
何时使用：快速事实、摘要、单个问题（几秒）用 perplexity MCP（perplexity_ask）最简单；深度／多来源研究、预期超过 5 分钟，或 MCP 调用已超时，则用本技能的 sonar-deep-research。
前提条件：环境中需有 PERPLEXITY_API_KEY，CLI 直接读取，无需额外配置；需要 python3，仅用标准库，无需安装其他依赖。
用法：CLI 位于技能文件夹中，技能安装到 ~/.agents/skills/perplexity-deep-research/，并符号链接到 ~/.claude/skills/。 python3 ~/.agents/skills/perplexity-deep-research/pplx_research.py "Survey the current state of X, with sources" 也可先 cd 进技能文件夹再直接调用。快速／低成本调用：python3 pplx_research.py --model sonar "what is the capital of France?"。更长时间并偏向近期来源：python3 pplx_research.py --timeout 2400 --recency month "what changed recently in Y?"。原始 JSON：python3 pplx_research.py --json "..."。
选项：位置参数 prompt 为研究问题；--model 默认 sonar-deep-research，可选 sonar、sonar-pro、sonar-deep-research；--timeout 默认 1800 秒（这是突破 MCP 约 5 分钟上限的关键）；--system 可选系统提示；--recency 可选 hour/day/week/month/year；--json 默认关闭，开启则输出原始 API 响应。
输出：格式化模式把答案打印到 stdout，随后是 Citations: 来源 URL 列表；模型与成本输出到 stderr，保持 stdout 干净可管道。退出码：0 成功，1 API／网络错误，2 缺少 PERPLEXITY_API_KEY。
限制与注意：sonar-reasoning 已弃用（API 返回 HTTP 400），不要使用；sonar-deep-research 成本更高且耗时数分钟，便宜的快速检查请用 sonar；这是原型，为同步调用加长超时，没有异步轮询，也没有重试。