连接你的引擎

Lingo.dev CLI 通过项目配置将您的代码库接入本地化引擎。每一次 lingo push 都会经过您的引擎——自动套用品牌语气、术语表、规则和模型配置。无需改动代码，也无需新增依赖。

会有哪些变化#

	之前	之后
翻译流程	Lingo.dev 默认流程	你的本地化引擎
品牌语调	无	按目标语言区域自动应用
术语表	无	每次请求按语义自动匹配
规则	无	按目标语言区域自动带入
模型选择	Lingo.dev 默认配置	你的模型配置与回退策略
质量审核	无	按你的配置自动运行 AI 审核器

设置#

关联你的引擎

在项目根目录运行 lingo link：

bash

lingo link

选择（或创建）一个 organization 和一个 localization engine。link 会将 orgId 和 engineId 写入 .lingo/config.json——记得提交，这样每次运行都会使用同一个引擎。你也可以在控制台中找到引擎 ID；它以 eng_ 开头（例如 eng_SxjMwMsfOIsvV1wh）。

身份验证

bash

lingo login

这会打开浏览器完成身份验证，并保存会话。对于 CI 或非交互式场景，请改为传入 API key：

bash

lingo login --api-key lk_...

……或者将其设为环境变量：

bash

export LINGO_API_KEY="lk_..."

可在控制台的 API Keys 页面生成 API key。

推送

bash

lingo push

CLI 会将源文件发送到您的引擎，并将翻译结果写回磁盘——自动套用品牌语气、术语表、规则和模型配置。

配置参考#

`.lingo/config.json`#

字段	说明
`orgId`	拥有该引擎的 organization。由 `lingo link` 设置。
`engineId`	执行翻译的引擎（`eng_...`）。由 `lingo link` 设置。

sourceLocale、targetLocales 和 files 的用法与其他项目完全一致——详见配置。

环境变量#

变量	必填	默认值	说明
`LINGO_API_KEY`	用于 CI	-	你的 Lingo.dev API key（替代 `lingo login`）
`LINGO_API_URL`	否	`https://api.lingo.dev`	自定义 API 基础 URL（用于自托管或预发布环境）