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 显示帮助