一、指令概述
该 RPA 指令用于从飞书云盘下载指定文件到本地指定目录，需配置飞书访问凭证、文件唯一标识（文件Token）及本地保存目录，执行后返回运行结果和文件本地保存路径，适用于飞书文件的本地化备份、离线编辑等场景。
飞书官方开发文档参考：https://open.feishu.cn/document/server-docs/docs/drive-v1/download/download
二、调用参数配置示意
| 参数名称 | 示例 / 默认值 | 说明 |
| 指令 | 下载文件 | 固定选择 “下载文件”，执行飞书文件本地下载操作。 |
| 飞书访问凭证 | 飞书访问凭证 | 配置飞书开放平台的访问凭证（需具备文件下载权限，可通过 “获取飞书访问凭证” 指令生成），支持变量（界面显示 “{x}” 标识）。 |
| 文件 Token | OmaFb**************** | 输入要下载文件在飞书云盘的唯一标识 Token（需为飞书合法文件的有效 Token），关键字符已打码，支持变量。 |
| 保存目录 | （如 “C:\Downloads\”） | 选择本地保存文件的文件夹路径，可点击 “选择文件夹” 按钮选取，支持变量。 |
| 生成的变量 - 运行结果 | 变量1（自定义变量名） | 存储文件下载的执行结果（如成功状态、错误信息等），需配置为自定义变量，后续流程可调用，支持变量。 |
| 生成的变量 - 文件保存至 | 变量2（自定义变量名） | 存储下载后文件在本地的完整文件路径（如 “C:\Downloads\ 报表.xlsx”），需配置为自定义变量，支持变量。 |
三、使用示例（下载飞书文件到本地场景）
场景：从飞书云盘下载 文件Token 为 OmaFb**************** 的文件，保存到 “C:\Documents\” 本地目录。
参数配置：
• 指令：下载文件
• 飞书访问凭证：feishuAuthToken（通过 “获取飞书访问凭证” 指令生成的变量）
• 文件 Token：OmaFb****************（飞书文件唯一标识，关键字符已打码）
• 保存目录：C:\Documents\（或通过 “选择文件夹” 选取）
• 运行结果：downloadResult（自定义变量，存储下载结果）
• 文件保存至：localFilePath（自定义变量，存储本地完整路径）
执行流程：
调用该 RPA 指令后，RPA 会通过 feishuAuthToken 完成飞书 API 认证，根据打码后的文件Token定位飞书文件并下载到指定本地目录；下载完成后，将执行结果存入 downloadResult，并把本地完整文件路径存入 localFilePath，便于后续流程（如本地文件查看、数据提取）调用。
四、返回结果说明
1. 运行结果与响应头说明
• 运行结果变量：存储下载操作的状态（成功 / 失败）及相关信息。
• 文件保存至变量：存储下载后文件在本地的完整路径（如 “C:\Documents\ 报表.xlsx”）。
• 响应头字段：
◦ Content-Type：字符串类型，标识文件的 MIME 类型（如application/vnd.openxmlformats-officedocument.wordprocessingml.document表示 Word 文档）。
◦ Content-Disposition：字符串类型，标识下载后的文件名。
五、注意事项
1. 访问凭证有效性：“飞书访问凭证” 需具备文件下载权限且未过期（建议通过 “获取飞书访问凭证” 指令动态生成有效凭证），否则会导致下载失败。
2. 文件 Token 准确性：文件Token 需是飞书云盘真实存在的文件标识（打码不影响实际值校验），否则会返回 “文件不存在” 错误。
3. 保存目录可写性：“保存目录” 需指向本地存在且可写入的文件夹（避免系统保护路径，如 “C:\Windows\”），否则会因 “无写入权限” 导致下载失败。
4. 文件格式兼容性：飞书支持下载的文件格式需符合其 API 规范，若遇到特殊格式无法下载，需参考飞书官方文档确认兼容性。
六、延伸应用
可结合 RPA 的 “文件解析”“数据提取” 指令，实现飞书文件自动化下载与内容处理：例如从飞书云盘下载业务报表文件，通过本指令保存到本地后，调用文件解析指令提取关键数据，再将数据同步至企业数据库或生成可视化报表，替代人工手动下载、解析、录入的重复工作，提升数据处理效率。