feishu-send-file

飞书发送文件技能。用于通过飞书向用户发送普通文件附件(HTML、ZIP、PDF、代码文件等)以及处理“本地图片路径被发成路径文本”的可靠补救场景。普通文件必须先上传获取 `file_key` 再发送;当本地图片用 `message`/`media` 发送后在飞书里只显示 `/root/...png` 路径而不显示...

安装

概览

{ “overview_html”: “飞书发送文件是一个专为飞书机器人设计的自动化技能,用于高效、可靠地向用户或群组发送各类普通文件附件。该工具的核心价值在于解决了飞书API中发送文件必须分两步操作的繁琐流程:首先需要将本地文件上传至飞书服务器获取唯一的 `file_key`,然后再使用该密钥发送消息。通过提供一键式Python脚本,极大简化了这一过程,用户只需输入文件路径和接收者信息即可完成整个发送任务。此外,该技能特别针对一个常见但易被忽视的陷阱提供了补救方案——当本地图片路径(如 `/root/myfiles/xxx.png`)通过常规方式发送后,在飞书客户端仅显示为路径文本而非实际图片时,说明发送失败。此时不应重复尝试相同方法,而应立即切换至本技能提供的**稳定图片上传脚本**,直接调用专用链路完成真正的图片发送。因此,它不仅是一个文件传输工具,更是一套完整的‘文件与图片’可靠送达解决方案。”, “feature_items”: [ “支持一键发送HTML、ZIP、PDF、代码文件等普通文件附件”, “内置两步流程自动化脚本,避免手动获取file_key的繁琐操作”, “专门提供稳定图片上传脚本,解决本地路径图片发送失败问题”, “自动处理接收者open_id提取及飞书应用配置读取”, “支持自定义文件名,提升用户体验和文件识别度” ], “scenarios_html”: “该工具主要面向需要通过飞书机器人向个人用户或群组成员批量、频繁发送各类文档、报告、压缩包或代码文件的开发者或自动化系统。例如,在一个持续集成/持续部署(CI/CD)流水线中,构建完成后自动将生成的HTML测试报告、PDF文档或日志文件打包发送至指定的运维人员或开发团队,极大提升了反馈效率。另一个典型场景是客服或技术支持系统,当需要向客户解释复杂问题时,可以自动附加相关的代码片段、流程图或说明文档,确保信息传递的完整性与准确性。对于图片发送,其适用场景尤为关键。当系统或用户尝试使用飞书的 `message` 接口并传入本地图片路径(尤其是Linux环境下常见的 `/root/myfiles/…` 路径)时,飞书客户端可能只会显示该路径字符串而非渲染出图片本身,这通常意味着图片并未真正上传成功。此时,若继续使用相同方式重试,结果将是一致的失败。因此,本技能的稳定图片上传脚本在此类场景下成为不可或缺的后备方案,它能绕过问题链路,强制走正确的图片上传通道,确保最终用户在飞书中看到的是清晰、可用的图片内容,而非一串无意义的路径文本。” }