基于飞书REST API的自动化深度研究工具，执行多轮分层搜索后自动生成结构化报告并上传至飞书云空间，严格禁用封装工具确保全流程合规可审计。
说明：
## 核心用法
`feishu-deep-research` 是一个端到端自动化研究工作流技能，专为投资研究、行业分析、竞品调研等场景设计。用户仅需输入研究主题和飞书云空间文件夹token，系统将自动执行三阶段深度研究：启动确认（唯一人工交互点）→ 全自动分层搜索与报告生成 → REST API直连上传与文档导入。
**关键执行路径**：确认研究参数后，系统按”历史基础数据→近期季度表现→最新动态”三层时间策略执行搜索，默认速率1次/秒，强制要求数据来源数达标（Basic≥5/Standard≥10/Deep≥20）且必须包含当年数据覆盖至current_date。生成含数据时效声明的Markdown报告后，通过`exec+curl`严格调用飞书认证、上传、导入、轮询四类API端点，全程产生可审计的中间产物（tenant_access_token/file_token/ticket/job_status）。
## 显著优点
**全流程合规架构**：强制禁用`feishu_doc`/`feishu_drive`等封装工具，以原生REST API调用确保每个关键步骤可验证、可追踪，满足企业审计要求。
**数据完整性保障机制**：内置硬性中断规则——来源数不足、时间覆盖缺失、API认证失败等场景均触发终止而非降级，杜绝”半成品报告”风险。分层搜索策略（财年/季度/当月）结合自动补充搜索，确保投资级数据时效性。
**企业级错误处理**：搜索限流自动重试（3次）、导入状态15轮轮询、配置缺失主动提示，各阶段错误均附带诊断信息与手动 fallback 指南。
## 潜在缺点与局限性
**技术门槛较高**：要求用户预先配置Feishu AppID/Secret并获取文件夹token，对非技术用户存在 setup 成本。
**交互设计严格**：启动后零交互，日期范围与搜索速率需在确认阶段一次性确定，中途无法调整。
**可视化能力受限**：仅支持Markdown基础表格与列表，复杂图表需导入飞书后手动优化；文件大小建议控制在100KB以内，超大报告需分章节处理。
**生态依赖风险**：深度绑定飞书API配额与权限体系（需drive:file:upload、docs:document:import等权限），API变更可能导致流程中断。
## 适合人群
– **投资分析师/战略研究员**：需要标准化、可溯源的定期行业追踪报告
– **企业知识管理团队**：构建自动化研究资产沉淀 pipeline
– **合规敏感型组织**：要求API调用全程可审计、拒绝黑盒封装工具
## 常规风险
| 风险类型 | 具体表现 | 缓解措施 |
|———|———|———|
| 认证泄露 | AppSecret硬编码或日志泄露 | 使用gateway config.get读取配置，避免明文存储 |
| 数据时效误读 | 用户未理解”覆盖至current_date”默认行为 | 启动确认阶段强制复述时间范围 |
| 搜索配额耗尽 | 深度研究触发平台搜索限流 | 可调速率+自动重试，极端情况人工介入 |
| 导入任务挂起 | 飞书服务端异步处理延迟/失败 | 15轮轮询+超时报告file_token供手动处理 |
会员专属
