云与 SFTP 后端

每个后端（Google Drive、S3、Azure Blob、Dropbox、SFTP）都是 automation_file 自带的，并由 build_default_registry() 自动注册。 无需额外安装步骤——在单例上调用 later_init 即可使用：

from automation_file import execute_action, s3_instance

s3_instance.later_init(region_name="us-east-1")

execute_action([
    ["FA_s3_upload_file", {"local_path": "report.csv",
                           "bucket": "reports", "key": "report.csv"}],
])

所有后端都暴露同样的五种操作：upload_file、upload_dir、 download_file、delete_*、list_*。如需构建自定义注册表， register_<backend>_ops(registry) 仍然是公开 API。

Google Drive

from automation_file import driver_instance, drive_upload_to_drive

driver_instance.later_init("token.json", "credentials.json")
drive_upload_to_drive("example.txt")

OAuth 凭证以 UTF-8 写在调用方提供的 token_path。 切勿打印或记录该文件内容。

SFTP

SFTPClient 使用 paramiko.RejectPolicy—— 未知主机会被拒绝，而不是自动加入。请显式提供 known_hosts= 或依赖 ~/.ssh/known_hosts。不要为图省事改用 AutoAddPolicy。

跨后端复制

跨后端调度器接受 URI 语法：

from automation_file import execute_action

execute_action([
    ["FA_cross_copy",
     {"src": "s3://reports/2026-04.csv",
      "dst": "drive:///Backups/april.csv"}],
])

URI 前缀：local://、s3://、drive://、sftp://、 azure://、dropbox://、ftp://。