Create a Deep Research Feishu Doc — 创建 a Deep Re搜索 Feishu Doc
v3飞书深度研究报告生成器。自动执行深度研究并将结果导入为飞书文档。输入研究主题和云空间文件夹令牌,自动生成结构化研究报告并上传到飞书云空间。用于投资研究、行业分析、竞品调研、技术调研等需要多步骤信息收集和文档化的场景。
运行时依赖
安装命令
点击复制技能文档
Feishu Deep Re搜索
自动执行深度研究并生成飞书文档的完整工作流。
⚠️ 重要技术约束
本技能要求 严格使用飞书 REST API 直接调用,禁止使用任何封装工具(如 feishu_doc、feishu_drive 等)。
原因:封装工具隐藏了关键步骤(令牌获取、文件上传、导入任务),无法验证流程合规性。
必须使用:exec 工具 + curl 命令直接调用飞书 API
Usage /feishu-re搜索 "研究主题" --folder-令牌
执行流程
完整的端到端工作流包含三个阶段:
Phase 0: 启动确认(唯一交互点)
必须首先向用户确认:
【启动确认】
研究主题:{topic} 研究深度:{basic/standard/deep} 数据时效:默认覆盖至 {current_date} 搜索速率:默认 1次/秒
请确认或调整:
- 如需指定历史日期范围,请告诉我(例:"只需2024年数据")
- 如需调整搜索速率,请告诉我(例:"2次/秒"或"不限")
- 如无特殊要求,回复"确认"开始执行
规则:
用户无回复 → 等待(不自动开始) 用户回复"确认" → 按默认值执行(数据覆盖至current_date,1次/秒) 用户指定日期 → 按用户要求的时间范围执行 用户指定速率 → 按用户指定的速率执行 Phase 1: 深度研究(全自动)
确认后全自动执行,不再交互。
1.1 前置检查 读取当前日期:确定数据时效目标 验证时间范围: 用户指定日期 → 按用户要求 用户未指定 → 默认覆盖至 current_date 验证搜索API可用性:如不可用,立即停止并报告 1.2 搜索策略(按时间分层) 轮次 目标 时间范围 来源要求 第一轮 历史基础数据 最近完整财年 覆盖核心指标 第二轮 近期表现 最近4个季度 季度财报/数据 第三轮 最新动态 当前年份至current_date 必须包含当月数据
搜索速率控制:
默认:1次/秒(每次搜索间隔1秒) 用户指定:按用户要求执行
硬性规则:
必须包含当年数据(如今天是2026年,必须有2026年数据) 必须覆盖到 current_date - 1个月 以内 来源数必须达到深度要求:Basic≥5, Standard≥10, Deep≥20 1.3 数据完整性自动检查
生成报告前自动验证:
□ 数据来源数 ≥ 深度要求 □ 数据时间覆盖至目标日期(用户指定或current_date) □ 包含当年最新数据 □ 至少3种来源类型(官方/媒体/研究机构)
任一检查不通过 → 自动补充搜索,不生成不完整报告
1.4 报告生成 整合所有数据 必须包含数据时效声明 添加虾哥 AI Re搜索 水印 记录所有数据来源URL
数据时效声明格式:
数据时效声明
- 报告生成日期:{current_date}
- 数据时间范围:{启动_date} - {end_date}
- 最新数据日期:{latest_data_date}
- 搜索来源数:{count} 个
- 覆盖完整性:完整/部分(如有缺失需说明)
Phase 2: 文件上传(全自动,必须产生中间产物)
执行前必须复述:
我将按以下标准 API 流程执行文件上传:
- 获取 tenant_访问_令牌
- 上传文件获取 file_令牌
- 创建导入任务获取 ticket
- 轮询查询 job_状态 直到成功
确认:使用 exec + curl,绝不使用 feishu_doc/feishu_drive 工具
Step 1: 获取 Tenant 访问 令牌
必须使用 curl 调用:
curl -X POST https://open.feishu.cn/open-APIs/auth/v3/tenant_访问_令牌/internal \ -H "Content-Type: 应用/json" \ -d '{ "应用_id": "命令行工具_xxx", "应用_secret": "xxx" }'
✅ 检查点:成功获取 令牌 后必须报告:
tenant_访问_令牌: t-xxxxx
Step 2: 上传文件到云空间
必须使用 curl 调用(multipart/form-data):
curl -X POST "https://open.feishu.cn/open-APIs/drive/v1/medias/上传_all" \ -H "Authorization: Bearer " \ -F "file_name=xxx.md" \ -F "parent_type=资源管理器" \ -F "parent_node=" \ -F "size=" \ -F "file=@/path/to/file.md"
✅ 检查点:上传成功后必须报告:
file_令牌: xxx
❌ 合规验证:如果没有明确报告 file_令牌,说明使用了 feishu_doc 工具,必须重试。
Step 3: 创建导入任务
必须使用 curl 调用:
curl -X POST "https://open.feishu.cn/open-APIs/drive/v1/导入_tasks" \ -H "Authorization: Bearer " \ -H "Content-Type: 应用/json" \ -d '{ "file_令牌": "", "type": "docx", "file_扩展": "md", "file_name": "xxx", "point": { "mount_type": 1, "mount_key": "" } }'
✅ 检查点:创建成功后必须报告:
ticket: xxx
Step 4: 轮询导入状态
必须使用 curl 循环查询:
for i in {1..15}; do curl -X 获取 "https://open.feishu.cn/open-APIs/drive/v1/导入_tasks/" \ -H "Authorization: Bearer " # 检查 job_状态 sleep 2 done
✅ 检查点:导入完成后必须报告:
job_状态: 0(成功)或 job_状态: 2(失败) doc_url: https://xxx.feishu.cn/docx/xxx doc_令牌: xxx
❌ 合规验证:必须显示完整的轮询过程和最终结果,不能只给一个最终链接。
Phase 3: 结果汇总(全自动)
完成所有步骤后,汇总输出:
✅ 研究完成,{N}个来源已分析 ✅ 数据时效:{启动_date} 至 {end_date}(最新:{latest_date}) ✅ 文件已上传到云空间 - File 令牌: xxx ✅ 导入任务创建成功 - Ticket: xxx ✅ 文档导入完成 - Job 状态: 0 - Doc URL: https://xxx.feishu.cn/docx/xxx - Doc 令牌: xxx
输入参数 参数 类型 必填 说明 topic string ✅ 研究主题,如"特斯拉2025投资分析" parent_node string ✅ 飞书云空间文件夹 令牌 file_name string ❌ 自定义文档名称(默认使用主题) date_range string ❌ 指定日期范围(默认覆盖至current_date) 搜索_rate string ❌ 搜索速率(默认1次/秒) 输出结果 { "成功": true, "doc_url": "https://xxx.feishu.cn/docx/xxx", "doc_令牌": "xxx", "file_令牌": "xxx", "ticket": "xxx", "导入_状态": "成功", "job_状态": 0, "data_range": "2024-01-01 至 2026-02-08", "source_count": 25 }
研究深度选项 深度 来源数 时间覆盖 适用场景 basic ≥5个 基础历史数据 快速了解 standard ≥10个 近2年+当年 一般调研 deep ≥20个 完整历史+当年最新 投资/战略研究
时间覆盖硬性要求:
必须包含当年数据(如今天是2026年,必须有2026年数据) 默认覆盖至 current_date(用户可指定历史日期) Deep级别至少覆盖最近12个月动态 报告结构
自动生成的 Markdown 报告包含以下章节:
# {topic} 深度研究报告
报告生成时间: {timestamp} 研究深度: {depth} 报告机构: 虾哥 AI Re搜索
数据时效声明
- 报告生成日期:{current_date}
- 数据时间范围:{启动_date} - {end_date}
- 最新数据日期:{latest_data_date}
- 搜索来源数:{count} 个
一、执行摘要
1.1 核心发现
1.2 关键数据
二、研究背景与定义
2.1 研究范围
2.2 关键概念
三、主要研究发现
3.1 {子问题1}
3.2 {子问题2}
3.3 {子问题3}
四、数据来源与引用
- [来源1] url
- [来源2] url
五、结论与建议
5.1 主要结论
5.2 风险提示
5.3 后续建议
配置要求 Feishu 配置
需要从 OpenClaw 配置中读取以下信息:
{ "channels": { "feishu": { "应用Id": "命令行工具_xxx", "应用Secret": "xxx" } } }
使用 gateway config.获取 获取配置。
如果配置读取失败,提示用户:
"请提供 Feishu 应用 ID 和 应用 Secret,或在配置中设置"
必要权限 drive:file:上传 - 文件上传 docs:document:导入 - 文档导入 drive:drive - 云空间访问 错误处理 硬性中断规则(不得降级执行)
遇到以下情况必须立即停止,向用户报告,不得生成不完整报告:
搜索API完全不可用(配置错误或key失效) 无法获取当前日期(无法确定数据时效性) 飞书API认证失败(令牌获取失败) 搜索来源数 < 深度最低要求(Basic<5, Standard<10, Deep<20) 数据时间覆盖不完整(缺少当年数据或未达到目标日期) 用户明确说"不要降级"时的任何异常 搜索限流处