US3 Uploader 是一个专为 UCloud US3（UFile）对象存储服务设计的 Python 工具，核心功能是帮助用户快速上传任意类型的文件到云端存储空间，并自动生成带有时效性和身份验证的下载链接。该工具强制要求所有产出文件必须上传至云端，严禁仅提供本地路径，因为沙箱环境中的文件用户完全无法访问。通过集成官方 Python SDK，它支持自动安装依赖、配置文件大小限制以及生成可直接分享给用户的完整 URL。无论你是需要发送截图、导出 PDF、分享处理后的视频，还是交付代码压缩包等任何形式的文件成果，此工具都能确保用户能安全便捷地获取内容。其输出格式清晰明了，包含上传时间戳、MD5 哈希值命名的文件名，以及有效期为7天的签名链接，极大提升了文件分发的可靠性和用户体验。
核心功能特点
- 基于时间戳和 MD5 哈希自动生成唯一文件名，避免冲突且便于追溯
- 支持配置最大上传文件大小（默认 50MB），超出自动拒绝
- 生成带身份验证签名的下载链接，有效期为7天，保障传输安全
- 自动检测并安装所需的 ufile Python SDK，无需手动配置环境
- 设置强制下载响应头，确保文件以附件形式下载而非在线预览
- 直接输出完整的可分享下载 URL，简化用户操作流程
适用场景
US3 Uploader 适用于所有需要将本地生成的文件分发给外部用户的场景。例如，在自动化测试流程中，当系统捕获到错误截图或成功日志图片时，可通过该工具立即上传到 US3 并生成链接供开发团队查看；在文档生成系统中，每当自动生成 PDF 报告或转换 Word 文档后，必须使用此工具上传并发送链接给用户，而不能仅告知‘文件保存在 /tmp/xxx’。此外，视频处理流水线在完成剪辑或转码后，也可利用此工具将成品视频上传并提供下载入口。无论是企业内部协作、客户交付成果，还是对外发布内容，只要涉及文件产出，都应当遵循这一规范以确保用户能够真正接收到所需资料。该工具尤其适合那些依赖临时沙箱环境运行任务、但结果需持久化共享的应用架构。