CLI 命令参考

查找用于设置、翻译和目录维护的 CLI 命令。

使用 lingo --help 查找常用命令,使用 lingo <command> --help 查看选项。lingo --version 用于确认已安装的是哪一代版本。当前软件包为 @lingo.dev/cli;i18n.json 项目请参阅独立的 v0 手册。

对于现有的 i18n.json 项目,迁移指南列出了旧版工作流与当前命令的对应关系。

初始化 #

lingo init 为源语言区域、目标语言区域和文件匹配模式生成初始配置。强制选项会替换现有文件条目,并可能丢弃高级选项;翻译前请检查生成的配置。

登录 #

lingo login 保存浏览器会话或已验证的 API 密钥。本地 --api-key 会持久保存该密钥。在其他命令中使用全局选项时,该选项仅对当次调用生效。

退出登录 #

lingo logout 清除持久保存的凭据。环境变量中的密钥和调用时提供的密钥仍然有效。

当前身份 #

lingo whoami 显示身份和身份验证类型;--json 提供机器可读的输出。因连接问题而改用已存储的信息,并不代表已完成在线验证。

lingo link 保存文件翻译所用的组织 ID 和本地化引擎 ID。这些 ID 用于选择资源,不会授予访问权限。

lingo unlink 移除这些 ID,同时保留文件、本地化设置和远程资源。

推送 #

lingo push 提交源文件。不同模式分别用于基线存储、增量翻译、补齐缺失的目标、刷新键和强制替换。--wait 还会获取输出。再次运行该命令会重试失败的任务。

拉取 #

lingo pull 获取本地记录的最近一次运行结果,并在写入前检查目标哈希值。--dry-run 可预览是否会执行写入,但仍可能连接服务器。

清除 #

lingo purge 预览或删除派生的目标文件。使用文件或语言区域筛选条件时,仅从 Lockfile 中移除选中的目标条目;未使用筛选条件时,则移除整个 Lockfile。共享的 XCStrings 目录会被跳过。

提取 #

lingo extract 将受支持的静态 TypeScript/TSX 调用转换为源 JSONC 文件和声明。这是本地提取操作,不会自动改写或翻译。

检查 #

如果目标文件缺失,lingo check 检查会失败;如果存在 .lingo/lock.json,且源内容在上次翻译后发生了变化,检查也会失败。它不会发起任何网络请求,也不需要 API 密钥。没有 Lockfile 时,它只检查目标文件是否存在。在 React 项目中,它还会检查翻译目录和类型是否已更新、上下文、孤立项以及缺失的翻译。它不会检查非 React 目标文件中的键,也不会评估翻译质量。

清理 #

lingo clean 立即从 JSONC 目录中移除孤立的源条目和过时的目标条目。它不提供试运行标志,也不会重新生成声明。

指南 #

lingo guide [name] 输出软件包内置的离线 React 指南。指南名称为 index、setup-react、api 和 migrate;省略名称时会选择索引。名称无法识别时,会显示可用选项。指南对应已安装的软件包版本。

智能体指南 #

lingo agent-guide [name] 面向 AI 智能体。不指定名称时,它会输出智能体指南,介绍设置、登录和 MCP server,并列出供智能体和用户使用的指南。指定名称时,它会输出相应指南,包括列表中未列出的技术栈指南。指南内容与已安装的软件包版本相匹配。

智能体 #

lingo agent setup 会检查检测到的编程智能体(Claude Code、Codex 和 Cursor,以及它自身运行所在的智能体)是否已配置 Lingo.dev MCP server,并引导尚未配置的智能体参阅 MCP 设置;它不会修改这些智能体的配置。--client 可改为指定要检查的智能体,包括未检测到的智能体。如果没有可检查的智能体,操作会失败,且不会写入任何内容。在项目中,它还会将 Lingo.dev 区块写入 AGENTS.md 和已有的 CLAUDE.md,除非后者导入了用于承载该区块的 AGENTS.md;它不会创建 CLAUDE.md。如果文件无法读取、链接指向项目之外,或区块标记不成对,它会保留文件原样并说明原因;请修复文件后重新运行设置。--dry-run 会显示执行计划,-y 会直接写入,无需确认,--status 会显示已检测到的智能体的配置情况,并忽略 --client。使用编程智能体进行设置 中提供了可交给智能体的提示词。

更新 #

lingo update 使用检测到的安装方式进行更新。若要安装特定版本,请使用包管理器。更新检查结果会被缓存;检测到 CI 环境或通过环境变量禁用时,会跳过检查。

评分 #

lingo score 已注册,但不会显示在常规帮助中。它通过 OpenRouter 运行本地评分器与模型的组合,并将结果写入本地,不会新增 Radar 历史记录。