文件管理¶

文件管理是本机自动化资产的统一入口。这里管理的是实际文件，不是自动化工作区中的临时列表：重命名、移动或删除资源都会影响磁盘上的数据；已经挂载的自动化也可能随之更新或失效。

进入文件管理¶

在主界面左侧固定导航中选择“文件管理”。资源按照标签分组显示；顶部搜索用于缩小当前列表，排序可在“文件名”和“更新时间”之间切换，再次选择同一排序方式可切换升序或降序。

这里管理什么¶

普通拖入或粘贴文件管理中的 .gcbp 时，软件会分配新 ID 并写入一份包内副本；之后修改来源 .gcbp，不会自动修改包内副本。“添加至预设”会读取所选普通本地蓝图的正文和资源，复制到指定自动化并分配新的本地 ID；即使目标包已有同 ID，也不会替换成已有正文。取消目标选择不会写入，受保护内容仍受原有签名和授权限制。同一自动化内的 Alt+V 关联粘贴共用当前包内正文，范围见自动化工作区。直接在自动化内部新建的蓝图只属于该 .gcbps，不会另外出现在文件管理中。

更多格式规则见文件格式、导入与导出。

标签与整理¶

标签同时是文件管理的分组和存储目录。

1. 在标签标题或空白处右键，选择“添加标签”。
2. 在非默认标签上右键，可重命名标签。
3. 拖动标签可调整显示顺序；这只改变文件管理的排列，不改变自动化执行顺序。
4. 把资源拖到另一标签可移动文件。遇到同名资源时，软件会要求确认新名称或自动分配不冲突的名称。

移动或重命名已挂载的 .gcbps 时，软件会同步更新挂载路径，因此正常的文件管理操作不会单独制造失效挂载。ONNX 与蓝图或自动化包需要分开移动，混合选择时不会执行移动。

默认标签用于提供稳定的创建位置，不能重命名。当前文件管理菜单不提供删除标签的操作；需要整理时可移动其中资源并重命名其他标签。

创建资源¶

在目标标签上右键，可以执行：

• “新建蓝图”：创建一个独立 .gcbp。
• “新建自动化”：创建一个空的 .gcbps，但不会自动把它挂载到所有 App 分页。
• “新建识图类 ONNX 模型”：在支持训练的本地 Debug 构建中打开模型训练界面，并把生成结果加入当前标签；当前尚未开放发行版训练组件。
• “导入 ONNX 模型”：选择一个或多个 .onnx 文件并复制到当前标签。

选中至少两个普通 .gcbp 后，可以选择“打包为蓝图包”。新建的 .gcbps 按文件管理中的当前排列顺序包含这些蓝图，原来的 .gcbp 仍然保留。对允许解散的 .gcbps 选择“解散蓝图包”时，包内蓝图会成为当前标签中的独立 .gcbp，原包会被删除并解除挂载。

自建检测或图像分类模型（本地 Debug）¶

同一个“新建识图类 ONNX 模型”入口可选择目标检测或图像分类。检测任务为目标画框，用于查找物体位置；图像分类为整张输入图指定一个类别，用于区分画面状态。分类是单标签任务，一张图只选一个类别；需要判断某个局部区域时，先准备该区域的图片，并在推理时使用相同区域。

1. 创建训练项目并选择任务，添加自己定义的标签。分类至少需要两个类别，例如“技能就绪”和“技能未就绪”。
2. 导入图片。检测任务添加标注框或明确确认负样本；分类任务为每张图指定类别，不需要画框。切换任务会保留原有框标注和分类记录。
3. 分类的每个类别至少准备两张独立有效图片，每张图的宽、高都不能小于 10 像素，全部图片都必须指定类别。损坏、无法完整解码、同内容的重复图片会被拒绝；复制文件或改文件名不会增加独立样本数，也不能把同一图片分给不同类别。每类会分别划分训练集与验证集，防止同内容图片跨集合泄漏。
4. 选择对应任务的本地基础模型和训练参数。分类使用 YOLOv8n-cls 或 YOLOv8s-cls，不能用检测权重代替；缺少组件或权重时先完成安装，训练不会自动下载依赖。分类尺寸须为 32 的倍数。
5. 开始训练，等待验证与 ONNX 导出完成。导出保留项目标签顺序，并将分类的缩放、中心裁剪、颜色与归一化配置写入模型本体；在 ONNX 推理节点选择模型后可自动读取。导出文件名冲突时会分配新名称，不覆盖已有模型。

训练项目可以先保存再继续补充图片。两类、每类两张只是启动条件，不能保证识别可靠；应使用覆盖实际场景、与训练样本独立的图片检查误判。当前合成图片短训示例只验证训练、导出和推理管线，不代表业务准确率，也不代表发行版或云端已经提供训练服务。

后续接线见 ONNX 推理。分类判定“技能就绪”只说明当前画面符合该状态；技能是否成功释放，仍需输入动作之后再次截图，检查释放结果或状态变化。

打开、重命名和定位¶

• 双击或使用“编辑”打开 .gcbp；.gcbps 应在自动化工作区中挂载后编辑其顺序与包内蓝图。
• 选中资源后按 F2，或使用右键菜单重命名。
• 使用“在文件资源管理器中显示”定位实际文件或标签目录。
• ONNX 资源可使用“识别 / 重新识别”更新模型类型标注；识别失败不会把模型变成蓝图。

部分来自账号、商品或热更新的资源可能受权限约束。右键菜单中的灰色项目表示当前类型、选择数量或权限不满足操作条件。

复制、剪切和粘贴¶

文件管理与自动化工作区共享蓝图剪切板，Ctrl+C、Ctrl+X 和 Ctrl+V 的结果由复制来源和粘贴位置共同决定。

ONNX 不参与这套蓝图剪切板；请用拖动、导入和标签移动管理模型。剪切内容跨到另一类工作区粘贴时会按“复制到目标”的语义处理，并结束原来的待剪切状态，避免跨存储边界误删来源。

剪切板数据会写入系统剪切板，因此可以在文件管理和自动化工作区之间切换后再粘贴。复制其他文本或文件后，原来的蓝图剪切板可能被覆盖。

删除与回收站¶

删除前先区分“删除文件”和“从自动化顺序移除步骤”：

• 在文件管理中删除 .gcbp，会删除独立蓝图文件；正常情况下文件进入 Windows 回收站。应用内的撤销不能恢复这类删除。
• 删除 .gcbps 会删除自动化包并清除指向它的挂载；同一文件即使挂载在多个 App 分页，也会一起失效。当前应用内没有恢复入口，重要包应先复制或在资源管理器中备份。
• 删除 ONNX 会同时删除文件管理中的模型资源，此操作按确认提示不可撤回。

如果节点或蓝图仍引用被删除的资源，后续编辑或运行可能出现资源为空、挂载缺失或执行失败。删除确认可以在设置中改为直接删除；这只减少确认步骤，不改变数据影响。

限制¶

• 文件管理只直接编辑普通蓝图；自动化顺序要在自动化工作区调整。
• ONNX 不能拖到 App 分页、自动化侧栏或蓝图步骤序列中。
• 不同类型资源支持的右键操作不同，混合多选时只执行所有项目都允许的操作。
• 外部文件被手动移动或删除时，软件无法像内部重命名或标签移动那样自动修复路径。

相关内容¶

• 文件格式、导入与导出
• 自动化工作区
• 蓝图编辑器
• 故障排查