用途:管理 SiteOS 统一 CLI 的用户身份、组织、成员关系与会话,属于身份认证类技能,不负责项目或服务资源。
主要能力:查询会话状态、发起登录、完成登录、结束本地会话;列出组织、创建组织(受限)、选择当前组织。
使用方式: 会话状态:npx @siteoshq/cli auth status --json 登录发起:npx @siteoshq/cli auth start --email <email> --json,随后用一次性令牌执行:npx @siteoshq/cli auth complete --token <token> --json 结束会话:npx @siteoshq/cli auth logout --json 组织列表:npx @siteoshq/cli auth organizations --json 创建组织:npx @siteoshq/cli auth organizations create --display-name <display-name> --json 选择组织:npx @siteoshq/cli auth select --organization <organization-id> --json(按不可变 ID 选择)
流程要点:未登录且未提供邮箱时,需明确询问邮箱并停止;首次验证登录会自动创建个人组织;无组织时应重新登录或接受团队邀请,不建议手动创建;创建额外组织仅限已验证的 @pixelpoint.io 团队账号,由服务端判定资格,被拒后不得通过其他端点重试。
限制:不得直接调用认证端点、读取凭据文件或私有 CLI 状态、暴露令牌或授权;不得凭名称猜测身份、按 slug 选择组织或修改认证状态;不得在未要求时登出、运行产品项目命令或臆造不支持的认证变更。仅报告会话就绪状态及安全的组织 ID 与显示名。
适用场景:需要认证 CLI、切换组织上下文后再进入项目或服务技能时使用。完成认证与组织选择后返回 $siteos 或请求方技能。