uip Maestro 调试

uip maestro debug将本地 Maestro 项目上传至Studio Web并运行服务器端调试会话，将每个元素的状态更新流式传输回控制台，并返回最终状态。

大纲

uip maestro debug <project-path>
                  [--folder-id <id>]
                  [--poll-interval <ms>]
                  [-i, --inputs <json>]
                  [--login-validity <minutes>]

需要uip login 。使用全局选项。退出代码遵循标准合同。

参数

• <project-path> （必填） — Maestro 项目目录的路径。必须包含project.uiproj 。

选项

选项	默认	描述
--folder-id <id>	已自动检测	Orchestrator 文件夹 ( OrganizationUnitId )。如果省略，则使用当前登录会话中的文件夹。已通过parseFolderId解析和验证。
--poll-interval <ms>	2000	轮询间隔（以毫秒为单位）。必须为正数。
-i, --inputs <json>	—	以 JSON 字符串或@path/to/file.json运行的输入参数。
--login-validity <minutes>	10	距离令牌过期仅几分钟，触发自动刷新。

行为

1. 验证登录并从会话中提取组织、租户、基本 URL 和身份验证令牌。
2. 将项目上传到 Studio Web 的目标文件夹下。
3. 轮询最终状态，发出每个元素的状态行，例如：

   Status: InProgress (2/5 elements completed)
     v Activity_1 [Completed]
     > Activity_2 [InProgress]
     - Activity_3 [NotStarted]
   

4. 如果运行期间发生事件，发出日志行。
5. 如果finalStatus为Completed或Successful ，则退出0 ；否则为1 。

示例

# Debug with auto-detected folder
uip maestro debug ./invoice-orchestration

# Specify folder and inline inputs
uip maestro debug ./invoice-orchestration --folder-id 2553016 \
  --inputs '{"amount":100,"customer":"Acme"}'

# Inputs from a file
uip maestro debug ./invoice-orchestration --inputs @inputs.json

数据形状（--输出 json）

{
  "Code": "MaestroDebug",
  "Data": {
    "jobKey":      "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId":  "c3d4e5f6-0000-0000-0000-000000000001",
    "runId":       "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Completed",
    "solutionId":  "e5f6a7b8-0000-0000-0000-000000000001",
    "elementExecutions": [
      { "elementId": "Activity_1", "status": "Completed" }
    ]
  }
}

另请参阅

• uip maestro process run — 运行已发布的流程
• uip maestro job traces — 已开始的作业的流追踪
• 身份验证
• Maestro 概述