Research

🔬 交互探索与深度调研双模研究系统

双模式研究工具:交互式实时探索构建活文档,或调用并行AI进行耗时数小时的深度调研,自动归档可追溯。

收藏
9.6k
安装
3.9k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Research Skill 提供两种互补的研究范式:

交互式研究(Interactive):适合与用户协作探索,通过对话实时搜索、综合信息并更新 research.md。每次交互后自动追加发现、移动已解答的问题、标注来源,形成可演进的知识库。

深度研究(Deep Research):针对复杂主题调用 parallel-research CLI,利用并行AI API在分钟至小时级别完成全面调研。支持多级处理器(lite → ultra8x)及 -fast 变体,适用于市场分析、技术深潜、多维度比较。

文档体系严格规范:每个主题独立文件夹,包含 prompt.md(原始问题)、research.md(主发现)、可选PDF导出。关键机制包括状态追踪(Active/Complete/Graduated)、5-10轮交互后的合成检查点、以及研究完成后可向项目规格(~/specs/)的晋升通道。

显著优点

  • 双轨架构:即时协作与异步深度任务无缝切换,覆盖从快速验证到全面调研的全谱系需求
  • 活文档理念:研究过程即产出,避免重复劳动,支持长期维护与迭代
  • 自动化交付:深度研究通过 cron 作业自动检查结果并回传,无需人工值守
  • 来源可追溯:强制链接引用、置信度标注、日期戳记,符合学术与工程严谨性
  • 晋升机制:研究可自然演进为项目规格,避免"调研完毕即废弃"

潜在局限

  • 深度研究成本:高阶处理器(ultra2x/4x/8x)可能产生显著API费用,需用户明确授权
  • 时间估算依赖经验:调度检查作业时需手动计算 atMs,文档虽提供校验命令但仍存在配置错误风险
  • PDF渲染限制:表格以堆叠行形式呈现(PyMuPDF 限制),不适合数据密集型报告的最终交付
  • 并行API依赖:深度研究功能绑定特定服务商,存在供应商锁定与可用性风险

适合人群

  • 技术决策者评估框架/技术选型
  • 产品经理进行竞品分析与市场进入研究
  • 开发者调研开源方案或架构模式
  • 研究者建立主题知识库
  • 任何需要将"聊聊"转化为可复用资产的知识工作者

常规风险

  • 调度作业误配atMs 计算错误可能导致检查作业立即执行(过去时间)或延迟过久(年份错误),文档已内置校验命令但仍需操作警觉
  • 环境变量假设PARALLEL_API_KEY 预期预置,若缺失将导致深度研究失败
  • 状态漂移:长期标记为 "Ongoing" 的文档可能因缺乏合成检查点而沦为信息垃圾堆
  • 过度研究:开放性问题列表若缺乏收敛机制,易导致研究范围无限蔓延

安全解读

核心用法

Research Skill 是一款面向开放式主题调研的文档型工具,提供两种研究模式:交互式研究(实时对话探索)和深度研究(异步并行AI分析)。用户通过自然语言指令启动研究,系统会自动在 ~/.openclaw/workspace/research/ 下创建结构化文件夹,包含原始问题记录、研究发现、资源链接及后续步骤。深度研究模式调用外部 parallel-research CLI 工具,通过 Parallel AI API 执行耗时数分钟至数小时的综合调研,并支持自动定时检查任务状态。

显著优点

  • 纯文档架构,零执行风险:无可执行代码、无脚本、无依赖库,本质为 Markdown 使用指南,从根本上杜绝了代码注入、权限提升等攻击面
  • 功能边界清晰:交互式与异步模式分工明确,前者适合快速探索,后者处理复杂多维度分析(市场研究、技术深度调研)
  • 结构化知识沉淀:强制性的文件夹模板(prompt.md + research.md)确保研究过程可追溯、可复用,支持 PDF 导出
  • 外部依赖透明:所有涉及 API 调用和复杂计算的功能均通过用户本地安装的 CLI 工具实现,遵循最小权限原则
  • 自动化工作流支持:集成定时任务机制,可自动检查深度研究进度并推送结果

潜在局限

  • 功能依赖外部工具:核心深度研究能力需用户自行安装 parallel-researchexport-pdf,未安装时功能不可用
  • 无原生错误处理:作为纯文档 Skill,无法捕获或处理 CLI 工具执行失败的情况(如 API 限流、网络中断)
  • 手动维护负担:研究文档需用户或 AI 助手持续更新,长期项目可能出现文档与实际认知脱节
  • PDF 导出格式限制:表格渲染为堆叠行(PyMuPDF 限制),复杂数据展示效果欠佳

适合人群

  • 产品经理、战略分析师进行市场与竞品调研
  • 开发者评估技术方案、架构选型前的可行性研究
  • 学术用户、知识工作者构建主题知识库
  • 需要可审计、可分享研究过程的团队协作场景

常规风险

  • API 密钥管理:Parallel AI 的 API Key 需用户自行保管于 ~/.secrets/,存在因用户配置不当导致泄露的风险(Skill 层面无防护能力)
  • 外部工具供应链parallel-research CLI 的来源安全性取决于用户安装渠道,建议仅通过官方或可信仓库获取
  • 定时任务配置错误:深度研究的自动检查功能涉及 atMs 时间戳计算,用户手动配置时可能因时区、精度问题导致任务异常调度
  • 研究结论置信度:文档强调需标注不确定性("seems like", "unverified"),但实际使用中可能存在过度依赖 AI 生成结论而忽视人工验证的情况

Research 内容

手动下载zip · 4.8 kB
SETUP.mdtext/markdown
请选择文件