mz_run
Run MIKE Zero simulations headlessly, returning a job ID for tracking progress and logs.
Instructions
无界面启动一次 MIKE Zero 模拟，返回作业 id。
默认后台运行，用 mz_progress / mz_job_status / mz_job_log 跟踪进度。
两种入口（实测 MIKE Zero 2023）：
direct=False（默认）走 MzLaunch.exe：支持 -e/-mpi/-gpu/-y/-z， 但模拟结束后会删掉
._spi_进度文件（本服务会先归档）。direct=True 直接调引擎 exe（如 MIKE11.exe / FemEngineHD.exe）：开关按引擎 自己的语法拼装，
._spi_跑完仍保留。不支持 -mpi/-gpu/-z。
Args: setup: setup 文件绝对路径。 engine: 可选，显式指定引擎 exe（如 MIKE11.exe）；不传则由 MzEngines.cfg 按扩展名自动选择。 direct: True 时绕过 MzLaunch，直接调用引擎。 engine_flag: 走 MzLaunch 时指定引擎的参数名，默认 "-e"。 silent: 走 MzLaunch 时传未文档化的 -run（实测可省，非必要不要开）。 exit_when_done: 走 MzLaunch 时传 -x，模拟结束后退出启动器。 mpi: 子域数，传 -mpi N（需该引擎支持 MPI）。 gpu: GPU 卡数，传 -gpu N。 priority: CPU 优先级，传 -y 1..4（1 低，4 高于正常）。 extra_args: 追加的原始命令行参数。 result_dir: 走 MzLaunch 时传 -z 指定结果目录。 year: 可选，指定 MIKE Zero 年份。 wait: 是否同步等待结束（长时间模拟建议保持 False）。 timeout: wait=True 时的等待上限（秒）。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gpu | No | ||
| mpi | No | ||
| wait | No | ||
| year | No | ||
| setup | Yes | ||
| direct | No | ||
| engine | No | ||
| silent | No | ||
| timeout | No | ||
| priority | No | ||
| extra_args | No | ||
| result_dir | No | ||
| engine_flag | No | -e | |
| exit_when_done | No |