SuperAPI AI 工具集

deep-research

通用与其它

查看项目

更新于 10-16 10:24

技能介绍

用途

Deep Research 是一个用于多来源研究并生成带引用追踪报告的技能。它面向需要综合分析、技术对比、最新进展综述、多视角调查或市场分析的场景。根据资料,其核心目的是通过结构化流程交付引用可追踪的研究报告,具备证据持久化、来源身份管理、主张级验证和渐进式上下文管理能力。

该技能遵循自主性原则:独立运作,从上下文推断假设,仅在遇到关键错误或无法理解的查询时停止;对高影响假设会在引言和方法论中显式呈现,而非静默采用默认值。

不适用场景:简单查找、调试、仅需 1-2 次搜索即可回答的问题、对时效性要求很高的快速查询。

主要能力

  • 引用追踪与来源管理:维护 sources.jsonl 作为稳定来源注册表,使用规范 ID。
  • 证据持久化:evidence.jsonl 为仅追加的证据存储,包含引文和定位符。
  • 主张级验证:claims.jsonl 为原子主张台账,记录支撑状态;交付前强制进行主张-支撑验证,不支持的事实主张不得通过交付。
  • 多模式选择:quick(3 阶段,2-5 分钟)、standard(6 阶段,5-10 分钟,默认)、deep(8 阶段,10-20 分钟)、ultradeep(8+ 阶段,20-45 分钟)。
  • 分阶段工作流:SCOPE、PLAN、RETRIEVE、TRIANGULATE、OUTLINE REFINEMENT、SYNTHESIZE、CRITIQUE、REFINE、PACKAGE;其中阶段 3-5 按章节作为证据循环运行(检索 → 证据存储 → 精炼大纲 → 起草 → 验证主张 → 按需增量检索),而非严格顺序门。
  • 输出多种格式:Markdown(主源)、JSONL 数据文件、HTML(McKinsey 风格,自动打开)、PDF(专业打印,自动打开)。
  • 质量门槛:10+ 来源,每个主要主张 3+ 独立来源(集群无关,而非仅计数);所有事实主张立即标注 [N] 并有证据支撑;无占位符、无捏造引用;散文优先(>=80%),谨慎使用列表。

使用方式

调用时加载相关参考文件:阶段 1-7 加载 methodology.md;阶段 8(报告)加载 report-assembly.md;HTML/PDF 输出加载 html-generation.md;质量检查加载 quality-gates.md;长报告(>18K 词)加载 continuation.md。模板包括 report_template.md 和 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]。

输出文件默认存放于 ~/Documents/[Topic]Research[YYYYMMDD]/,包括 Markdown、sources.jsonl、evidence.jsonl、claims.jsonl、run_manifest.json、HTML 和 PDF。

报告必需部分:执行摘要(200-400 词)、引言(范围、方法、假设)、主要分析(4-8 个发现,每个 600-2,000 词,带引用)、综合与洞察、局限与注意事项、建议、参考文献(完整,每个引用,无占位符)、方法附录。

限制

  • 依赖 lovstudio-dev-blog 的博客发布契约;发布到 blog_posts 必须使用 dev-blog 自动化语义。
  • 若同步命令因网站路径、环境或数据库架构不可用而失败,保留已完成的研究产物,并报告确切的同步错误和可重跑的命令。
  • 最终答复需包含一行发布状态:已发布到 LovStudio:是/否,并附公开 URL(如 https://lovstudio.ai/blog/[slug])。
  • 资料中未提供价格、收费或平台兼容性信息。

后处理发布(LovStudio)

在阶段 8 成功生成 Markdown 报告后,除非用户明确表示“private”“do not publish”“不要发布”或等效内容,否则自动发布到 LovStudio 博客系统。这是一个强制性完成门槛,而非可选后续步骤。发布使用命令:cd /Users/mark/lovstudio/coding/web && pnpm run sync:research -- [markdown_path];若路径不确定,可运行 cd /Users/mark/lovstudio/coding/web && pnpm run sync:research -- --limit 5。发布语义由 lovstudio-dev-blog 拥有并由网站同步脚本执行:新报告为公开详情页(is_visible=true),默认出现在 /blog 索引(show_in_index=true);重新同步现有报告也会将其提升至索引,除非显式隐藏;已发布报告应带封面,网站同步脚本可在 Markdown 产物未提供封面 URL 时自动生成并上传。