用途:管理 arkcli 的认证与身份,包括首次登录、切换到火山 Volc SSO、查看凭证状态与当前身份、获取或切换普通 ARK API Key、清理本地登录状态,以及为其他业务技能解除认证阻塞。云开发机/CI 已注入 VOLC_INIT_* 凭证时用 arkcli init-volc 无交互引导 profile。
主要能力与用法:arkcli auth status 查看认证状态(默认入口,含 active_profile 等字段);arkcli auth whoami 查看身份(用户名/IAM 用户 ID/账号 ID);arkcli auth login 交互式选择登录方式;arkcli auth login volc-sso 浏览器 SSO 登录;无浏览器场景用两段式:先 arkcli auth login --no-browser 打印授权 URL 并输出 authorize_pending JSON,再 arkcli auth login --no-browser --code <授权码> 完成登录,两条命令须共享同一 HOME;arkcli auth apikey 选择普通 API Key 并写入凭证存储,arkcli auth apikey create 创建并保存普通 API Key;arkcli auth logout 删除本地凭证。
限制:0.1.16 起 AK/SK 登录通道暂关,SSO 与 --no-browser 是登录入口;--no-browser/--code 挂在 auth login 根命令,不能挂 volc-sso 子命令;auth 不注册 --dry-run。API Key 按 profile 类型分池:agent-plan 个人版用专属 Key,agent-plan-team/coding-plan-team 用席位 Key,auth apikey 只处理普通池,不能保证 Plan/席位 Key 可用。TTY 首登普通池为空会询问是否创建;非 TTY、用户拒绝或无专属记录时不写。语音模型能力 arkcli 不支持。首次使用前须先读 arkcli-shared/SKILL.md,profile 管理已迁移至 arkcli profile。缺失细节如完整环境变量契约以官方参考文档为准,暂未在本文提供。