globalize-now-account-setup

Globalize 账户设置

Globalize CLI（@globalize-now/cli-client）可让 AI Agent 在 Globalize 平台上管理翻译项目、语言、术语表、风格指南和仓库连接。

此技能会安装 CLI 并验证你的账户身份。登录后，运行 globalize-now-project-setup 来创建翻译项目并连接你的仓库。

请按顺序完成以下步骤。

---

设置模式

完成步骤 1（检测）且没有阻碍后，询问用户：

你希望如何继续？

1. 引导模式 — 我会在每个步骤前后进行说明。
2. 非引导模式 — 我会不间断地运行所有步骤，并在最后显示完整摘要。

引导模式规则

• 每个步骤之前：简要说明将执行什么操作以及原因。
• 每个步骤之后：总结发生的更改（安装的文件、创建的配置、运行的命令）。

非引导模式规则

• 不间断地执行所有步骤，不逐步说明。
• 遇到硬性阻碍（例如，找不到 Node.js）仍须停止执行，不得跳过。
• 最后生成摘要：

## Account Setup Complete

### What was done
- [x] Step 1: Detect Environment — {Node version, existing auth yes/no}
- [x] Step 2: Install CLI — {npx or global}
- [x] Step 3: Authenticate — {auth method}
- [x] Step 4: Verify — {org name}

### Next steps
- Run `globalize-now-project-setup` to create a translation project and connect this repo.

---

步骤 1：检测环境

继续之前，请检查以下内容：

信号	检测方式
Node.js	node --version 以状态码 0 退出，且版本 >= 18。CLI 必需。
已有身份验证	~/.globalize/config.json 存在且包含 apiKey 字段，或已设置 GLOBALIZE_API_KEY 环境变量。

检测结果

如果缺少 Node.js 或版本低于 18：硬性停止 — CLI 要求 Node.js >= 18。请用户安装或升级 Node，然后再继续。

如果已配置身份验证（~/.globalize/config.json 中包含 apiKey，或已设置 GLOBALIZE_API_KEY），则跳过登录流程，直接前往步骤 4：验证以确认凭据有效。

如果没有发现阻碍，请先显示设置模式提示，再继续步骤 2。

---

步骤 2：安装

无需全局安装。直接使用 npx 运行命令：

npx @globalize-now/cli-client <command>

如果用户更喜欢，也可以全局安装：

npm install -g @globalize-now/cli-client

二进制文件名为 globalise-now-cli。

---

步骤 3：身份验证

CLI 按以下顺序解析凭据：

1. GLOBALIZE_API_KEY 环境变量 — 最适合 CI/CD
2. ~/.globalize/config.json 配置文件 — 最适合本地开发
3. 交互式登录 — 基于浏览器的设备授权流程

如果已通过身份验证

运行以下命令进行检查：

npx @globalize-now/cli-client auth status --json

如果返回有效的 source 和 key，则表示已配置身份验证。跳至步骤 4。

如果尚未通过身份验证

以非阻塞模式启动设备授权流程：

npx @globalize-now/cli-client auth login --no-wait --json

此命令会返回设备代码信息，但不会等待批准：

{
  "data": {
    "user_code": "ABCD-1234",
    "verification_uri_complete": "https://...",
    "device_code": "...",
    "code_verifier": "...",
    "expires_in": 900,
    "interval": 5
  }
}

向用户提供 verification_uri_complete URL 和 user_code，并请用户在浏览器中打开该 URL 并批准。

用户确认已批准后，完成身份验证：

npx @globalize-now/cli-client auth complete \
  --device-code <DEVICE_CODE> \
  --code-verifier <CODE_VERIFIER> \
  --json

成功后，此命令会将 API 密钥保存到 ~/.globalize/config.json，并返回：

{
  "data": {
    "org": "...",
    "status": "authenticated"
  }
}

如果用户尚未批准，命令会持续轮询，直到用户批准或代码过期。

注意： 在交互式终端中，auth login（不带 --no-wait）会自动运行完整流程 — 打开浏览器、等待批准并保存密钥。作为 Agent 运行时，请使用 --no-wait + auth complete。

---

步骤 4：验证

运行以下两个命令以确认一切正常：

npx @globalize-now/cli-client auth status --json

此命令应返回包含 source、key（前缀）和 api（URL）的 JSON。

然后验证 API 连通性：

npx @globalize-now/cli-client orgs list --json

此命令应返回用户所属的组织。如果遇到身份验证错误，请返回步骤 3。

---

下一步

CLI 已安装并登录。要创建翻译项目、连接此仓库并设置目录文件模式，请运行 globalize-now-project-setup 技能。