认证与账号命令

TIP

bridge 不可用时，认证和账号命令自动降级为本地模式，无需额外配置。

认证命令

auth:login

交互式登录，创建 CLI 会话。

参数：

参数	类型	必填	说明
email	string	是	登录邮箱
password	string	是	登录密码
rememberMe	boolean	否	是否记住登录状态，默认 true
deviceName	string	否	设备名称

请求示例：

workova auth:login --input '{"email": "user@example.com", "password": "your-password"}'

返回示例：

{
  "success": true,
  "data": {
    "sessionId": "sess_a1b2c3",
    "user": {
      "id": "usr_x9y8z7",
      "email": "user@example.com"
    },
    "expiresAt": "2026-04-06T10:00:00Z"
  }
}

auth:logout

退出当前会话。

参数：

参数	类型	必填	说明
sessionId	string	否	指定要退出的会话 ID
scope	string	否	退出范围，可选 current 或 all，默认 current

请求示例：

workova auth:logout

返回示例：

{
  "success": true,
  "data": {
    "authenticated": false
  }
}

auth:status

查看当前登录状态。无参数。

请求示例：

workova auth:status

返回示例：

{
  "success": true,
  "data": {
    "authenticated": true,
    "expired": false,
    "session": {
      "expires_at": "2026-04-06T10:00:00Z",
      "user": {
        "id": "usr_x9y8z7",
        "email": "user@example.com"
      }
    }
  }
}

auth:whoami

返回当前登录用户基本信息。无参数。

请求示例：

workova auth:whoami

返回示例：

{
  "success": true,
  "data": {
    "user": {
      "id": "usr_x9y8z7",
      "email": "user@example.com",
      "displayName": "Alice"
    }
  }
}

账号命令

account:profile

查看账号详细资料。无参数。

请求示例：

workova account:profile

返回示例：

{
  "success": true,
  "data": {
    "profile": {
      "id": "usr_x9y8z7",
      "email": "user@example.com",
      "displayName": "Alice",
      "membership_level": "pro"
    }
  }
}

account:update-profile

更新账号资料。

参数：

参数	类型	必填	说明
displayName	string	否	显示名称
avatarUrl	string	否	头像 URL
locale	string	否	语言区域设置
timezone	string	否	时区
bio	string	否	个人简介

请求示例：

workova account:update-profile --input '{"displayName": "New Name"}'

返回示例：

{
  "success": true,
  "data": {
    "profile": {
      "id": "usr_x9y8z7",
      "email": "user@example.com",
      "displayName": "New Name",
      "membership_level": "pro"
    }
  }
}

account:quota

查看当前账号配额。无参数。

请求示例：

workova account:quota

返回示例：

{
  "success": true,
  "data": {
    "quota": {
      "quota_tokens": 1000000,
      "used_tokens": 350000,
      "remaining_tokens": 650000,
      "usage_percentage": 35.0
    }
  }
}

account:usage

查看用量统计。

参数：

参数	类型	必填	说明
window	string	否	统计窗口，可选 day / week / month / records，默认 month
page	number	否	分页页码
limit	number	否	每页条数

请求示例：

workova account:usage --input '{"window": "month"}'

返回示例：

{
  "success": true,
  "data": {
    "usage": {
      "total_tokens": 350000,
      "total_cost": 4.2,
      "request_count": 128
    }
  }
}

account:change-password

修改密码。

参数：

参数	类型	必填	说明
currentPassword	string	是	当前密码
newPassword	string	是	新密码，最少 8 个字符

请求示例：

workova account:change-password --input '{"currentPassword": "old-pass", "newPassword": "new-pass"}'

返回示例：

{
  "success": true,
  "data": {
    "result": "ok"
  }
}

降级说明

当 bridge 不可用时，auth:* 和 account:* 命令自动降级为本地模式运行。

WARNING

降级模式仅适用于认证和账号命令。Agent 执行、工作流运行、MCP 管理等依赖 runtime 的操作在降级模式下不可用。

会话文件

CLI 会话默认保存在 ~/.workova/cli-session.json，可通过环境变量自定义路径：

export WORKOVA_CLI_SESSION_FILE=/path/to/session.json
workova auth:login