项目#
Ultralytics Platform 项目为组织和管理模型提供了有效的解决方案。将相关模型归组,以便更轻松地进行管理、比较和开发。
graph TB
P[Project]:::start --> M1[Model 1]:::proc
P --> M2[Model 2]:::proc
P --> M3[Model 3]:::proc
M1 --> S[Check in Sidebar]:::proc
M2 --> S
M3 --> S
S --> C[Charts]:::out
S --> T[Comparison Table]:::out
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef out fill:#9C27B0,color:#fff创建项目#
在侧边栏中导航到 Projects,然后点击 New Project。

快速创建
你也可以通过 Home 页面上的快速操作创建项目。
输入项目详细信息:
- Name:项目的描述性名称(系统会自动生成一个随机名称)
- URL:项目 slug,根据名称生成,可在创建前编辑
- Description:关于项目用途的可选备注
- Visibility:Public(任何人都可以查看)或 Private(只有你和团队成员可以访问)。新项目默认为 Public;Enterprise 工作区中的新项目默认为 Private,并使用 Ultralytics-Enterprise 许可证。
- License:项目的可选许可证(None、Apache-2.0、MIT、BSD-3-Clause、AGPL-3.0、GPL-3.0、LGPL-3.0、MPL-2.0、EUPL-1.1、Unlicense、CC0-1.0、Ultralytics-Enterprise 或 Other)。Ultralytics-Enterprise 许可证适用于商业用途,且不受 AGPL 要求限制;Enterprise 计划包含此许可证——请参阅 Ultralytics 许可。Enterprise 工作区会为新项目预先选择此许可证。

点击创建项目完成操作。你的新项目会显示在项目列表和侧边栏中。
项目页面#
项目页面包含两个主要区域:
| 区域 | 描述 |
|---|---|
| 模型侧边栏 | 可调整大小的项目中所有模型列表,并提供用于选择图表的复选框 |
| 主面板 | 图表仪表板或比较表(可在两种视图之间切换) |
两个区域上方的控件行包含模型搜索框、Diff 开关(仅限表格视图,并标注存在差异的列数)、视图选项下拉菜单和视图模式切换按钮。

项目页眉#
页眉显示:
- 项目图标(可自定义颜色、字母或上传的图像)
- 可编辑名称(点击即可重命名;slug 会自动更新)
- 许可证选择器(点击即可更改;从克隆项目继承的 copyleft 许可证已锁定)
- 模型数量、已完成/训练中/失败数量、总大小
- 克隆数量和最后更新时间
- 描述(点击即可编辑)
页眉中的操作按钮:
| 按钮 | 描述 |
|---|---|
| New Model | 为可编辑项目打开训练对话框 |
| Upload models | 为可编辑项目选择一个或多个 .pt 检查点 |
| Clone Project | 将公共项目及其已完成模型克隆到你的工作区 |
| Star | 为项目加星标或取消星标 |
| Share | 分享或嵌入公共项目 |
| More actions | 所有者可执行 Information(元数据)、Refresh 和 Delete Project |
项目的可见性徽章位于页面顶部面包屑中的项目名称旁边;点击它即可在公共和私有之间切换。
视图模式#
使用视图控件在三种视图模式之间切换。系统会按项目记住所选模式。
- Cards:侧边栏中显示完整大小的模型卡片,右侧显示 Charts 仪表板——用于查看已选模型的损失曲线和指标比较。
- Compact:精简的模型侧边栏,右侧显示 Charts 仪表板——在包含大量实验的项目中为模型提供更多垂直空间。
- Table:并排显示训练参数和最终指标的比较表。启用 Diff 后,仅显示不同模型之间值有差异的列。

筛选和排序#
模型列表上方的控件行提供:
- Search:按名称筛选模型
- Status filter:All、Completed、Untrained、Running、Starting 或 Failed
- Group by:None 或 Task——分组适用于 Compact 和 Table 模式
- Sort by:Created、Name 或 Size,每项都支持升序或降序
模型侧边栏#
可调整大小的侧边栏列出项目中的所有模型:
- 复选框:选择要在图表和比较表中显示的模型
- 拖放
.pt文件到侧边栏中,直接上传模型(模型上传详情) - 训练进度:显示正在运行模型的训练进度(epoch 数量和进度条)
- 模型颜色选择器,在每个图表中保持一致
点击任意模型即可打开其模型页面。
项目图标#
自定义项目图标:
- 点击项目名称旁边的图标
- 选择颜色和字母,或上传自定义图像
- 更改会自动保存
可见性设置#
控制谁可以查看你的项目:
| 设置 | 描述 |
|---|---|
| 公开 | 任何人都可以在 Explore 页面查看 |
| 私有 | 只有你和团队成员可以查看 |
分享项目#
项目不支持单独邀请协作者。要与他人分享项目,请使用以下任一机制:
克隆项目#
将公共项目克隆到你自己的账户:
- 访问公共项目页面
- 点击 Clone Project
- 项目及其已完成模型会复制到你的工作区;你可以在克隆对话框中选择克隆项目的可见性
克隆项目默认继承源项目的可见性(因此克隆公共项目会创建公共克隆),你可以在确认前于克隆对话框中选择 Public 或 Private。Enterprise 工作区中的新克隆项目默认为私有。克隆数量会显示在原始项目上。如果原始项目使用 copyleft 许可证(例如 AGPL-3.0),克隆项目会继承该许可证,并且该许可证会被锁定。
比较模型#
图表仪表板#
使用图表仪表板比较模型性能:
- 使用复选框在侧边栏中选择模型
- 查看按类型分组的叠加指标曲线(指标、损失、学习率)
- 拖动图表重新排列,通过拖动边缘调整大小
- 悬停即可查看确切值,点击图例项目可隐藏或显示模型,点击模型曲线可导航到该模型
可用的图表组:
| 组 | 图表 |
|---|---|
| 指标 | 任务指标,例如用于目标检测的 mAP50、mAP50-95、precision 和 recall |
| Loss | 每个损失分量对应一个图表(box、cls、…),训练数据使用实线,验证数据使用虚线 |
| 学习率 | lr/pg0、lr/pg1、lr/pg2 |
比较针对不同任务训练的模型是可行的,但每个模型只会在图表中绘制它实际报告的指标。
- 悬停查看精确值
- 点击图例项以隐藏/显示模型
- 拖动以缩放到特定区域
- 点击模型线以导航到该模型的页面
- 折叠组,或使用其菜单隐藏单个图表以及训练或验证损失序列
- 重新排列图表并调整大小;布局会在不同会话之间保留
比较表#
切换到表格视图,逐项比较训练参数和最终指标:
- 点击 Table 视图模式切换开关
- 将所有选定模型显示为行,将训练参数和指标显示为列
- 使用 Diff 按钮,仅显示不同模型之间值有差异的列
上传模型#
上传现有的 .pt 模型文件:
- 将文件拖放到项目页面或模型侧边栏中
- 可以同时上传多个文件(最多同时上传 3 个文件)
- 模型元数据(任务、架构、类别名称、训练结果)会从
.pt文件中自动解析 - 图表会根据本地解析的数据即时更新,同时上传在后台完成
仅支持来自 Ultralytics YOLO 训练的 PyTorch .pt 文件。Platform 会解析嵌入的元数据,包括训练结果、参数、任务类型和类别名称。有关格式详情,请参阅 Models。
编辑项目#
更新项目名称、描述或设置:
- 点击项目名称以内联方式进行编辑
- 点击描述以内联方式进行编辑
- 点击图标进行自定义
- 点击许可证徽章以更改许可证

自定义元数据#
打开 更多操作,选择 信息,查看以下两个部分:
- Ultralytics 元数据:只读的 Platform 详细信息,例如项目 ID、所有者、可见性、许可证、标签和时间戳
- 自定义元数据:用于记录部门、项目、成本中心、治理或其他组织背景信息的自定义 JSON 对象
工作区查看者可以检查元数据,而拥有编辑权限的成员可以替换自定义元数据对象。序列化后的元数据对象最多包含 500,000 个字符,每个顶级键最多包含 128 个字符。保存空对象({})即可清除自定义元数据。
删除项目#
移除不再需要的项目:
- 打开标题栏中的 More actions 菜单,然后选择 Delete Project
- 确认删除
删除项目也会删除其中的所有模型。此操作会将项目移至 Trash,你可以在 30 天内恢复它们。
常见问题#
没有单独的每个项目模型数量限制。整个工作区的计划限制适用于所有项目:免费版支持 100 个模型,Pro 支持 500 个模型,Enterprise 不限数量。为了更清晰地进行比较:
- 将相关实验分组(相同数据集/任务)
- 不再需要过时的运行记录时,将其删除到 Trash
- 使用有意义的项目名称
可以,已删除的项目会移至 Trash,并可在 30 天内恢复:
- 前往 Settings > Trash
- 找到项目
- 点击 Restore