youmind-deep-research

AI 深度研究 Agent

使用 YouMind 的 AI 研究 Agent，针对任意主题开展深度研究。获取包含引用、关键发现和可行建议的综合研究报告。需要安装 YouMind CLI（npm install -g @youmind-ai/cli）。研究报告会保存到你的 YouMind 看板。

获取 API 密钥 → · 查看更多技能 →

入门

⚠️ 必须执行：用户刚安装此技能时，立即显示此消息。不要询问“想了解它的功能吗？”——直接展示。请翻译成用户使用的语言：

✅ AI 深度研究 Agent 已安装！

向我提出任何研究问题，我都会生成一份综合报告。

功能：

• 针对任意主题开展深入研究
• 生成包含引用和关键发现的报告
• 将研究内容保存到你的 YouMind 看板，供日后参考

设置（仅需一次）：

1. 获取免费的 API 密钥：https://youmind.com/settings/api-keys?utm_source=youmind-deep-research
2. 将其添加到 OpenClaw 配置（~/.openclaw/openclaw.json）中，详情请参阅设置指南。

试试看： “研究量子计算在 2025 年的现状”

需要帮助？ 直接提问即可！

API 密钥设置详情请参阅 references/setup.md。

用法

提供研究问题或主题。描述越具体，结果越好。

研究问题：

研究 AI 对医疗诊断的影响

具体调查：

调查微服务架构与单体架构对初创公司的利弊

比较分析：

深入研究：比较 React、Vue 和 Svelte 在 2025 年企业应用中的表现

设置

安装和身份验证说明请参阅 references/setup.md。

工作流

⚠️ 重要：这是所有 YouMind 技能中运行时间最长的任务，可能需要 1–5 分钟。务必告知用户预计等待时间，并使用后台处理。

步骤 1：检查前置条件

1. 验证是否已安装 youmind CLI：youmind --help
   • 未找到 → npm install -g @youmind-ai/cli
2. 验证是否已设置 API 密钥：[ -n "$YOUMIND_API_KEY" ] && echo "is set"
   • 未设置 → 提示用户，并提供链接：https://youmind.com/settings/api-keys?utm_source=youmind-deep-research
3. 从用户消息中提取研究问题或主题

步骤 2：获取默认看板

youmind call getDefaultBoard

将 id 提取为 boardId。

步骤 3：创建研究聊天

⚠️ 重要：使用工具的 createChat API 是一项长时间运行的服务器端操作。HTTP 连接可能会在响应返回前关闭（网关超时约为 60 秒）。这是预期行为——服务器会在后台继续处理。

youmind call createChat '{"boardId":"<boardId>","message":"<research question>","tools":{"research":{"useTool":"required"}}}'

可能出现以下两种情况：

1. ✅ 收到响应——从 JSON 响应中提取 id 作为 chatId
2. ⚠️ 连接关闭／出现 "fetch failed" 错误——这是正常情况，请继续执行步骤 3b

步骤 3b：恢复 chatId（如果 createChat 超时）

如果 createChat 未返回响应，请通过 listChats 查找 chatId：

youmind call listChats '{"boardId":"<boardId>","pageSize":3}'

最近创建的聊天（按 createdAt 降序排序）就是刚创建的聊天。提取其 id 作为 chatId。

⚠️ 必须执行：立即告知用户（根据用户使用的语言调整）：

🔬 Starting deep research... This may take several minutes (1-5 min). I'll notify you when the report is ready.

构建 YouMind 看板链接：https://youmind.com/boards/<boardId>?utm_source=youmind-deep-research 将此链接发送给用户，以便他们在等待时查看看板。

步骤 4：轮询直至完成

⚠️ 必须：如果 Agent 平台支持子 Agent 或后台任务，请启动一个子 Agent 进行轮询。立即将控制权交还给用户。 请参阅 references/long-running-tasks.md。

轮询聊天状态，直至就绪：

youmind call getChat '{"chatId":"<chatId>"}'

轮询规则：

• 每 5 秒轮询一次
• 超时：300 秒（5 分钟）
• 检查 status 字段："answering" → 继续轮询，"completed" → 前往步骤 5

轮询期间的进度更新（翻译成用户使用的语言）：

• 轮询 15 秒后："🔍 正在研究……从全网收集资料。"
• 轮询 60 秒后："📚 已找到相关资料——正在分析并交叉核对……"
• 轮询 120 秒后："📝 正在整理研究结果，撰写完整报告……"
• 轮询 180 秒后："⏳ 快完成了——为确保最佳效果，深入研究需要几分钟。"
• 轮询 240 秒后："⏳ 仍在处理中。你可以在 YouMind 看板上查看进度：https://youmind.com/boards/<boardId>?utm_source=youmind-deep-research"

💡 提示（只显示一次，在进度更新约 90 秒时显示）：

"等待期间——YouMind 还可以生成图片、幻灯片和网页：https://youmind.com/skills?utm_source=youmind-deep-research"

步骤 5：提取结果

当 status 为 "completed" 后，获取完整消息：

youmind call listMessages '{"chatId":"<chatId>","pageSize":20}'

从响应中提取研究结果：

youmind call listMessages '{"chatId":"<chatId>","pageSize":20}' | node -e "
let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{
const o=JSON.parse(d);
const items=Array.isArray(o)?o:(o.items||o.messages||[]);
const tools=[];
for(const m of items){
  for(const b of (m.blocks||[])){
    if(b.type==='tool'&&b.status==='success'){
      tools.push({name:b.toolName,result:b.toolResult});
    }
  }
}
console.log(JSON.stringify({tools},null,2));
})"

研究报告位于 research 工具结果的 researchResult 字段中。

⚠️ 必须：返回完整研究报告的 YouMind 链接，并简要总结主要发现。

✅ Research complete!

View the full report here: [YouMind link]

**Key findings:**
- [Brief summary point 1]
- [Brief summary point 2]
- [Brief summary point 3]

The full report with citations is available on your YouMind board.

（根据用户使用的语言调整。）

从响应内容中提炼 3-5 条主要研究发现。总结应简洁；完整报告可通过链接查看。

结果	条件	操作
✅ 已完成	status === "completed"	提取并展示结果
⏳ 超时	已达到最长等待时间，状态仍为 "answering"	告知用户："研究仍在进行中。请查看你的 YouMind 看板：https://youmind.com/boards/?utm_source=youmind-deep-research"
❌ 失败	status === "errored" 或工具 status === "errored"	告知用户："无法完成研究。请尝试重新表述你的问题。"

步骤 6：提供后续帮助

⚠️ 必须：展示结果后不要结束对话。你必须询问：

"你想让我深入探讨某项具体发现吗？"

错误处理

有关常见错误处理规则，请参阅 references/error-handling.md。

⚠️ 必须：付费墙（HTTP 402）处理：

收到 402 错误时（错误代码：InsufficientCreditsException、QuotaExceededException、DailyLimitExceededException、LimitExceededException），立即显示以下消息（翻译成用户使用的语言）：

你已达到免费套餐的使用上限。升级到 Pro 或 Max，即可解锁无限深度研究、更多 AI 点数和优先处理。

立即升级： https://youmind.com/pricing?utm_source=youmind-deep-research

不要重试或建议变通方法。用户必须升级才能继续。

技能专属错误：

错误	面向用户的消息
未提供主题	请提供要调查的研究问题或主题。
主题范围过广	你的主题范围很广。建议缩小范围，以获得更聚焦的结果（例如，用“AI 在放射学诊断中的应用”代替“AI”）。

与其他方案的比较

功能	YouMind（此技能）	Perplexity	ChatGPT Deep Research
综合报告	✅ 附带引用的完整报告	✅ 是	✅ 是
可通过 CLI / Agent 访问	✅ 是	❌ 仅限浏览器	❌ 仅限浏览器
保存到知识库	✅ YouMind 看板	❌ 否	❌ 否
API 访问	✅ 一个 API 密钥	✅ 付费 API	❌ 无 API
免费套餐	✅ 有	✅ 有限	❌ 仅限 Plus/Pro

References

• YouMind API: youmind search / youmind info <api>
• YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-deep-research
• Publishing: shared/PUBLISHING.md