Lingo.dev CLI 通过项目配置将您的代码库接入本地化引擎。每一次 lingo push 都会经过您的引擎——自动套用品牌语气、术语表、规则和模型配置。无需改动代码，也无需新增依赖。
会有哪些变化#
| 之前 | 之后 | |
|---|---|---|
| 翻译流程 | Lingo.dev 默认流程 | 你的本地化引擎 |
| 品牌语调 | 无 | 按目标语言区域自动应用 |
| 术语表 | 无 | 每次请求按语义自动匹配 |
| 规则 | 无 | 按目标语言区域自动带入 |
| 模型选择 | Lingo.dev 默认配置 | 你的模型配置与回退策略 |
| 质量审核 | 无 | 按你的配置自动运行 AI 审核器 |
设置#
1
关联你的引擎
在项目根目录运行 lingo link：
bash
lingo link选择（或创建）一个 organization 和一个 localization engine。link 会将 orgId 和 engineId 写入 .lingo/config.json——记得提交，这样每次运行都会使用同一个引擎。你也可以在控制台中找到引擎 ID；它以 eng_ 开头（例如 eng_SxjMwMsfOIsvV1wh）。
2
身份验证
bash
lingo login这会打开浏览器完成身份验证，并保存会话。对于 CI 或非交互式场景，请改为传入 API key：
bash
lingo login --api-key lk_...……或者将其设为环境变量：
bash
export LINGO_API_KEY="lk_..."可在控制台的 API Keys 页面生成 API key。
3
推送
bash
lingo pushCLI 会将源文件发送到您的引擎，并将翻译结果写回磁盘——自动套用品牌语气、术语表、规则和模型配置。
配置参考#
.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（用于自托管或预发布环境） |
你可以期待什么#
CLI 产出的每一条翻译，都会经过你引擎的完整流程：
- 品牌语调会按语言区域调整语气和正式程度
- 术语表条目会通过语义匹配严格落实术语
- 规则可应用因地区语言而异的语言规则
- 模型配置会选择合适的 LLM，并自动回退
- AI Reviewers会在每次请求后自动评估质量
翻译结果会显示在 Reports 中，触发类型为 api，并与来自 API 和集成的请求一并展示。
