CLI 环境

在项目内容配置之外设置凭据、目标服务、诊断及运维选项。

环境变量用于提供当前机器的专属设置。请将源路径、目标语言区域和输出布局保存在 .lingo/config.json 中,便于随项目共享。机密信息则应保存在运行时或运行器的机密存储中。

凭据和目标服务 #

变量行为
LINGO_API_KEY凭据的优先级低于调用时指定的 --api-key,高于已保存的登录凭据。
LINGO_API_URLAPI 基础地址;默认为 https://api.lingo.dev。

其他目标服务会接收调用方的内容和凭据。请仅使用可信且已获授权的服务。

诊断和禁用选项 #

变量行为
LINGO_DEBUG设为任意非空值即可启用启动诊断。
LINGO_TELEMETRY_DISABLED=1 或 DO_NOT_TRACK=1禁用 CLI 遥测,包括使用事件和 OTLP 导出。
NO_UPDATE_NOTIFIER=1 或 LINGO_DISABLE_UPDATE_CHECK=1禁用自动更新检查。
NO_COLOR影响颜色显示。
CI影响显示方式;检测到 CI 环境时,还会跳过更新检查。

请严格使用 1 指定的禁用值。调试诊断包含 Node 版本、平台、当前工作目录和原始命令行参数,其中可能出现通过命令行传入的 API 密钥。分享诊断信息前,请移除机密信息。不要将禁用调试视为全面保护措施:进程检查或故障检查仍可能暴露这些信息。

本地评分 #

lingo score 需要 OPENROUTER_API_KEY,这一要求与 Lingo 登录无关。其模型配置中的提供商字段用于构成 OpenRouter 模型标识,而非选择传输方式。

运维日志导出覆盖设置 #

日志导出支持 LINGO_SIGNOZ_INGEST_ENDPOINT、OTEL_EXPORTER_OTLP_LOGS_ENDPOINT 和 OTEL_EXPORTER_OTLP_ENDPOINT,优先级依次递减。选择数据接收密钥时,优先使用 LINGO_SIGNOZ_INGEST_KEY,其次是 SIGNOZ_INGESTION_KEY;OTEL_EXPORTER_OTLP_HEADERS 可提供额外标头。OTEL_SERVICE_NAME 默认为 @lingo.dev/cli。

这些设置用于配置诊断基础设施,而非翻译。请勿将密钥或含有机密信息的标头写入代码仓库文件或支持日志。身份验证介绍常规的身份选择方式;项目路径和语言区域则由配置管理。