CLI 命令

Lingo.dev CLI 命令的参考文档

此页面包含 Lingo.dev CLI 可用命令的完整列表。要从 CLI 本身访问此文档,请运行以下命令:

npx lingo.dev@latest --help

lingo.dev

用法:lingo.dev [选项] [命令]

Lingo.dev CLI

选项:
  -v, --version         显示版本
  -y, --no-interactive  禁用交互模式
  -h, --help            显示帮助

命令:
  init [options]        初始化 Lingo.dev 项目
  i18n [options]        运行本地化引擎
  auth [options]        显示当前认证状态
  login                 使用 Lingo.dev API 进行认证
  logout                从 Lingo.dev API 注销
  show                  输出当前配置
  config                管理 Lingo.dev CLI 配置
  lockfile [options]    如果不存在则创建锁文件
  cleanup [options]     从目标文件中移除源文件中不存在的键
  mcp                   使用 Lingo.dev 模型上下文提供器与您的 AI 代理集成
  ci [options]          运行 Lingo.dev CI/CD 操作
  status [options]      显示本地化过程的状态
  run [options]         运行 Lingo.dev 本地化引擎
  purge [options]       删除指定 --bucket、--file、--key 或 --locale 的翻译
  help [command]        显示命令的帮助信息

lingo.dev init

用法:lingo.dev init [选项]

初始化 Lingo.dev 项目

选项:
  -f --force                覆盖现有配置(默认值:false
  -s --source <locale>      源语言环境(默认值:"en")
  -t --targets <locale...>  目标语言环境列表(默认值:"es")
  -b, --bucket <type>       存储桶类型(默认值:"json")
  -p, --paths [path...]     存储桶的路径列表(默认值:[])
  -y, --no-interactive      禁用交互模式
  -h, --help                显示帮助

lingo.dev i18n

用法:lingo.dev i18n [选项]

运行本地化引擎

选项:
  --locale <locale>    要处理的语言环境
  --bucket <bucket>    要处理的存储桶
  --key <key>          要处理的键。仅处理特定的翻译键,适用于调试或更新单个条目
  --file [files...]    要处理的文件。仅处理特定路径,可以包含星号 * 匹配多个文件。如果有大量文件并希望专注于特定文件,此选项非常有用。用逗号或空格分隔指定多个文件。
  --frozen             以只读模式运行 - 如果需要更新任何翻译则失败,适用于 CI/CD 管道检测缺失翻译
  --force              忽略锁文件并处理所有键,适用于完全重新翻译
  --verbose            显示详细输出,包括中间处理数据和 API 通信详情
  --interactive        启用交互模式以在应用翻译之前进行审查和编辑
  --api-key <api-key>  显式设置要使用的 API 密钥,覆盖设置中的默认 API 密钥
  --debug              在开始时暂停执行以进行调试,等待用户确认后继续
  --strict             在第一个错误时停止处理,而不是继续处理其他语言环境/存储桶
  -h, --help           显示帮助

lingo.dev auth

用法:lingo.dev auth [选项]

显示当前的认证状态

选项:
  --login     登录到您的账户(已弃用:请改用 'lingo.dev login')
  --logout    从您的账户登出(已弃用:请改用 'lingo.dev logout')
  -h, --help  显示帮助

lingo.dev login

用法:lingo.dev login [选项]

通过 Lingo.dev API 进行认证

选项:
  -h, --help  显示帮助

lingo.dev logout

用法:lingo.dev logout [选项]

 Lingo.dev API 登出

选项:
  -h, --help  显示帮助

lingo.dev show

用法:lingo.dev show [选项] [命令]

打印当前配置

选项:
  -h, --help       显示帮助

命令:
  config           打印当前配置
  locale <type>    打印语言环境列表
  files [options]  打印由 Lingo.dev 管理的文件列表
  help [command]   显示命令的帮助

lingo.dev show config

用法:lingo.dev show config [选项]

打印当前配置

选项:
  -h, --help  显示帮助

lingo.dev show locale

用法:lingo.dev show locale [选项] <type>

打印语言环境列表

参数:
  type        要显示的语言环境类型,可以是 "sources" "targets"

选项:
  -h, --help  显示帮助

lingo.dev show files

用法:lingo.dev show files [选项]

打印由 Lingo.dev 管理的文件列表

选项:
  --source    仅显示源文件,即包含原始翻译的文件
  --target    仅显示目标文件,即包含翻译内容的文件
  -h, --help  显示帮助

lingo.dev config

用法:lingo.dev config [选项] [命令]

管理 Lingo.dev CLI 配置

选项:
  -h, --help         显示帮助

命令:
  set <key> <value>  设置配置键的值
  unset <key>        移除配置键
  get <key>          获取配置键的值
  help [command]     显示命令的帮助

lingo.dev config set

用法: lingo.dev config set [选项] <key> <value>

将配置键设置为指定值

参数:
  key         要设置的配置键
  value       新值

选项:
  -h, --help  显示帮助

lingo.dev config unset

用法: lingo.dev config unset [选项] <key>

移除配置键

参数:
  key         要移除的配置键

选项:
  -h, --help  显示帮助

lingo.dev config get

用法: lingo.dev config get [选项] <key>

获取配置键的值

参数:
  key         配置键

选项:
  -h, --help  显示帮助

lingo.dev lockfile

用法: lingo.dev lockfile [选项]

如果锁文件不存在,则创建一个锁文件

选项:
  -f, --force  强制创建锁文件
  -h, --help   显示帮助

lingo.dev cleanup

用法: lingo.dev cleanup [选项]

从目标文件中移除在源文件中不存在的键

选项:
  --locale <locale>  指定要清理的语言区域
  --bucket <bucket>  指定要清理的存储桶
  --dry-run          显示将被移除的内容但不进行实际更改
  --verbose          显示详细输出,包括:
    - 将被移除的键列表。
    - 处理步骤。
  -h, --help         显示帮助

lingo.dev mcp

用法: lingo.dev mcp [选项]

 Lingo.dev 模型上下文提供程序与您的 AI 代理一起使用

选项:
  -h, --help  显示帮助

lingo.dev ci

用法: lingo.dev ci [选项]

运行 Lingo.dev CI/CD 操作

选项:
  --parallel [boolean]             以并行模式运行
  --api-key <key>                  API 密钥
  --pull-request [boolean]         创建包含更改的拉取请求
  --commit-message <message>       提交消息
  --pull-request-title <title>     拉取请求标题
  --working-directory <dir>        工作目录
  --process-own-commits [boolean]  处理由此操作生成的提交
  -h, --help                       显示帮助

lingo.dev status

用法: lingo.dev status [选项]

显示本地化过程的状态

选项:
  --locale <locale>    要处理的语言区域
  --bucket <bucket>    要处理的存储桶
  --file [files...]    要处理的文件。仅处理路径中包含此字符串的文件。
                       如果有大量文件并希望专注于特定文件,此选项非常有用。
                       可以用逗号或空格分隔指定多个文件。
  --force              忽略锁文件并处理所有键,适用于估算完整重新翻译
  --verbose            显示详细输出,包括键级别的字数统计
  --api-key <api-key>  显式设置要使用的 API 密钥,覆盖设置中的默认 API 密钥
  -h, --help           显示帮助

lingo.dev may-the-fourth

用法: lingo.dev may-the-fourth [选项]

愿原力与你同在

选项:
  -h, --help  显示帮助

lingo.dev run

用法: lingo.dev run [选项]

运行 Lingo.dev 本地化引擎

选项:
  --source-locale <source-locale>  用作源语言区域的语言区域。默认为
                                   i18n.json locale.source
  --target-locale <target-locale>  用作目标语言区域的语言区域。默认为
                                   i18n.json locale.targets
  --bucket <bucket>                要处理的存储桶
  --file <file>                    要处理的文件。仅处理路径中匹配此
                                   glob 模式的文件。使用引号包裹模式以防止
                                   shell 扩展(例如,--file '**/*.json')。
                                   如果有大量文件并希望专注于特定文件,此选项非常有用。
                                   可以用逗号或空格分隔指定多个文件。支持 glob 模式。
  --key <key>                      要处理的键。仅处理特定的翻译键,
                                   适用于更新单个条目。支持 glob 模式。
  --force                          忽略锁文件并处理所有键,适用于完整重新翻译
  --api-key <api-key>              显式设置要使用的 API 密钥,覆盖设置中的默认 API 密钥
  --debug                          在开始时暂停执行以进行调试,
                                   等待用户确认后继续
  --concurrency <concurrency>      要运行的并发任务数
  --watch                          监视源文件的更改并自动重新翻译
  --debounce <milliseconds>        监视模式的去抖延迟(以毫秒为单位,默认值: 5000ms)
  -h, --help                       显示帮助

lingo.dev purge

用法: lingo.dev purge [选项]

删除指定的 --bucket、--file、--key、--locale 的翻译

选项:
  --bucket <bucket>  要处理的存储桶
  --file [files...]  要处理的文件。仅处理与给定的 glob 模式匹配的文件。
  --key <key>        要删除的键。删除所有与给定 glob 模式匹配的翻译键。
  --locale <locale>  要处理的语言区域
  --yes-really       跳过交互式确认并直接删除。
  -h, --help         显示帮助