用途:该技能通过火山引擎 TOS 网关的 file_jobs API 提交异步任务,对 TOS 中存储的文件对象进行压缩或解压。
主要能力:file_compress.py 可将多个 TOS 对象压缩为归档文件,支持 zip、tar、zst 格式,输出对象键后缀需与所选格式一致;file_uncompress.py 可解压 TOS 中的归档文件到指定前缀。两者均支持 --wait 轮询等待任务完成。tos_jobs_client.py 为共享客户端,使用预签名 URL 认证。
使用方式:首次使用需安装依赖,cd {baseDir} 后执行 pip install -r {baseDir}/requirements.txt,随后用 Python 3.7+ 运行脚本,如 python3 {baseDir}/scripts/file_compress.py --keys file1.jpg,file2.txt --format zip --output-key output/archive.zip --wait,解压示例为 python3 {baseDir}/scripts/file_uncompress.py --key output/archive.zip --prefix output/unzipped/ --wait。
环境变量:TOS_ACCESS_KEY、TOS_SECRET_KEY、TOS_ENDPOINT、TOS_REGION、TOS_BUCKET 为必填;TOS_OBJECT_KEY 可选,可用 --key 或 --keys 覆盖;使用临时凭证时可选 TOS_SECURITY_TOKEN。
限制:任务为异步模型,需通过 --wait 或自行轮询获取结果;压缩输出键后缀必须匹配格式;认证依赖 TOS 身份与预签名 URL。更多参数与工作流见 README.md、REFERENCE.md、WORKFLOWS.md。