用于设置和身份管理的命令。它们都不会触及源内容,只负责管理凭据和项目绑定。
lingo login#
用于在 Lingo.dev 上完成身份验证。提供两种方式:
OTP(默认,交互式)#
lingo login
lingo login --email you@company.com # skip the email prompt
lingo login --email you@company.com --code 123456 # skip the code prompt too向你的邮箱发送一次性验证码,验证通过后,会将 Supabase 会话存储到 ~/.lingo/auth.json 中。刷新令牌也会一并保存,因此会话可在多次使用间持续有效,直到你显式执行 logout。
API 密钥(CI / 非交互式)#
lingo login --api-key lk_...用于存储 API 密钥。你可以在 Lingo.dev 平台中所属组织的 API keys 设置下生成密钥。
你也可以在任意命令中将 --api-key 作为全局标志传入,这样会完全绕过已存储的凭据:
lingo push --api-key lk_...非常适合不希望将凭据写入磁盘的一次性 CI 任务。
lingo logout#
lingo logout清除 ~/.lingo/auth.json。如果你尚未登录,则不会执行任何操作。
lingo link#
lingo link
lingo link --org org_a8c... --engine eng_b9d... # skip prompts将当前项目绑定到一个组织和一个本地化引擎。会把 orgId 和 engineId 写入 .lingo/config.json(请提交该文件)。
交互模式下,你可以从现有组织/引擎中选择,也可以直接创建新的——link 会提示你输入名称,为新组织完成引导问卷,并在链接前通过 API 创建相应资源。
lingo unlink#
lingo unlink从 .lingo/config.json 中移除 orgId 和 engineId。不会删除组织或引擎——只会解除本地绑定。在重新链接到其他引擎前,这个命令尤其有用。
lingo whoami#
lingo whoami
lingo whoami --json会显示以下三项信息:
- 身份——你当前登录使用的邮箱,或显示你是否正在使用 API 密钥。
- 组织——已链接的组织(名称通过 API 解析)。
- 引擎——已链接的引擎(名称通过 API 解析)。
Email: you@company.com
Org: Acme Inc (org_a8c...)
Engine: Production (eng_b9d...)
Auth: session如果你当前不在已链接项目的目录中,则不会显示“组织/引擎”两行。--json 会以便于脚本处理的结构化格式输出相同的数据。
全局 --api-key 标志#
每个命令都支持 --api-key 标志,仅对当前这次调用覆盖已存储的凭据。CI 中的标准写法如下:
env:
LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
- run: lingo push --backfill-missing --yes --api-key "$LINGO_API_KEY"(CLI 也会从环境变量中读取 LINGO_API_KEY 作为兜底。)
接下来#
- lingo push——范围控制 + 增量翻译。
- lingo pull——跨机器拉取。
- Configuration——
.lingo/config.json、锁文件、运行状态。
