回收站与恢复#

Ultralytics Platform 实施 30 天的软删除策略，允许你恢复意外删除的项目、数据集和模型。删除的项目会移至“回收站”，在永久删除之前可以进行恢复。

软删除策略#

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

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

访问回收站#

导航到你的回收站：

1. 进入 Settings（设置）并点击 Trash（回收站）选项卡
2. 或者直接导航到 /trash（重定向到 Settings > Trash）

回收站内容#

回收站会显示所有软删除的资源，并带有筛选标签页（每个标签页显示实时计数），以及一个可按名称和类型匹配的搜索框：

查看回收站项目#

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

（父项目信息由回收站 API 为模型返回，但不会显示在回收站表格中。）

级联行为#

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

存储树状图#

回收站选项卡包含一个存储可视化图（树状图），显示已删除项目的相对大小，并按类型进行颜色编码：

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

还原项目#

恢复已删除的项目（团队工作空间中的编辑者角色或更高权限）：

1. 导航到 Settings > Trash（设置 > 回收站）
2. 找到你想要还原的项目
3. 点击 Restore（还原）按钮（撤销图标）

该项目将返回其原始位置，且所有数据保持完整。

如果原始标识符（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 访问权限或更高权限。

常见问题解答#