项目#
Ultralytics Platform 项目为你组织和管理模型提供了一个有效的解决方案。将相关的模型分组成组，以便于管理、比较和开发。
graph TB
P[Project]:::start --> M1[Model 1]:::proc
P --> M2[Model 2]:::proc
P --> M3[Model 3]:::proc
M1 --> C[Charts Dashboard]:::out
M2 --> C
M3 --> C
M1 --> T[Comparison Table]:::out
M2 --> T
M3 --> T
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef out fill:#9C27B0,color:#fff创建项目#
在侧边栏中导航至 Projects（项目），然后点击 New Project（新建项目）。
快速创建
你也可以从主页的快速操作中创建项目。
输入你的项目详情：
- Name（名称）：项目的描述性名称（自动生成随机名称）
- URL：项目别名，根据名称生成，在创建前可编辑
- Description（描述）：关于项目用途的可选注释
- Visibility（可见性）：公开（任何人均可查看）或私有（仅你和你的团队成员可以访问）。新项目默认为公开；企业工作区的新项目默认为私有，并使用 Ultralytics-Enterprise 许可。
- 许可证：项目的可选许可证（包括 AGPL-3.0、Apache-2.0、MIT、GPL-3.0、BSD-3-Clause、LGPL-3.0、MPL-2.0、EUPL-1.1、Unlicense、Ultralytics-Enterprise 等）。Ultralytics-Enterprise 许可证用于商业用途，无需满足 AGPL 要求，可通过企业版计划获取 — 详见 Ultralytics Licensing。
点击创建项目以完成。你的新项目将显示在“项目”列表和侧边栏中。
项目页面#
项目页面包含两个主要区域：
| 区域 | 描述 |
|---|---|
| Models Sidebar（模型侧边栏） | 可调整大小的模型列表，包含项目内所有模型，提供搜索、状态筛选、排序选项以及用于选择的复选框 |
| Main Panel（主面板） | 图表仪表板或比较表格（在视图之间切换） |
项目标题#
标题显示内容：
- 项目图标（可自定义颜色、字母或上传图片）
- 可编辑名称（点击重命名；别名会自动更新）
- 许可徽章
- 模型计数、已完成/运行中/失败计数、总大小
- 克隆计数和最后更新时间戳
- 描述（点击编辑）
标题中的操作按钮：
| 按钮 | 描述 |
|---|---|
| New Model（新建模型） | 为可编辑项目打开训练对话框 |
| Upload models | 为一个可编辑项目选择一个或多个 .pt 检查点 |
| Clone Project | 将一个公共项目及其已完成的模型克隆到你的工作区 |
| Star（收藏） | 给项目加星标或取消星标 |
| Share（共享） | 分享或嵌入公共项目 |
| Refresh（刷新） | 刷新项目数据 |
| Delete project | 将你拥有的项目及其模型移至回收站 |
视图模式#
使用视图控件在三种视图模式之间切换：
- Cards（卡片）：全宽模型侧边栏，右侧为图表仪表板 — 显示已选中模型的损失曲线和指标对比。
- Compact（紧凑）：精简的模型侧边栏，右侧为图表仪表板 — 为实验较多的项目模型提供更多纵向空间。
- Table（表格）：比较表格，并排显示训练参数和最终指标。启用 Diff（差异）可仅高亮显示跨模型的值不同的列。
模型侧边栏#
可调整大小的侧边栏列出了项目中的所有模型：
- 复选框：用于选择哪些模型显示在图表/表格中
- 搜索：按名称筛选模型
- 视图选项：用于状态筛选（全部、已完成、未训练、运行中、启动中、失败）、按任务分组以及排序
- 拖放
.pt文件直接到侧边栏以上传模型（模型上传详情） - 训练进度：显示运行中模型的训练进度（epoch 计数和进度条）
点击任意模型以打开其模型页面。
项目图标#
自定义项目图标：
- 点击项目名称旁边的图标
- 选择颜色和字母，或上传自定义图片
- 更改会自动保存
可见性设置#
控制谁可以查看你的项目：
| 设置 | 描述 |
|---|---|
| Public（公开） | 任何人均可在探索页面上查看 |
| Private（私有） | 仅你和你的团队成员可见 |
共享项目#
没有按项目邀请协作者的功能。若要与他人共享项目，请使用以下任一机制：
克隆项目#
将公开项目克隆到你自己的账户中：
- 访问该公开项目页面
- 点击 Clone Project（克隆项目）
- 项目及其已完成的模型会被复制到你的工作区；你可以在克隆对话框中选择克隆后的可见性
克隆的项目默认继承源项目的可见性（因此克隆公开项目会创建一个公开克隆），你可以在确认前通过克隆对话框选择公开或私有。企业工作区的新克隆默认设为私有。原项目上会显示克隆计数。如果原项目拥有 copyleft 许可（例如 AGPL-3.0），克隆项将继承并锁定该许可。
比较模型#
图表仪表板#
使用图表仪表板比较模型性能：
- 使用复选框在侧边栏中选择模型
- 按类型查看叠加的指标曲线（指标、训练损失、验证损失、学习率）
- 拖动图表以重新排列，通过拖动边缘调整大小
- 悬停以查看准确数值，点击图例项以隐藏/显示模型，点击模型线条以导航至该模型
可用的图表组：
| 分组 | 图表 |
|---|---|
| Metrics（指标） | mAP50, mAP50-95, 精度 (precision), 召回率 (recall) |
| Loss（损失） | train/box_loss, train/cls_loss, train/dfl_loss, val/box_loss, val/cls_loss, val/dfl_loss |
| Learning Rate（学习率） | lr/pg0, lr/pg1, lr/pg2 |
- 悬停查看准确数值
- 点击图例项隐藏/显示模型
- 拖动以缩放特定区域
- 点击模型线条导航至该模型页面
- 重新排列并调整图表大小；布局会在会话间保持
比较表格#
切换到表格视图，以便并排比较训练参数和最终指标：
- 点击 Table（表格）视图模式切换按钮
- 查看所有选定模型，行表示模型，列表示训练参数和指标
- 使用 Diff（差异）按钮，仅高亮显示不同模型间数值不同的列
上传模型#
上传现有的 .pt 模型文件：
- 拖放文件到项目页面或模型侧边栏
- 可以同时上传多个文件（最多 3 个并发上传）
- 模型元数据（任务、架构、类别名称、训练结果）是从
.pt文件中自动解析的 - 图表会根据本地解析的数据即时更新，同时后台会继续完成上传
仅支持来自 Ultralytics YOLO 训练的 PyTorch .pt 文件。Platform 会解析嵌入的元数据，包括训练结果、参数、任务类型和类别名称。有关格式详情，请参阅模型。
编辑项目#
更新项目名称、描述或设置：
- 点击项目名称进行内联编辑
- 点击描述进行内联编辑
- 点击图标进行自定义
- 点击许可证徽章以更改许可证
自定义元数据#
打开更多操作并选择信息以查看以下两个部分：
- Ultralytics 元数据：只读的 Platform 详细信息，例如项目 ID、所有者、可见性、许可证、标签和时间戳
- 自定义元数据：你自己的用于部门、项目、成本中心、治理或其他组织上下文的 JSON 对象
工作区查看者可以检查元数据，而拥有编辑权限的成员可以替换自定义元数据对象。序列化元数据对象限制为 500,000 个字符，每个顶级键限制为 128 个字符。保存空对象（{}）以清除自定义元数据。
删除项目#
移除你不再需要的项目：
- 点击标题栏中的 Delete（删除）按钮（垃圾桶图标）
- 确认删除
删除项目也会删除其中的所有模型。此操作会将项目移至回收站，在那里它们可以在 30 天内恢复。
常见问题解答#
一个项目可以包含多少个模型？#
没有单独的每个项目模型限制。工作区范围的套餐限制适用于所有项目：Free 支持 100 个模型，Pro 支持 500 个，Enterprise 则无限制。为了更清晰地进行对比：
- 将相关实验（相同数据集/任务）进行分组
- 当不再需要过时的运行结果时，将其移至回收站
- 使用有意义的项目名称
我可以恢复已删除的项目吗？#
可以，删除的项目会进入 Trash（回收站），并且可以在 30 天内恢复：
- 转到设置 > 回收站
- 找到该项目
- 点击 Restore（恢复）
我可以在项目之间迁移模型吗？#
可以，你可以使用模型页面上的克隆模型对话框将模型克隆到不同的项目中。