命令行接口
功能描述
EmeyeStudio 支持通过命令行参数控制启动行为，适用于以下场景：
- 通过快捷方式或脚本直接打开指定工作区
- 在 CI/自动化测试环境中无人值守启动
- 查询程序版本号
命令行参数一览
| 参数 | 说明 |
|---|---|
-h、--help |
显示命令行帮助信息 |
--version（Qt6 构建下亦可用 -v） |
显示程序版本号 |
-w <路径>、--workspace <路径> |
启动时打开指定的工作区文件 |
-a、--auto |
自动模式（用于 UI 自动化测试，详见下文） |
使用步骤
指定工作区启动
使用 --workspace 参数（短选项 -w）启动时直接打开目标工作区，跳过欢迎对话框：
EmeyeStudio.exe --workspace "G:\work\hard-demo\hard-demo.workspace"
启动时的加载优先级：
- 命令行
--workspace参数指向的工作区（存在且有效时） - 上次使用的工作区
- 欢迎对话框（手动选择）
查询版本号
EmeyeStudio.exe --version
输出版本号与「帮助 → 关于」对话框、exe 文件属性中的版本一致。
查看帮助
EmeyeStudio.exe --help
输出全部命令行参数及说明。
自动模式（自动化测试）
EmeyeStudio.exe --auto
自动模式面向 UI 自动化测试和 CI 环境，行为与正常模式不同：
- 跳过所有交互对话框（确认框、提示框等）
- 未打开工作区时，自动在当前目录创建测试工作区
__emeye_test_workspace - 启动 15 分钟后自动退出，防止测试进程挂起
注意：此参数会跳过用户确认环节，仅供自动化测试使用，日常使用不推荐。
注意事项
--workspace的路径必须指向.workspace工作区文件（JSON 格式），不能是目录。- 路径包含空格时必须使用引号括起。
- 指定的工作区文件不存在时，程序不会报错退出，而是回退到上次使用的工作区；若仍无法加载，则显示欢迎对话框。
- 命令行参数仅在启动阶段生效。运行过程中切换工作区请使用「文件 → 切换工作区」菜单。
- 首次运行时需先完成用户协议（EULA）确认，之后启动不再弹出。