文档
配置 verbatra,让每个 语言 环境 保持 同步。
CLI、SDK、Studio 和 MCP 服务器的指南与参考:从快速上手开始,或者让你的编码智能体来配置 verbatra。
从你的 目标 开始
选择你要做的事;每张卡片都会打开对应的页面。
选择 技术栈
标有“快速上手”的卡片会打开该技术栈的分步指南;其他卡片会打开它的 init 命令和文件布局。
每次 运行 都是 差异 比对,而不是重写。
运行 verbatra translate 时会发生什么。
手动维护一个源语言环境,意味着其他每个语言文件都会漂移:新键在目标文件中缺失,编辑过的字符串留下过期的译文,删除的键则作为孤立的键留着。verbatra 把每个目标与已提交的锁文件 verbatra.lock.json 比对,只把已更改的内容发给你配置的提供商,从而消除这种差距;没有新内容可翻译时,再运行一次根本不会调用提供商。每条结果在写入之前都会经过检查,因此损坏的占位符会被搁置并重试,绝不会发布出去。完整流程见运行的工作原理。
1. 检查
verbatra check比对源文件、目标文件和锁文件。它不调用任何提供商,也不需要密钥。2. 翻译
verbatra translate只发送缺失和已更改的键,并拒绝任何占位符不匹配、内联标记损坏或 ICU 语法无效的结果。3. 在 CI 中设门禁
GitHub Action 在每个 pull request 上运行
check,只要有语言环境不同步就让它失败。
verbatra 读写常见的语言文件格式,从 JSON 和 YAML 到 XLIFF、gettext,以及 Android 和 Apple 的消息目录,并通过统一的接口,使用任何受支持的 LLM 或机器翻译提供商进行翻译(也可以一个都不用,见不用机器翻译运行);verbatra 未内置的格式,可以写成自定义适配器加入(见编写自定义格式适配器)。完整的列表见格式和提供商。
软件包
一个引擎,四种使用方式。
verbatra 可执行文件:从 init 和 extract 到 translate、check、export 和 studio 的每个命令,都是 SDK 之上的一层薄封装。从这里开始。
底层的引擎:translate、watch、check、diff、doctor、extract、伪本地化、类型生成,以及 Excel 和 TMX 的往返流程,全部可以通过代码使用。
本地仪表盘,支持就地编辑、审校队列、展示覆盖率和运行情况的 Overview,以及浏览器智能体工具。除非你主动启用,否则不会产生提供商花费。
一个 stdio MCP 服务器,向 Claude Code、Cursor 或任何 MCP 客户端提供翻译状态、术语表和编辑工具。