标注和项目

Selector 工作区

• 画布显示当前图像和标注。
• 工具栏切换选择、创建、移动、调整大小和链接。
• 属性面板显示所选对象的类型、名称、几何形状、描述和关系。
• 树和图帮助查找对象并检查它们的关系。

创建和编辑元素

1. 选择创建工具并在画布上选择对象的区域。
2. 提供类型和友好名称，然后根据需要添加说明。
3. 使用移动和调整大小工具来细化对象的边界。
4. 在所需的帧或源状态上测试对象。

选择多个对象允许您执行支持的常见操作。在进行批量更改之前，请保存项目或确保可以撤消操作。

特征和处理区域

特征描述元素或其片段的视觉属性。它可以用作模板、计算机视觉方法的区域或比较材料。

• 该特征与所有者和原始图像相关联。
• 裁剪、蒙版和预览可帮助您检查保存的素材。
• 如果所选操作需要，复制特征会创建单独的链接文件。
• 处理区域将测量或处理限定在图像的一部分。

关系和分组

元素关系连接元素与特征，例如指定层级、所有者或领域关系。选择关系后可查看其类型和关联对象。

组保存在项目中并由支持的工作流程创建。当前版本中没有用于自定义组的通用可视化编辑器。

文字和语音描述

该描述可以与元素、特征、关系、匹配或图像系列相关联。在保存到项目之前对文本进行编辑。

语音标注使用所选语音识别方式。本地 Vosk 的音频保留在计算机上；云端方式会将录音发送给所选服务。

多视图和图像分析

画布布局允许您同时查看同一项目的不同材料。缩放、滚动和光标可以在视图之间同步。

• 放大镜和像素视图显示光标下的值。
• 直方图和线剖面用于评估亮度和颜色。
• 图层和比较允许您将原始图像与方法的结果进行比较。

视图内容的布局属于本地设置，可能不会随项目一起转移。

修改历史

受支持的标注修改可撤销和重做。打开其他项目或结束会话后，可用历史可能变化；重要步骤请另存独立副本。

保存和加载

• Ctrl+S: 保存当前项目。
• Ctrl+O: 打开项目管理器并选择项目或自动保存。
• 另存为在新位置创建项目。操作后，请检查关联图像和结果。

保存时，将检查项目结构和关联文件的可用性。在将项目传输给其他用户之前，必须更正有关丢失图像或结果的警告。

项目管理器和自动保存

管理器显示找到的项目、自动保存和有读取问题的文件。在恢复自动保存之前，请创建当前项目的副本。

复制、移动或重命名项目后，从新位置打开它并再次保存以检查所有内容引用。

计算机视觉

计算机视觉操作会生成与主要标注分开的结果。运行、预览、序列、处理图及结果应用见计算机视觉手册。

Screph Code

Screph Code 是内置智能体 IDE，用于基于项目数据处理文件和请求。保存项目后，可将选定的图像、标注和获准数据移交到独立的代码工作目录。Screph 项目与该目录分别保存。

• Builder 可以用文本响应并修改所选工作文件夹中的文件。
• 在出现提示之前，将工作文件夹保存到版本控制或作为备份。
• 回答后查看修改、创建、删除的文件。
• Builder 可在所选访问模式范围内修改文件和执行命令。“停止”在完成资源清理后结束当前工作，但不会撤销已写入的文件。智能体的回复不能证明最终程序可正常工作。

在文件、对象和更改选项卡中检查源代码、附件和修改。离开未保存的文件时，可以保存、放弃更改或取消切换。若文件被外部修改，请先检查，再替换编辑器中的文本。

模型与 Code 执行引擎分别选择。准备好相应连接和环境后，可使用“按连接”、Codex 或 OpenHands。与 Agent 共用聊天外观不会合并历史、上下文或权限。Codex Desktop 是独立应用；向其移交草稿不代表已向模型提交请求。

Screph Code 聊天

数据集与模型训练

1. 创建数据集并设置名称、任务和类别。通过“添加数据”导入文件、文件夹、所选 Capture 帧或 Canvas 素材。General 中提供 Flowers mini 示例数据集，可像普通数据集一样编辑。
2. 在画布上分配类别并创建边界框或掩码。对于没有对象的图像，请确认空场景；缺少标注不等于负样本。排除有误的样本，并对尚未审核的样本进行质量检查。
3. 解决“下一步”中列出的数据问题。选择要训练的模型、权重、设备和参数。如果环境尚未就绪，“开始训练”会打开环境准备窗口；此时数据集已保存。
4. 第一次点击“开始训练”会检查输入、固定数据集版本，并用真实样本生成预处理预览。检查预览后，需要单独确认运行。准备和训练期间锁定数据集编辑；“停止”取消当前工作。
5. “结果”显示历史、指标、运行比较和错误。应在可编辑数据集中修正问题，再用新运行检查；旧版本和结果不会被覆盖。在数据或参数改变之前，不能重复完全相同的成功运行。
6. 简化流程使用验证集评估结果发布候选模型。高级视图还可单独在留出测试集上执行最终评估。预测预览不能替代此评估。
7. 在“模型”页面发布命名模型，选择主模型并填写应用配置。若要传递给最终程序，请单独启用权限，并指定输入数据源和结果用途。发布模型或将其选为主模型不会自动启用向智能体的传递。

“数据集与训练”选项卡使用同一画布。分类为图像指定一个类别，检测保存对象框，实例分割保存各实例的二值掩码。“简化”和“高级”显示同一份数据、参数和结果；程序模式决定可用任务和模型。

Canvas 区域通过明确导入与数据集样本关联。移动或删除区域本身不会修改已保存的数据集标注。同一序列的图像以及同一来源的裁剪在划分数据时保持同组，避免相邻帧同时进入训练和独立验证。

单击选择缩略图不会替换画布图像。“在 Canvas 上打开所选项”可打开样本进行标注，双击则打开单独预览。检测标注时，选择类别和“ML · 矩形”，再框出对象；可以调整、删除边界框或重新指定类别。

分割标注使用多边形、画笔和橡皮擦工具。每个实例创建独立掩码。点和边界框提示需要准备好 MobileSAM；向相邻帧传播使用所选的可用处理器。需要接受、拒绝或修改建议掩码；它不会自动成为已确认标注。

“需要检查”“确认标注”“图像中没有对象”和“从训练中排除”含义不同。被排除的样本仍会保存，但不参与训练。恢复样本后，即使保留了原类别，也需要重新检查质量。

在训练预览中检查真实图像和标注的变换：尺寸、裁剪、填充和数据增强。取消会返回设置，不启动训练。切换标签页会保留待确认预览；返回 Learning 后再确认。

“添加当前图像/标注…”会明确导入所选内容。分类任务将区域保存为独立裁剪样本；检测和分割任务则保留完整帧及其边界框或掩码。快速添加可使用“创建”→“区域 → 数据集”，并在画布上方选择数据集和类别。

“智能体”打开只读的 Learning 助手，使用训练与验证摘要及当前配置。需在语言模型的“任务模型”页面单独指定模型。图像、路径和留出的测试子集不会发送到此聊天；它不能启动训练或修改数据。数据集助手的标注和补充生成属于独立任务，需要查看并明确接受；接受的建议仍需质量检查。

保存训练与恢复

默认情况下，长时间本地训练独立于应用窗口运行。重新打开后，历史会重新连接到已保存运行。如果已确认进程停止且存在完整的轮次检查点，会提供明确的继续操作。未知状态不代表可以自动启动另一份训练。

草稿、固定数据集版本、运行、候选模型和已发布模型分别保存。迁移时使用项目、数据集或模型的导出命令；仅有权重文件不能带走标注和历史。检测和分割支持 COCO 导出，检测支持 Screph-manifest YOLO 导出。

摄像头标定与帧的使用

在“捕获”→“来源”中，General、Industrial 和 UAV 模式的摄像头、流和文件来源可使用“摄像头标定…”。选择镜头模型和标定靶，确认摄像头、尺寸、焦距和变焦一致，并且未预先校正镜头。

可通过文件、时间轴或已运行来源的自动采集添加帧。计算至少需要八个拟合帧和三个留出的验证帧。点击“计算”后检查误差和警告；配置文件保存为 JSON，采集集保存为 ZIP。ZIP 与项目分别保存，可用于以后继续。

“校正图像…”为同一摄像头和图像尺寸创建结果。比较模型后应使用新的验证帧。标定、教学模型以及成功处理图像都不能证明摄像头、机器人或飞行控制能力；空间尺度需单独验证。

结束工作前

1. 保存项目并等待文件写入。
2. 检查相关内容的警告。
3. 创建项目目录的备份副本，并单独创建包含代码的工作文件夹。