用途：为 OKX CLI 处理登录与授权流程，包括首次设置、会话过期后重新认证和退出登录。支持站点：global（www.okx.com）、eea（my.okx.com）、us（app.okx.com）、tr（tr.okx.com）。站点与认证方式是两个维度，API key 与 OAuth 都需要先选站点；站点一旦选定会被持久化，OAuth 站点在首次 okx auth login --site <X> 成功后保存，无独立的 set-site 命令。
前置：如未安装，先执行 npm install -g @okx_ai/okx-trade-cli。
主要用法：先做强制预检，并行运行 okx config show --json 和 okx auth status --json，依次检查站点、API key、OAuth 状态。若从未选择站点，须让用户从四个站点中明确选择，不可默认 global；若任一 profile 已有 api_key，应停止登录，直接按原请求继续，因为 CLI 的 REST 客户端总是优先使用 API key 且不会回退。API key 报 401 或签名错误时，OAuth 不是有效补救，需用户二选一：更换 API key，或先删除损坏的 profile 再走 OAuth。
AI 代理必须使用 okx auth login --manual --site <global|eea|us|tr>，该模式输出含 verificationUri、userCode、expiresIn 的 JSON 后立即退出；非 --manual 会阻塞轮询。需把链接与验证码以自然语言明文展示给用户，等待用户确认后再运行一次 okx auth status --json 校验，不要自动轮询。状态分为 logged_in、pending、not_logged_in。交互式终端可直接运行 okx auth login --site <X>。
其他命令：okx config init 是 API key 向导（非 OAuth）；okx auth logout 退出登录，DCR 客户端注册会保留；okx auth install、okx auth install-status、okx auth remove 用于二进制管理，出现 Failed to spawn okx-auth 时先安装再重试。token 过期由 CLI 自动处理。认证后可根据任务转到交易、组合、理财、机器人或行情等技能。
限制：站点无法脱离一次认证尝试单独持久化；待授权期间不要运行其他 okx 命令；状态回复中只应展示站点与权限，避免暴露 expiresAt、ttl、profile 等字段。具体收费、平台与更多细节资料暂未提供。