核心用法
feishu-file-finder 是一款针对飞书（Feishu）平台的文件检索工具，允许用户通过命令行在指定群聊的历史消息中搜索特定文件名，并自动下载到本地。
基础命令结构：
node index.js --chat <chat_id> --file <filename>
可选参数：
-o, --output <dir>：自定义保存目录（默认当前目录）-h, --hours <num>：设置搜索回溯时长（默认 24 小时）
环境依赖：需预先配置 FEISHU_APP_ID 和 FEISHU_APP_SECRET 以调用飞书开放平台 API。
显著优点
1. 补全自动化缺口：专为解决 OpenClaw 自动下载失败或遗漏的场景设计，形成可靠的后备机制
2. 精准定位：通过文件名直接检索，避免人工翻找海量聊天记录的低效操作
3. 灵活可控：支持自定义时间窗口和输出路径，适应不同业务场景需求
4. 轻量集成：基于 Node.js 实现，易于嵌入现有工作流或 CI/CD 管道
潜在缺点与局限性
1. 依赖飞书 API 凭证：必须持有有效的企业应用凭证，个人用户或无权限应用无法使用
2. 文件名完全匹配：暂不支持模糊搜索或正则匹配，对文件名记忆要求较高
3. 时效性约束：历史消息搜索受飞书 API 本身的消息存储期限限制
4. 无预览功能：下载前无法查看文件内容或元信息，存在误下风险
适合人群
- 使用 OpenClaw 自动化工具但偶尔遇到文件下载失败的开发者/运维人员
- 需要定期从飞书群聊归档历史文件的企业 IT 管理员
- 构建飞书生态集成方案的技术团队
常规风险
- 凭证泄露风险：
FEISHU_APP_ID和FEISHU_APP_SECRET属于敏感信息，需通过安全方式（如密钥管理服务）注入，避免硬编码 - API 限流风险：高频调用可能触发飞书开放平台频率限制
- 权限越界风险：应用需具备读取群聊消息历史权限，配置不当可能导致数据暴露
- 文件安全风险：下载的文件未经过杀毒或内容安全检测，执行前需自行验证来源可靠性
技术实现说明
该工具基于飞书开放平台的消息 API 实现，通过遍历指定时间范围内的聊天记录，匹配文件名后触发下载流程。由于是自建技能，其安全性高度依赖部署环境的安全配置。