Appearance
完整命令参考
所有命令语法：workova <domain>:<action> [--input JSON | --input-file PATH]
概述
Workova CLI 覆盖以下能力域，共 70+ 条命令：
| 域 | 说明 |
|---|---|
auth / account | 登录、登出、账号资料、配额、用量 |
agent | Agent 增删改查、工具查看、技能绑定 |
conversation / chat / run | 对话管理、消息发送、任务运行 |
workflow / workflow-run | 工作流定义与运行控制 |
automation | 自动化触发器管理与手动触发 |
mcp | MCP 服务管理、工具调用 |
skill | 技能安装、校验、管理 |
plugin | 插件安装、启用、校验 |
runtime / contracts | 运行时状态、命令契约 |
认证与账号
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
auth:login | 登录 | 否 | 查看 |
auth:logout | 退出会话 | 否 | 查看 |
auth:status | 查看登录状态 | 否 | 查看 |
auth:whoami | 当前用户信息 | 否 | 查看 |
account:profile | 查看账号资料 | 否 | 查看 |
account:update-profile | 更新账号资料 | 否 | 查看 |
account:quota | 查看配额 | 否 | 查看 |
account:usage | 查看用量统计 | 否 | 查看 |
account:change-password | 修改密码 | 否 | 查看 |
Agent 管理
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
agent:list | 列出所有 Agent | 是 | 查看 |
agent:get | 获取 Agent 详情 | 是 | 查看 |
agent:create | 创建 Agent | 是 | 查看 |
agent:update | 更新 Agent | 是 | 查看 |
agent:delete | 删除 Agent | 是 | 查看 |
agent:tools | 查看已绑定工具 | 是 | 查看 |
agent:bind-skill | 绑定技能 | 是 | 查看 |
agent:unbind-skill | 解绑技能 | 是 | 查看 |
对话与消息
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
conversation:create | 创建对话 | 是 | 查看 |
conversation:list | 列出对话 | 是 | 查看 |
conversation:history | 查看对话历史 | 是 | 查看 |
conversation:delete | 删除对话 | 是 | 查看 |
chat:send | 发送消息 | 是 | 查看 |
run:start | 启动异步运行 | 是 | 查看 |
run:events | 获取运行事件流 | 是 | 查看 |
run:follow | 跟踪运行至完成 | 是 | 查看 |
工作流
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
workflow:list | 列出工作流 | 是 | 查看 |
workflow:get | 获取工作流详情 | 是 | 查看 |
workflow:create | 创建工作流 | 是 | 查看 |
workflow:update | 更新工作流 | 是 | 查看 |
workflow:delete | 删除工作流 | 是 | 查看 |
workflow:export | 导出工作流定义 | 是 | 查看 |
workflow-run:start | 启动工作流运行 | 是 | 查看 |
workflow-run:events | 获取运行事件 | 是 | 查看 |
workflow-run:snapshot | 获取运行快照 | 是 | 查看 |
workflow-run:pause | 暂停运行 | 是 | 查看 |
workflow-run:resume | 恢复运行 | 是 | 查看 |
workflow-run:cancel | 取消运行 | 是 | 查看 |
workflow-run:list | 列出运行记录 | 是 | 查看 |
自动化
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
automation:list | 列出自动化 | 是 | 查看 |
automation:create | 创建自动化 | 是 | 查看 |
automation:update | 更新自动化 | 是 | 查看 |
automation:delete | 删除自动化 | 是 | 查看 |
automation:enable | 启用 | 是 | 查看 |
automation:disable | 禁用 | 是 | 查看 |
automation:runs | 查看运行记录 | 是 | 查看 |
automation:process | 手动触发 | 是 | 查看 |
MCP 服务
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
mcp:list | 列出 MCP 服务 | 是 | 查看 |
mcp:get | 获取服务详情 | 是 | 查看 |
mcp:create | 创建 MCP 服务 | 是 | 查看 |
mcp:update | 更新 MCP 服务 | 是 | 查看 |
mcp:delete | 删除 MCP 服务 | 是 | 查看 |
mcp:test | 测试连接 | 是 | 查看 |
mcp:connect | 连接服务 | 是 | 查看 |
mcp:disconnect | 断开服务 | 是 | 查看 |
mcp:tools:list | 列出工具 | 是 | 查看 |
mcp:tools:call | 调用工具 | 是 | 查看 |
Skill 管理
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
skill:list | 列出技能 | 是 | 查看 |
skill:get | 获取技能详情 | 是 | 查看 |
skill:validate | 校验技能 | 是 | 查看 |
skill:install | 安装技能 | 是 | 查看 |
skill:create | 创建技能 | 是 | 查看 |
skill:update | 更新技能 | 是 | 查看 |
skill:delete | 删除技能 | 是 | 查看 |
Plugin 管理
| 命令 | 说明 | 需要 bridge | 示例 |
|---|---|---|---|
plugin:list | 列出插件 | 是 | 查看 |
plugin:info | 查看插件详情 | 是 | 查看 |
plugin:install | 安装插件 | 是 | 查看 |
plugin:uninstall | 卸载插件 | 是 | 查看 |
plugin:enable | 启用插件 | 是 | 查看 |
plugin:disable | 禁用插件 | 是 | 查看 |
plugin:commands | 查看插件命令 | 是 | 查看 |
plugin:validate | 校验 manifest | 是 | 查看 |
运行时与系统
| 命令 | 说明 | 需要 bridge |
|---|---|---|
runtime:health | 检查运行时状态 | 是 |
runtime:capabilities | 查看运行时能力 | 是 |
contracts:list | 列出所有可用命令契约 | 是 |
输入方式
bash
# 内联 JSON
workova agent:create --input '{"name": "my-agent"}'
# 从文件读取
workova agent:create --input-file ./config.json--input 和 --input-file 互斥。
环境变量
| 变量 | 说明 | 默认值 |
|---|---|---|
WORKOVA_GUI_APP_PATH | 桌面端应用路径 | 系统默认 |
WORKOVA_RUNTIME_BRIDGE_BIN | bridge 可执行文件路径 | 内置 |
WORKOVA_DISABLE_AUTO_DISCOVERY | 禁用桌面端自动发现 | false |
WORKOVA_CLI_SESSION_FILE | 会话文件路径 | ~/.workova/cli-session.json |
WORKOVA_CLI_CONFIG_FILE | 配置文件路径 | ~/.workova/cli-config.json |
本地文件
| 文件 | 说明 |
|---|---|
~/.workova/cli-session.json | 登录会话（token、过期时间） |
~/.workova/cli-config.json | CLI 配置 |
WARNING
会话文件包含认证 token，勿提交到版本控制。