3. 创建第一个WorkVisual项目

WorkVisual 是 KUKA 机器人控制系统的工程配置平台，所有离线配置、总线组态、信号映射和程序编辑都围绕“项目”这一容器展开。一个 WorkVisual 项目并不是单一文件，而是一个以 .wvs 项目文件为入口、由多个子目录和资源文件共同构成的工程集合。理解项目的创建流程和目录结构，是后续所有配置工作的基础。本节以一台 KR C4 控制柜搭配 KR 6 R900 六轴机器人的典型场景为例，完整走通“新建项目—选择控制器型号—认识目录结构—保存与备份”这条链路。

一、新建项目的两种入口

启动 WorkVisual 后，在起始页可以看到“新建项目”和“打开项目”两个主要入口。新建项目有两种常用方式：一是从空白项目开始，二是从已有项目或模板复制。对于第一次接触 WorkVisual 的工程师，建议从空白项目开始，这样能清楚看到项目从无到有的完整结构。

点击“新建项目”后，软件会弹出项目创建向导。向导第一步要求填写项目名称和存储路径。项目名称建议遵循可追溯的命名规则，例如 P3_KR6R900_KR C4_20240610，其中包含项目编号、机器人型号、控制器型号和日期。存储路径应避免中文和空格，推荐使用类似 D:\KUKA_Projects\ 的纯英文路径，因为部分旧版本 WorkVisual 对中文路径支持不稳定，可能在后续编译或导出时出现找不到文件的错误。

二、选择控制器型号与机器人型号

项目名称确定后，向导进入控制器型号选择环节。这一步非常关键，因为控制器型号决定了项目中可用的总线驱动、I/O 模块库和系统变量集合。常见的 KUKA 控制器型号包括 KR C4、KR C4 compact、KR C5 等。选择错误会导致后续无法添加某些现场总线模块，或者编译时提示设备描述文件缺失。

以 KR C4 为例，选中后向导会进一步要求选择机器人型号。这里选择 KR 6 R900 sixx。需要说明的是，控制器型号和机器人型号是两个独立维度：控制器决定“大脑”的能力，机器人型号决定运动学参数、轴数量和负载数据。如果现场是 KR C4 控制柜驱动一台 KR 10 R1100，那么控制器选 KR C4，机器人选 KR 10 R1100，两者不能混淆。

三、项目目录结构解析

项目创建完成后，WorkVisual 会在指定路径下生成一个以项目名命名的文件夹。这个文件夹内部并不是杂乱无章的，而是有明确分工。下面这张图展示了典型 WorkVisual 项目的目录层级与关键文件关系。

从图中可以看到，项目根目录下最重要的入口是 .wvs 文件，它相当于一本书的目录，记录了项目引用了哪些子资源。Controller 目录存放控制器相关的 XML 描述文件，Robot 目录存放机器人运动学参数和轴限位数据，Bus/IO 目录则保存现场总线组态和信号映射表。这些文件之间通过相对路径互相引用，因此移动项目时必须整体移动文件夹，不能只复制 .wvs 文件。

四、保存与备份的正确做法

WorkVisual 的保存分为“保存”和“另存为”两种。日常编辑过程中建议养成按 Ctrl+S 的习惯，但更重要的是阶段性备份。备份不是简单地把 .wvs 文件复制到 U 盘，而是要把整个项目文件夹打包。原因在于，.wvs 文件只记录引用关系，真正的设备描述、机器人参数和总线配置都分散在子目录中。如果只复制 .wvs 文件到另一台电脑，打开时会提示大量资源缺失。

推荐的备份策略是“三二一”原则的简化版：至少保留两份备份，一份在本地硬盘，一份在移动存储或网络盘。备份文件建议压缩为 zip 包，并在文件名中标注日期和版本，例如 P3_KR6R900_KR C4_20240610_backup_20240611.zip。如果项目需要交付给现场调试人员，还应在压缩包内附一份简短的 README.txt，说明 WorkVisual 版本号、控制器型号、机器人型号和已知注意事项。

五、一个可执行的检查清单

项目创建和首次保存完成后，建议按下面的清单逐项确认，避免把问题带到后续配置阶段。

完成以上步骤后，你就拥有了一个结构完整、可追溯、可备份的 WorkVisual 项目。后续的现场总线配置、I/O 信号映射和程序编辑，都将在这个项目容器内逐步展开。项目目录结构的清晰程度，直接决定了后期排障时能否快速定位到具体配置文件，因此这一步值得多花几分钟确认。