Uploadcare Automation

技能概述

通过自然语言命令自动化管理 Uploadcare 文件，包括列表查询、永久存储、元数据检查、下载链接生成和文件组管理。

适用场景

1. 防止文件自动删除 - Uploadcare 上传的文件默认 24 小时后自动删除，使用此技能可自动标记文件为永久存储，避免数据丢失
2. 批量文件审计 - 快速列出项目中所有文件，按存储状态、日期或排序条件筛选，便于定期检查和管理大量上传文件
3. 文件元数据查询 - 获取文件详细信息（尺寸、类型、CDN URL、图片维度等），验证上传完整性或生成临时下载链接

核心功能

1. 列表与筛选 - 浏览项目中的所有文件，支持按存储状态（已存储/未存储）、删除状态、上传日期范围排序和分页查询
2. 永久存储 - 通过文件 UUID 将临时文件标记为永久存储，防止 24 小时后自动删除；支持批量处理多个文件
3. 元数据与下载 - 查询文件的详细信息（文件名、大小、MIME 类型、上传时间、图片维度等），并生成临时下载链接用于分享或进一步处理

常见问题

Uploadcare 文件为什么会自动删除？

Uploadcare 默认将上传的文件视为临时文件，除非手动调用存储 API，否则文件会在 24 小时后自动删除。这是为了防止临时文件占用存储空间。

如何永久保存上传的文件？

需要调用 UPLOADCARE_STORE_FILE 工具并提供文件的 UUID（格式如 3e55317b-23d1-4f35-9b4c-b9accb7b53f4）。存储后文件将永久保留，不会被自动清理。

文件 UUID 格式要求是什么？

UUID 必须符合 8-4-4-4-12 的十六进制格式，例如 3e55317b-23d1-4f35-9b4c-b9accb7b53f4。格式错误的 UUID 会被 API 拒绝。