CLI

Workova CLI 用同一份 Automation、Run、Artifact 和 Input Schema 契约控制本地 Runtime。它不会为每条命令临时启动一个新的 GUI 进程。

使用前提

1. 已安装并登录 Workova 桌面客户端。
2. Workova 正在托盘运行。
3. “设置 → 权限与自动化”显示 CLI 已连接。

本地命令通过 Local IPC 连接当前 Runtime。远程命令与手机相同，会进入指定设备的 Device Inbox。 命令中的自动化参数可以填写唯一名称或自动化 ID；遇到同名项时，CLI 会要求改用 ID，不会自行猜测。

常用命令

# 查看本机可用自动化
workova automation list

# 查看输入 Schema
workova automation schema order-export

# 运行并持续查看状态
workova run order-export --input-file inputs.json --watch

# 查看一次运行
workova run get local_run_123

# 打开本地产物
workova artifact open art_123

命令统一输出格式化 JSON：终端中容易阅读，Shell、CI 和外部脚本也能直接解析，不需要额外输出开关。

远程运行

workova remote run automation_123 \
  --device macbook-home \
  --input-file inputs.json \
  --watch

远程运行不会把插件执行计划交给服务器。服务器只验证权限并把消息送到指定电脑。 远程入口使用设备目录公开的自动化 ID，避免不同电脑存在同名自动化时发错目标。

输入文件

CLI 自动使用桌面端当前登录账号的数据范围，不需要填写内部隔离 ID。--input '{"date":"today"}' 用于直接传 JSON；文件路径必须使用 --input-file inputs.json。输入必须符合自动化当前发布版本的 Input Schema。文件字段在远程运行时仍需按界面提示授权传输或使用已同步的 Artifact 引用。

错误码

CLI 失败时会同时返回用户可读说明和稳定错误码。自动化脚本应按错误码判断，而不是匹配中文错误文本。