|
文档
预约演示平台
平台MCPCLI
API工作流
指南更新日志

概览

  • @lingo.dev/cli

快速开始

  • 快速上手
  • 配置

参考

  • lingo push
  • lingo pull
  • 其他命令
  • lingo purge

配置

  • 键级控制
  • 格式
  • Locale

指南

  • 添加语言
  • 现有翻译
  • 重新翻译
  • 翻译备注
  • 运行、状态与恢复
  • CI/CD
  • Monorepo
  • 大型项目

在找旧版 CLI(v0)? 查看旧版 CLI 文档

其他命令

用于设置和身份管理的命令。它们都不会触及源内容,只负责管理凭据和项目绑定。

lingo login#

用于在 Lingo.dev 上完成身份验证。提供两种方式:

OTP(默认,交互式)#

bash
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 / 非交互式)#

bash
lingo login --api-key lk_...

用于存储 API 密钥。你可以在 Lingo.dev 平台中所属组织的 API keys 设置下生成密钥。

你也可以在任意命令中将 --api-key 作为全局标志传入,这样会完全绕过已存储的凭据:

bash
lingo push --api-key lk_...

非常适合不希望将凭据写入磁盘的一次性 CI 任务。

lingo logout#

bash
lingo logout

清除 ~/.lingo/auth.json。如果你尚未登录,则不会执行任何操作。

lingo link#

bash
lingo link
lingo link --org org_a8c... --engine eng_b9d...   # skip prompts

将当前项目绑定到一个组织和一个本地化引擎。会把 orgId 和 engineId 写入 .lingo/config.json(请提交该文件)。

交互模式下,你可以从现有组织/引擎中选择,也可以直接创建新的——link 会提示你输入名称,为新组织完成引导问卷,并在链接前通过 API 创建相应资源。

lingo unlink#

bash
lingo unlink

从 .lingo/config.json 中移除 orgId 和 engineId。不会删除组织或引擎——只会解除本地绑定。在重新链接到其他引擎前,这个命令尤其有用。

lingo whoami#

bash
lingo whoami
lingo whoami --json

会显示以下三项信息:

  1. 身份——你当前登录使用的邮箱,或显示你是否正在使用 API 密钥。
  2. 组织——已链接的组织(名称通过 API 解析)。
  3. 引擎——已链接的引擎(名称通过 API 解析)。
text
Email:   you@company.com
  Org:     Acme Inc (org_a8c...)
  Engine:  Production (eng_b9d...)
  Auth:    session

如果你当前不在已链接项目的目录中,则不会显示“组织/引擎”两行。--json 会以便于脚本处理的结构化格式输出相同的数据。

全局 --api-key 标志#

每个命令都支持 --api-key 标志,仅对当前这次调用覆盖已存储的凭据。CI 中的标准写法如下:

yaml
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、锁文件、运行状态。

这个页面对你有帮助吗?

Max PrilutskiyMax Prilutskiy·已更新 5 天前·1 分钟阅读