当用户明确要求深度研究/详尽报告时，用…

用户明确说「deep research」「exhaustive」「comprehensive report」「thorough investigation」时，用 parallel-cli 发起深度研究、轮询并交付报告文件。

适用场景

解决思路

1. 确认用户明确要求深度/详尽研究；普通研究或查证应改用 parallel-web-search。
2. 根据主题取一个描述性文件名（小写、连字符、无空格，如 ai-chip-market-2026），后续步骤复用为 -o "$FILENAME"。
3. 启动研究：parallel-cli research run "$ARGUMENTS" --processor pro-fast --text --no-wait --json；--text 返回带内联引用的 markdown 报告，若用户要结构化 JSON 则去掉 --text。
4. 用 --text 时可加 --text-description "..." 控制长度、格式或重点。
5. 若是已知 interaction_id 的后续追问，加 --previous-interaction-id "$INTERACTION_ID"，并改用更轻的处理器（lite-fast 或 base-fast）。
6. 必须保留 --no-wait，否则命令会阻塞数分钟并超时。
7. 按需求选择处理器：lite-fast 10–60s（快速查询/追问）、base-fast 15–100s（简单问题）、core-fast 1–5min（中等研究）、pro-fast 2–10min（默认）、ultra-fast 5–25min（多源深度研究，约 2 倍成本）、ultra2x/4x/8x-fast 最长 2 小时（仅明确要求时）。
8. 默认用 -fast 档（缓存数据更快）；若用户问最近一两天的新闻，改用非 fast 变体（pro、ultra 等）以获取更新数据。
9. 可运行 parallel-cli research processors 查看完整处理器列表与延迟。
10. 解析 JSON 输出提取 run_id、interaction_id 和监控 URL，并立即告知用户：研究已启动、所选处理器的预期延迟、监控 URL，并说明可将轮询放到后台继续工作。
11. 轮询结果：parallel-cli research poll "$RUN_ID" -o "$FILENAME" --timeout 540。
12. 轮询时用 --timeout 540（9 分钟）以符合工具执行限制；不要加 --json（输出过大会淹没上下文）；-o 会写文件：$FILENAME.json 始终写入，$FILENAME.md 仅在第一步用了 --text 时写入。
13. 轮询完成时 stdout 会打印执行摘要，把它分享给用户；重新轮询并想覆盖已有文件时加 --force。
14. 若轮询超时：告知用户研究仍在服务端运行，并重新执行同一条 poll 命令继续等待。
15. 第一步后：分享监控 URL（仅用于跟踪进度，不是最终报告）。
16. 第二步后：分享执行摘要、生成的文件路径（$FILENAME.md 和 $FILENAME.json）、interaction_id，并说明可基于此研究继续追问（如「深入 X」「与 Y 对比」）；完成后不要再分享监控 URL。
17. 询问用户是否要阅读文件了解详情；除非用户要求，不要把文件内容读入上下文。
18. 记住 interaction_id，后续相关追问时作为 --previous-interaction-id 传入。
19. 若找不到 parallel-cli，运行 /parallel:parallel-cli-setup 安装并认证。
20. 若命令报 no such option/no such command/unrecognized arguments，说明 CLI 过旧，让用户运行 parallel-cli update（pipx 安装则 pipx upgrade parallel-web-tools）后重试。
21. 若 research 命令返回 403，提示可能需要余额；可运行 parallel-cli balance get，必要时在获得明确确认后运行 parallel-cli balance add <amount_cents>，然后重试原命令。

适用边界 · 注意事项

• 用户只是普通研究、快速查询或事实核查时，应改用 parallel-web-search（深度研究慢 10–100 倍且更贵）。
• 用户未明确要求深度/详尽研究时不要使用。
• 未安装 parallel-cli 或无法联网时不可用。