4. 工程文件与项目结构

在 MotoSim EG-VRC 中，一个“工程”并不只是单个文件，而是由工程文件、机器人模型、控制器参数、示教程序、外部轴数据以及若干辅助资源共同组成的集合。很多初学者在虚拟调试中遇到的“打开工程后机器人不见了”“程序能运行但工具坐标丢失”“换台电脑就报路径错误”，根源往往不在仿真逻辑，而在工程文件与目录组织没有按规范管理。本节围绕新建工程、导入机器人、保存与备份、目录组织四个环节，说明如何建立一个可长期维护、可迁移、可回溯的虚拟调试工程。

一、新建工程：先定坐标系与控制器，再建文件

启动 MotoSim EG-VRC 后，通过 File → New Project 新建工程。此时软件会要求指定工程名称、存储路径以及初始控制器类型。工程名称建议采用“项目代号_工位_版本”的形式，例如 PJ01_WeldStation_V01，避免使用中文、空格和特殊符号，因为部分控制器参数文件对路径字符敏感。

新建工程时最关键的一步是选择控制器型号与机器人系列。MotoSim 的工程文件会记录控制器类型（如 DX200、YRC1000）、机器人型号（如 MH6、GP25）以及对应的软件版本。如果控制器选错，后续导入的机器人可能无法与虚拟示教器正常通信。因此建议在新建前先确认现场实际控制柜型号，再在软件中选择匹配项。若只是做离线编程验证，也应选择与现场一致的控制器，否则程序中的变量、I/O 分配和坐标系定义会出现偏差。

新建完成后，软件会自动生成一个工程目录，其中包含工程主文件、机器人模型文件夹、控制器参数文件夹和备份文件夹。此时不要急于导入机器人，先确认工程根目录位置，并记录该路径，后续所有资源都应放在这个根目录之下。

二、导入机器人：模型、工具与外部轴要分步确认

导入机器人通常通过 Robot → Import Robot 或工程树中的“添加机器人”完成。MotoSim 支持从内置模型库选择，也支持导入外部 CAD 模型（如 STEP、IGES 格式）。对于标准 MOTOMAN 机器人，建议优先使用内置模型库，因为其运动学参数、关节限位和 DH 参数已经与控制器匹配；只有在需要模拟特殊夹具或非标末端执行器时，才导入外部 CAD 模型。

导入机器人后，需要依次确认三件事：第一，机器人基座坐标系是否与工位布局一致，通常基座原点应放在机器人安装法兰中心；第二，工具坐标系（TOOL）是否已定义，若末端有焊枪、吸盘或夹具，应建立对应的工具坐标并设置 TCP；第三，若工位包含外部轴（如行走轴、变位机），需要单独导入外部轴模型并与机器人建立协调关系。这三步中任何一步遗漏，都会导致后续示教点位置偏移。

导入完成后，建议立即在虚拟示教器中执行一次单轴点动，观察机器人各轴运动方向是否与现场一致。若方向相反，应检查机器人型号或控制器参数中的轴定义，而不是直接修改程序。

三、保存与备份策略：区分“保存”与“归档”

MotoSim 的保存分为两个层次：一是工程保存，二是备份归档。工程保存使用 File → Save 或 Ctrl+S，它只更新当前工程主文件和已修改的资源文件，不会生成历史版本。备份归档则通过 File → Save As 或手动复制工程目录完成，目的是保留某个时间点的完整状态。

在实际虚拟调试中，建议采用“三份策略”：第一份是工作副本，放在本地工程目录，用于日常编辑；第二份是版本备份，每次完成一个阶段性任务（如完成机器人导入、完成程序示教、完成节拍验证）后，将整个工程目录复制到备份目录，并以“日期_版本_说明”命名，例如 20250612_V03_完成焊接节拍验证；第三份是异地备份，将备份目录同步到网络盘或移动硬盘，防止本地磁盘故障。

需要特别注意的是，MotoSim 工程中可能引用外部 CAD 文件或控制器参数文件。如果这些文件放在工程目录之外，备份时只复制工程目录会导致引用丢失。因此，在导入外部资源时，应尽量将其复制到工程目录下的 Resource/ 或 Robot/ 子目录中，再建立引用。这样整个工程目录就是一个自包含的单元，迁移时只需整体拷贝即可。

四、项目目录组织规范：让工程可迁移、可回溯

一个规范的 MotoSim 工程目录，通常包含以下一级子目录：Robot/ 存放机器人本体、工具和外部轴模型；Controller/ 存放控制器参数、I/O 分配和系统变量；Program/ 存放示教程序 JOB 文件；Resource/ 存放工位布局、夹具 CAD、贴图等辅助资源；Backup/ 存放历史版本备份。工程主文件放在根目录，命名与工程名称一致。

在团队协作中，还应在根目录放置一个 README.txt 或 工程说明.md，记录工程对应的现场工位、控制器型号、机器人型号、软件版本、创建日期和最近修改内容。这样即使工程被复制到另一台电脑，接手人员也能快速了解工程背景，而不必逐个打开文件猜测。

最后，建议在每次关闭 MotoSim 前执行一次“保存 + 备份”动作，并检查备份目录中是否已生成对应版本。对于长期项目，可以按周建立备份文件夹，例如 Backup/2025_W24/，将当周所有版本集中存放，避免备份目录过于扁平、难以检索。通过这样的目录组织，虚拟调试工程才能从“一次性文件”变成“可维护资产”。