deep-research

深度研究

核心目的

通过结构化流程交付带有引用追踪的研究报告，包括证据持久化、来源身份管理、声明级验证和渐进式上下文管理。

自主原则： 独立运行。根据上下文推断假设。仅在出现严重错误或无法理解的查询时停止。在引言和方法论中明确说明高重要性假设，而非默认隐藏。

---

决策树

请求分析
+-- 简单查询？ --> 停止：使用WebSearch
+-- 调试？ --> 停止：使用标准工具
+-- 需要复杂分析？ --> 继续

模式选择
+-- 初步探索 --> 快速（3阶段，2-5分钟）
+-- 标准研究 --> 标准（6阶段，5-10分钟）[默认]
+-- 关键决策 --> 深度（8阶段，10-20分钟）
+-- 全面审查 --> 超深度（8+阶段，20-45分钟）

默认假设： 技术查询 = 技术受众。比较 = 平衡视角。趋势 = 最近1-2年。

---

工作流程概览

阶段	名称	快速	标准	深度	超深度
1	范围界定	是	是	是	是
2	计划	-	是	是	是
3	检索	是	是	是	是
4	三角验证	-	是	是	是
4.5	大纲细化	-	是	是	是
5	综合	-	是	是	是
6	批判	-	-	是	是
7	优化	-	-	是	是
8	打包	是	是	是	是

注意： 阶段3-5按章节作为证据循环运行（检索 → 证据存储 → 细化大纲 → 草稿 → 验证声明 → 如有需要增量检索），而非严格的顺序门控。

---

执行

调用时，加载相关参考文件：

1. 阶段1-7： 加载 methodology.md 获取详细阶段说明
2. 阶段8（报告）： 加载 report-assembly.md 进行渐进式生成
3. HTML/PDF输出： 加载 html-generation.md
4. 质量检查： 加载 quality-gates.md
5. 长报告（>18K字）： 加载 continuation.md

模板：

• 报告结构：report_template.md
• HTML样式：mckinsey_report_template.html

脚本：

• python scripts/validate_report.py --report [path]
• python scripts/verify_citations.py --report [path]
• python scripts/md_to_html.py [markdown_path]

---

输出约定

必需部分：

• 执行摘要（200-400字）
• 引言（范围、方法、假设）
• 主要分析（4-8个发现，每个600-2,000字，带引用）
• 综合与见解（模式、含义）
• 局限性与注意事项
• 建议
• 参考文献（完整——每个引用，无占位符）
• 方法论附录

输出文件（全部保存到 ~/Documents/[Topic]_Research_[YYYYMMDD]/）：

• Markdown（主要真实来源）
• sources.jsonl — 稳定来源注册表，带规范ID
• evidence.jsonl — 仅追加的证据存储，带引用和定位信息
• claims.jsonl — 原子声明账本，带支持状态
• run_manifest.json — 查询、模式、假设、提供者配置
• HTML（麦肯锡风格，自动打开）
• PDF（专业打印，自动打开）

质量标准：

• 10个以上来源，每个主要声明至少3个（集群独立，不仅计数）
• 所有事实声明立即引用[N]，并在 evidence.jsonl 中有证据支持
• 声明支持验证必须执行：不允许无支持的事实声明通过交付
• 无占位符，无虚构引用
• 以散文为主（>=80%），少用项目符号

---

何时使用/不使用

使用： 综合分析、技术比较、最新进展综述、多视角调查、市场分析。

不使用： 简单查询、调试、1-2次搜索即可回答的问题、快速时效性查询。