回收站与恢复#

Ultralytics Platform实施 30 天软删除策略，让你可以恢复误删的项目、数据集和模型。删除的项目会移至回收站，你可以在永久删除前将其恢复。

软删除策略#

当你在平台上删除资源时：

1. 立即：项目会移至回收站（不会被永久删除）
2. 30 天内：项目在回收站中保持可恢复状态
3. 30 天后：项目会被自动永久删除

访问回收站#

前往回收站：

1. 前往 Settings，然后点击 Trash 选项卡
2. 或直接前往 /trash（重定向至 Settings > Trash）

回收站内容#

回收站显示所有软删除的资源，并提供筛选选项卡，每个选项卡显示实时数量；此外还有一个搜索框，可按名称和类型进行匹配：

查看回收站项目#

回收站中的每个项目都会显示：

（对于模型，回收站 API 会返回父项目信息，但回收站表格不会显示该信息。）

级联行为#

删除父资源时，子资源也会移至回收站：

存储树状图#

回收站选项卡包含存储可视化图（树状图），用于显示回收站项目的相对大小，并按类型以不同颜色区分：

• 蓝色：项目
• 绿色：数据集
• 紫色：模型

恢复项目#

恢复已删除的项目（团队工作区中需要 Editor 角色或更高权限）：

1. 前往 Settings > Trash
2. 找到你想恢复的项目
3. 点击 Restore 按钮（撤销图标）

该项目将恢复到原位置，且所有数据保持完整。

如果原始 slug 已被占用，平台会使用唯一且可用的 slug 恢复该项目，让你可以立即访问。

恢复行为#

永久删除#

自动删除#

回收站中的项目会在 30 天后自动永久删除。

清空回收站#

立即永久删除所有项目：

1. 前往 Settings > Trash
2. 点击标题栏中的回收站图标
3. 确认操作

永久删除单个项目#

无需等待即可永久删除单个项目：

1. 在回收站中找到该项目
2. 点击其所在行的 Delete permanently（回收站）按钮
3. 确认删除——对话框会显示项目名称以及随其级联删除的模型数量

对于项目，永久删除还会移除属于已删除工作区资源的相关部署和导出文件。如果某个部署无法删除，平台会向你发出警告，并将其继续列在 Deployments 页面中，以便你从该页面重试。

存储空间与回收站#

回收站中的项目仍会计入你的存储配额：

API 访问#

通过 REST API 以编程方式访问回收站。全部三项操作都使用同一个 /api/trash 路径，并作用于生成 API 密钥的工作区——要管理团队工作区的回收站，请使用该工作区的 API 密钥。Python 示例使用 ultralytics-platform SDK：

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://platform.ultralytics.com/api/trash?type=all&page=1&limit=50"

trash = client.lifecycle.trash(type="all", page=1, limit=50)

恢复和删除操作需要 Editor 或更高权限。

常见问题#