parallel-deep-research

深度研究

研究主题：$ARGUMENTS

需要 parallel-cli ≥ 0.3.0。如果以下任何命令报错 no such option、no such command 或 unrecognized arguments，说明用户使用的是旧版 CLI。请告知用户运行 parallel-cli update（如果通过 pipx 安装则运行 pipx upgrade parallel-web-tools），然后重试。

何时使用（与 parallel-web-search 对比）

仅当用户明确要求深度/详尽研究时使用此技能。深度研究比 parallel-web-search 慢 10-100 倍且更昂贵。对于普通的“研究 X”请求、快速查询或事实核查，请改用 parallel-web-search。

步骤 1：启动研究

根据主题选择一个描述性文件名（例如 ai-chip-market-2026、react-vs-vue-comparison）。使用小写字母和连字符，不含空格。在步骤 2 中重复使用此基础名称作为 -o "$FILENAME"。

parallel-cli research run "$ARGUMENTS" --processor pro-fast --text --no-wait --json

--text 标志告诉 API 在任务完成时返回 Markdown 报告（含内联引用），而不是默认的结构化 JSON。对于叙事/报告风格的请求（大多数用户对“深度研究”的期望）使用此标志。如果用户明确要求结构化 JSON 输出，则去掉 --text。

与 --text 一起使用时可选的：传递 --text-description "Keep under 1500 words, focus on M&A activity" 来控制长度、格式或重点。

如果这是对先前研究或丰富任务的后续，并且你知道 interaction_id，则添加上下文链：

parallel-cli research run "$ARGUMENTS" --processor lite-fast --text --no-wait --json --previous-interaction-id "$INTERACTION_ID"

通过在请求之间链接 interaction_id 值，每个后续问题自动拥有先前轮次的完整上下文——因此你可以深入挖掘而无需重复已经研究过的内容。对于后续问题，使用较轻量的处理器（lite-fast 或 base-fast），因为繁重的工作已在初始轮次完成。

此命令立即返回。不要省略 --no-wait——没有它命令会阻塞数分钟并超时。

处理器选项（根据用户请求选择）：

处理器	预期延迟	使用场景
lite-fast	10–60秒	快速查询、后续问题
base-fast	15–100秒	简单问题
core-fast	1–5分钟	中等研究
pro-fast	2–10分钟	默认——探索性研究，深度与速度的良好平衡
ultra-fast	5–25分钟	多源深度研究（约2倍成本）
ultra2x-fast / ultra4x-fast / ultra8x-fast	最多2小时	最难的问题，仅在明确要求时使用

关于 -fast 后缀的说明：-fast 层级使用缓存的网络数据，速度更快。非快速变体（pro、ultra 等）重新获取更新鲜的数据——更慢但更适合非常近期的事件。默认使用 -fast，除非用户特别要求最近一两天的新闻。

运行 parallel-cli research processors 查看完整列表及延迟。

解析 JSON 输出以提取 run_id、interaction_id 和监控 URL。立即告知用户：

• 深度研究已启动
• 所选处理器层级的预期延迟（来自上表）
• 监控 URL，他们可以在此跟踪进度

告知他们可以将轮询步骤置于后台，以便在研究运行时继续工作。

步骤 2：轮询结果

parallel-cli research poll "$RUN_ID" -o "$FILENAME" --timeout 540

重要：

• 使用 --timeout 540（9分钟）以保持在工具执行限制内
• 不要传递 --json——完整输出很大，会淹没上下文。-o 标志将结果写入文件。
• 使用 -o "$FILENAME"：
  • 始终写入 $FILENAME.json（元数据 + 基础信息）
  • 仅当步骤 1 使用了 --text 时才写入 $FILENAME.md（Markdown 报告）
• 轮询命令在研究完成时向标准输出打印执行摘要。与用户分享此执行摘要——它让用户快速了解概览，无需打开文件。
• 如果重新轮询并希望覆盖现有文件，请传递 --force

如果轮询超时

较高级别的处理器可能需要超过9分钟。如果轮询未完成就退出：

1. 告知用户研究仍在服务器端运行
2. 重新运行相同的 parallel-cli research poll 命令以继续等待

响应格式

步骤 1 之后： 分享监控 URL（仅用于跟踪进度——不是最终报告）。

步骤 2 之后：

1. 分享轮询命令打印到标准输出的执行摘要
2. 告知用户生成的文件路径：
   • $FILENAME.md——格式化的 Markdown 报告（如果使用了 --text）
   • $FILENAME.json——元数据和基础信息
3. 分享 interaction_id 并告知用户可以提出基于此研究的后续问题（例如，“深入挖掘 X”或“与 Y 比较”）

完成后不要再次分享监控 URL——结果在文件中，不在该链接。

询问用户是否希望阅读文件以获取更多细节。除非用户要求，否则不要将文件内容读入上下文。

记住 interaction_id——如果用户提出与此研究相关的后续问题，请在下一个研究或丰富命令中将其用作 --previous-interaction-id。

设置

如果找不到 parallel-cli，请安装并认证：

/parallel:parallel-cli-setup

如果任何 parallel-cli research 命令返回 403，告知用户可能需要余额。主动提供运行 parallel-cli balance get，如果需要，在运行 parallel-cli balance add <amount_cents> 之前请求明确确认。然后重试原始研究命令。