SuperAPI AI 工具集

cloud-storage

智能体与模型

查看项目

更新于 10-15 20:31

技能介绍

用途:用于存储用户上传文件、以限时 URL 提供私有资源、实现多租户文件隔离,以及通过预签名 URL 让客户端直传。

主要能力:多租户路径按 user_id/job_id 隔离;签名 URL 为私有文件提供限时访问,支持单个与批量生成;可见性控制区分公开桶与私有桶,并可在两者间迁移;预签名上传让客户端直接上传到存储;上传时校验 MIME 类型与文件大小,并计算 SHA-256 校验和。

使用方式:提供 Python 与 TypeScript 的 StorageService 实现,配置项包括 supabase_url、supabase_key、bucket_name、public_bucket_name、signed_url_expiration、max_file_size、allowed_mime_types,可从环境变量读取。后端上传调用 upload_asset;私有访问调用 get_signed_url 或 get_signed_urls_batch;直传先由后端 create_presigned_upload 生成 upload_url,客户端再以 PUT 上传;删除与可见性变更会校验路径是否以 user_id 开头。

适用场景:用户上传文件、私有资源限时分享、多租户隔离、大文件客户端直传、列表批量签名 URL。

限制:资料未提供具体收费、价格、平台支持范围与性能数据;示例依赖 Supabase Storage 客户端,其他云存储需自行适配;预签名上传有效期在示例中为 5 分钟,签名 URL 默认 3600 秒,最大文件默认 10MB,允许类型默认 png/jpeg/webp/gif。