废纸篓与恢复#
Ultralytics Platform 实施 30 天软删除策略，让你可以恢复意外删除的项目、数据集和模型。已删除的项目会移至废纸篓，你可以在永久删除前将其恢复。
软删除策略#
你在平台上删除资源时：
- 立即：项目移至废纸篓（不会被永久删除）
- 30 天内：项目仍可在废纸篓中恢复
- 30 天后：项目将自动永久删除
你有 30 天时间恢复任何已删除项目。超过此期限后，该项目及其所有相关数据都会被永久删除，且无法恢复。
访问废纸篓#
前往废纸篓：
- 前往 设置，然后点击 废纸篓 标签页
- 或者直接前往
/trash（会重定向到Settings > Trash）
废纸篓内容#
废纸篓会显示所有软删除的资源，并提供筛选标签页，每个标签页都显示实时数量；此外还有一个搜索框，可按名称和类型匹配 结果：
| 筛选条件 | 显示内容 |
|---|---|
| 全部 | 所有已移至废纸篓的项目 |
| 数据集 | 已移至废纸篓的数据集 |
| 项目 | 已移至废纸篓的项目 |
| 模型 | 已移至废纸篓的模型 |
查看废纸篓中的项目#
废纸篓中的每个项目都会显示：
| 字段 | 说明 |
|---|---|
| 名称 | 原始资源名称 |
| 输入 | 项目、数据集或模型（以颜色区分） |
| 删除时间 | 项目被删除的时间 |
| 到期时间 | 距离永久删除的天数（例如“30d”）；少于 15 天时显示琥珀色，少于 8 天时显示红色 |
| 大小 | 项目占用的存储空间 |
| 级联删除 | 包含的子项目会显示为名称旁边的 +N 徽标 |
（Trash API 会返回模型的父项目相关信息，但不会在废纸篓表格中显示。）
级联行为#
删除父资源时，子资源也会移至废纸篓：
将模型（或包含模型的项目）移至废纸篓时，会取消该模型正在进行的任何云端训练，并 终止其 GPU 实例。已用 GPU 时间仍会计费。请参阅 计费。
存储树状图#
废纸篓标签页包含存储可视化图（树状图），按类型以不同颜色显示已移至废纸篓的项目相对大小：
- 蓝色：项目
- 绿色：数据集
- 紫色：模型
恢复项目#
恢复已删除的项目（在团队工作区中需要编辑者或更高角色）：
- 前往 设置 > 废纸篓
- 找到要恢复的项目
- 点击 恢复 按钮（撤销图标）
该项目会返回原位置，所有数据均保持完整。
如果原始别名已被占用，平台会使用一个唯一且可用的别名恢复该项目，让你可以立即访问。
恢复行为#
| 资源 | 恢复行为 |
|---|---|
| 项目 | 恢复项目及其中的所有模型 |
| 数据集 | 恢复数据集及其所有图像和标注 |
| 模型 | 如果项目处于活动状态，则将模型恢复到原始项目 |
如果模型的父项目位于回收站中，则无法恢复该模型。你会看到以下错误：“无法在父项目位于回收站时恢复模型。请先恢复项目。”恢复单个模型前，务必先恢复父项目。
永久删除#
自动删除#
回收站中的项目会在 30 天后自动永久删除。
清空回收站#
立即永久删除所有项目：
- 前往 设置 > 废纸篓
- 点击页眉中的回收站图标
- 确认操作
清空回收站会立即永久删除所有项目。此操作无法撤销，所有数据都会丢失，包括与已移至回收站的资源关联的部署、导出作业和存储文件。
永久删除单个项目#
如需立即永久删除单个项目：
- 在回收站中找到该项目
- 点击该项目所在行中的 永久删除（回收站）按钮
- 确认删除 — 对话框会显示项目名称以及随其级联删除的模型数量
对于项目，永久删除还会移除属于已删除工作区资源的相关部署和导出文件。如果无法删除某个部署，平台会向你发出警告，并将该部署保留在你的个人资料部署选项卡中；打开该部署页面即可重试删除。
存储空间与回收站#
回收站中的项目仍会计入你的存储配额：
| 场景 | 对存储空间的影响 |
|---|---|
| 删除项目 | 仍占用存储空间 |
| 恢复项目 | 没有变化（仍计入配额） |
| 永久删除 | 释放存储空间 |
| 30 天后自动删除 | 自动释放存储空间 |
API 访问#
通过 REST API 以编程方式访问回收站。所有三种操作都使用同一个 /api/trash 路径，并针对签发 API 密钥的工作区执行 — 要管理团队工作区的回收站，请使用该工作区的 API 密钥。Python 示例使用 ultralytics-platform SDK：
from ultralytics_platform import Platform
client = Platform() # reads ULTRALYTICS_API_KEYcurl -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)type 接受 all、project、dataset 或 model。limit 默认为 50，最大为 200。列出内容需要查看者或更高级别的访问权限。
恢复和删除操作需要编辑者或更高级别的访问权限。
常见问题#
不能。30 天后，项目会被永久删除且无法恢复。请务必在回收站显示的到期日期前恢复重要项目。
项目及其中所有活动模型会一起移至回收站。恢复项目时，也会恢复随项目一同移至回收站的模型。父项目仍在回收站中时，无法恢复级联删除的模型。
会，回收站中的项目仍会占用存储配额。要释放空间，请永久删除项目或清空回收站。
不能。如果项目被永久删除，其中的所有模型也会被永久删除。请务必在 30 天期限结束前恢复项目。
回收站中的每个项目都会显示一个“到期时间”列，其中标明距离自动永久删除还有多少天（例如“30d”）。