核心用法
feishu-file 是面向飞书生态的文件发送技能，通过调用飞书开放平台 API 实现本地文件到聊天会话的自动化投递。核心流程为：获取 Access Token → 识别文件类型 → 校验大小限制 → 上传至飞书服务器 → 发送文件消息。支持通过环境变量或命令行参数指定接收者（Open ID 或 Chat ID），兼容绝对路径与相对路径。
显著优点
1. 格式覆盖全面：支持 PDF、Office 套件、图片、音视频、压缩包及文本等 30+ 种格式，自动映射 MIME 类型到飞书 file_type 参数
2. 官方 API 集成：基于飞书标准 /im/v1/files 与 /im/v1/messages 端点，稳定性与兼容性有保障
3. 智能类型识别：结合 file 命令与扩展名双重校验，降低手动配置成本
4. 分层大小管控：针对不同媒介设置差异化上限（图片 20MB、视频 50MB、其他 30MB），符合飞书平台规范
5. 灵活接收者配置：支持环境变量默认设置与命令行参数覆盖，便于 CI/CD 流水线集成
潜在缺点与局限性
1. 强凭证依赖：必须预先配置 FEISHU_APP_ID 与 FEISHU_APP_SECRET，且应用需具备 im:message、im:file 等权限，配置门槛较高
2. 网络敏感操作：大文件上传受带宽与飞书服务器稳定性影响，存在超时风险
3. 无本地缓存机制：每次调用均重新获取 Access Token，高频场景下可能触发 API 限流
4. 接收者 ID 不透明：Open ID / Chat ID 需人工从飞书后台获取，无法直接通过姓名搜索
5. opus 格式特殊处理：音频中的 opus 格式被强制排除，需单独使用 feishu-voice 技能，增加用户认知负担
适合人群
- 企业运维/DevOps 工程师：需要将构建产物（日志、报告、安装包）自动推送到飞书群
- RPA/自动化办公用户：批量发送标准化文件（合同、报表）到指定会话
- 飞书应用开发者：快速验证文件消息能力，无需从零封装 API
常规风险
1. 凭证泄露风险：App Secret 以明文环境变量存储，若日志打印或容器镜像泄露，可导致企业级飞书数据被恶意调用
2. 文件内容审计缺失：上传过程无本地内容扫描，敏感文件可能直接外发
3. 接收者误配置：命令行参数覆盖机制若被脚本错误调用，可能导致文件发送到非预期会话
4. API 限流与计费：高频自动化场景需关注飞书开放平台调用频次配额
5. 跨平台兼容性：依赖 curl、jq、file 等 Unix 工具，Windows 原生环境需额外配置