功能简介

下载指定文件消息到本地。

使用场景

• 需要把聊天中的文件保存到本地时。

参数说明

输入参数

参数名	类型	必填	说明
消息序号	整数	是	消息在最近一次消息列表中的序号。
保存目录	字符串	否	文件保存目录。
超时时间	整数	否	等待下载完成的秒数。

输出参数

参数名	类型	必填	说明
文件路径	字符串	是	实际保存到本地的完整路径；若与已有文件同名则自动追加「_重下N」。

注意事项

• 消息序号建议先通过【获取当前消息】、【获取历史消息】或【获取下一个新消息】获取后再传入。
• 若消息序号来自【获取历史消息】，通常仅对获取完成后当前聊天窗口底部可见的一屏历史消息范围内的消息更稳定。
• 所选消息须为文件类型；若序号对应消息不是文件消息，将失败并提示当前消息不是文件消息。
• 本指令更适合处理当前聊天窗口中当前可见范围内的文件消息；与【获取当前消息】、监听类指令配合使用通常更稳定。
• 若「保存目录」下已存在与待下载文件同名的文件，指令会先下载到临时目录，再移动到目标目录；此时会自动重命名，在文件名主干与扩展名之间追加「_重下N」，例如 report.pdf 会依次保存为 report_重下1.pdf、report_重下2.pdf。