Lingo.dev CLI 只需一个配置字段，就能将您的代码库接入本地化引擎。每次 lingo.dev run 调用都会经过您的引擎——自动应用品牌语调、术语表、指令和模型配置。无需改动代码，也无需新增依赖。
会有哪些变化#
| 接入前 | 接入后 | |
|---|---|---|
| 翻译流程 | Lingo.dev 默认流程 | 您的本地化引擎 |
| 品牌语调 | 无 | 按目标语言区域自动应用 |
| 术语表 | 无 | 按请求进行语义匹配 |
| 指令 | 无 | 按目标语言区域自动附带 |
| 模型选择 | Lingo.dev 默认配置 | 您的模型配置，含回退机制 |
| 质量审核 | 无 | 您配置的 AI 审核器会自动运行 |
配置方式#
1
在 i18n.json 中添加 engineId（可选）
如果您想指定某个引擎，请在 i18n.json 配置中加入 engineId 字段。您可以在控制台中找到引擎 ID——它以 eng_ 开头（例如 eng_SxjMwMsfOIsvV1wh）。
json
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}其余配置保持不变——源语言区域、目标语言区域、存储桶都无需调整。如果省略 engineId，CLI 会使用您组织中的默认引擎。
2
设置 API 密钥
CLI 使用您的 Lingo.dev API 密钥进行身份验证。请将其设置为环境变量：
bash
export LINGO_API_KEY="your-api-key"或者将其持久化保存到 ~/.lingodotdevrc：
ini
[auth.vnext]
apiKey = your-api-key您可以在控制台的 API Keys 页面生成 API 密钥。
3
运行翻译
bash
lingo.dev runCLI 会将翻译请求发送到您的引擎，并把结果写回语言区域文件——自动应用品牌语调、术语表、指令和模型配置。
配置参考#
i18n.json#
| 字段 | 说明 |
|---|---|
engineId | 可选。您的引擎 ID（eng_...）。如省略，则使用您组织中的默认引擎。 |
其他所有 i18n.json 字段（version、locale、buckets）的用法与标准 CLI 配置完全一致。
环境变量#
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
LINGO_API_KEY | 是 | - | 您的 Lingo.dev API 密钥 |
LINGO_API_URL | 否 | https://api.lingo.dev | 自定义 API 基础 URL（用于自托管或预发布环境） |
效果预期#
CLI 生成的每一条翻译，都会完整经过您引擎的处理流程：
- 品牌语调按语言区域调整语气与正式程度
- 术语表条目通过语义匹配确保术语准确统一
- 指令应用语言区域特定的语言规则
- 模型配置选择合适的 LLM，并支持自动回退
- AI Reviewers会在每次请求后自动评估质量
翻译会显示在 Reports 中，触发类型为 api，并与来自 API 和各类集成的请求一同展示。
